url-prefix

Crates.iourl-prefix
lib.rsurl-prefix
version2.0.4
sourcesrc
created_at2018-10-12 06:10:22.149232
updated_at2022-03-19 05:44:01.627225
descriptionA library for creating URL prefix strings.
homepagehttps://magiclen.org/url-prefix
repositoryhttps://github.com/magiclen/url-prefix
max_upload_size
id89402
size7,448
Magic Len (Ron Li) (magiclen)

documentation

README

URL Prefix

CI

This crate can be used to create URL prefix strings by inputting a protocol, a domain, a port number and a path without additional parsing.

Why We Need This?

Sometimes our web applications are run on different protocols(HTTP/HTTPS) and domains. And it is boring to write some code like below to format a URL:

let mut url_prefix = String::new();
if is_https {
    url_prefix.push_str("https://");
} else {
    url_prefix.push_str("http://");
}
url_prefix.push_str(domain);

if is_https && port != 443 || !is_https && port != 80 {
    url_prefix.push_str(":");
    url_prefix.push_str(&port.to_string());
}

Instead, we can easily use this crate to create URL prefix strings. For examples,

let prefix = url_prefix::create_prefix(url_prefix::Protocol::HTTPS, "magiclen.org", None, None);

assert_eq!("https://magiclen.org", prefix);
let prefix = url_prefix::create_prefix(url_prefix::Protocol::HTTPS, "magiclen.org", Some(8100), Some("url-prefix"));

assert_eq!("https://magiclen.org:8100/url-prefix", prefix);

Crates.io

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

Documentation

https://docs.rs/url-prefix

License

MIT

Commit count: 33

cargo fmt