Yatera

Yet another Tera template v2 CLI.

It features rich DX and extra built-ins.

Installation

macOS/Linux

Install Yatera on macOS or Linux by running the following command in your terminal:

curl -fsSL https://yatera.fyi/install.sh | sh

Windows

Install Yatera on Windows by running the following command in PowerShell:

irm https://yatera.fyi/install.ps1 | iex

Cargo Binstall

Install Yatera using Cargo Binstall by running the following command in your terminal:

cargo binstall yatera

Build from Source

To compile Yatera from source code, install Rust and then install Yatera using Cargo:

cargo install yatera

Usage

Use the tera command to render templates from stdin:

# Render a template with variables:
cat template.tera | tera var1=value var2=value > output.txt

# Use structured data as variables (JSON/TOML/YAML):
cat template.tera | tera --json '{"var":"value"}' > output.txt
cat template.tera | tera --json-file vars.json > output.txt

# Read and write files directly:
tera --in-file template.tera --out-file output.txt --json-file vars.json

Environment sources parse the variable's contents as JSON, TOML, or YAML. Choose one structured context source; name=value arguments override its values. Missing variables or invalid context contents produce an error.

Input

By default Yatera reads the template from stdin. You can override this behavior by using the --in-file option to specify a template file:

tera --in-file template.tera > output.txt

Output

By default Yatera writes the rendered result to stdout. You can override this behavior by using the --out-file option to specify an output file:

tera --in-file template.tera --out-file output.txt

Variables

Yatera supports multiple ways to provide template variables, from passing arguments to JSON/TOML/YAML strings or files.

Argument Variables

To provide template variables directly as command-line arguments, use the name=value format:

cat template.tera | tera var1=value var2=value > output.txt

Alternatively, use repeatable --var NAME VALUE flags, or the jq-compatible --arg NAME VALUE alias:

cat template.tera | tera --var var1 value --var var2 value > output.txt
cat template.tera | tera --arg var1 value --arg var2 value > output.txt

Variable Files

To read variables from JSON/TOML/YAML files:

cat template.tera | tera --json-file vars.json > output.txt

CLI options:

Variable Strings

To read variables from JSON/TOML/YAML strings:

cat template.tera | tera --json '{"var":"value"}' > output.txt

CLI options:

Environment Variable Strings

Yatera also supports reading variables from JSON/TOML/YAML strings stored in environment variables:

export VARS='{"var":"value"}'
cat template.tera | tera --json-env VARS

CLI options:

Built-Ins

Yatera supports all default Tera built-ins as well as extra filters.

Extra Filters

heck

heck methods are available as string filters:

printf '{{ name | snake_case }}' | tera name="Hello World"
#=> hello_world

License

MIT © Sasha Koss