pikl 0.0.1

注意

pikl最终派生自python的pickle模块。 尽管已经努力消除已查明的安全漏洞， 几乎可以肯定的是，仍然存在更多的伤害。

pickle模块不是用来防止错误或 恶意构建的数据。从不解除从 可能会执行不受信任或未经身份验证的源作为任意代码。

另请参见https://docs.python.org/3.6/library/pickle.html

一般用法

要使用pikl而不是python的内置pickle模块，请替换：

import pickle

签署人：

import pikl.pickle as pikl

这提供了兼容性，但其效果是您可以快速实现 在Python3中，Python2使用慢速版本。

要获得更确定的实现选择，请使用以下选项之一：

import pikl.fastpickle as pikl # always C
import pikl.slowpickle as pikl # always Python

由pickle生成的bytestream可以由pikl加载，前提是 满足某些限制（例如，协议>；=2，不使用全局操作码）：

$ python3
>>> import pickle
>>> s = pickle.dumps({'abc': 2})
>>> from pikl import pickle as pikl
>>> pikl.loads(s)
{'abc': 2}

加载早期协议将引发UnpicklingError：

>>> s = pickle.dumps({'abc': 2}, protocol=0)
>>> pikl.loads(s)
Traceback (most recent call last):
...
pikl.pickle_3.UnpicklingError: Only binary pickle protocols are supported

加载未注册的类或可调用的类将引发UnpicklingError：

>>> s = pickle.dumps(complex(2, 1))
>>> pikl.loads(s)
Traceback (most recent call last):
...
pikl.pickle_3.UnpicklingError: GLOBAL opcode is not supported

扩展注册表

提供用于加载类或可调用项的opt-in机制pikluses copyreg模块中的扩展注册表：

>>> import copyreg
>>> copyreg.add_extension('builtins', 'complex', 240)
>>> s = pickle.dumps(complex(2, 1))
>>> pikl.loads(s)
(2+1j)

pickler和unpickler必须在相同的注册表代码上达成一致。未来 pikl的版本将包括一个机制（例如定义的配置文件）来实现这一点 协助。