Skip to main content


Project description


`PyBuilder <>`_

`|Build Status| <>`_ `|Windows
build status| <>`_
`|PyPI version| <>`_
Status| <>`_
`|Ready in backlog| <>`_ `|Open
bugs| <>`_

PyBuilder is a software build tool written in 100% pure Python, mainly
targeting Python applications.

PyBuilder is based on the concept of dependency based programming, but
it also comes with a powerful plugin mechanism, allowing the
construction of build life cycles similar to those known from other
famous (Java) build tools.

PyBuilder is running on the following versions of Python: 2.6, 2.7, 3.3,
3.4, 3.5 and PyPy.

See the `Travis Build <>`_ for
version specific output.


PyBuilder is available using pip:


$ pip install pybuilder

For development builds use:


$ pip install --pre pybuilder

See the `Cheeseshop
page <>`_ for more

Getting started

PyBuilder emphasizes simplicity. If you want to build a pure Python
project and use the recommended directory layout, all you have to do is
create a file with the following content:


from pybuilder.core import use_plugin


default_task = "publish"

See the `PyBuilder homepage <>`_ for more


PyBuilder provides a lot of plugins out of the box that utilize tools
and libraries commonly used in Python projects:

- `python.coverage <>`_
- Uses the standard
`coverage <>`_ module
to calculate unit test line coverage.
- `python.distutils <>`_
- Provides support to generate and use
` <>`_ files.
- **python.django** - Provides support for developing
`Django <>`_ applications.
- `python.frosted <>`_
- Lint source files with
`frosted <>`_
- `python.flake8 <>`_
- Provides support for
`flake8 <>`_
- `python.pep8 <>`_
- Provides support for
`pep8 <>`_
- `python.install\_dependencies <>`_
- Installs the projects build and runtime dependencies using ``pip``
- `python.pychecker <>`_
- Provides support for
`pychecker <>`_
- `python.Pydev <>`_
- Generates project files to import projects into `Eclipse
PyDev <>`_
- `python.PyCharm <>`_
- Generates project files to import projects into `Jetbrains
PyCharm <>`_
- `python.pylint <>`_
- Executes `pylint <>`_ on your
- `python.pymetrics <>`_
- Calculates several metrics using
`pymetrics <>`_
- `python.unittest <>`_
- Executes `unittest <>`_
test cases
- `python.integrationtest <>`_
- Executes python scripts as integrations tests
- `python.pytddmon <>`_
- Provides visual feedback about unit tests through
`pytddmon <>`_
- `python.cram <>`_
- Runs `cram <>`_ tests
- `python.sphinx <>`_
- Build your documentation with `sphinx <>`_
- `python.sonarqube <>`_
- Analyze your project with `SonarQube <>`_.
- python.snakefood - Analyze your code dependencies with
`snakefood <>`_.

In addition, a few common plugins are provided:

- `copy\_resources <>`_
- Copies files.
- `filter\_resources <>`_
- Filters files by replacing tokens with configuration values.
- `source\_distribution <>`_
- Bundles a source distribution for shipping.

External plugins: \*
`pybuilder\_aws\_plugin <>`_
- handle AWS functionality

Release Notes

The release notes can be found
`here <>`_. There will also be
a git tag with each release. Please note that we do not currently
promote tags to GitHub "releases".


See `developing
PyBuilder <>`_

.. |Build
Status| image::
.. |Windows build
status| image::
.. |PyPI version| image::
.. |Coverage
Status| image::
.. |Ready in
backlog| image::
.. |Open
bugs| image::

Release history Release notifications | RSS feed

Download files

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

Files for pybuilder, version 0.11.10
Filename, size File type Python version Upload date Hashes
Filename, size pybuilder-0.11.10.tar.gz (71.6 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page