Skip to content

Commit b714ee6

Browse files
committed
docs: add benchmark comparison and cross-links to Go/Zig versions
1 parent a390ee9 commit b714ee6

File tree

1 file changed

+48
-0
lines changed

1 file changed

+48
-0
lines changed

README.rst

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -357,6 +357,54 @@ A Go port of this library is available at `json2xml-go <https://github.com/vinit
357357
The Go version provides the same features and a native compiled binary for maximum performance.
358358

359359

360+
Performance Benchmarks
361+
^^^^^^^^^^^^^^^^^^^^^^
362+
363+
Comprehensive benchmarks comparing Python, Go, and Zig implementations:
364+
365+
.. list-table::
366+
:header-rows: 1
367+
:widths: 25 20 15 15
368+
369+
* - Test Case
370+
- Python (CPython)
371+
- Go
372+
- Zig
373+
* - **Small JSON** (47 bytes)
374+
- 68.88ms
375+
- 7.13ms
376+
- 2.65ms
377+
* - **Medium JSON** (2.6 KB)
378+
- 73.40ms
379+
- 4.85ms
380+
- 2.13ms
381+
* - **Large JSON** (323 KB)
382+
- 420.06ms
383+
- 68.88ms
384+
- 5.90ms
385+
* - **Very Large JSON** (1.6 MB)
386+
- 2.08s
387+
- 288.75ms
388+
- 20.62ms
389+
390+
**Recommendation by Use Case:**
391+
392+
- **Python integration / scripting**: Use this library (json2xml)
393+
- **CLI tool / moderate performance**: Use `json2xml-go <https://github.com/vinitkumar/json2xml-go>`_
394+
- **Maximum performance / large files**: Use `json2xml-zig <https://github.com/vinitkumar/json2xml-zig>`_
395+
396+
For detailed benchmarks, see `BENCHMARKS.md <https://github.com/vinitkumar/json2xml/blob/master/BENCHMARKS.md>`_.
397+
398+
399+
Other Implementations
400+
^^^^^^^^^^^^^^^^^^^^^
401+
402+
This library is also available in other languages:
403+
404+
- **Go**: `json2xml-go <https://github.com/vinitkumar/json2xml-go>`_ - 7x faster, native compiled binary
405+
- **Zig**: `json2xml-zig <https://github.com/vinitkumar/json2xml-zig>`_ - 85x faster, maximum performance
406+
407+
360408
Help and Support to maintain this project
361409
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
362410

0 commit comments

Comments
 (0)