copyreg — регистрация функций поддержки pickle

Исходный код: Lib/copyreg.py

Модуль copyreg предоставляет способ определять функции, используемые при сериализации определённых объектов. Модули pickle и copy используют эти функции при сериализации и копировании таких объектов. Модуль предоставляет сведения о настройке конструкторов объектов, которые не являются классами. Такие конструкторы могут быть фабричными функциями или экземплярами классов.

copyreg.constructor(object)

Объявляет object допустимым конструктором. Если object не является вызываемым (и поэтому не может использоваться как конструктор), возбуждается исключение TypeError.

copyreg.pickle(type, function, constructor_ob=None)

Объявляет, что function следует использовать как функцию «сведения» для объектов типа type. Функция function должна возвращать строку или кортеж, содержащий от двух до шести элементов. Дополнительные сведения об интерфейсе функции function см. в описании dispatch_table.

Параметр constructor_ob является устаревшей возможностью и теперь игнорируется, но, если он передан, должен быть вызываемым.

Обратите внимание, что атрибут dispatch_table объекта-пиклера или подкласса pickle.Pickler также можно использовать для объявления функций сведения.

>>> import copyreg, copy, pickle
>>> class C:
...     def __init__(self, a):
...         self.a = a
...
>>> def pickle_c(c):
...     print("pickling a C instance...")
...     return C, (c.a,)
...
>>> copyreg.pickle(C, pickle_c)
>>> c = C(1)
>>> d = copy.copy(c)
pickling a C instance...
>>> p = pickle.dumps(c)
pickling a C instance...