Skip to main content
To find out what's new in this version of Invoke, please see `the changelog
<http://pyinvoke.org/changelog.html#0.16.0>`_.

Invoke is a Python (2.6+ and 3.3+) 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:

.. code-block:: python

from invoke import task

@task
def clean(ctx, 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:
ctx.run("rm -rf {0}".format(pattern))

@task
def build(ctx, docs=False):
ctx.run("python setup.py build")
if docs:
ctx.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

* Where Fabric 1.x considered the command-line approach the default mode of
use, Invoke (and tools built on it) are equally at home embedded in your own
Python code or a REPL:

.. testsetup:: blurb

fakeout = """
Hello, this is pip
Installing is fun
Fake output is fake
Successfully installed invocations-0.13.0 pep8-1.5.7 spec-1.3.1
"""
proc = MockSubprocess(out=fakeout, exit=0)

.. testcleanup:: blurb

proc.stop()

.. doctest:: blurb

>>> from invoke import run
>>> cmd = "pip install -r requirements.txt"
>>> result = run(cmd, hide=True, warn=True)
>>> print(result.ok)
True
>>> print(result.stdout.splitlines()[-1])
Successfully installed invocations-0.13.0 pep8-1.5.7 spec-1.3.1

* 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://pyinvoke.org. Post-install usage information may be found in ``invoke
--help``.

You can install the development version via ``pip install -e
git+https://github.com/pyinvoke/invoke#egg=invoke``.

Release files for invoke 0.16.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for invoke 0.16.0
File Size Uploaded
invoke-0.16.0.tar.gz 288.4 kB Details

Built distributions (wheels)

Table of built distributions (wheels) for invoke 0.16.0
File Interpreter ABI Platform
invoke-0.16.0-py3-none-any.whl Python 3 none any Details
invoke-0.16.0-py2-none-any.whl Python 2 none any Details

Total release size: 574.3 kB

Release files / invoke-0.16.0.tar.gz

Download URL invoke-0.16.0.tar.gz
Size 288.4 kB
Tags Source
SHA-256 checksum
How to use checksums
61f1b7a4b3cb942ce92cb3f75cea8c69cc7c6106bea321772d35d74090cf9992
BLAKE2b-256 checksum
How to use checksums
c02c425bfd4796538c4bb76885d6761fae81bbe116f3966ae82688fcf95d2dfe
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / invoke-0.16.0-py3-none-any.whl

Download URL invoke-0.16.0-py3-none-any.whl
Size 142.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d7b7a4154785e3b6d3264a07fc882d1921c23a7ede81b8a712db6a7084133b4c
BLAKE2b-256 checksum
How to use checksums
69b1ef3d9738c3dfd237d6e6ae263b5bb63181d4c6b58048d3cd247e29f4c292
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / invoke-0.16.0-py2-none-any.whl

Download URL invoke-0.16.0-py2-none-any.whl
Size 143.4 kB
Tags Python 2
SHA-256 checksum
How to use checksums
2a1914e4878e6bdea1bd7a721bde115fe18a7513f09bd60e48a2358927e18e10
BLAKE2b-256 checksum
How to use checksums
ea617b991653c501f4e05fa07b7a98d55fc7c9320b1bb6b868c5d3398b325670
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

3.0.3

2 release files

3.0.2

2 release files

3.0.1

2 release files

3.0.0

2 release files

2.2.1

2 release files

2.2.0

2 release files

2.1.4

2 release files

2.1.3

2 release files

2.1.2

2 release files

2.1.1

2 release files

2.1.0

2 release files

2.0.1

2 release files

2.0.0

2 release files

1.7.3

2 release files

1.7.2

2 release files

1.7.1

2 release files

1.7.0

2 release files

1.6.0

3 release files

1.5.1

3 release files

1.5.0

3 release files

1.4.1

3 release files

1.4.0

3 release files

1.3.1

3 release files

1.3.0

3 release files

1.2.0

3 release files

1.1.1

3 release files

1.1.0

3 release files

1.0.2

3 release files

1.0.1

3 release files

1.0.0

3 release files

0.23.0

3 release files

0.22.1

3 release files

0.22.0

3 release files

0.21.0

3 release files

0.20.4

3 release files

0.20.1

3 release files

0.20.0

3 release files

0.19.0

3 release files

0.16.3

3 release files

0.16.2

3 release files

0.16.1

3 release files

This release

0.16.0 This release

3 release files

0.15.0

3 release files

0.12.0

2 release files

0.10.1

3 release files

0.10.0

3 release files

0.9.0

1 release file

0.8.2

1 release file

0.8.1

1 release file

0.8.0

1 release file

0.7.0

1 release file

0.6.1

1 release file

0.6.0

1 release file

0.5.1

1 release file

0.5.0

1 release file

0.4.0

1 release file

0.3.0

1 release file

0.2.0

1 release file

0.1

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page