Go to file

Dirkjan Ochtman 3d642cc927 Upgrade actions/checkout to v4		2024-10-23 08:00:13 +00:00
.github	Upgrade actions/checkout to v4	2024-10-23 08:00:13 +00:00
instant-xml	chore: remove redundant `Eq` derives in forward-enum tests	2024-10-22 21:03:59 +00:00
instant-xml-macros	fix: support all accumulators in enum forward deserialization	2024-10-22 21:03:59 +00:00
.gitignore	Ignore macOS cruft	2023-09-15 13:04:46 +02:00
Cargo.toml	Explicitly set workspace resolver	2023-09-15 13:04:46 +02:00
README.md	Update repository URL after move	2024-08-20 18:21:33 +02:00
cover.svg	Add cover image (#51 )	2024-02-28 11:13:54 -08:00
deny.toml	Ignore unactionable time advisory	2022-11-21 21:33:54 -08:00

README.md

instant-xml: more rigorously mapping XML to Rust types

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.

This library is used in production at Instant Domain Search.

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 and @choinskib for their work on this library, and thanks (of course) to @dtolnay for creating serde.