Skip to content

Pickle: сериализация любых объектов Python ​

JSON — формат обмена: его читают другие языки. Но внутри своей программы иногда нужно сохранить любой объект Python: кортеж, множество, datetime, даже объект своего класса. Для этого и создан модуль pickle — он записывает и восстанавливает объекты без потери типов.

Как это работает ​

pickle.dump(obj, file) — в файл, pickle.load(file) — обратно. Файл открывается в бинарном режиме 'wb'/'rb':

py
import pickle
import datetime as dt

hand = (8, 'Q')                  # кортеж
cities = {'Омск', 'Москва'}      # множество
when = dt.datetime(1961, 4, 12, 9, 7)

data = {'hand': hand, 'cities': cities, 'when': when}

with open('data.pkl', 'wb') as f:
    pickle.dump(data, f)

Восстановление:

py
with open('data.pkl', 'rb') as f:
    loaded = pickle.load(f)

print(loaded['hand'])    # (8, 'Q')  — всё ещё tuple
print(loaded['cities'])  # {'Омск', 'Москва'}
print(type(loaded['when']))  # <class 'datetime.datetime'>

После json.loads(json.dumps(...)) кортеж уже был бы списком; pickle вернул ровно то, что сохранил.

Pickle-файл — не текст: его нельзя открыть в редакторе и поправить «на глаз». Зато он компактный и быстрый. Расширение по умолчанию — .pkl или .pickle.

⚠️ Безопасность: не открывай чужой pickle ​

Самое важное ограничение. pickle.load() может выполнить произвольный код, зашитый в файл. Вредоносный pickle — это не «данные с ошибками», а инструмент атаки: файл может выполнить os.system('rm -rf ...') в момент чтения.

Правило железное:

  • свой pickle-файл, созданный вашей же программой, в той же версии Python — читается;
  • чужой pickle-файл (с диска, из сети, от коллеги) — никогда не читать через pickle.load().

Для обмена между программами и людьми есть безопасные форматы: JSON, CSV, YAML (safe_load).

Телефонная книга в pickle ​

py
import pickle

phone_book = {
    'Серёга': {'city': 'Омск', 'phone': '+7 900 123-45-67'},
    'Соня': {'city': 'Москва', 'phone': '+7 911 234-56-78'},
    'Дима': {'city': 'Челябинск', 'phone': '+7 922 345-67-89'}
}

with open('phone_book.pkl', 'wb') as f:
    pickle.dump(phone_book, f)

with open('phone_book.pkl', 'rb') as f:
    loaded = pickle.load(f)

print(loaded == phone_book)  # True

Плюсы и минусы ​

Плюсы:

  • любые типы Python: кортежи, множества, datetime, собственные классы;
  • быстро и компактно;
  • в стандартной библиотеке.

Минусы:

  • бинарный — человек не читает и не правит;
  • опасен для чужих данных: load может выполнить код;
  • не переносим: pickle от одной версии Python может не читаться другой, другие языки его не понимают;
  • не формат обмена — только «внутренний бэкап» программы.

Итог ​

Pickle — «заморозка» объектов Python в файл. Отлично подходит, когда данные уходят и возвращаются в ту же программу; непригоден для обмена с людьми и другими языками. Все форматы на месте — последний урок курса: как выбрать нужный.


Упражнения ​

  1. Сохраните кортеж (8, 'Q') в файл hand.pkl, восстановите его и напечатайте type() результата. Сравните: что вернул бы json.loads(json.dumps(...)) для того же кортежа? Объясните разницу в комментарии.
py
import pickle
import json
# допишите код ниже
  1. Сохраните в один pickle-файл словарь с ключами: cities (множество {'Омск', 'Москва'}) и when (datetime старта Гагарина — 1961-04-12 09:07). Восстановите и напечатайте типы обоих значений.
py
import pickle
import datetime as dt
# допишите код ниже
  1. Попробуйте сохранить множество через json.dumps({'cities': {'Омск', 'Москва'}}). Запишите в комментарий, какое исключение возникло, и почему pickle справился бы там же, где JSON упал.
py
import json
# допишите код ниже
  1. Сохраните телефонную книгу Виты в phone_book.pkl, восстановите и проверьте равенство == с исходным словарём.
py
import pickle

phone_book = {
    'Серёга': {'city': 'Омск', 'phone': '+7 900 123-45-67'},
    'Соня': {'city': 'Москва', 'phone': '+7 911 234-56-78'},
    'Дима': {'city': 'Челябинск', 'phone': '+7 922 345-67-89'}
}
# допишите код ниже
  1. Напечатайте первые 200 байтов файла phone_book.pkl (считайте его в режиме 'rb' и превратите в строку через errors='ignore'). В комментарии ответьте: можно ли этот файл открыть в текстовом редакторе и поправить один телефон?
py
# допишите код ниже
  1. Коллега прислал вам файл friends.pkl с «телефонной книгой». Напишите в комментарии: что вы сделаете с этим файлом (и почему именно так), какой формат попросили бы вместо него, и какое правило безопасности из урока это иллюстрирует.
py
# допишите ответ ниже