polyxml-cli 0.14.0

Command-line interface and polyglot schema compiler for PolyXML
Documentation

PolyXML CLI (polyxml)

Unified developer command-line interface and polyglot schema compiler toolchain for PolyXML.

polyxml parses W3C XSD 1.0 and 1.1 schemas into a unified, language-agnostic Intermediate Representation (IR), resolves cyclic/recursive types via Tarjan's Strongly Connected Components (SCC) algorithm, and compiles production-ready, idiomatic data models and codecs for 7 target languages.

Installation

# From workspace root
cargo install --path crates/polyxml-cli

Supported Target Languages

Target Flag (--lang) Generated Artifacts & Features
Python python Modern Python 3.12+ @dataclass or Pydantic v2 models, field constraints, zero-copy streaming codecs
Rust rust Zero-copy Cow<'a, str> & owned structs, automatic recursive boxing (Box<T>), streaming serializers/deserializers
C++ cpp Modern C++20/C++23 value types, std::variant choice representations, concepts, CMake/Meson export
Java java Java 21+ records, sealed interface choice models, Jakarta/Java Bean Validation annotations
TypeScript typescript TypeScript 5+ interfaces, discriminated unions, Zod runtime validation schemas with z.lazy() recursion
Go go Idiomatic Go 1.22+ structs with encoding/xml tags, pointer cycle breaking, choice mutual-exclusivity unmarshaling
C# csharp Modern C# 12 / .NET 8+ records with primary constructors, System.Xml.Serialization attributes, IValidatableObject validation

Commands

1. polyxml generate

Compile schemas directly into code for one or more target languages:

# Generate Python dataclasses
polyxml generate --lang python --out ./generated/python schemas/order.xsd

# Generate Pydantic v2 models with runtime validation
polyxml generate --lang python --backend pydantic-v2 --out ./generated/python schemas/order.xsd

# Generate zero-copy Rust models with codecs
polyxml generate --lang rust --zero-copy --codecs --out ./generated/rust schemas/order.xsd

# Multi-target compilation in a single invocation
polyxml generate \
  --lang python \
  --lang rust \
  --lang cpp \
  --lang java \
  --lang typescript \
  --lang go \
  --lang csharp \
  --out ./generated \
  schemas/pain.001.001.09.xsd

# Dry-run inspection without writing files to disk
polyxml generate --lang rust --dry-run schemas/order.xsd

2. polyxml build

Build an entire multi-target, multi-schema project declaratively from a polyxml.toml workspace manifest:

polyxml build --config polyxml.toml

3. polyxml validate

Statically check W3C XML schemas for structural validity, element types, and cycle topology:

polyxml validate schemas/*.xsd

Workspace Manifest (polyxml.toml)

[workspace]
name = "enterprise-data-pipeline"
schemas = ["schemas/iso20022/*.xsd"]
include_dirs = ["schemas/common/"]
output_base_dir = "./generated"

[[generate]]
target = "python"
output = "src/generated/python"
backend = "pydantic-v2"
codecs = true

[[generate]]
target = "rust"
output = "src/generated/rust"
zero_copy = true
codecs = true

[[generate]]
target = "java"
output = "src/generated/java"
package = "com.enterprise.banking.iso20022"

[[generate]]
target = "typescript"
output = "src/generated/ts"

[[generate]]
target = "cpp"
output = "src/generated/cpp"

[[generate]]
target = "go"
output = "src/generated/go"
package = "payments"

[[generate]]
target = "csharp"
output = "src/generated/csharp"
namespace = "Enterprise.Banking.Iso20022"