bootstrapper 0.1

Bootstrap Python projects with virtualenv and pip.

Bootstrap Python project by creating virtual environment, installing all requirements there and execute post-bootstrap hooks if any.

Also supported creating virtual environments not only for default requirements file (named major, by default: requirements.txt), but for any other files (named minor), which matched mask requirements-(.*).txt, where requirements and txt could be changed manually if not default requirements file would be used.

Requirements

• Python 2.6 or 2.7

• virtualenv 1.7 or higher

• argparse (optional, only needed for Python 2.6)

• virtualenv-clone (optional, needed only when you want to create virtual environments for minor requirements as copy of major virtual environment)

Installation

As easy as:

# pip install bootstrapper

Configuration

You may configure any option of bootstrapper, virtualenv and pip by setting it in bootstrap.cfg file. For example:

[bootstrapper]
copy_virtualenv = True

[pip]
quiet = True

[virtualenv]
system_site_packages = True
quiet = True

By default, next configuration would be used:

[pip]
download_cache = {env}/src/

[virtualenv]
distribute = True

So, if you not rewrite this options they would be auto-added to your configuration. Also, all bootstrap configuration would be overwrited by values from command line.

Usage

$ bootstrapper --help
usage: bootstrapper [-h] [-v] [-c CONFIG] [-e ENV] [-r REQUIREMENTS]
                [-p PRE_REQUIREMENTS [PRE_REQUIREMENTS ...]] [-C HOOK]
                [-H] [--copy-virtualenv] [--recreate-virtualenv]
                [--only-major] [-q]
                [dest]

Bootstrap Python projects with virtualenv and pip.

positional arguments:
  dest                  Bootstrap project using only this minor requirements.
                        By default major requirements file and all minor files
                        would be used for bootstrapping.

optional arguments:
  -h, --help            show this help message and exit
  -v, --version         show program's version number and exit
  -c CONFIG, --config CONFIG
                        Path to config file. By default: bootstrap.cfg
  -e ENV, --env ENV     Name of major virtual environment. By default: env
  -r REQUIREMENTS, --requirements REQUIREMENTS
                        Path to major requirements file. By default:
                        requirements.txt
  -p PRE_REQUIREMENTS [PRE_REQUIREMENTS ...], --pre-requirements PRE_REQUIREMENTS [PRE_REQUIREMENTS ...]
                        List pre-requirements to check separated by space.
  -C HOOK, --hook HOOK  Execute this hook after bootstrap process.
  -H, --hook-all        Execute HOOK in each virtualenv, not only in major
                        one.
  --copy-virtualenv     Create virtualenv for minor requirements by copying
                        major virtualenv. NOTE: If minor venv already exists
                        copy process would be aborted to avoid "dest dir
                        exists" error.
  --recreate-virtualenv
                        Recreate virtualenv each time, does not care about
                        exists of env at disk.
  --only-major          Create only major virtual environment, ignore all
                        other requirements files.
  -q, --quiet           Minimize output, show only error messages.