Universal Binary JSON draft-12 serializer for Python
This is a Python v3.2+ (and 2.7+) Universal Binary JSON encoder/decoder based on the draft-12 specification.
# To get from PyPI
pip3 install py-ubjson
# To only build extension modules inline (e.g. in repository)
python3 setup.py build_ext -i
# To build & install globally
python3 setup.py install
# To skip building of extensions when installing (or building)
PYUBJSON_NO_EXTENSION=1 python3 setup.py install
Notes
It's meant to behave very much like Python's built-in JSON module, e.g.:
import ubjson
encoded = ubjson.dumpb({u'a': 1})
decoded = ubjson.loadb(encoded)
Note: Only unicode strings in Python 2 will be encoded as strings, plain str will be encoded as a byte array.
import ubjson
help(ubjson.dump)
help(ubjson.load)
This converts between JSON and UBJSON formats:
python3 -mubjson
USAGE: ubjson (fromjson|tojson) (INFILE|-) [OUTFILE]
This library has been checked using flake8 and pylint, using a modified configuration - see pylint.rc and flake8.cfg.
python3 -mvenv py
. py/bin/activate
pip install -U pip setuptools
pip install -e .[dev]
./coverage_test.sh
Note: See coverage_test.sh
for additional requirements.
The only existing implementation I was aware of at the time of writing (simpleubjson) had the following limitations: