Skip to content

Latest commit

 

History

History
62 lines (45 loc) · 2.38 KB

README.md

File metadata and controls

62 lines (45 loc) · 2.38 KB

Serde Querystrings badge-ci Latest Version Documentation

This crate is a Rust library for serialising to and deserialising from querystrings. 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 abitrarily nested structs encoded in arbitrary orders, we perform two passes over the input string. This likely adds a non-trivial amount of memory and compute. Due to this serde_urlencoded should be preferred over this crate whenever non-nested query parameters are sufficient. The crate is built upon Serde, a high performance generic serialization framework and rust-url, a URL parser for Rust.

Installation

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

[dependencies]
serde_qs = "0.13"

Minimum supported Rust version is 1.61 due to dependencies.

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

License

serde_qs is licensed under either of

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.