build

A simple, correct PEP 517 package builder.

build will invoke the PEP 517 hooks to build a distribution package. It is a simple build tool and does not perform any dependency management.

python -m build

usage: python -m build [-h] [--version] [--sdist] [--wheel] [--outdir dir]
                       [--skip-dependencies] [--no-isolation]
                       [--config-setting CONFIG_SETTING]
                       [srcdir]

srcdir

source directory (defaults to current directory)

-h, --help

show this help message and exit

--version, -V

show program’s version number and exit

--sdist, -s

build a source package

--wheel, -w

build a wheel

--outdir <dir>, -o <dir>

output directory (defaults to {srcdir}/dist)

--skip-dependencies, -x

does not check for the dependencies

--no-isolation, -n

do not isolate the build in a virtual environment

--config-setting <config_setting>, -C <config_setting>

pass option to the backend

Note

A pyproject-build CLI script is also available, so that tools such as pipx can use it.

By default build will build the package in a isolated environment, but this behavior can be disabled with --no-isolation.