Package tinyview on DUB

To use this package, run the following command in your project's root directory:

Tinyview

A small library to support string substitutions and partial includes.

Many use cases doesn't need any complex logic in the templates. Tinyview specially designed for those use cases. For example, to generate static HTML pages or to generate email templates etc.

Syntax

Syntax is very easy to remember. Inspired by Liquid and Jinja2, but only variable substitution and partial includes supported.

Variable substitution

{{ variable_name }}

Example,

Dear {{ first_name }},

Thank you for the feedback!

Regards
Tinyview

Include other files

{% include "filename" %}

Example,

{% include "top.html" %}
<h1>{{ title }}</h1>
<div class="content">
{{ content }}
</div>
{% include "footer.html" %}

Install

Add tinyview to your project by running the following command.

dub add tinyview

Hello World!

import std.stdio;

import tinyview;

void main()
{
    auto view = Tinyview("Hello {{ name }}!");
    writeln(view.render(["name": "World"]));
}

$ dub run
Hello World!

Usage

String templates

auto data = [
    "name": "Admin",
    "status": "Running"
];

auto tmpl = q"[Dear {{ name }},

Application status is {{ status }}.

]";
auto view = Tinyview(tmpl);
writeln(view.render(data));

String templates with string partials

auto partials = [
    "top.html": "<!DOCTYPE html><html><head><title>{{ title }}</title></head><body>",
    "footer.html": "</body></html>"
];
auto data = [
    "title": "Hello World!",
    "content": "Content text"
];

auto tmpl = `{% include "top.html" %}{{ content }}{% include "footer.html" %}`;
auto view = Tinyview(tmpl);
writeln(view.render(data, partials));

Render templates from the filesystem

Tinyview will look for templates in config.viewsDirectory (Default is "./views").

$ ls views
index.html
top.html
seo.html
footer.html

auto data = [
    "title": "Hello World!",
    "content": "Content text"
];

auto filename = "index.html";
auto view = Tinyview(filename);
writeln(view.renderFile(data));

Configurations

viewsDirectory (Default: "./views") - When file name is provided, it will be looked up in this directory.

config.viewsDirectory = "./";

onMissingKey (Default: MissingKey.empty) - By default, render function adds empty string if the variable or include file is not available. Other available options are:

MissingKey.error to raise error when variable or include file not found.
MissingKey.passThrough to retain the variable and include syntax as is when not found. Useful for multistage processing.

config.onMissingKey = MissingKey.error;

maxDepth (Default: 3) - If a partial file includes other files and variables, max depth to parse the included template and replace.

config.maxDepth = 2;

TinyviewConfig config;
config.viewsDirectory = "./";
config.onMissingKey = MissingKey.error;
config.maxDepth = 2;

auto view = Tinyview("Hello {{ name }}!", config);
writeln(view.render(["name": "World"]));

Contributing

Fork it (https://github.com/aravindavk/tinyview/fork)
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -asm 'Add some feature')
Push to the branch (git push origin my-new-feature)
Create a new Pull Request

Contributors

Aravinda VK - Creator and Maintainer

0.2.0	2024-Aug-24
0.1.1	2024-Jul-15
0.1.0	2024-Jul-13
~main	2024-Aug-24

tinyview 0.1.0