Crate nanotemplate[−][src]

A minimal templating engine that renders a string from the template, replacing all instances of {placeholder} with given values.

The engine is strict:

  • all placeholders must have values provided,
  • all provided values must have matching placeholder,
  • a single placeholder can be used multiple times and will be expanded in all places.

Values are provided as an iterable object that provides placeholder name and value pairs.

Placeholder name may only contain letters (a to z, A to Z), numbers, dash, underscore and a dot to limit the risk of accidental placeholders in templates.

Hash maps are not used; all data is kept in vectors making it O(N + N * M) where N is number of placeholders and M is number of values. This should still be very fast for templates with small number of placeholders as no data is copied (works with slices).

use nanotemplate::template;

assert_eq!(
    template("Hello, my name is {name}!", &[("name", "nanotemplate")]).unwrap(),
    "Hello, my name is nanotemplate!".to_owned());

Also comes with simple CLI utility:

echo "Hello, my name is {name}!" | nanotemplate name=nanotemplate

Enums

TemplateError

Traits

PlaceholderValuePair

Provides a way to get placeholder name and value for template expansion.

Functions

template

Renders a string from the tempalte, replacing all instances of {placeholder} with given values.