copyreg – Регистрация вспомогательных функций pickle¶copyreg – Register pickle support functions

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

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

copyreg.constructor(object)¶

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

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

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

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

Обратите внимание, что атрибут dispatch_table объекта pickler или подкласса 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...