python-rapidjson 1.16__tar.gz → 1.18__tar.gz

{python-rapidjson-1.16 → python-rapidjson-1.18}/CHANGES.rst

@@ -1,6 +1,26 @@
 Changes
 -------
 
+1.18 (2024-06-29)
+~~~~~~~~~~~~~~~~~
+
+* Expose PEP-484 typing stubs, thanks to Rodion Kosianenko and GoodWasHere (`PR #204`__)
+
+  __ https://github.com/python-rapidjson/python-rapidjson/pull/204
+
+
+1.17 (2024-05-18)
+~~~~~~~~~~~~~~~~~
+
+* Use `current master`__ version of rapidjson
+
+  __ https://github.com/Tencent/rapidjson/compare/5e17dbed34eef33af8f3e734820b5dc547a2a3aa...ab1842a2dae061284c0a62dca1cc6d5e7e37e346
+
+* Generate wheels on PyPI using Python 3.13b1 release, thanks to cibuildwheel `2.18.0`__
+
+  __ https://cibuildwheel.pypa.io/en/stable/changelog/#v2180
+
+
 1.16 (2024-02-28)
 ~~~~~~~~~~~~~~~~~
 
@@ -47,7 +67,7 @@ Changes
 
 * Use `current master`__ version of rapidjson
 
-  __ https://github.com/Tencent/rapidjson/compare/083f359f5c36198accc2b9360ce1e32a333231d9...5e17dbed34eef33af8f3e734820b5dc547a2a3aa9
+  __ https://github.com/Tencent/rapidjson/compare/083f359f5c36198accc2b9360ce1e32a333231d9...5e17dbed34eef33af8f3e734820b5dc547a2a3aa
 
 * Use cibuildwheel `2.15.0`__
 

{python-rapidjson-1.16 → python-rapidjson-1.18}/LICENSE

@@ -3,6 +3,7 @@ python-rapidjson is licensed under the MIT license.
 The MIT License (MIT)
 
 Copyright (c) 2015, 2016, 2017 Ken Robbins
+Copyright (c) 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023, 2024 Lele Gaifax
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{python-rapidjson-1.16 → python-rapidjson-1.18}/MANIFEST.in

@@ -2,6 +2,7 @@ include .dir-locals.el
 include LICENSE MANIFEST.in *.cfg *.ini *.py *.rst *.txt
 include python-rapidjson/*.cpp python-rapidjson/*.h
 include benchmarks/*.py tests/*.py
+include typings/*.pyi
 
 exclude .github .gitmodules
 

{python-rapidjson-1.16 → python-rapidjson-1.18}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: python-rapidjson
-Version: 1.16
+Version: 1.18
 Summary: Python wrapper around rapidjson
 Home-page: https://github.com/python-rapidjson/python-rapidjson
 Author: Ken Robbins
@@ -155,6 +155,26 @@ __ https://python-rapidjson.readthedocs.io/en/latest/quickstart.html#incompatibi
 Changes
 -------
 
+1.18 (2024-06-29)
+~~~~~~~~~~~~~~~~~
+
+* Expose PEP-484 typing stubs, thanks to Rodion Kosianenko and GoodWasHere (`PR #204`__)
+
+  __ https://github.com/python-rapidjson/python-rapidjson/pull/204
+
+
+1.17 (2024-05-18)
+~~~~~~~~~~~~~~~~~
+
+* Use `current master`__ version of rapidjson
+
+  __ https://github.com/Tencent/rapidjson/compare/5e17dbed34eef33af8f3e734820b5dc547a2a3aa...ab1842a2dae061284c0a62dca1cc6d5e7e37e346
+
+* Generate wheels on PyPI using Python 3.13b1 release, thanks to cibuildwheel `2.18.0`__
+
+  __ https://cibuildwheel.pypa.io/en/stable/changelog/#v2180
+
+
 1.16 (2024-02-28)
 ~~~~~~~~~~~~~~~~~
 
@@ -201,7 +221,7 @@ Changes
 
 * Use `current master`__ version of rapidjson
 
-  __ https://github.com/Tencent/rapidjson/compare/083f359f5c36198accc2b9360ce1e32a333231d9...5e17dbed34eef33af8f3e734820b5dc547a2a3aa9
+  __ https://github.com/Tencent/rapidjson/compare/083f359f5c36198accc2b9360ce1e32a333231d9...5e17dbed34eef33af8f3e734820b5dc547a2a3aa
 
 * Use cibuildwheel `2.15.0`__
 

{python-rapidjson-1.16 → python-rapidjson-1.18}/benchmarks/conftest.py

@@ -2,7 +2,7 @@
 # :Project:   python-rapidjson -- Benchmarks specific pytest configuration
 # :Author:    Lele Gaifax <lele@metapensiero.it>
 # :License:   MIT License
-# :Copyright: © 2016, 2017, 2018, 2020 Lele Gaifax
+# :Copyright: © 2016, 2017, 2018, 2020, 2024 Lele Gaifax
 #
 
 from collections import namedtuple
@@ -56,6 +56,32 @@ contenders.append(Contender('rapidjson_nn_c',
                             rj.Encoder(number_mode=rj.NM_NATIVE),
                             rj.Decoder(number_mode=rj.NM_NATIVE)))
 
+
+
+class DecoderPython(rj.Decoder):
+    def end_array(self, a):
+        return a
+
+    def start_object(self):
+        return {}
+
+    def end_object(self, d):
+        return d
+
+    def string(self, s):
+        return s
+
+
+class EncoderPython(rj.Encoder):
+    def default(self, obj):
+        return repr(obj)
+
+
+contenders.append(Contender('rapidjson_p',
+                            EncoderPython(),
+                            DecoderPython()))
+
+
 numbers_contenders = [
     Contender('Wide numbers', rj.dumps, rj.loads),
     Contender('Native numbers',
@@ -147,7 +173,9 @@ def pytest_generate_tests(metafunc):
         if metafunc.config.option.compare_other_engines:
             metafunc.parametrize('contender', contenders, ids=attrgetter('name'))
         else:
-            metafunc.parametrize('contender', contenders[:1], ids=attrgetter('name'))
+            metafunc.parametrize('contender', [c for c in contenders
+                                               if c.name.startswith('rapidjson')],
+                                 ids=attrgetter('name'))
 
     if 'datetimes_loads_contender' in metafunc.fixturenames:
         metafunc.parametrize('datetimes_loads_contender',

{python-rapidjson-1.16 → python-rapidjson-1.18}/benchmarks/tablize.py

@@ -2,7 +2,7 @@
 # :Project:   python-rapidjson -- reST tables writer tool
 # :Author:    Lele Gaifax <lele@metapensiero.it>
 # :License:   MIT License
-# :Copyright: © 2017, 2018, 2020, 2021, 2022 Lele Gaifax
+# :Copyright: © 2017, 2018, 2020, 2021, 2022, 2024 Lele Gaifax
 #
 
 # Assume we did::
@@ -70,7 +70,7 @@ class Comparison:
         cells = ['=' * (width+2) for width in widths]
         headseprow = '+' + '+'.join(cells) + '+'
 
-        cells = [' {:^%d} ' % width for width in widths]
+        cells = [f' {{:^{width}}} ' for width in widths]
         rowfmt = '|' + '|'.join(cells) + '|'
 
         print(seprow)
@@ -95,6 +95,7 @@ def dumps_and_loads(benchmarks):
                   'rapidjson_c',
                   'rapidjson_nn_f',
                   'rapidjson_nn_c',
+                  'rapidjson_p',
                   'simdjson',
                   'orjson',
                   'ujson',
@@ -104,15 +105,17 @@ def dumps_and_loads(benchmarks):
                  r'``Encoder()``\ [2]_',
                  r'``dumps(n)``\ [3]_',
                  r'``Encoder(n)``\ [4]_',
-                 r'simdjson\ [5]_',
-                 r'orjson\ [6]_',
-                 r'ujson\ [7]_',
-                 r'simplejson\ [8]_',
-                 r'stdlib\ [9]_')
-    d_headers = (r'``loads()``\ [10]_',
-                 r'``Decoder()``\ [11]_',
-                 r'``loads(n)``\ [12]_',
-                 r'``Decoder(n)``\ [13]_',
+                 r'``PyEncoder()``\ [5]_',
+                 r'simdjson\ [6]_',
+                 r'orjson\ [7]_',
+                 r'ujson\ [8]_',
+                 r'simplejson\ [9]_',
+                 r'stdlib\ [10]_')
+    d_headers = (r'``loads()``\ [11]_',
+                 r'``Decoder()``\ [12]_',
+                 r'``loads(n)``\ [13]_',
+                 r'``Decoder(n)``\ [14]_',
+                 r'``PyDecoder()``\ [15]_',
                  r'simdjson',
                  r'orjson',
                  r'ujson',
@@ -121,20 +124,29 @@ def dumps_and_loads(benchmarks):
 
     assert len(contenders) == len(s_headers) == len(d_headers)
 
+    from csimdjson import VERSION as simdjv
+    from orjson import __version__ as orjv
+    from simplejson import __version__ as sjv
+    from ujson import __version__ as ujv
+
+    pyv = '%d.%d.%d' % sys.version_info[:3]
+
     footnotes = [
         '.. [1] ``rapidjson.dumps()``',
         '.. [2] ``rapidjson.Encoder()``',
         '.. [3] ``rapidjson.dumps(number_mode=NM_NATIVE)``',
         '.. [4] ``rapidjson.Encoder(number_mode=NM_NATIVE)``',
-        '.. [5] `simdjson 5.0.1 <https://pypi.org/project/pysimdjson/5.0.1/>`__',
-        '.. [6] `orjson 3.7.6 <https://pypi.org/project/orjson/3.7.6/>`__',
-        '.. [7] `ujson 5.4.0 <https://pypi.org/project/ujson/5.4.0/>`__',
-        '.. [8] `simplejson 3.17.6 <https://pypi.org/pypi/simplejson/3.17.6>`__',
-        '.. [9] Python %d.%d.%d standard library ``json``' % sys.version_info[:3],
-        '.. [10] ``rapidjson.loads()``',
-        '.. [11] ``rapidjson.Decoder()``',
-        '.. [12] ``rapidjson.loads(number_mode=NM_NATIVE)``',
-        '.. [13] ``rapidjson.Decoder(number_mode=NM_NATIVE)``']
+        '.. [5] ``rapidjson.Encoder()`` subclassed in Python with *no-op* hook methods',
+        f'.. [6] `simdjson {simdjv} <https://pypi.org/project/pysimdjson/>`__',
+        f'.. [7] `orjson {orjv} <https://pypi.org/project/orjson/{orjv}/>`__',
+        f'.. [8] `ujson {ujv} <https://pypi.org/project/ujson/{ujv}/>`__',
+        f'.. [9] `simplejson {sjv} <https://pypi.org/pypi/simplejson/{sjv}>`__',
+        f'.. [10] Python {pyv} standard library ``json``',
+        '.. [11] ``rapidjson.loads()``',
+        '.. [12] ``rapidjson.Decoder()``',
+        '.. [13] ``rapidjson.loads(number_mode=NM_NATIVE)``',
+        '.. [14] ``rapidjson.Decoder(number_mode=NM_NATIVE)``',
+        '.. [15] ``rapidjson.Decoder() subclassed in Python with *no-op* hook methods``']
 
     comparison = Comparison(contenders, benchmarks)
 
@@ -157,17 +169,17 @@ def ascii_vs_utf8(benchmarks):
                ('ujson', 'uj'),
                ('simplejson', 'sj'),
                ('stdlib json', 'json'))
-    contenders = ['%s %s' % (e[0], k) for e in engines for k in ('ascii', 'utf8')]
-    i = 14
+    contenders = [f'{e[0]} {k}' for e in engines for k in ('ascii', 'utf8')]
+    i = 15
     s_headers = []
     footnotes = []
     for e in engines:
         i += 1
-        s_headers.append(r'``%s ascii``\ [%d]_' % (e[1], i))
-        footnotes.append('.. [%d] ``%s.dumps(ensure_ascii=True)``' % (i, e[0]))
+        s_headers.append(rf'``{e[1]} ascii``\ [{i}]_')
+        footnotes.append(f'.. [{i}] ``{e[0]}.dumps(ensure_ascii=True)``')
         i += 1
-        s_headers.append(r'``%s utf8``\ [%d]_' % (e[1], i))
-        footnotes.append('.. [%d] ``%s.dumps(ensure_ascii=False)``' % (i, e[0]))
+        s_headers.append(rf'``{e[1]} utf8``\ [{i}]_')
+        footnotes.append(f'.. [{i}] ``{e[0]}.dumps(ensure_ascii=False)``')
 
     comparison = Comparison(contenders, benchmarks)
 

python-rapidjson-1.18/docs/benchmarks-tables.rst

@@ -0,0 +1,123 @@
+
+Serialization
+~~~~~~~~~~~~~
+
++-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+
+|       serialize       |   ``dumps()``\ [1]_   |  ``Encoder()``\ [2]_  |  ``dumps(n)``\ [3]_   | ``Encoder(n)``\ [4]_  | ``PyEncoder()``\ [5]_ |    simdjson\ [6]_     |     orjson\ [7]_      |      ujson\ [8]_      |   simplejson\ [9]_    |     stdlib\ [10]_     |
++=======================+=======================+=======================+=======================+=======================+=======================+=======================+=======================+=======================+=======================+=======================+
+|    100 arrays dict    |         1.00          |         1.00          |         0.73          |         0.73          |         0.99          |         2.21          |       **0.17**        |         0.85          |         5.93          |         2.31          |
++-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+
+|    100 dicts array    |         1.00          |         0.99          |         0.77          |         0.74          |         1.01          |         2.27          |       **0.22**        |         0.84          |         6.82          |         2.27          |
++-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+
+|    256 Trues array    |         1.00          |         1.01          |         1.18          |         1.00          |         1.07          |         2.62          |       **0.36**        |         1.56          |         2.95          |         2.60          |
++-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+
+|    256 ascii array    |         1.00          |         1.00          |         1.01          |         1.00          |         1.00          |         0.90          |       **0.09**        |         0.47          |         1.05          |         0.90          |
++-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+
+|   256 doubles array   |         1.00          |         1.00          |         1.00          |         1.00          |         1.00          |         0.91          |       **0.04**        |         0.22          |         0.95          |         0.92          |
++-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+
+|   256 unicode array   |         1.00          |         0.80          |         0.79          |         0.82          |         0.80          |         0.68          |       **0.02**        |         0.52          |         0.66          |         0.68          |
++-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+
+|      apache.json      |         1.00          |         1.00          |         1.00          |         1.00          |         1.01          |         1.70          |       **0.19**        |         1.02          |         3.29          |         1.68          |
++-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+
+|      canada.json      |         1.00          |         1.00          |         0.98          |         0.99          |         1.00          |         1.04          |       **0.06**        |         0.27          |         1.81          |         1.05          |
++-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+
+|    complex object     |         1.00          |         1.00          |         0.89          |         0.88          |         1.00          |         1.55          |       **0.17**        |         0.66          |         2.68          |         1.54          |
++-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+
+|   composite object    |         1.00          |         0.99          |         0.68          |         0.64          |         0.98          |         1.70          |       **0.21**        |         0.83          |         2.48          |         1.72          |
++-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+
+|       ctm.json        |         1.00          |         1.00          |         0.75          |         0.75          |         1.00          |         2.27          |       **0.21**        |         1.11          |         6.56          |         2.27          |
++-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+
+|      github.json      |         1.00          |         1.00          |         0.97          |         0.96          |         1.00          |         1.38          |       **0.16**        |         0.86          |         2.10          |         1.39          |
++-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+
+|   instruments.json    |         1.00          |         1.00          |         0.74          |         0.74          |         1.00          |         1.81          |       **0.20**        |         0.90          |         2.86          |         1.81          |
++-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+
+|       mesh.json       |         1.00          |         1.00          |         0.89          |         0.89          |         1.00          |         0.94          |       **0.10**        |         0.28          |         1.19          |         0.94          |
++-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+
+|     truenull.json     |         1.00          |         1.02          |         1.06          |         1.03          |         1.03          |         2.13          |       **0.28**        |         1.76          |         2.12          |         2.21          |
++-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+
+|      tweet.json       |         1.00          |         1.00          |         0.99          |         0.93          |         1.00          |         1.70          |       **0.20**        |         0.91          |         2.70          |         1.69          |
++-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+
+|     twitter.json      |         1.00          |         1.00          |         0.95          |         0.95          |         1.00          |         1.46          |       **0.18**        |         0.94          |         2.02          |         1.46          |
++-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+
+|        overall        |         1.00          |         1.00          |         0.80          |         0.80          |         1.00          |         1.85          |       **0.14**        |         0.68          |         4.63          |         1.92          |
++-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+
+
+Deserialization
+~~~~~~~~~~~~~~~
+
++-----------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+
+|      deserialize      |   ``loads()``\ [11]_   |  ``Decoder()``\ [12]_  |  ``loads(n)``\ [13]_   | ``Decoder(n)``\ [14]_  | ``PyDecoder()``\ [15]_ |        simdjson        |         orjson         |         ujson          |       simplejson       |         stdlib         |
++=======================+========================+========================+========================+========================+========================+========================+========================+========================+========================+========================+
+|    100 arrays dict    |          1.00          |          1.01          |          0.98          |          0.93          |          1.59          |          0.86          |        **0.56**        |          0.85          |          1.20          |          0.94          |
++-----------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+
+|    100 dicts array    |          1.00          |          1.00          |          0.87          |          0.86          |          1.58          |          0.62          |        **0.36**        |          0.69          |          1.35          |          1.00          |
++-----------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+
+|    256 Trues array    |          1.00          |          1.02          |          1.08          |          0.98          |          1.14          |          0.93          |        **0.42**        |          0.96          |          1.53          |          1.37          |
++-----------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+
+|    256 ascii array    |          1.00          |          1.00          |          0.99          |          0.99          |          1.50          |          0.50          |        **0.33**        |          0.85          |          0.86          |          0.77          |
++-----------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+
+|   256 doubles array   |          1.00          |          1.00          |          0.26          |          0.26          |          1.01          |          0.21          |        **0.16**        |          0.61          |          1.08          |          1.03          |
++-----------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+
+|   256 unicode array   |          1.00          |          1.00          |          1.00          |          1.00          |          1.07          |          1.12          |        **0.41**        |          0.82          |          4.06          |          1.45          |
++-----------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+
+|      apache.json      |          1.00          |          1.00          |          1.01          |          1.01          |          1.57          |          0.68          |        **0.44**        |          0.79          |          0.84          |          0.82          |
++-----------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+
+|      canada.json      |          1.00          |          1.00          |          0.33          |          0.33          |          1.12          |          0.29          |        **0.25**        |          0.54          |          0.97          |          0.96          |
++-----------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+
+|    complex object     |          1.00          |          1.00          |          0.84          |          0.83          |          1.31          |          0.68          |        **0.35**        |          0.78          |          1.15          |          0.96          |
++-----------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+
+|   composite object    |          1.00          |          1.00          |          0.84          |          0.83          |          1.34          |          0.61          |        **0.39**        |          0.59          |          1.45          |          1.07          |
++-----------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+
+|       ctm.json        |          1.00          |          0.99          |          0.93          |          0.93          |          1.48          |          0.80          |        **0.53**        |          1.13          |          1.20          |          0.97          |
++-----------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+
+|      github.json      |          1.00          |          1.00          |          0.99          |          0.98          |          1.37          |          0.66          |        **0.39**        |          0.77          |          0.91          |          0.82          |
++-----------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+
+|   instruments.json    |          1.00          |          1.00          |          0.87          |          0.87          |          1.23          |          0.66          |        **0.36**        |          0.76          |          1.17          |          0.94          |
++-----------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+
+|       mesh.json       |          1.00          |          1.00          |          0.52          |          0.51          |          1.04          |          0.43          |        **0.33**        |          0.66          |          1.48          |          1.04          |
++-----------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+
+|     truenull.json     |          1.00          |          1.01          |          1.01          |          0.99          |          1.01          |          0.58          |        **0.34**        |          0.87          |          0.99          |          0.95          |
++-----------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+
+|      tweet.json       |          1.00          |          1.01          |          0.99          |          0.97          |          1.30          |          0.69          |        **0.39**        |          0.84          |          1.17          |          0.99          |
++-----------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+
+|     twitter.json      |          1.00          |          1.00          |          0.97          |          0.97          |          1.25          |          0.68          |        **0.39**        |          0.85          |          0.99          |          0.89          |
++-----------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+
+|        overall        |          1.00          |          1.01          |          0.91          |          0.87          |          1.54          |          0.80          |        **0.53**        |          0.82          |          1.19          |          0.94          |
++-----------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+------------------------+
+
+ASCII vs UTF-8 Serialization
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
++-------------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+
+|        serialize        |  ``rj ascii``\ [16]_  |  ``rj utf8``\ [17]_   |  ``uj ascii``\ [18]_  |  ``uj utf8``\ [19]_   |  ``sj ascii``\ [20]_  |  ``sj utf8``\ [21]_   | ``json ascii``\ [22]_ | ``json utf8``\ [23]_  |
++=========================+=======================+=======================+=======================+=======================+=======================+=======================+=======================+=======================+
+|    Long ASCII string    |         1.00          |         0.43          |       **0.24**        |         0.29          |         0.60          |         1.24          |         0.57          |         1.00          |
++-------------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+
+|   Long Unicode string   |         1.00          |         0.57          |         0.64          |       **0.47**        |         0.72          |         0.62          |         0.76          |         0.48          |
++-------------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+
+|         overall         |         1.00          |         0.53          |         0.51          |       **0.41**        |         0.68          |         0.82          |         0.70          |         0.65          |
++-------------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+-----------------------+
+
+.. [1] ``rapidjson.dumps()``
+.. [2] ``rapidjson.Encoder()``
+.. [3] ``rapidjson.dumps(number_mode=NM_NATIVE)``
+.. [4] ``rapidjson.Encoder(number_mode=NM_NATIVE)``
+.. [5] ``rapidjson.Encoder()`` subclassed in Python with *no-op* hook methods
+.. [6] `simdjson 3.6.4 <https://pypi.org/project/pysimdjson/>`__
+.. [7] `orjson 3.10.5 <https://pypi.org/project/orjson/3.10.5/>`__
+.. [8] `ujson 5.10.0 <https://pypi.org/project/ujson/5.10.0/>`__
+.. [9] `simplejson 3.19.2 <https://pypi.org/pypi/simplejson/3.19.2>`__
+.. [10] Python 3.11.9 standard library ``json``
+.. [11] ``rapidjson.loads()``
+.. [12] ``rapidjson.Decoder()``
+.. [13] ``rapidjson.loads(number_mode=NM_NATIVE)``
+.. [14] ``rapidjson.Decoder(number_mode=NM_NATIVE)``
+.. [15] ``rapidjson.Decoder() subclassed in Python with *no-op* hook methods``
+.. [16] ``rapidjson.dumps(ensure_ascii=True)``
+.. [17] ``rapidjson.dumps(ensure_ascii=False)``
+.. [18] ``ujson.dumps(ensure_ascii=True)``
+.. [19] ``ujson.dumps(ensure_ascii=False)``
+.. [20] ``simplejson.dumps(ensure_ascii=True)``
+.. [21] ``simplejson.dumps(ensure_ascii=False)``
+.. [22] ``stdlib json.dumps(ensure_ascii=True)``
+.. [23] ``stdlib json.dumps(ensure_ascii=False)``