XML Encoding for JSON
XSON is a Python package that supports the serialization of Python objects to XML documents according to the JSONx specification (draft), as well as the deserialization of JSONx documents to Python objects. The implementation aims at being API and CLI-compatible with Python's standard JSON package.
- Python >= 3.8
To use XSON in another project, it can be added to setup.cfg
as an install
requirement (if using setuptools with declarative config):
[options]
install_requires =
xson
To install XSON manually, e.g., into a virtual environment, use pip:
pip install xson
The above approaches install the latest release of XSON from PyPI. Alternatively, for the development version, clone the project and perform a local install:
pip install .
Example:
>>> import xson
>>> out = xson.dumps({'foo': 42, 'bar': [3.14, 'baz', True, None]}, indent=4)
>>> print(out) #doctest: +NORMALIZE_WHITESPACE
<?xml version="1.0" encoding="UTF-8"?>
<json:object xmlns:json="https://www.ibm.com/xmlns/prod/2009/jsonx">
<json:number name="foo">42</json:number>
<json:array name="bar">
<json:number>3.14</json:number>
<json:string>baz</json:string>
<json:boolean>true</json:boolean>
<json:null/>
</json:array>
</json:object>
>>> dct = xson.loads(out)
>>> print(dct)
{'foo': 42, 'bar': [3.14, 'baz', True, None]}
A command line tool is available to validate, pretty-print, or convert between JSONx and JSON objects:
xson-tool --help
or:
python -m xson.tool --help
Licensed under the BSD 3-Clause License.