yatera-0.1.0 is not a library.
Yatera
Yet another Tera template v2 CLI.
It features rich DX and extra built-in filters.
Installation
macOS/Linux
Install Yatera on macOS or Linux by running the following command in your terminal:
|
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:
Build from Source
To compile Yatera from source code, install Rust and then install Yatera using Cargo:
Usage
Use the tera command to render templates from stdin:
# Render a template with variables
|
# Use structured data as variables (JSON, TOML, or YAML)
|
|
# Read and write files directly (can be used individually)
Arguments
The following arguments are available (also see tera --help):
| Argument | Description |
|---|---|
var1=value var2=value |
Set template variables from the command line |
--json '{"key":"value"}' |
Set template variables from a JSON string |
--json-file vars.json |
Set template variables from a JSON file |
--toml-file vars.toml |
Set template variables from a TOML file |
--toml "$(cat vars.toml)" |
Set template variables from a TOML string |
--yaml-file vars.yaml |
Set template variables from a YAML file |
--yaml "$(cat vars.yaml)" |
Set template variables from a YAML string |
--from template.tera |
Read the template from a file instead of stdin |
--to output.txt |
Write the rendered result to a file instead of stdout |
Built-Ins
Filters
heck
heck methods are available as string filters:
|
#=> hello_world
| Filter | Result for Hello World |
|---|---|
to_upper_camel_case / to_pascal_case |
HelloWorld |
to_lower_camel_case |
helloWorld |
to_snake_case |
hello_world |
to_kebab_case |
hello-world |
to_shouty_snake_case |
HELLO_WORLD |
to_shouty_kebab_case |
HELLO-WORLD |
to_title_case |
Hello World |
to_train_case |
Hello-World |
Filters accept strings and can be chained with other Tera filters.