#url #template #string


Lightweight URL templates. Master URLs with placeholders!

6 releases

✓ Uses Rust 2018 edition

0.1.5 Mar 12, 2019
0.1.4 Feb 3, 2019

#26 in #url

Download history 40/week @ 2019-01-29 11/week @ 2019-02-05 1/week @ 2019-02-12 7/week @ 2019-02-19 16/week @ 2019-02-26 2/week @ 2019-03-05

25 downloads per month

MIT license

152 lines


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.


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-❤"));


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


~31K SLoC