Features

• Incorporates a convention over configuration mentality.

• Use the default *.tpl extension to find and render templates, or specify your own.

• Use the template extension on a directory to render all files under it.

• Specify the path(s) or let it default to searching for templates in the current working directory.

• Use template variables in filenames to render scalar filename outputs.

• Use hash/dict or list/array types in filenames to render multiple files.

• Default configuration expects a file named shadowconf with any of the following extensions: .json, .hcl, .env, .yml, .ini.

• If no configuration file is specified, it will load and use the shell environment to render variables.

• All defaults can be overriden.

Quick Install

Install from PyPi:

pip install shadowgen

Install from GitHub:

git clone https://github.com/karma0/shadow
cd shadow
pip install -U .

Examples

Display the help and exit:

shadow --help

Discover templates to be generated:

shadow sim

Find all templates in the current working directory and generate them using the config file shadowconf.json as the variables to build them:

shadow fax

Find all generated templates and remove them:

shadow clean

Generate templates in the tests directory on files ending in *.j2, using environment variables to fill and render the templates:

shadow fax -e -t .j2 tests

Generate the single template file named test.txt using the HCL config file test.txt.hcl:

shadow fax -c test.txt.hcl test.txt.tpl

Credits

Created and maintained by karma0.

This package was created with Cookiecutter and the karma0/cookiecutter-pypackage project template.

0.3.2 (2019-04-01)

• Updated installation documentation.

0.3.1 (2019-04-01)

• Renamed PyPi project to shadowgen.

• Dependency upgrades.

0.3.0 (2019-02-06)

• Added config passthrough from CLI.

• Fixed yield bug in rendering of filenames.

• Added some preliminary tests.

• Fixed logging.

• Added always fallback to loading the environment if no config file is present.

• Added checks for shadowconf file using extensions: json, ini, env, etc.

0.2.2 (2019-01-31)

• Documentation fixes.

0.2.1 (2019-01-31)

• Version bump; getting everything working.

0.2.0 (2019-01-31)

• First release on PyPI.