Apparently the code to forestall Tk eating events was too aggressive (Tk user input...
[python/dscho.git] / Doc / lib / libcopyreg.tex
blobbdeca88b8ea7f6e314c9852a0de9483f718684e6
1 \section{\module{copy_reg} ---
2 Register \module{pickle} support functions}
4 \declaremodule[copyreg]{standard}{copy_reg}
5 \modulesynopsis{Register \module{pickle} support functions.}
8 The \module{copy_reg} module provides support for the
9 \refmodule{pickle}\refstmodindex{pickle} and
10 \refmodule{cPickle}\refbimodindex{cPickle} modules. The
11 \refmodule{copy}\refstmodindex{copy} module is likely to use this in the
12 future as well. It provides configuration information about object
13 constructors which are not classes. Such constructors may be factory
14 functions or class instances.
17 \begin{funcdesc}{constructor}{object}
18 Declares \var{object} to be a valid constructor. If \var{object} is
19 not callable (and hence not valid as a constructor), raises
20 \exception{TypeError}.
21 \end{funcdesc}
23 \begin{funcdesc}{pickle}{type, function\optional{, constructor}}
24 Declares that \var{function} should be used as a ``reduction''
25 function for objects of type \var{type}; \var{type} should not a
26 class object. \var{function} should return either a string or a
27 tuple. The optional \var{constructor} parameter, if provided, is a
28 callable object which can be used to reconstruct the object when
29 called with the tuple of arguments returned by \var{function} at
30 pickling time. \exception{TypeError} will be raised if
31 \var{object} is a class or \var{constructor} is not callable.
32 \end{funcdesc}