invoke

To find out what’s new in this version of Invoke, please see the changelog.

Invoke is a Python (2.6+ and 3.2+) task execution tool & library, drawing inspiration from various sources to arrive at a powerful & clean feature set.

Like Ruby’s Rake tool and Invoke’s own predecessor Fabric 1.x, it provides a clean, high level API for running shell commands and defining/organizing task functions from a tasks.py file:

from invoke import run, task

@task
def clean(docs=False, bytecode=False, extra=''):
    patterns = ['build']
    if docs:
        patterns.append('docs/_build')
    if bytecode:
        patterns.append('**/*.pyc')
    if extra:
        patterns.append(extra)
    for pattern in patterns:
        run("rm -rf %s" % pattern)

@task
def build(docs=False):
    run("python setup.py build")
    if docs:
        run("sphinx-build docs docs/_build")

From GNU Make, it inherits an emphasis on minimal boilerplate for common patterns and the ability to run multiple tasks in a single invocation:
```
$ invoke clean build
```
Following the lead of most Unix CLI applications, it offers a traditional flag-based style of command-line parsing, deriving flag names and value types from task signatures (optionally, of course!):
```
$ invoke clean --docs --bytecode build --docs --extra='**/*.pyo'
$ invoke clean -d -b build --docs -e '**/*.pyo'
$ invoke clean -db build -de '**/*.pyo'
```
Like many of its predecessors, it offers advanced features as well – namespacing, task aliasing, before/after hooks, parallel execution and more.

For documentation, including detailed installation information, please see http://docs.pyinvoke.org. Post-install usage information may be found in invoke --help.

You can install the development version via pip install invoke==dev.

Download files

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

Source Distribution

invoke-0.8.0.tar.gz (114.2 kB view details)

Uploaded Jun 9, 2014 Source

File details

Details for the file invoke-0.8.0.tar.gz.

File metadata

Download URL: invoke-0.8.0.tar.gz
Upload date: Jun 9, 2014
Size: 114.2 kB
Tags: Source
Uploaded using Trusted Publishing? No

File hashes

Hashes for invoke-0.8.0.tar.gz
Algorithm	Hash digest
SHA256	`2a67c10fd925f1486e56abb2e0f9e00c72414a17056ec9716f91f3bf21e30e90`
MD5	`7a774ee54973cea76eb6a14aa49593c4`
BLAKE2b-256	`72f3a152574c3e7b44d8eebfffee6bff286094edaa6c23c02ae9abc8d03135c2`