14 releases

0.2.1 Mar 6, 2023
0.2.0 Feb 1, 2023
0.1.0 Dec 28, 2022
0.1.0-beta.2 Aug 15, 2022
0.0.7 Nov 22, 2020

#284 in Encoding

Download history 301/week @ 2024-02-26 374/week @ 2024-03-04 663/week @ 2024-03-11 408/week @ 2024-03-18 316/week @ 2024-03-25 515/week @ 2024-04-01 270/week @ 2024-04-08 290/week @ 2024-04-15 347/week @ 2024-04-22 197/week @ 2024-04-29 339/week @ 2024-05-06 435/week @ 2024-05-13 475/week @ 2024-05-20 423/week @ 2024-05-27 405/week @ 2024-06-03 348/week @ 2024-06-10

1,704 downloads per month
Used in 6 crates (5 directly)

MIT/Apache

85KB
2K SLoC

Serde-querystring



A query string parser for rust with support for different parsing methods.

Install

# Cargo.toml
[dependencies]
serde-querystring = "0.2.0"

Usage

You can use the parsers provided in this crate directly, examples are available in each parser's tests.

use serde_querystring::DuplicateQS;

let parsed = DuplicateQS::parse(b"foo=bar&foo=baz");
let values = parsed.values(b"foo"); // Will give you a vector of b"bar" and b"baz"

Or you can use serde(with serde feature, enabled by default)

use serde::Deserialize;
use serde_querystring::{from_str, ParseMode, DuplicateQS};

#[derive(Deserialize)]
struct MyStruct{
  foo: Vec<String> // Or (String, u32) tuple
}

let parsed: MyStruct = from_str("foo=bar&foo=2022", ParseMode::Duplicate).unwrap();
// or
let parsed: MyStruct = DuplicateQS::parse(b"foo=bar&foo=baz").deserialize().unwrap();

There are also crates for actix_web(serde-querystring-actix) and axum(serde-querystring-axum) which provide extractors for their frameworks and can be used without directly relying on the core crate.

Parsers

Simple Mode

Simply parses key=value pairs, accepting only one value per key. In case a key is repeated, we only collect the last value.

use serde_querystring::{UrlEncodedQS, ParseMode, from_str};

UrlEncodedQS::parse(b"key=value");
// or
let res: MyStruct = from_str("foo=bar&key=value", ParseMode::UrlEncoded).unwrap();

Repeated key mode

Supports vectors or values by repeating a key.

use serde_querystring::{DuplicateQS, ParseMode, from_str};

DuplicateQS::parse(b"foo=bar&foo=bar2&foo=bar3");
// or
let res: MyStruct = from_str("foo=bar&foo=bar2&foo=bar3", ParseMode::Duplicate).unwrap();

Delimiter mode

Supports vectors or values by using a delimiter byte(ex. b'|').

use serde_querystring::{DelimiterQS, ParseMode, from_str};

DelimiterQS::parse(b"foo=bar|bar2|bar3", b'|');
// or
let res: MyStruct = from_str("foo=bar|bar2|bar3", ParseMode::Delimiter(b'|')).unwrap();

Brackets mode

Supports vectors or values by using a brackets and subkeys.

use serde_querystring::{BracketsQS, ParseMode, from_str};

BracketsQS::parse(b"foo[1]=bar&foo[2]=bar&foo[3]=bar");
// or
let res: MyStruct = from_str("foo[1]=bar&foo[2]=bar&foo[3]=bar", ParseMode::Brackets).unwrap();

Credit

We use some lines of code from form_urlencoded to parse percent encoded chars.

License

This project is licensed under either of

at your option.

Dependencies

~0–425KB