#url #escape #unescape #encode #decode

url-escape

This library is for encoding/escaping special characters in URLs and decoding/unescaping URLs as well

2 releases

Uses new Rust 2021

0.1.1 Mar 19, 2022
0.1.0 Apr 21, 2021

#579 in Encoding

Download history 277/week @ 2022-03-10 447/week @ 2022-03-17 313/week @ 2022-03-24 698/week @ 2022-03-31 665/week @ 2022-04-07 573/week @ 2022-04-14 1196/week @ 2022-04-21 734/week @ 2022-04-28 702/week @ 2022-05-05 566/week @ 2022-05-12 484/week @ 2022-05-19 482/week @ 2022-05-26 498/week @ 2022-06-02 476/week @ 2022-06-09 507/week @ 2022-06-16 493/week @ 2022-06-23

2,084 downloads per month
Used in 9 crates (7 directly)

MIT license

17KB
219 lines

URL Escape

CI

This library is for encoding/escaping special characters in URLs and decoding/unescaping URLs as well.

Usage

Encoding

This crate provides some encode_* functions to encode URL text in different situations.

For example, to put a text to a fragment, use the encode_fragment function.

assert_eq!("a%20%3E%20b?", url_escape::encode_fragment("a > b?"));

The functions suffixed with _to_writer, _to_vec or _to_string are useful to generate URL text.

let mut url = String::from("https://");
assert_eq!("admin%40example.com", url_escape::encode_userinfo_to_string("admin@example.com", &mut url));
url.push_str("@127.0.0.1/");
assert_eq!("%E4%B8%AD%E6%96%87%E5%AD%97/eng/12%2034", url_escape::encode_path_to_string("中文字/eng/12 34", &mut url));
url.push('/');
assert_eq!(r"56%2F78", url_escape::encode_component_to_string("56/78", &mut url));
url.push('?');
assert_eq!(r"a=1&b=a%20b%20c", url_escape::encode_query_to_string("a=1&b=a b c", &mut url));

assert_eq!("https://admin%40example.com@127.0.0.1/%E4%B8%AD%E6%96%87%E5%AD%97/eng/12%2034/56%2F78?a=1&b=a%20b%20c", url);

Decoding

assert_eq!("中文字/eng/12 34", url_escape::decode("%E4%B8%AD%E6%96%87%E5%AD%97/eng/12%2034"));

Crates.io

https://crates.io/crates/url-escape

Documentation

https://docs.rs/url-escape

License

MIT

Dependencies

~13KB