json2xml 6.2.0__tar.gz → 6.3.0__tar.gz

{json2xml-6.2.0 → json2xml-6.3.0}/HISTORY.rst

@@ -1,4 +1,14 @@
 
+6.3.0 / 2026-06-10
+==================
+
+  * feat: reduce pure Python serializer allocations in hot dict, list, and scalar paths
+  * feat: preserve XML output semantics while reusing validated element-name and attribute work
+  * perf: lower peak memory pressure for large conversions after the 6.2.0 Rust bytes-writer release
+  * docs: add hyperfine Rust memory benchmark notes with reproduction details and the measured throughput tradeoff
+  * chore: release ``json2xml-rs`` 0.4.0 and require it from ``json2xml[fast]`` for accelerated installs
+
+
 6.2.0 / 2026-06-05
 ==================
 

{json2xml-6.2.0 → json2xml-6.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: json2xml
-Version: 6.2.0
+Version: 6.3.0
 Summary: Simple Python Library to convert JSON to XML
 Author-email: Vinit Kumar <mail@vinitkumar.me>
 License: Apache Software License 2.0
@@ -32,7 +32,7 @@ Requires-Dist: setuptools; extra == "dev"
 Requires-Dist: pygments>=2.20.0; extra == "dev"
 Requires-Dist: xmltodict>=0.12.0; extra == "dev"
 Provides-Extra: fast
-Requires-Dist: json2xml-rs>=0.3.0; extra == "fast"
+Requires-Dist: json2xml-rs>=0.4.0; extra == "fast"
 Dynamic: license-file
 
 .. image:: ./json2xml-hero.png

{json2xml-6.2.0 → json2xml-6.3.0}/docs/rust_memory_benchmark.rst

@@ -6,7 +6,7 @@ This benchmark compares peak memory usage before and after the Rust serializer s
 Summary
 -------
 
-The current branch reduces serializer peak RSS by about **77.44 MiB** on a 100,000-record payload that produces **78.17 MiB** of XML. That is a **49.1% reduction** in serializer memory delta compared with the previous PR commit.
+The current branch still reduces serializer peak RSS by about **77.43 MiB** on a 100,000-record payload that produces **78.17 MiB** of XML. That is a **49.1% reduction** in serializer memory delta compared with the previous PR commit.
 
 .. list-table::
    :header-rows: 1
@@ -23,10 +23,10 @@ The current branch reduces serializer peak RSS by about **77.44 MiB** on a 100,0
      - 157.70 MiB
      - 0.180s
    * - Current
-     - ``07d840f``
-     - 271.65 MiB
-     - 80.26 MiB
-     - 0.265s
+     - ``43543e8`` + worktree
+     - 270.91 MiB
+     - 80.27 MiB
+     - 0.232s
 
 The memory result matches the implementation change: the previous version held roughly one final XML payload in Rust plus one Python ``bytes`` payload, while the current version writes into the Python ``bytes`` object directly.
 
@@ -36,14 +36,14 @@ Methodology
 The benchmark uses ``benchmark_memory_rust.py`` with a deterministic generated payload so the Rust fast path can be measured without file parsing or pure-Python fallback behavior.
 
 * Machine: Apple Silicon arm64
-* OS: macOS 26.5
+* OS: macOS 26.5.1
 * Python: 3.14.0
 * Build: ``python3 -m maturin develop --release --offline``
 * Payload: 100,000 nested records
 * Input JSON size: 44.31 MiB
 * Output XML size: 78.17 MiB
 * Measurement: process ``ru_maxrss`` after payload creation versus peak after ``json2xml_rs.dicttoxml(payload, attr_type=True)``
-* Sampling: three fresh Python processes per version
+* Sampling: five fresh Python processes for the current version using ``hyperfine 1.20.0 --runs 5 --show-output --export-json``
 
 The baseline RSS is captured after the large Python payload is already built. The reported serializer delta is ``peak_rss - baseline_rss``, which focuses the comparison on output construction rather than payload allocation.
 
@@ -89,11 +89,41 @@ Raw Samples
      - 271.55 MiB
      - 80.30 MiB
      - 0.258s
+   * - current-hyperfine-1
+     - 190.77 MiB
+     - 271.12 MiB
+     - 80.36 MiB
+     - 0.233s
+   * - current-hyperfine-2
+     - 190.66 MiB
+     - 271.02 MiB
+     - 80.36 MiB
+     - 0.234s
+   * - current-hyperfine-3
+     - 190.62 MiB
+     - 270.98 MiB
+     - 80.36 MiB
+     - 0.234s
+   * - current-hyperfine-4
+     - 190.78 MiB
+     - 270.84 MiB
+     - 80.06 MiB
+     - 0.231s
+   * - current-hyperfine-5
+     - 190.38 MiB
+     - 270.61 MiB
+     - 80.23 MiB
+     - 0.229s
+
+Hyperfine Result
+----------------
+
+Hyperfine measured full fresh-process runtime for the current benchmark command at **684.3 ms +/- 26.5 ms** across five runs, with a range of **664.1 ms to 728.0 ms**. The exported hyperfine memory sample was **272.59 MiB**, which is consistent with the script's average peak RSS of **270.91 MiB**.
 
 Tradeoff
 --------
 
-The memory improvement comes with a throughput cost in this release benchmark. Average conversion time increased from 0.180s to 0.265s, about **47.5% slower** for this payload.
+The memory improvement comes with a throughput cost in this release benchmark. Average conversion time increased from the previous 0.180s to the current hyperfine-sampled 0.232s, about **29.0% slower** for this payload.
 
 That cost is likely from routing every XML write through ``std::io::Write`` and PyO3's bytes writer. The memory win is substantial for large outputs, but latency-sensitive callers may want more timing data before treating the bytes-writer path as a universal improvement.
 
@@ -105,6 +135,7 @@ Run each version in a fresh process after installing the desired Rust extension
 .. code-block:: bash
 
    python3 -m maturin develop --release --offline
-   python3 benchmark_memory_rust.py --records 100000 --label current-release-1
+   hyperfine --runs 5 --show-output --export-json /private/tmp/json2xml-rust-memory-hyperfine.json \
+     'python3 benchmark_memory_rust.py --records 100000 --label current-hyperfine'
 
 For the previous comparison, install commit ``7dd86b0`` in a temporary worktree, then run the same command from the main checkout so the benchmark script stays identical.

{json2xml-6.2.0 → json2xml-6.3.0}/json2xml/__init__.py

@@ -2,4 +2,4 @@
 
 __author__ = """Vinit Kumar"""
 __email__ = "mail@vinitkumar.me"
-__version__ = "6.2.0"
+__version__ = "6.3.0"