ssrjson-benchmark 0.0.9__cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

ssrjson_benchmark/result_types.py

@@ -0,0 +1,96 @@
+import json
+from typing import TYPE_CHECKING, Any
+
+
+class BenchmarkResultBase(dict):
+    ATTRS = ()
+    DEFAULT_SECTION_CLS = dict
+
+    def __setattr__(self, name: str, value: Any) -> None:
+        self[name] = value
+
+    def __getitem__(self, key: Any) -> Any:
+        try:
+            return super().__getitem__(key)
+        except KeyError:
+            cls = getattr(self.__class__, "DEFAULT_SECTION_CLS", None)
+            if cls is None:
+                raise
+            obj = cls()
+            super().__setitem__(key, obj)
+            return obj
+
+    def __getattr__(self, attrname):
+        try:
+            return self.__getitem__(attrname)
+        except KeyError:
+            raise AttributeError(attrname)
+
+    @classmethod
+    def parse(cls, j):
+        self = cls()
+        for k, v in j.items():
+            if k in cls.ATTRS:
+                setattr(self, k, v)
+            else:
+                setattr(self, k, cls.DEFAULT_SECTION_CLS.parse(v))
+        return self
+
+
+class BenchmarkResultPerFileTargetLib(BenchmarkResultBase):
+    speed: int
+    ratio: float
+    ATTRS = ("speed", "ratio")
+
+
+class BenchmarkResultPerFileTarget(BenchmarkResultBase):
+    DEFAULT_SECTION_CLS = BenchmarkResultPerFileTargetLib
+    ATTRS = ("ssrjson_bytes_per_sec",)
+    ssrjson_bytes_per_sec: float
+
+    if TYPE_CHECKING:
+
+        def __getitem__(self, key: str) -> BenchmarkResultPerFileTargetLib: ...
+
+
+class BenchmarkResultPerFile(BenchmarkResultBase):
+    DEFAULT_SECTION_CLS = BenchmarkResultPerFileTarget
+    ATTRS = (
+        "byte_size",
+        "pyunicode_size",
+        "pyunicode_kind",
+        "pyunicode_is_ascii",
+    )
+    byte_size: int
+    pyunicode_size: int
+    pyunicode_kind: int
+    pyunicode_is_ascii: bool
+
+    if TYPE_CHECKING:
+
+        def __getitem__(self, key: str) -> BenchmarkResultPerFileTarget: ...
+
+
+class BenchmarkFinalResult(BenchmarkResultBase):
+    categories: list[str]
+    results: dict[str, dict[str, BenchmarkResultPerFile]]
+    filenames: set[str]
+    processbytesgb: float
+    perbinbytesmb: int
+
+    @classmethod
+    def parse(cls, j: dict):
+        ret = cls()
+        ret.categories = j["categories"]
+        ret.results = dict()
+        ret.filenames = j["filenames"]
+        ret.processbytesgb = j["processbytesgb"]
+        ret.perbinbytesmb = j["perbinbytesmb"]
+        for k, v in j["results"].items():
+            ret.results[k] = dict()
+            for a, b in v.items():
+                ret.results[k][a] = BenchmarkResultPerFile.parse(b)
+        return ret
+
+    def dumps(self):
+        return json.dumps(self, ensure_ascii=False, indent=4)

ssrjson_benchmark/template.md

@@ -0,0 +1,14 @@
+# ssrJSON benchmark Report
+
+REV:            `{REV}`
+Python:         `{PYTHON}`
+Orjson:         `{ORJSON_VER}`
+MsgSpec:        `{MSGSPEC_VER}`
+Ujson:          `{UJSON_VER}`
+Generated time: {TIME}
+OS:             {OS}
+SIMD flag:      {SIMD_FLAGS}
+Chipset:        {CHIPSET}
+Memory:         {MEM}
+Process(GB):    {PROCESS_MEM}
+PerBin(MB):     {PER_BIN_MEM}

ssrjson_benchmark-0.0.9.dist-info/METADATA

@@ -0,0 +1,88 @@
+Metadata-Version: 2.4
+Name: ssrjson-benchmark
+Version: 0.0.9
+Summary: benchmark of ssrJSON
+Author-email: Eritque Arcus <eritque-arcus@ikuyo.dev>, Antares <antares0982@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Nambers/ssrJSON-benchmark
+Project-URL: Issues, https://github.com/Nambers/ssrJSON-benchmark/issues
+Project-URL: Repository, https://github.com/Nambers/ssrJSON-benchmark.git
+Keywords: ssrjson,benchmark,json
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: System :: Benchmark
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: ssrjson>=0.0.9
+Requires-Dist: orjson
+Requires-Dist: msgspec
+Requires-Dist: ujson
+Requires-Dist: matplotlib
+Requires-Dist: psutil; platform_machine == "x86_64"
+Requires-Dist: svglib
+Requires-Dist: reportlab
+Requires-Dist: py-cpuinfo
+Dynamic: license-file
+
+# ssrJSON-benchmark
+
+<div align="center">
+
+[![PyPI - Version](https://img.shields.io/pypi/v/ssrjson-benchmark)](https://pypi.org/project/ssrjson-benchmark/) [![PyPI - Wheel](https://img.shields.io/pypi/wheel/ssrjson-benchmark)](https://pypi.org/project/ssrjson-benchmark/)
+
+The [ssrJSON](https://github.com/Antares0982/ssrjson) benchmark repository.
+
+</div>
+
+## Benchmark Results
+
+The benchmark results can be found in [website results](https://ikuyo.dev/ssrJSON-benchmark/) or [GitHub results](https://github.com/Nambers/ssrJSON-benchmark/tree/main/results). Contributing your benchmark result is welcomed.
+
+Quick jump for
+
+* [x86-64-v4, AVX512](https://github.com/Nambers/ssrJSON-benchmark/tree/main/results/AVX512)
+* [x86-64-v3, AVX2](https://github.com/Nambers/ssrJSON-benchmark/tree/main/results/AVX2)
+* [x86-64-v2, SSE4.2](https://github.com/Nambers/ssrJSON-benchmark/tree/main/results/SSE4.2)
+* [aarch64, NEON](https://github.com/Nambers/ssrJSON-benchmark/tree/main/results/NEON)
+
+## Usage
+
+```bash
+# you may need to install `svglib`, `reportlab` and `py-cpuinfo` as well
+pip install ssrjson-benchmark
+python -m ssrjson_benchmark
+```
+
+## Benchmark options
+
+```
+usage: python -m ssrjson_benchmark [-h] [-f FILE] [-d IN_DIR] [-m] [--no-pdf] [--process-gigabytes PROCESS_GIGABYTES]
+                   [--bin-process-megabytes BIN_PROCESS_MEGABYTES] [--out-dir OUT_DIR]
+
+options:
+  -h, --help            show this help message and exit
+  -f, --file FILE       Use a result JSON file generated in previous benchmark to print report. Will skip all tests.
+  -d, --in-dir IN_DIR   Benchmark JSON files directory. If not provided, use the files bundled in this package.
+  -m, --markdown        Generate Markdown report
+  --no-pdf              Don't generate PDF report
+  --process-gigabytes PROCESS_GIGABYTES
+                        Total gigabytes to process per test case, default 0.1 (float)
+  --bin-process-megabytes BIN_PROCESS_MEGABYTES
+                        Maximum bytes to process per bin, default 32 (int)
+  --out-dir OUT_DIR     Output directory for reports
+```
+
+## Notes
+
+* This repository conducts benchmarking using json, [ujson](https://github.com/ultrajson/ultrajson), [msgspec](https://github.com/jcrist/msgspec), [orjson](https://github.com/ijl/orjson), and [ssrJSON](https://github.com/Antares0982/ssrjson). The benchmark for `dumps_to_str` aims to produce a `str` object. If a JSON library's dumps-related interface only outputs a `bytes` object, it will be substituted with dumps followed by a single `decode("utf-8")` operation. Similarly, for the `dumps_to_bytes` test, if the JSON library's dumps-related interface only outputs a `str` object, it will be replaced with dumps followed by a single `encode("utf-8")` operation.
+* To ensure the accuracy of benchmark results, this repository differentiates between scenarios with and without UTF-8 caches when testing `dumps_to_bytes`. For `dumps_to_str` and `loads`, since these methods are unrelated to encoding `str` objects to UTF-8, the data sources do not involve any UTF-8 cache, and no distinction is made in their tests.
+  * Cache writing of ssrJSON is disabled globally when running benchmark.
+  * We use `orjson.dumps` to create UTF-8 cache for all benchmark targets.
+  * Test with UTF-8 cache is skipped when the whole JSON object is ASCII.
+* The performance of JSON encoding is primarily constrained by the speed of writing to the buffer, whereas decoding performance is mainly limited by the frequent invocation of CPython interfaces for object creation. During decoding, both ssrJSON and orjson employ short key caching to reduce the number of object creations, and this caching mechanism is global in both libraries. As a result, decoding benchmark tests may not accurately reflect the conditions encountered in real-world production environments.
+* The files simple_object.json and simple_object_zh.json do not represent real-world data; they are used to compare the performance of the fast path. Therefore, the benchmark results from these test cases should not be interpreted as indicative of actual performance in production environment.
+

ssrjson_benchmark-0.0.9.dist-info/RECORD

@@ -0,0 +1,22 @@
+ssrjson_benchmark/__init__.py,sha256=CxJ2-wwiINL7dz6K13CC6BwMi6nTAckZ1Ri_X0FOq8E,422
+ssrjson_benchmark/__main__.py,sha256=mNVuixTjENSsk6LqFxPs_MIM_W3k0QgYDg4xm5wn3tA,3227
+ssrjson_benchmark/_ssrjson_benchmark.so,sha256=-pEDyeASzmeKjhkS_4NtrpxNUc8QgVCJEZ1vL8wXObs,22825
+ssrjson_benchmark/benchmark_impl.py,sha256=zl0KSXQwBL07xES4JYLjke8DMbUzweEBCpM1-0dZEDs,37911
+ssrjson_benchmark/result_types.py,sha256=mzuXhJSE8lXq2f980vbsUX6jI6-zFGftnj1Js4sPsro,2594
+ssrjson_benchmark/template.md,sha256=Y6ufs0ROQjgeqYSecbnKPd5cUuXzfor2yCUKI5GY9sk,353
+ssrjson_benchmark/_files/apache.json,sha256=PWRTA_Ndfp2EY4IiCNvyrNtIXjsYlX9WMNnq5-yjQGM,126371
+ssrjson_benchmark/_files/canada.json,sha256=HTO1LmhieUT3Sz4gqwG8-jkaV-qc-nlurQ0BxDVgTnw,3489802
+ssrjson_benchmark/_files/ctm.json,sha256=AYxJ_k_SsSSoljPfosNHIVuF4myQlFbBTGg9H3JAk2A,1691678
+ssrjson_benchmark/_files/github.json,sha256=ZTI6ZBUhKHTXhutl6_TnnTGuMIsfkHofV5It4oBDL_s,67831
+ssrjson_benchmark/_files/instruments.json,sha256=IUZpcByg5XZuwPtATZlcStk1n1sx0tLYFE0nQjJnUjg,193873
+ssrjson_benchmark/_files/mesh.json,sha256=SRBCOA_kaG1FbpJWb7n5R-7H0p74FfH5MD4ig73fzx0,752407
+ssrjson_benchmark/_files/simple_object.json,sha256=Zaalit6WeTnSkn52yhHZXPbnHMZalaXi7PIlCpt7qeg,36902
+ssrjson_benchmark/_files/simple_object_zh.json,sha256=UOmpDly_tpkCVL-tyxn_1sabMJn1ttcs3Zu2T0dvIE8,110486
+ssrjson_benchmark/_files/truenull.json,sha256=enl_cy6qWa8b7bdVpx3-e0k6X9BFe_aCPot1rEquGiU,12000
+ssrjson_benchmark/_files/tweet.json,sha256=vRuGAaWuYiQDHGiaujUYY3nuK9UFNWEeloZe95VWNAI,4994
+ssrjson_benchmark/_files/twitter.json,sha256=s4v0svEREPZ-TOogwUf3PvhE9DG4K_7fivfSaYdwYHs,755433
+ssrjson_benchmark-0.0.9.dist-info/METADATA,sha256=P14e8XNJvF0IVrNG35HwqZEB_e_J7uQXYFEsxS3Rrt8,5206
+ssrjson_benchmark-0.0.9.dist-info/WHEEL,sha256=sLnxkimgGZnkHfiVG0CKXk3cbEzmkkBUHrkKJEO9o6g,151
+ssrjson_benchmark-0.0.9.dist-info/top_level.txt,sha256=l1O9IjI1lR5DczhKv9O-GeItgq5HZySDOI5KjfFfvq8,37
+ssrjson_benchmark-0.0.9.dist-info/RECORD,,
+ssrjson_benchmark-0.0.9.dist-info/licenses/LICENSE,sha256=O43ZquZ3FGDxi9aUS-Kqz5gHy1QX9bvvMDv9JOpjUZg,1070

ssrjson_benchmark-0.0.9.dist-info/WHEEL

@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: false
+Tag: cp313-cp313-manylinux_2_17_x86_64
+Tag: cp313-cp313-manylinux2014_x86_64
+

ssrjson_benchmark-0.0.9.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Eritque arcus
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ssrjson_benchmark-0.0.9.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+_ssrjson_benchmark
+ssrjson_benchmark