PolyXML¶

The "protoc for XML" — Modern XSD-to-Code Generator & High-Performance Streaming Runtime
Python • Rust • C++20 • Java 22+ • TypeScript • Go • C# 12

Welcome to PolyXML¶

PolyXML turns W3C XML Schemas (.xsd) into production-ready, type-safe data models with built-in streaming parsers and serializers. Written in safe Rust, it compiles schemas once and generates idiomatic, strongly-typed code across 7 modern language runtimes with zero intermediate DOM allocations.

While web ecosystems shifted toward JSON and Protocol Buffers, mission-critical infrastructure in defense & aerospace (UCI), finance (ISO 20022, FIXML), and healthcare (HL7) remains deeply reliant on XML. PolyXML breaks down language barriers and eliminates legacy performance penalties by providing one unified, native Rust engine for all tech stacks.

Supported Ecosystems¶

⚡ Why PolyXML? (Old Way vs. PolyXML Way)¶

Legacy XML Toolchains (JAXB, CodeSynthesis, xsdata, xgen)
❌ Language Silos: Fragmented, unmaintained open-source or costly commercial tools.
❌ Memory Bloat: Intermediate DOM allocations cause 10x-20x memory churn & GC spikes.
❌ Antiquated Code: Sprawling pre-C++11 raw pointers and mutable JavaBeans with getters/setters.
❌ Licensing Traps: GPL v2 dual-licensing or per-seat commercial paywalls (CodeSynthesis, gSOAP).
❌ Security Exposure: Vulnerable by default to XXE file exfiltration (e.g. lxml/xsdata CWE-611).

The PolyXML Way
✅ Unified Rust Tool: Generates idiomatic, type-safe code (like protoc) across 7 languages.
✅ Zero-Allocation Streaming: Direct-to-struct parsing with quick-xml & lexical-core (10x–24x faster).
✅ Dual-Format XML ↔ JSON: Whole-document transcoding (`polyxml transcode`) and dual-annotated models.
✅ Modern Language Idioms: Immutable Java 22+ records, C++20 value types, Python 3.12 PEP 695 dataclasses.
✅ Secure by Design: Pure-Rust streaming parser structurally immune to XXE (CWE-611) & SSRF.
✅ 100% Permissive MIT: Zero commercial licensing fees, zero GPL infection risk.

👉 Read the Full Architectural Comparison & Head-to-Head Benchmarks →

🛠️ Universal XSD-to-Code Generation¶

PolyXML includes a full-fledged CLI toolchain (polyxml) that transforms W3C XSD 1.0 and 1.1 schemas into strongly-typed data contracts and high-performance codecs across all 7 target ecosystems:

flowchart LR
    XSD[W3C XSD 1.0 / 1.1<br/>Schema Files] --> PARSER[Pure-Rust XSD Parser<br/>polyxml-core]
    PARSER --> IR[PolyXML-IR<br/>Language-Agnostic IR]
    IR --> TARJAN[Tarjan SCC Analysis<br/>Cycle Cutting & Boxing]
    TARJAN --> CLI[polyxml CLI]
    CLI --> PY[Python 3.12+<br/>dataclass & Pydantic v2]
    CLI --> RS[Rust 2021/2024<br/>Zero-Copy, Owned & rkyv]
    CLI --> CPP2[C++20 / C++23<br/>Modules & Glaze Serde]
    CLI --> JV[Java 22+<br/>Records, Jackson & Sealed Interfaces]
    CLI --> TS2[TypeScript 5+<br/>Zod, Valibot & TypeBox]
    CLI --> GO2[Go 1.22+<br/>Structs, Sonic & EasyJSON]
    CLI --> CS[C# 12 / .NET 8+<br/>Record Structs & Source Gen]

Tested against the official W3C XML Schema Test Suite (XSTS) with >99.8% schema compilation pass rate and >96% round-trip validation pass rate via polyxml-w3c-tests.

Architecture at a Glance¶

flowchart TD
    XML[Raw XML Stream] --> CORE[polyxml-core<br/>quick-xml + lexical-core]
    CORE --> CABI[polyxml-c<br/>C-ABI Shared Library]
    CORE --> PY[polyxml-python<br/>PyO3 / abi3]
    CORE --> NAPI[polyxml-js<br/>napi-rs]

    CABI --> CPP[Modern C++20<br/>polyxml.hpp]
    CABI --> GO[Go<br/>Cgo]
    CABI --> JAVA[Java 22+<br/>Panama FFI]

    PY --> PYMODELS[Python Dataclasses<br/>& Pydantic v2]
    NAPI --> TS[Node.js / TypeScript]

🌐 Real-World Industry Showcases¶

Explore complete, production-ready example repositories showcasing PolyXML in mission-critical industries across all 7 supported languages:

Next Steps¶

• Check out the 5-Minute Multi-Language Quickstart to see PolyXML in action.
• Read about our XSD-to-Code Generator & CLI Toolchain.
• Choose a language guide for your ecosystem.
• Learn how Polymorphic Types & xsi:type Dispatch work at runtime.
• Read about our Architecture & Streaming Design.
• Explore Performance & Benchmarks.