Installation

You can download a tarball from Github, checkout the latest git tag or fetch the artifacts from project page on PyPI.

The recommended way is to checkout the git tags, as they are PGP signed with one of the following keys:

build may also be installed via pip or an equivalent:

$ pip install build

Tip

If you prefer, or are already using virtualenv in your workflow, you can install build with the optional virtualenv depedency:

$ pip install 'build[virtualenv]'

this way, build will use virtualenv for isolation, instead of venv. This can be particularly useful, for example, when using automation tools that rely on virtualenv, such as tox, or when your operating system’s Python package does not include venv in the standard installation (such as some versions of Ubuntu).

Bootstrapping

This package can build itself with only the toml and pep517 dependencies. The --skip-dependency-check flag should be used in this case.

We have a dependency on tomli, but toml can be used instead, which may make bootstraping easier.

Compatibility

build is verified to be compatible with the following Python versions:

  • 2.7

  • 3.5

  • 3.6

  • 3.7

  • 3.8

  • 3.9

  • PyPy(2)

  • PyPy3