Commit e62aad30 authored by Ezio Melotti's avatar Ezio Melotti

#13426: fix typos in pickle doc.

parent eeae1498
...@@ -237,7 +237,7 @@ The :mod:`pickle` module defines three exceptions: ...@@ -237,7 +237,7 @@ The :mod:`pickle` module defines three exceptions:
.. exception:: UnpicklingError .. exception:: UnpicklingError
Error raised when there a problem unpickling an object, such as a data Error raised when there is a problem unpickling an object, such as a data
corruption or a security violation. It inherits :exc:`PickleError`. corruption or a security violation. It inherits :exc:`PickleError`.
Note that other exceptions may also be raised during unpickling, including Note that other exceptions may also be raised during unpickling, including
...@@ -324,11 +324,11 @@ The :mod:`pickle` module exports two classes, :class:`Pickler` and ...@@ -324,11 +324,11 @@ The :mod:`pickle` module exports two classes, :class:`Pickler` and
.. method:: persistent_load(pid) .. method:: persistent_load(pid)
Raise an :exc:`UnpickingError` by default. Raise an :exc:`UnpicklingError` by default.
If defined, :meth:`persistent_load` should return the object specified by If defined, :meth:`persistent_load` should return the object specified by
the persistent ID *pid*. If an invalid persistent ID is encountered, an the persistent ID *pid*. If an invalid persistent ID is encountered, an
:exc:`UnpickingError` should be raised. :exc:`UnpicklingError` should be raised.
See :ref:`pickle-persistent` for details and examples of uses. See :ref:`pickle-persistent` for details and examples of uses.
...@@ -377,7 +377,7 @@ raised in this case. You can carefully raise this limit with ...@@ -377,7 +377,7 @@ raised in this case. You can carefully raise this limit with
Note that functions (built-in and user-defined) are pickled by "fully qualified" Note that functions (built-in and user-defined) are pickled by "fully qualified"
name reference, not by value. This means that only the function name is name reference, not by value. This means that only the function name is
pickled, along with the name of module the function is defined in. Neither the pickled, along with the name of the module the function is defined in. Neither the
function's code, nor any of its function attributes are pickled. Thus the function's code, nor any of its function attributes are pickled. Thus the
defining module must be importable in the unpickling environment, and the module defining module must be importable in the unpickling environment, and the module
must contain the named object, otherwise an exception will be raised. [#]_ must contain the named object, otherwise an exception will be raised. [#]_
...@@ -668,7 +668,7 @@ inoffensive, it is not difficult to imagine one that could damage your system. ...@@ -668,7 +668,7 @@ inoffensive, it is not difficult to imagine one that could damage your system.
For this reason, you may want to control what gets unpickled by customizing For this reason, you may want to control what gets unpickled by customizing
:meth:`Unpickler.find_class`. Unlike its name suggests, :meth:`find_class` is :meth:`Unpickler.find_class`. Unlike its name suggests, :meth:`find_class` is
called whenever a global (i.e., a class or a function) is requested. Thus it is called whenever a global (i.e., a class or a function) is requested. Thus it is
possible to either forbid completely globals or restrict them to a safe subset. possible to either completely forbid globals or restrict them to a safe subset.
Here is an example of an unpickler allowing only few safe classes from the Here is an example of an unpickler allowing only few safe classes from the
:mod:`builtins` module to be loaded:: :mod:`builtins` module to be loaded::
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment