Struct Template 

pub struct Template<'a> { /* private fields */ }

Class to hold hidden data about template

Implementations

impl<'a> Template<'a>

Class implementation

pub fn new(expanded: &'a str) -> Self

Create a new template using a string containing ${..} variables Note: will only dereference 16 nested levels of variables Simple default value;

Example

use stemplate::Template;
Template::new("My name is ${name}");

Example

use stemplate::Template;
// Simple default value (variable not supplied in template or is empty";
Template::new("My name is ${name:-Fred}");

Example

use stemplate::Template;
// Nested variables where fullname = "${first:=Fred} ${last:=Bloggs}"
Template::new("My name is ${fullname}");

pub fn new_delimit(expanded: &'a str, sdlim: &'a str, edlim: &'a str) -> Self

Create a new template as above but choose different delimiters

Example

use stemplate::Template; Template::new_delimit(“My name is {%name%}”, “{%”, “%}”);

pub fn render<V: AsRef<str> + Debug + ToString>( &self, vars: &HashMap<&str, V>, ) -> String

Render a template.

Example

use std::collections::HashMap;
use stemplate::Template;
let template = Template::new("My name is ${name}");
let mut args = HashMap::new();
args.insert("name", "Fred");
let s = template.render(&args);
assert_eq!(s, "My name is Fred");

Example

// Multi-valued example use in *<delimit>
// Delimit is optional and is newline by default
// This is useful for lists etc.
// Normally HTML markup would be included
use std::collections::HashMap;
use stemplate::Template;
let mut args = HashMap::new();
args.insert("dog", "woofers|rex|freddy");
args.insert("cat", "kitty|moggi");
args.insert("pets", "${dog} and ${cat}");
let s = Template::new("${*|pets}").render(&args);
assert_eq!(s, "woofers and kitty|rex and moggi");

pub fn render_strings(&self, vars: &HashMap<String, String>) -> String

Render a template with string values. Convenience for use with serde hash maps.

Example

use std::collections::HashMap;
use stemplate::Template;
let template = Template::new("My name is ${name}");
let mut args = HashMap::new();
args.insert("name", "Fred");
let s = template.render(&args);
assert_eq!(s, "My name is Fred");

Example

// Nested variables
use std::collections::HashMap;
use stemplate::Template;
let mut args = HashMap::new();
args.insert("first", "Doris");
args.insert("fullname", "${first:=Fred} ${last:=Bloggs}");
let template = Template::new("${fullname}");
let s = template.render(&args);
assert_eq!(s, "Doris Bloggs");

pub fn render_env(&self) -> String

Render a template from environment variables.

Example

use stemplate::Template;
// Using Googles LLM API. GEMINI_URL contains other env variables
let url: String = Template::new_delimit("{GEMINI_URL}", "{", "}").render_env();

Example

use stemplate::Template;
let s = Template::new("File contains: ${!test.inc}").render_env();
//assert_eq!(s, "File contains: inc");

Trait Implementations

impl<'a> Debug for Template<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.