Skip to main content

A comprehensive command line utility to render templates and ease code generation.

Project description

Shadow Documentation Status Updates

A comprehensive command line utility to render templates and ease code generation.


  • 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 shadow-cli

Install from GitHub:

git clone
cd shadow
pip install -U .


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


Created and maintained by karma0.

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


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.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for shadow-cli, version 0.3.0
Filename, size File type Python version Upload date Hashes
Filename, size shadow-cli-0.3.0.tar.gz (21.2 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page