boilerplate 1.0-beta

How it works?

myfancy_template/                                                      simpleapp/
  |-- config.py                 $> boil myfancy_template simpleapp        |-- __init__.py
  `-- tmpl/                     =================================>        `-- simpleapp.py
        |-- __init__.py
        `-- _$project_name$_.py

Boilerplate simply creates project / app structure on the given template basis. You can configurate context variables (only variables) which you can use everywhere in your templates, even in files or directories structures.

How to install?

1. Pip:

   $> pip install boilerplate

2. Download and install:

   $> python setup.py install

3. Or directly from github:

   $> pip install -e git+git://github.com/jqb/boilerplate.git#egg=boilerplate

You need to have root privileges to install it in system packages.

Set up BOILERPLATE_TEMPLATES environ variable to tell boilerplate where it should search for your custom templates. It should be setup in your <dot>-file, eg in your .bashrc

export BOILERPLATE_TEMPLATES=$HOME/.boilerplate_temlplates

Usage

Boilerplate comes with “boil” command line. Here’s how you might use it.

1. listing existing templates:

   $> boil -l     # show list of all available templates, you can also type "boil --list"

2. creating new project from existing template:

   $> boil <template-name> <project-name>
   
   
   ``project_name`` and ``template_name`` variables are always available your
   template context.

3. creating new project template:

   $> cd $BOILERPLATE_TEMPLATES
   $> boil boil_template my_first_template

This is what you gonna get:

$BOILERPLATE_TEMPLATES/my_first_template/
   |-- __init__.py
   |-- config.py    # meta information about template, context variables for template engine
   `-- tmpl/        # template directory, name "tmpl" will be replaced with "project_name"
         `-- my_fancy_template_readme.txt

1. using my new project template:

   $> boil my_first_template myproject

TODO

• docs for all features available via Configuration objects