| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202 |
- Metadata-Version: 2.4
- Name: ujson
- Version: 5.11.0
- Summary: Ultra fast JSON encoder and decoder for Python
- Home-page: https://github.com/ultrajson/ultrajson
- Download-URL: https://github.com/ultrajson/ultrajson
- Author: Jonas Tarnstrom
- Project-URL: Source, https://github.com/ultrajson/ultrajson
- Platform: any
- Classifier: Development Status :: 5 - Production/Stable
- Classifier: Intended Audience :: Developers
- Classifier: Programming Language :: C
- Classifier: Programming Language :: Python :: 3
- Classifier: Programming Language :: Python :: 3 :: Only
- Classifier: Programming Language :: Python :: 3.9
- Classifier: Programming Language :: Python :: 3.10
- Classifier: Programming Language :: Python :: 3.11
- Classifier: Programming Language :: Python :: 3.12
- Classifier: Programming Language :: Python :: 3.13
- Classifier: Programming Language :: Python :: 3.14
- Classifier: Typing :: Typed
- Requires-Python: >=3.9
- Description-Content-Type: text/markdown
- License-File: LICENSE.txt
- Dynamic: download-url
- Dynamic: license-file
- # UltraJSON
- [](https://pypi.org/project/ujson)
- [](https://pypi.org/project/ujson)
- [](https://pypistats.org/packages/ujson)
- [](https://github.com/ultrajson/ultrajson/actions)
- [](https://codecov.io/gh/ultrajson/ultrajson)
- [](https://zenodo.org/badge/latestdoi/1418941)
- [](https://github.com/psf/black)
- UltraJSON is an ultra fast JSON encoder and decoder written in pure C with bindings for
- Python 3.9+.
- Install with pip:
- ```sh
- python -m pip install ujson
- ```
- ## Project status
- > [!WARNING]
- > UltraJSON's architecture is fundamentally ill-suited to making changes without
- > risk of introducing new security vulnerabilities. As a result, this library
- > has been put into a *maintenance-only* mode. Support for new Python versions
- > will be added and critical bugs and security issues will still be
- > fixed but all other changes will be rejected. Users are encouraged to migrate
- > to [orjson](https://pypi.org/project/orjson/) which is both much faster and
- > less likely to introduce a surprise buffer overflow vulnerability in the
- > future.
- ## Usage
- May be used as a drop in replacement for most other JSON parsers for Python:
- ```pycon
- >>> import ujson
- >>> ujson.dumps([{"key": "value"}, 81, True])
- '[{"key":"value"},81,true]'
- >>> ujson.loads("""[{"key": "value"}, 81, true]""")
- [{'key': 'value'}, 81, True]
- ```
- ### Encoder options
- #### encode_html_chars
- Used to enable special encoding of "unsafe" HTML characters into safer Unicode
- sequences. Default is `False`:
- ```pycon
- >>> ujson.dumps("<script>John&Doe", encode_html_chars=True)
- '"\\u003cscript\\u003eJohn\\u0026Doe"'
- ```
- #### ensure_ascii
- Limits output to ASCII and escapes all extended characters above 127. Default is `True`.
- If your end format supports UTF-8, setting this option to false is highly recommended to
- save space:
- ```pycon
- >>> ujson.dumps("åäö")
- '"\\u00e5\\u00e4\\u00f6"'
- >>> ujson.dumps("åäö", ensure_ascii=False)
- '"åäö"'
- ```
- #### escape_forward_slashes
- Controls whether forward slashes (`/`) are escaped. Default is `True`:
- ```pycon
- >>> ujson.dumps("https://example.com")
- '"https:\\/\\/example.com"'
- >>> ujson.dumps("https://example.com", escape_forward_slashes=False)
- '"https://example.com"'
- ```
- #### indent
- Controls whether indentation ("pretty output") is enabled. Default is `0` (disabled):
- ```pycon
- >>> ujson.dumps({"foo": "bar"})
- '{"foo":"bar"}'
- >>> print(ujson.dumps({"foo": "bar"}, indent=4))
- {
- "foo": "bar"
- }
- ```
- ## Benchmarks
- *UltraJSON* calls/sec compared to other popular JSON parsers with performance gain
- specified below each.
- ### Test machine
- Linux 5.15.0-1037-azure x86_64 #44-Ubuntu SMP Thu Apr 20 13:19:31 UTC 2023
- ### Versions
- - CPython 3.11.3 (main, Apr 6 2023, 07:55:46) [GCC 11.3.0]
- - ujson : 5.7.1.dev26
- - orjson : 3.9.0
- - simplejson : 3.19.1
- - json : 2.0.9
- | | ujson | orjson | simplejson | json |
- |-------------------------------------------------------------------------------|-----------:|-----------:|-----------:|-----------:|
- | Array with 256 doubles | | | | |
- | encode | 18,282 | 79,569 | 5,681 | 5,935 |
- | decode | 28,765 | 93,283 | 13,844 | 13,367 |
- | Array with 256 UTF-8 strings | | | | |
- | encode | 3,457 | 26,437 | 3,630 | 3,653 |
- | decode | 3,576 | 4,236 | 522 | 1,978 |
- | Array with 256 strings | | | | |
- | encode | 44,769 | 125,920 | 21,401 | 23,565 |
- | decode | 28,518 | 75,043 | 41,496 | 42,221 |
- | Medium complex object | | | | |
- | encode | 11,672 | 47,659 | 3,913 | 5,729 |
- | decode | 12,522 | 23,599 | 8,007 | 9,720 |
- | Array with 256 True values | | | | |
- | encode | 110,444 | 425,919 | 81,428 | 84,347 |
- | decode | 203,430 | 318,193 | 146,867 | 156,249 |
- | Array with 256 dict{string, int} pairs | | | | |
- | encode | 14,170 | 72,514 | 3,050 | 7,079 |
- | decode | 19,116 | 27,542 | 9,374 | 13,713 |
- | Dict with 256 arrays with 256 dict{string, int} pairs | | | | |
- | encode | 55 | 282 | 11 | 26 |
- | decode | 48 | 53 | 27 | 34 |
- | Dict with 256 arrays with 256 dict{string, int} pairs, outputting sorted keys | | | | |
- | encode | 42 | | 8 | 27 |
- | Complex object | | | | |
- | encode | 462 | | 397 | 444 |
- | decode | 480 | 618 | 177 | 310 |
- Above metrics are in call/sec, larger is better.
- ## Build options
- For those with particular needs, such as Linux distribution packagers, several
- build options are provided in the form of environment variables.
- ### Debugging symbols
- #### UJSON_BUILD_NO_STRIP
- By default, debugging symbols are stripped on Linux platforms. Setting this
- environment variable with a value of `1` or `True` disables this behavior.
- ### Using an external or system copy of the double-conversion library
- These two environment variables are typically used together, something like:
- ```sh
- export UJSON_BUILD_DC_INCLUDES='/usr/include/double-conversion'
- export UJSON_BUILD_DC_LIBS='-ldouble-conversion'
- ```
- Users planning to link against an external shared library should be aware of
- the ABI-compatibility requirements this introduces when upgrading system
- libraries or copying compiled wheels to other machines.
- #### UJSON_BUILD_DC_INCLUDES
- One or more directories, delimited by `os.pathsep` (same as the `PATH`
- environment variable), in which to look for `double-conversion` header files;
- the default is to use the bundled copy.
- #### UJSON_BUILD_DC_LIBS
- Compiler flags needed to link the `double-conversion` library; the default
- is to use the bundled copy.
|
