tmpl-cli

Render Jinja2 templates from the command line with JSON, YAML, environment variables, or inline values.

Install

pip install tmpl-cli

# With YAML support:
pip install tmpl-cli[yaml]

Usage

# Render a template file with a data file
tmpl render template.conf -d config.json

# Inline template with --set
tmpl render "Hello {{name}}!" --set name=World

# Multiple data sources (later overrides earlier)
tmpl render app.conf -d defaults.json -d overrides.json --set debug=true

# Use environment variables
tmpl render deploy.yaml --env
tmpl render deploy.yaml --env-prefix APP_

# List variables in a template
tmpl vars template.conf

# Validate syntax
tmpl validate template.conf

# Check template + data completeness
tmpl check template.conf -d data.json --strict

Commands

Data Sources (priority low→high)

1. -d / --data files (JSON or YAML, repeatable)
2. --env (all env vars) or --env-prefix PREFIX (filtered, prefix stripped)
3. -s / --set key=value (highest priority, repeatable)

Values in --set are auto-parsed as JSON when possible (--set count=5 → int, --set items='["a","b"]' → list).

For AI Agents

See SKILL.md for agent-optimized documentation.

License

MIT