================================================================================
  SAFEXML VS DEFUSEDXML HIGH-PERFORMANCE BENCHMARK SUITE
================================================================================

### 1. SINGLE-THREADED BENCHMARK (Latency & Throughput)

Workload                     | Engine       | Latency (µs)   | Throughput (ops/s) | vs defusedxml 
-----------------------------------------------------------------------------------------------
Small (~1 KB, 10 items)      | defusedxml   |         78.1 µs |          12805.2 op/s | 1.00x (baseline)
                             | SafeXML (Rust) |         45.1 µs |          22181.2 op/s | 1.73x (+73.2%)
                             | stdlib etree |         36.7 µs |          27242.3 op/s | 2.13x         
-----------------------------------------------------------------------------------------------
Medium (~50 KB, 500 items)   | defusedxml   |       3625.2 µs |            275.8 op/s | 1.00x (baseline)
                             | SafeXML (Rust) |       3018.9 µs |            331.2 op/s | 1.20x (+20.1%)
                             | stdlib etree |       1830.8 µs |            546.2 op/s | 1.98x         
-----------------------------------------------------------------------------------------------
Large (~500 KB, 5000 items)  | defusedxml   |      43025.4 µs |             23.2 op/s | 1.00x (baseline)
                             | SafeXML (Rust) |      27021.2 µs |             37.0 op/s | 1.59x (+59.2%)
                             | stdlib etree |      26705.0 µs |             37.4 op/s | 1.61x         
-----------------------------------------------------------------------------------------------

### 2. MULTI-THREADED CONCURRENCY BENCHMARK (GIL-Release Scaling)

Simulating concurrent web requests parsing XML payloads with ThreadPoolExecutor:
Concurrency          | Engine         | Throughput (docs/s)    | Speedup vs defusedxml 
-------------------------------------------------------------------------------------
2 Worker Threads     | defusedxml     |              959.2 docs/s | 1.00x (GIL blocked)   
                     | SafeXML (Rust) |             1459.9 docs/s | 1.52x FASTER          
-------------------------------------------------------------------------------------
4 Worker Threads     | defusedxml     |              980.5 docs/s | 1.00x (GIL blocked)   
                     | SafeXML (Rust) |             1449.2 docs/s | 1.48x FASTER          
-------------------------------------------------------------------------------------
8 Worker Threads     | defusedxml     |              958.3 docs/s | 1.00x (GIL blocked)   
                     | SafeXML (Rust) |             1301.7 docs/s | 1.36x FASTER          
-------------------------------------------------------------------------------------
