jinplate 0.0.3

CLI renderer for Jinja2

jinplate

A command line Jinja2 renderer inspired by gomplate

jinplate can read from local and remote variable files in a number of formats and use them to render a local Jinja2 template file.

jinplate uses URIs to identify how to fetch and parse Jinja2 variable files.

Installation

pip install jinplate

Usage

jinplate --help

Usage: jinplate [OPTIONS] TEMPLATE_FILE DATASOURCE

  A command line renderer for jinja templates

  TEMPLATE_FILE is the path to a jinja template file to render

  DATASOURCE is the URI of a datasource supported by jinplate that contains
  the template variables

Options:
  --help  Show this message and exit.

Local Vars Example

test.j2

---

key: {{ test1.key }}
arr: {{ test2.arr }}

vars.json

{
  "test1": {
    "key": "val"
  },
  "test2": {
    "arr": [1, 2, 3]
  }
}

jinplate test.j2 "file:///$(pwd)/vars.json"

---

key: val
arr: [1, 2, 3]

Remote Vars example

python -m http.server

jinplate test.j2 "http://127.0.0.1:8000/vars.json"

---

key: val
arr: [1, 2, 3]

Supported Vars File Schemes

URI Scheme	Plugin	Example
file	jinplate.plugins.scheme.file	file:////path/to/vars.yaml
http	jinplate.plugins.scheme.http	http://127.0.0.1:8000/vars.json

Supported Vars File Types

File type	Plugin	Example
json	jinplate.plugins.filetype.json	http://127.0.0.1:8000/vars.json
yaml	jinplate.plugins.filetype.yaml	http://127.0.0.1:8000/vars.yml file:////path/to/vars.yaml
dotenv	jinplate.plugins.filetype.dotenv	file:////path/to/vars.env