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.
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.
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.
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.