Package: jsonpickle
jsonpicklejsonpickle is a library for the two-way conversion of complex Python objects
andJSON.  jsonpickle builds upon the existing JSON
encoders, such as simplejson, json, and ujson.Warningjsonpickle can execute arbitrary Python code.Please see the Security section for more details.For complete documentation, please visit thejsonpickle documentation.Bug reports and merge requests are encouraged at thejsonpickle repository on github.Why jsonpickle?Data serialized with python’s pickle (or cPickle or dill) is not easily readable outside of python. Using the json format, jsonpickle allows simple data types to be stored in a human-readable format, and more complex data types such as numpy arrays and pandas dataframes, to be machine-readable on any platform that supports json. E.g., unlike pickled data, jsonpickled data stored in an Amazon S3 bucket is indexible by Amazon’s Athena.Securityjsonpickle should be treated the same as thePython stdlib pickle modulefrom a security perspective.WarningThe jsonpickle moduleis not secure.  Only unpickle data you trust.It is possible to construct malicious pickle data which willexecute
arbitrary code during unpickling.  Never unpickle data that could have come
from an untrusted source, or that could have been tampered with.Consider signing data with an HMAC if you need to ensure that it has not
been tampered with.Safer deserialization approaches, such as reading JSON directly,
may be more appropriate if you are processing untrusted data.InstallInstall from pip for the latest stable release:pip install jsonpickleInstall from github for the latest changes:pip install git+https://github.com/jsonpickle/jsonpickle.gitIf you have the files checked out for development:git clone https://github.com/jsonpickle/jsonpickle.git
cd jsonpickle
python setup.py developNumpy Supportjsonpickle includes a built-in numpy extension.  If would like to encode
sklearn models, numpy arrays, and other numpy-based data then you must
enable the numpy extension by registering its handlers:>>> import jsonpickle.ext.numpy as jsonpickle_numpy
>>> jsonpickle_numpy.register_handlers()Pandas Supportjsonpickle includes a built-in pandas extension.  If would like to encode
pandas DataFrame or Series objects then you must enable the pandas extension
by registering its handlers:>>> import jsonpickle.ext.pandas as jsonpickle_pandas
>>> jsonpickle_pandas.register_handlers()DevelopmentUsemaketo run the unit tests:make testpytestis used to run unit tests internally.Atoxtarget is provided to run tests using all installed and supported Python versions:make toxjsonpickleitself has no dependencies beyond the Python stdlib.toxis required for testing when using thetoxtest runner only.The testing requirements are specified inrequirements-dev.txt.
It is recommended to create a virtualenv and run tests from within the
virtualenv, or use a tool such asvxto activate the virtualenv without polluting the shell environment:python3 -mvenv env3x
vx env3x pip install --requirement requirements-dev.txt
vx env3x make testjsonpicklesupports multiple Python versions, so using a combination of
multiple virtualenvs andtoxis useful in order to catch compatibility
issues when developing.GPG SigningReleases before v3.0.0 are signed withdavvid’s key. v3.0.0 and after are likely signed byTheelx’s key. All upcoming releases should be signed by one of these two keys, usually Theelx’s key.jsonpickleJSjsonpickleJSis a javascript implementation of jsonpickle by Michael Scott Cuthbert.
jsonpickleJS can be extremely useful for projects that have parallel data
structures between Python and Javascript.LicenseLicensed under the BSD License. See COPYING for details.
See jsonpickleJS/LICENSE for details about the jsonpickleJS license.