A fast, microscopic helper crate for runtime text substitution.
microtemplate to do exactly one thing. There's no reason to include more feature-rich/large libraries like regex/handlebars/tinytemplate if all you need is text substitution.Add microtemplate to your dependencies:
toml
[dependencies]
microtemplate = "1.0.0"
Usage example (from the tests): ```rs use microtemplate::{Substitutions, render};
// This derive allows microtemplate to use the struct as substitutions.
struct Movie<'a> { name: &'a str, // automatically replaces "{name}" in a template description: &'a str, }
fn main() { let the_birds = Movie { name: "The Birds", description: "a swarm of birds that suddenly and violently attack the residents of a California coastal town", };
// the template string here can be generated whenever- in this example it is known at compile time but that does not matter.
let rendered = render("{name} is a movie about {description}.", the_birds);
// The Birds is a movie about a swarm of birds that suddenly and violently attack the residents of a California coastal town.
println!("{}", rendered);
// note that if a substitution is indicated in the template string but it is not found in the struct passed, it is replaced with an empty string ("")
} ```
Licensed under either of
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
If you have any bug reports, improvements, or feature requests, please make an issue