Skip to content

Serde support for querystring-style strings

License

Notifications You must be signed in to change notification settings

vegardgs-ksat/serde_qs

 
 

Repository files navigation

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.

About

Serde support for querystring-style strings

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Rust 100.0%