Skip to main content

Generate new files from templates.

Project description

https://travis-ci.org/cjrh/templitz.svg?branch=master https://coveralls.io/repos/github/cjrh/templitz/badge.svg?branch=master https://img.shields.io/pypi/pyversions/templitz.svg https://img.shields.io/github/tag/cjrh/templitz.svg https://img.shields.io/badge/install-pip%20install%20templitz-ff69b4.svg https://img.shields.io/pypi/v/templitz.svg https://img.shields.io/badge/calver-YYYY.MM.MINOR-22bfda.svg

ALPHA

templitz

File templates for faster project bootstrap

Overview

So you’re making another Python project and there are a bunch of boilerplate files you need (use cookiecutter), or you have an existing project that you want to add some stuff to (cookiecutter doesn’t help). templitz offers a very lightweight way to add some typical files to a project.

For example:

$ templitz -t travis
$ templitz -t appveyor

These two commands will dump a typical .travis.yml and a appveyor.yml into your current directory (which should probably be the root of a Python project for any of this to make sense).

This program does nothing other than look up a file with a .templitz extension, and if found, copies that into your target folder. It’s just an easy way to add standard, boilerplate files to projects. Examples are CI configs, setup.py, flit.ini, README.rst, pytest.ini and so on. This tools just does the same copy-from-a-previous-project file copying that you would normally do by hand.

Here are a few more examples:

$ templitz -t asyncio

This one dumps a typical starter main.py for an asyncio-based application.

How about a C/C++? This one will dump a generic Makefile that will work out-of-the-box for most typical C/C++ projects:

$ templitz -t Makefile

BYO templitz

templitz includes a few example templates (in the /library directory), but you can also add your own quite easily: just set the TEMPLITZ_PATH env var to configure your own search path for templates:

$ export TEMPLITZ_PATH=$HOME/.mytemplitz:$HOME/.myothertemplitz

Then your own templitz will be found automatically. Note that the first templit found that matches the given -t parameter is the one that hits, and the TEMPLITZ_PATH setting is checked first.

Reference

$ templitz --help
usage: templitz.py [-h] [-t TEMPLATE] [-i] [-l] [-s] [-o OUTDIR]
                   [-p PARAMS [PARAMS ...]]

optional arguments:
  -h, --help            show this help message and exit
  -t TEMPLATE, --template TEMPLATE
  -i, --info            Information about the templit.
  -l, --list            List all available templitz.
  -s, --stdout          Write to stdout instead of file.
  -o OUTDIR, --outdir OUTDIR
                        Output directory.
  -p PARAMS [PARAMS ...], --params PARAMS [PARAMS ...]

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 templitz, version 2017.10.3
Filename, size File type Python version Upload date Hashes
Filename, size templitz-2017.10.3-py2.py3-none-any.whl (18.3 kB) File type Wheel Python version py2.py3 Upload date Hashes View hashes
Filename, size templitz-2017.10.3.tar.gz (11.3 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 SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page