Render Jinja2 templates on the command line using a YAML, JSON or HCL file as input for the render context.
Installation
j2y is installed using pip:
$ pip install j2y
Alternatively you can install directly from Github master branch:
$ pip install git+https://github.com/chaudum/j2y.git@master
Usage
By default, the j2cli command takes a YAML file as input:
$ j2cli template.j2 < values.yaml
Alternatively you can use JSON or HCL as input format:
$ j2cli template.j2 -f json < values.json $ j2cli template.j2 -f hcl < values.hcl
It’s also possible to provide multiple input files:
$ j2cli template.j2 --context v1.yaml --context v2.yaml
Run j2cli -h to see all available options.
Template Variables
Additionally to the variables provided by the input file, j2cli also provides built-in default variables. These variables are:
- meta.date:
Type: datetime
Value: Current UTC datetime object
- meta.platform:
Type: dict
Value: Output of platform.uname()
- env:
Type: dict
Value: All environment variables (output of os.environ).
Local Development
Bootstrapping
Create a virtualenv and install the package as develop egg:
$ python -m venv env $ source env/bin/activate (env) $ pip install -e .
Tests
At the moment there are very simple test cases only. Test are written as Python doctests and run using pytest:
(env) $ pip install -e ".[test]" (env) $ pytest
Pytest additionally runs the black linter and mypy static type checker.
Documentation
The tests located in the docs/ folder can also be built into HTML using Sphinx:
(env) $ sphinx-build -E -W docs/ _build/
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file j2y-0.3.0.tar.gz.
File metadata
- Download URL: j2y-0.3.0.tar.gz
- Upload date:
- Size: 15.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.0.0 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.8.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
62ddf571e107d04f9b2eef77c08a5413d5fd283e255c84b7a15ae604e375872b
|
|
| MD5 |
fa02718b6bcec2691f2a24763ef54819
|
|
| BLAKE2b-256 |
4734bfc50588fa31592151e30b1081e6e0288afa4e7ebbbb19c79479d3d408f3
|
File details
Details for the file j2y-0.3.0-py2.py3-none-any.whl.
File metadata
- Download URL: j2y-0.3.0-py2.py3-none-any.whl
- Upload date:
- Size: 9.3 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.0.0 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.8.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c4bce9c384e3e5ea665e8fb13b52d5a504d9dbdb43d62c9d26a44cc37a9e43c6
|
|
| MD5 |
b1a935c91b5aa890fafcbe4ca4b190c8
|
|
| BLAKE2b-256 |
d3e6e5d005f70dfc2c1d7f79a7d642717537c9f2afac4f31f3555d3742c698e4
|
