jsonpickle
jsonpickle is a library for the two-way conversion of complex Python objects and JSON. jsonpickle builds upon the existing JSON encoders, such as simplejson, json, and ujson.
For complete documentation, please visit the jsonpickle documentation.
Bug reports and merge requests are encouraged at the jsonpickle 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.
Security
jsonpickle should be treated the same as the Python stdlib pickle module from a security perspective.
Install
Install from pip for the latest stable release:
pip install jsonpickle
Install from github for the latest changes:
pip install git+https://github.com/jsonpickle/jsonpickle.git
If you have the files checked out for development:
git clone https://github.com/jsonpickle/jsonpickle.git cd jsonpickle python setup.py develop
Numpy Support
jsonpickle 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 Support
jsonpickle 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()
Development
Use make to run the unit tests:
make test
pytest is used to run unit tests internally.
A tox target is provided to run tests using all installed and supported Python versions:
make tox
jsonpickle itself has no dependencies beyond the Python stdlib. tox is required for testing when using the tox test runner only.
The testing requirements are specified in requirements-dev.txt. It is recommended to create a virtualenv and run tests from within the virtualenv, or use a tool such as vx to activate the virtualenv without polluting the shell environment:
python3 -mvenv env3x vx env3x pip install --requirement requirements-dev.txt vx env3x make test
jsonpickle supports multiple Python versions, so using a combination of multiple virtualenvs and tox is useful in order to catch compatibility issues when developing.
GPG Signing
Releases before v3.0.0 are signed with davvid’s key. v3.0.0 and after are likely signed by Theelx’s key. All upcoming releases should be signed by one of these two keys, usually Theelx’s key.
jsonpickleJS
jsonpickleJS is 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.
License
Licensed under the BSD License. See COPYING for details. See jsonpickleJS/LICENSE for details about the jsonpickleJS license.
4 maintainers
Metadata
4 maintainers
Release files for jsonpickle 3.0.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| jsonpickle-3.0.3.tar.gz | 264.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| jsonpickle-3.0.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 305.7 kB
Release files / jsonpickle-3.0.3.tar.gz
| Download URL | jsonpickle-3.0.3.tar.gz |
|---|---|
| Size | 264.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5691f44495327858ab3a95b9c440a79b41e35421be1a6e09a47b6c9b9421fd06
|
|
BLAKE2b-256 checksum How to use checksums |
056838c6c809fd3203e507c0c95ebede5e682bdc84f2e81fc6f818d7926c6a41
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.11.7
|
Release files / jsonpickle-3.0.3-py3-none-any.whl
| Download URL | jsonpickle-3.0.3-py3-none-any.whl |
|---|---|
| Size | 40.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e8d6dcc58f6722bea0321cd328fbda81c582461185688a535df02be0f699afb4
|
|
BLAKE2b-256 checksum How to use checksums |
d6bec11f919e02622f15b942c0f2867dff6c3836ce32cd617627dda73bc9e5b7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.11.7
|
