pct 4.0.1

Percent-encoded strings for URL, URI, IRI, etc.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

use pct::{PctString, UriReserved};

struct CustomEncoder;

impl pct::Encoder for CustomEncoder {
    fn encode(&self, c: char) -> bool {
        UriReserved::Any.encode(c) || c.is_uppercase()
    }
}

fn main() {
    // You can encode any string into a percent-encoded string
    // using the [`PctString::encode`] function.
    // It takes a `char` iterator and a [`Encoder`] instance deciding which
    // characters to encode.
    let pct_string = PctString::encode("Hello World!".chars(), UriReserved::Any);
    // [`URIReserved`] is a predefined encoder for URI-reserved characters.
    assert_eq!(pct_string.as_str(), "Hello%20World%21");

    // You can create your own encoder by implementing the [`Encoder`] trait.
    let pct_string = PctString::encode("Hello World!".chars(), CustomEncoder);
    println!("{}", pct_string.as_str());
    assert_eq!(pct_string.as_str(), "%48ello%20%57orld%21");

    // You can also use any function implementing `Fn(char) -> bool`.
    let pct_string = PctString::encode("Hello World!".chars(), char::is_uppercase);
    assert_eq!(pct_string.as_str(), "%48ello %57orld!");
}