12.2. copyreg – Регистрация функций поддержки pickle¶copyreg – Register pickle support functions

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

copyreg.constructor(object)¶

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

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

Объявляет, что function должна использоваться как функция редукции (reduction) для объектов типа тип. функция должна возвращать строку или кортеж, содержащий два или три элемента.

Необязательный параметр constructor, если указан, представляет собой вызываемый объект, который можно использовать для восстановления объекта при вызове с кортежем аргументов, возвращаемых function во время упаковки. TypeError будет возбуждено, если object является классом или constructor не является вызываемым.

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

>>> import copyreg, copy, pickle
>>> class C(object):
...     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...