#url #escape #unescape #encode #decode

url-escape

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

1 unstable release

0.1.0 Apr 21, 2021

#18 in #escape

Download history 49/week @ 2021-08-18 31/week @ 2021-08-25 22/week @ 2021-09-01 21/week @ 2021-09-08 38/week @ 2021-09-15 83/week @ 2021-09-22 92/week @ 2021-09-29 36/week @ 2021-10-06 14/week @ 2021-10-13 44/week @ 2021-10-20 148/week @ 2021-10-27 58/week @ 2021-11-03 102/week @ 2021-11-10 46/week @ 2021-11-17 30/week @ 2021-11-24 54/week @ 2021-12-01

234 downloads per month
Used in 6 crates (5 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.

extern crate url_escape;

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.

extern crate url_escape;

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

extern crate url_escape;

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

`