Skip to main content

Generate entire directory structures using Jinja templates with support for external data and custom plugins.

Project description

makejinja

makejinja logo

PyPI | Docker | Docs | Example | Jinja reference

Generate entire directory structures using Jinja templates with support for external data and custom plugins.


makejinja

makejinja can be used to automatically generate files from Jinja templates. It is conceptually similar to Ansible templates since both are built on top of Jinja. However, makejinja is a standalone tool that can be used without Ansible and offers some advanced features like custom plugins. A use case for this tool is generating config files for Home Assistant: Using the same language that the built-in templates use, you can greatly simplify your configuration. An example for Home Assistant can be found in the tests directory.

Highlights

  • Recursively render nested directories containing template files to a common output directory.
  • Load data files containing variables to use in your Jinja templates from YAML, TOML, and Python files.
  • Write custom plugins to extend the functionality of makejinja.
  • Adjust all Jinja options (e.g., whitespace behavior and delimiters) to your needs via CLI flags or a config file.

Installation

The tool is written in Python and can be installed via pip, nix, and docker. It can be used as a CLI tool or as a Python library.

PIP

makejinja is available on PyPI and can be installed via pip:

pip install makejinja
makejinja -i ./input -o ./output

Nix

If you use the nix package manager, you can add this repository as an input to your flake and use makejinja.packages.${system}.default or apply the overlay makejinja.overlays.default. You can also run it directly as follows:

nix run github:mirkolenz/makejinja -- -i ./input -o ./output

Docker

We automatically publish an image to the GitHub Container Registry. To use it, mount a directory to the container and pass the options as the command:

docker run --rm -v $(pwd)/data:/data ghcr.io/mirkolenz/makejinja:latest -i /data/input -o /data/output

Usage in Terminal / Command Line

In its default configuration, makejinja searches the input directory recursively for files ending in .jinja. It then renders these files and writes them to the output directory, preserving the directory structure. Our documentation contains a detailed description of all options and can also be accessed via makejinja --help.

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.

Source Distribution

makejinja-2.5.0.tar.gz (13.3 kB view hashes)

Uploaded source

Built Distribution

makejinja-2.5.0-py3-none-any.whl (14.2 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page