jinja2 template renderer
Project description
jiren
jiren is an application that generates text from a template. The format of the template is based on jinja2.
Read this in Japanese: 日本語
Installation
pip install jiren
Usage
Generate text
Generate text from a template using the jiren
command. This command can read a template from stdin or files.
An example of reading a template from stdin:
Command:
echo "hello, {{ name }}" | jiren -- --name=world
Outputs:
hello, world
An example of reading a template from a file:
Command:
cat <<EOF >template.j2
hello, {{ name }}
EOF
jiren -i template.j2 -- --name=world
Outputs:
hello, world
In this example, the template contains a variable called name
. You can set values for variables in a template using program arguments passed to the jiren
command. Note that the arguments for the variables must be located after --
.
If you want to know more about template format, please refer to jinja2 document ( http://jinja.pocoo.org/ ).
Variables in a template
You can use the help to check the variables defined in a template.
Command:
echo "{{ greeting }}, {{ name }}" | jiren -- --help
Outputs:
... (omitted)
variables:
--name NAME
--greeting GREETING
Default values
You can set default values for variables for which no values was specified. This is based on the jinja2 specification.
Command:
echo "{{ greeting }}, {{ name | default('world') }}" | jiren -- --greeting=hello
Outputs:
hello, world
Option: required
When using the --required
option, you must specify values for all variables.
Command:
echo "{{ greeting }}, {{ name }}" | jiren --required -- --greeting=hello
Outputs:
... (omitted)
jiren: error: the following arguments are required: --name
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.