6 releases (1 stable)

1.0.0 Apr 16, 2025
0.3.0 Mar 24, 2025
0.2.0 Feb 17, 2025
0.1.2 Jan 19, 2025

#322 in Parser implementations

Download history 300/week @ 2025-01-19 5/week @ 2025-01-26 20/week @ 2025-02-02 9/week @ 2025-02-09 135/week @ 2025-02-16 10/week @ 2025-02-23 12/week @ 2025-03-02 9/week @ 2025-03-09 25/week @ 2025-03-16 181/week @ 2025-03-23 57/week @ 2025-03-30 132/week @ 2025-04-06 234/week @ 2025-04-13 78/week @ 2025-04-20 32/week @ 2025-04-27

480 downloads per month

MIT license

1.5MB
36K SLoC

A comprehensive library for parsing XML schemas and generating code based on them.

This project originated as a fork of xsd-parser-rs but has since evolved into a complete rewrite.

If you enjoy the project and would like to support my work, you can buy me a coffee or send a tip via PayPal. Thanks a lot! 😊

Crates.io License Crates.io Version Crates.io Total Downloads docs.rs Github CI Dependency Status

Overview

The core idea of this library is to break down the code generation process into distinct steps, enabling better control and extensibility for users. The workflow is structured as follows:

  1. Parsing XML Schemas: The Parser resolves XML schemas from various sources (e.g., local files, web links) and stores the processed information in the Schemas object. Resolving is done by using so called Resolvers, that can be implemented by the user.

  2. Interpreting Schemas: The Interpreter uses the Schemas object to extract type information by applying extensions and restrictions defined in the schema. This results in a simplified Types structure that represents language-agnostic types.

  3. Optimizing Types: The Optimizer refines the Types structure by applying various optimizations. This step is optional but may be necessary to handle specific features (e.g., serde support) when generating valid code.

  4. Generating Code: Finally, the Generator converts the optimized Types information into Rust code by using so called Renderers. As the resolvers, renderers can be implemented by the user to extend code generator.

overview

This layered approach allows users to customize or extend the process at multiple stages. For example:

  • Add custom logic to modify the type information.
  • Replace the default generator with a custom implementation.
  • Implement a custom interpreter to generate Types and use the default Rust code generator.

The possibilities for customization and extension are nearly limitless.

Example

To quickly generate Rust code from an XML schema, you can use the generate function. This function acts as a simple wrapper for the entire process described above and is controlled via a Config structure to adjust various parameters.

use xsd_parser::{generate, Config, Error, config::{Schema, InterpreterFlags, OptimizerFlags, GeneratorFlags}};

fn main() -> Result<(), Error> {
    let mut config = Config::default();
    config.parser.schemas = vec![Schema::File("my-schema.xsd".into())];
    config.interpreter.flags = InterpreterFlags::all();
    config.optimizer.flags = OptimizerFlags::all();
    config.generator.flags = GeneratorFlags::all();

    let code = generate(config)?;
    println!("{code}");

    Ok(())
}

Features

This library provides the following features:

  • Rust Code Generation: Convert any XML schema into Rust code.
  • Layered Architecture: Add user-defined code to manipulate type information or generated code.
  • User-Defined Types: Inject existing types into the generated code to reuse predefined structures.
  • serde Support: Generate code for serialization and deserialization using serde with serde_xml or quick_xml as serializer/deserializer.
  • quick_xml Support: Direct serialization/deserialization support using quick_xml, avoiding serde limitations and leveraging asynchronous features.

Planned Features

  • Schema-Based Validation: Generate validators directly from schemas to validate XML data during reading or writing.

License

This crate is licensed under the MIT License.

Dependencies

~7–19MB
~249K SLoC