OS Manuals

/usr/bin/pyproject-build

Executable binaries for build installed for python3.13

From py3.13-build-bin 1.6.1-r0 (os), captured 2026-11-05 by running pyproject-build --help (exit 0). permalink

usage: pyproject-build [-h] [--version] [--quiet | --verbose] [--outdir PATH]
                       [--sdist-extract-dir PATH] [--sdist] [--wheel] [--metadata] [--report PATH]
                       [--config-setting KEY=[VALUE] | --config-json JSON_STRING]
                       [--installer {pip,uv} | --no-isolation] [--env-dir PATH]
                       [--dependency-constraints-txt PATH] [--skip-dependency-check]
                       [srcdir]

    A simple, correct Python build frontend.

    By default, a source distribution (sdist) is built from the project root
    and a binary distribution (wheel) is built from the sdist.
    If this is undesirable, you can pass `--sdist` and/or `--wheel`
    to build distributions independently of each other.

positional arguments:
  srcdir                source directory, .tar.gz source distribution, or (with --metadata) a .whl
                        to read metadata from (defaults to the current working directory)

global options:
  -h, --help            show this help message and exit
  --version, -V         show program's version number and exit
  --quiet, -q           reduce verbosity
  --verbose, -v         increase verbosity

build options:
  --outdir, -o PATH     output directory (defaults to {srcdir}/dist). Cannot be used together with
                        ``--metadata``
  --sdist-extract-dir PATH
                        extract the intermediate sdist to PATH (created if missing and kept
                        afterwards) instead of a random temporary directory; reusing it across
                        rebuilds gives compiler caches such as ccache/sccache a stable source
                        path. Only affects the default (via-sdist) build and building a wheel from
                        an sdist
  --sdist, -s           build a source distribution (disables the default behavior)
  --wheel, -w           build a wheel (disables the default behavior)
  --metadata            print out a wheel's metadata in JSON format, building it first unless the
                        source argument is already a .whl. Cannot be used in conjunction with
                        ``--sdist`` or ``--wheel``
  --report PATH         write a machine-readable JSON report of the built artifacts (name, path,
                        kind, size and SHA-256 hash) to this path. Cannot be used together with
                        ``--metadata``
  --config-setting, -C KEY=[VALUE]
                        settings to pass to the backend. Multiple settings can be provided.
                        Settings beginning with a hyphen will erroneously be interpreted as
                        options to build if separated by a space; use ``--config-setting=--my-
                        setting -C--my-other-setting`` instead. A setting passed without
                        ``=VALUE`` is given an empty value, but this form is not supported by pip;
                        write ``KEY=`` instead for compatibility
  --config-json JSON_STRING
                        settings to pass to the backend as a JSON object. This is an alternative
                        to ``--config-setting`` that allows complex nested structures. Cannot be
                        used together with ``--config-setting``

installation options:
  --installer {pip,uv}  Python package installer to use (defaults to pip)
  --no-isolation, -n    disable building the project in an isolated virtual environment. Build
                        dependencies must be installed separately when this option is used
  --env-dir PATH        create the isolated build environment at this location instead of a
                        temporary directory. The location must be empty; it is removed on success
                        and kept on failure so it can be inspected
  --dependency-constraints-txt PATH
                        constrain build dependencies using a constraints.txt when installing
                        dependencies
  --skip-dependency-check, -x
                        do not check that build dependencies are installed
Options (17)
OptionDescriptionSource
-h, --helpshow this help message and exithelp
--version, -Vshow program's version number and exithelp
--quiet, -qreduce verbosityhelp
--verbose, -vincrease verbosityhelp
--outdir, -o PATHoutput directory (defaults to {srcdir}/dist).help
--sdist-extract-dir PATHextract the intermediate sdist to PATH (created if missing and kept afterwards) instead of a random temporary directory;help
--sdist, -sbuild a source distribution (disables the default behavior)help
--wheel, -wbuild a wheel (disables the default behavior)help
--metadataprint out a wheel's metadata in JSON format, building it first unless the source argument is already a .whl.help
--report PATHwrite a machine-readable JSON report of the built artifacts (name, path, kind, size and SHA-256 hash) to this path.help
--config-setting, -C KEY=[VALUEsettings to pass to the backend.help
--config-json JSON_STRINGsettings to pass to the backend as a JSON object.help
--installer pipPython package installer to use (defaults to pip)help
--no-isolation, -ndisable building the project in an isolated virtual environment.help
--env-dir PATHcreate the isolated build environment at this location instead of a temporary directory.help
--dependency-constraints-txt PATHconstrain build dependencies using a constraints.txt when installing dependencieshelp
--skip-dependency-check, -xdo not check that build dependencies are installedhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.