stillpoint-software/Hyperbee.Templatingv3.4.1
.NET 8.0.NET 9.0.NET 10.0
A lightweight templating and variable substitution syntax engine. The library supports value replacements, code expressions, token nesting, in-line definitions, conditional flow, and looping.
Get Started
$ dotnet add package Hyperbee.TemplatingReadme
Hyperbee Templating
Hyperbee Templating is a lightweight templating and variable substitution syntax engine. The library supports value replacements, code expressions, token nesting, in-line definitions, conditional flow, and looping. It is designed to be lightweight and fast.
Features
- Variable substitution syntax engine
- Value replacements
- Expression replacements
- Token nesting
- Conditional tokens
- Conditional flow
- Iterators
- User-defined methods
Getting Started
To get started with Hyperbee.Templating, refer to the documentation for detailed instructions and examples.
Install via NuGet:
dotnet add package Hyperbee.Templating
Basic Usage
Variable Substitution
You can use the TemplateParser to perform variable substitutions.
var template = "hello {{name}}.";
var result = Template.Render(template, new()
{
Variables =
{
["name"] = "me"
}
});
Console.WriteLine(result); // Output: hello me.
Expression Substitution
var template = "hello {{x => x.name.ToUpper()}}.";
var result = Template.Render(template, new()
{
Variables =
{
["name"] = "me"
}
});
Console.WriteLine(result); // Output: hello ME.
Token Nesting
Token values can contain other tokens.
var template = "hello {{fullname}}.";
var result = Template.Render(template, new()
{
Variables =
{
["fullname"] = "{{first}} {{last}}",
["first"] = "Hari",
["last"] = "Seldon"
}
});
Console.WriteLine(result); // Output: hello Hari Seldon.
Conditional Tokens
You can use conditional tokens to control the flow based on conditions.
var template = "{{#if condition}}hello {{name}}.{{/if}}";
var result = Template.Render(template, new()
{
Variables =
{
["condition"] = "true",
["name"] = "me"
}
});
Console.WriteLine(result); // Output: hello me.
