A python JSON serialisation library implemented as a C extension.
- Speed: Initial benchmarks show non-float/exponential json data to be on par with
orjsonandmsgspec. - Memory: Initial benchmarks show memory usage close or sometimes less than
msgspec.
See more at Benchmarks.
Important
This project is under development and not meant to be used in prod. (if ever haha)
- Extremely fast implementations
- Very low memory usage
- Allows for python like indexing, hence avoiding creation of intermediate/unused python objects.
| Decoder | decode (μs) | vs. |
|---|---|---|
| msgspec structs | 332.3 | 1.00x |
| msgspec | 433.9 | 1.31x |
| specific-json | 436.7 | 1.31x |
| orjson | 528.5 | 1.59x |
| json | 817.4 | 2.46x |
| Decoder | decode (ms) | vs. |
|---|---|---|
| orjson | 2.376 | 1.00x |
| specific-json | 2.550 | 1.07x |
| msgspec | 2.718 | 1.14x |
| json | 6.795 | 2.86x |
Important
Regarding the orjson benchmarks, since specific-json cannot handle escaped characters yet, the data for all libs had no escaped chars.
BUT, only one string had escaped characters, so overall performance should not be heavily affected.
Do take these benchmarks with a pinch of salt, these are results on my machine (Windows) and they have been modified to fit in one file for convenience. A more reliable benchmark will be used and uploaded in the future hopefully.
All major platforms are supported on Pypi!
Note
Python 3.12+ is required!
#windows
py -m pip install -U specific-json
#linux/macos
python3 -m pip install -U specific-jsonIf you want to build this yourself, run this command to compile the extension in the root directory.
py setup.py build_ext --inplace
from specific_json import json_decode
json_str = \
"""
{
"name": "Sacul",
"active": true,
"tags": ["python", "c", "json"]
}
"""
def main():
whole_obj = json_decode(json_str)
is_active = json_decode(json_str, "active")
first_tag = json_decode(json_str, "tags", 0)
print(whole_obj)
print(is_active)
print(first_tag)
if __name__ == "__main__":
main()The project is currently incomplete, see the TODO.