Serde Querystrings

This crate is a Rust library for serialising to and deserialising from querystrings using serde. This crate is designed to extend serde_urlencoded when using nested parameters, similar to those used by qs for Node, and commonly used by Ruby on Rails via Rack.

The core of the library was inspired by serde_urlencoded. In order to support deserializing abitrarily nested structs encoded in arbitrary orders, we perform two passes over the input string. This adds a non-trivial amount of memory and compute, approximately a 50% overhead compared to serde_urlencoded. However, in absolute terms, deserialization is on the order of single-digit microseconds.

Similarly, serialization needs to buffer keys in case there are nested values, resulting in about 50% overhead.

For detailed benchmark documentation, see benches/README.md.

Installation

[!IMPORTANT] We are currently in the process of stabilizing a major v1 release of this crate. If you are evaluating this crate, consider using the release candidate over the stable 0.x release.

See this issue and the release notes for more information.

This crate works with Cargo and can be found on crates.io with a Cargo.toml like:

[dependencies]
serde_qs = "0.15"

Minimum supported Rust version is 1.68.

For older versions of Rust, serde_qs versions <= 0.11 support Rust 1.36.

License

serde_qs is licensed under either of

• Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in serde_qs by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.