37 lines
1.7 KiB
Markdown
37 lines
1.7 KiB
Markdown
|
|
|
|
# instant-xml: more rigorously mapping XML to Rust types
|
|
|
|
[](https://docs.rs/instant-xml)
|
|
[](https://crates.io/crates/instant-xml)
|
|
[](https://github.com/InstantDomain/instant-xml/actions?query=workflow%3ACI)
|
|
[](LICENSE-MIT)
|
|
[](LICENSE-APACHE)
|
|
|
|
instant-xml is a serde-like library providing traits and procedural macros to help map XML to Rust
|
|
types. While serde is great for formats like JSON, the underlying structure it provides is not a
|
|
great fit for XML, limiting serde-based tools like quick-xml. instant-xml more rigorously maps the
|
|
XML data model (including namespaces) to Rust types while providing a serde-like interface.
|
|
|
|
## Features
|
|
|
|
* Familiar serde-like interface
|
|
* Full support for XML namespaces
|
|
* Avoids copying deserialized data where possible
|
|
* Minimum supported Rust version is 1.58
|
|
|
|
## Limitations
|
|
|
|
instant-xml is still early in its lifecycle. While it works well for our use cases, it might not
|
|
work well for you, and several more semver-incompatible releases should be expected to flesh out
|
|
the core trait APIs as we throw more test cases at it. There's also currently not that much
|
|
documentation.
|
|
|
|
We'd love to hear your feedback!
|
|
|
|
## Thanks
|
|
|
|
Thanks to [@rsdy](https://github.com/rsdy) and [@choinskib](https://github.com/choinskib) for
|
|
their work on this library, and thanks (of course) to [@dtolnay](https://github.com/dtolnay/) for
|
|
creating serde.
|