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, and does not rely on any external dependencies.
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 parser = new TemplateParser
{
Variables =
{
["name"] = "me"
}
};
var template = "hello {{name}}.";
var result = parser.Render(template);
Console.WriteLine(result); // Output: hello me.
Expression Substitution
var parser = new TemplateParser
{
Variables =
{
["name"] = "me"
}
};
var template = "hello {{x => x.name.ToUpper()}}.";
var result = parser.Render(template);
Console.WriteLine(result); // Output: hello ME.
Token Nesting
Token values can contain other tokens.
var parser = new TemplateParser
{
Variables =
{
["fullname"] = "{{first}} {{last}}",
["first"] = "Hari",
["last"] = "Seldon"
}
};
var template = "hello {{fullname}}.";
var result = parser.Render(template);
Console.WriteLine(result); // Output: hello Hari Seldon.
Conditional Tokens
You can use conditional tokens to control the flow based on conditions.
var parser = new TemplateParser
{
Variables =
{
["condition"] = "true",
["name"] = "me"
}
};
var template = "{{#if condition}}hello {{name}}.{{/if}}";
var result = parser.Render(template);
Console.WriteLine(result); // Output: hello me.