python-rapidjson · Python Simple Repository Browser

Project Links

Meta

Author: Ken Robbins

Maintainer: Lele Gaifax

Requires Python: >=3.6

Classifiers

Development Status

5 - Production/Stable

Intended Audience

Developers

Programming Language

C++
Python :: 3 :: Only
Python :: 3
Python :: 3.9
Python :: 3.10
Python :: 3.11
Python :: 3.12
Python :: 3.13
Python :: 3.14
Python

Authors:

Ken Robbins <ken@kenrobbins.com>

Lele Gaifax <lele@metapensiero.it>

License:

MIT License

Status:

RapidJSON is an extremely fast C++ JSON parser and serialization library: this module wraps it into a Python 3 extension, exposing its serialization/deserialization (to/from either bytes, str or file-like instances) and JSON Schema validation capabilities.

Latest version documentation is automatically rendered by Read the Docs.

Getting Started

First install python-rapidjson:

$ pip install python-rapidjson

or, if you prefer Conda:

$ conda install -c conda-forge python-rapidjson

Basic usage looks like this:

>>> import rapidjson
>>> data = {'foo': 100, 'bar': 'baz'}
>>> rapidjson.dumps(data)
'{"foo":100,"bar":"baz"}'
>>> rapidjson.loads('{"bar":"baz","foo":100}')
{'bar': 'baz', 'foo': 100}
>>>
>>> class Stream:
...   def write(self, data):
...      print("Chunk:", data)
...
>>> rapidjson.dump(data, Stream(), chunk_size=5)
Chunk: b'{"foo'
Chunk: b'":100'
Chunk: b',"bar'
Chunk: b'":"ba'
Chunk: b'z"}'

Most functionalities are exposed both as functions and as classes.

The following uses a relaxed syntax Decoder instance, that handles JSONC and trailing commas:

>>> from rapidjson import Decoder
>>> from rapidjson import PM_COMMENTS, PM_TRAILING_COMMAS
>>> decoder = Decoder(parse_mode=PM_COMMENTS | PM_TRAILING_COMMAS)
>>> decoder('''
... {
...     "bar": /* Block comment */ "baz",
...     "foo":100, // Trailing comma and comment
... }
... ''')
{'bar': 'baz', 'foo': 100}

Development

If you want to install the development version (maybe to contribute fixes or enhancements) you may clone the repository:

$ git clone --recursive https://github.com/python-rapidjson/python-rapidjson.git

Note

The --recursive option is needed because we use a submodule to include RapidJSON sources. Alternatively you can do a plain clone immediately followed by a git submodule update --init.

Alternatively, if you already have (a compatible version of) RapidJSON includes around, you can compile the module specifying their location with the option --rj-include-dir, for example:

$ python3 setup.py build --rj-include-dir=/usr/include/rapidjson

A set of makefiles implement most common operations, such as build, check and release; see make help output for a list of available targets.

Performance

python-rapidjson tries to be as performant as possible while staying compatible with the json module.

See this section in the documentation for a comparison with other JSON libraries.

Incompatibility

Although we tried to implement an API similar to the standard library json, being a strict drop-in replacement in not our goal and we have decided to depart from there in some aspects. See this section in the documentation for further details.

Platform	CPython 3.9	CPython 3.10	CPython 3.11	CPython 3.12	CPython 3.13	CPython 3.14	CPython (additional flags: t) 3.14
macosx_10_13_x86_64
macosx_10_15_x86_64
macosx_10_9_x86_64
macosx_11_0_arm64
manylinux_2_24_aarch64
manylinux_2_24_ppc64le
manylinux_2_24_x86_64
manylinux_2_28_aarch64
manylinux_2_28_ppc64le
manylinux_2_28_x86_64
musllinux_1_2_aarch64
musllinux_1_2_ppc64le
musllinux_1_2_x86_64
win32
win_amd64

python-rapidjson 1.22

Development Status

Intended Audience

Programming Language

Getting Started

Development

Performance

Incompatibility

Changes

1.22 (2025-10-21)

1.21 (2025-07-10)

1.20 (2024-08-05)

1.19 (2024-07-28)

1.18 (2024-06-29)

1.17 (2024-05-18)

1.16 (2024-02-28)

1.15 (2024-02-28)

1.14 (2023-12-14)

1.13 (2023-10-29)

1.12 (2023-10-07)

1.11 (2023-09-11)

1.10 (2023-03-15)

1.9 (2022-10-17)

1.8 (2022-07-07)

1.7 (2022-07-06)

1.6 (2022-02-19)

1.5 (2021-10-16)

1.4 (2021-06-25)

1.3 (2021-06-25)

1.2 (2021-06-25)

1.1 (2021-06-25)

1.0 (2020-12-13)

0.9.4 (2020-11-16)

0.9.3 (2020-10-24)

0.9.2 (2020-10-24)

0.9.1 (2019-11-13)

0.9.0 (2019-11-13)

0.8.0 (2019-08-09)

0.7.2 (2019-06-09)

0.7.1 (2019-05-11)

0.7.0 (2019-02-11)

0.6.3 (2018-07-11)

0.6.2 (2018-06-08)

0.6.1 (2018-06-06)

0.6.0 (2018-06-06)

0.5.2 (2018-03-31)

0.5.1 (2018-03-31)

0.5.0 (2018-03-31)

0.4.3 (2018-01-14)

0.4.2 (2018-01-09)

0.4.1 (2018-01-08)

0.4.0 (2018-01-05)

0.3.2 (2017-12-21)

0.3.1 (2017-12-20)

0.3.0 (2017-12-20)

0.2.7 (2017-12-08)

0.2.6 (2017-12-08)

0.2.5 (2017-09-30)

0.2.4 (2017-09-17)

0.2.3 (2017-08-24)

0.2.2 (2017-08-24)

0.2.1 (2017-08-24)

0.2.0 (2017-08-24)

0.1.0 (2017-08-16)

0.1.0b4 (2017-08-14)

0.1.0b3 (2017-08-12)

0.1.0b2 (2017-08-12)

0.1.0b1 (2017-08-12)

0.0.11 (2017-03-05)

0.0.10 (2017-03-02)

0.0.9 (2017-03-02)

0.0.8 (2016-12-09)

Wheel compatibility matrix

Files in release