urltemplate

Crates.iourltemplate
lib.rsurltemplate
version0.1.5
sourcesrc
created_at2019-02-02 12:08:05.865611
updated_at2019-03-12 07:03:44.137435
descriptionLightweight URL templates. Master URLs with placeholders!
homepagehttps://github.com/vladignatyev/rust-urltemplate
repositoryhttps://github.com/vladignatyev/rust-urltemplate.git
max_upload_size
id112171
size12,285
Vladimir Ignatyev (vladignatyev)

documentation

https://docs.rs/urltemplate/0.1.0/urltemplate/

README

Urltemplate

Convert URL template containing placeholders into url. Whenever you need to turn https://example.com/?utm_source={source}&key2={value2} into URL like https://example.com/?utm_source=github&key2=

Core idea is to have minimalistic and comfortable to use placeholders for http/https URLs. Comfortable means to be easily used in any web-related project, UTF-safe.

Warning: This crate is experimental. Also, it is being actively developed.

Usage

extern crate urltemplate;

use urltemplate::UrlTemplate;

use std::collections::HashMap;
let mut params = HashMap::new();
params.insert("source".to_string(), "url-template-crate-❤".to_string());

let url_with_placeholders = UrlTemplate::from("https://www.mozilla.org/?utm_source={source}");

let url_as_string =  url_with_placeholders.substitute_str(&params).expect("valid url");
let url_as_url =  url_with_placeholders.substitute(&params).expect("valid url");

assert_eq!(url_as_string, "https://www.mozilla.org/?utm_source=url-template-crate-❤");
assert_eq!(url_as_url.query(), Some("utm_source=url-template-crate-❤"));

Notes

  • UTF safe
  • no external dependencies (only url crate is required)
  • compact and clean implementation
Commit count: 15

cargo fmt