# Buildsheet autogenerated by ravenadm tool -- Do not edit.

NAMEBASE=		python-build
VERSION=		1.4.2
KEYWORDS=		python
VARIANTS=		v13 v14
SDESC[v13]=		Simple, correct Python build frontend (3.13)
SDESC[v14]=		Simple, correct Python build frontend (3.14)
HOMEPAGE=		https://build.pypa.io
CONTACT=		Python_Automaton[python@ironwolf.systems]

DOWNLOAD_GROUPS=	main
SITES[main]=		PYPIWHL/4a/57/3b7d4dd193ade4641c865bc2b93aeeb71162e81fc348b8dad020215601ed
DISTFILE[1]=		build-1.4.2-py3-none-any.whl:main
DIST_SUBDIR=		python-src
DF_INDEX=		1
SPKGS[v13]=		single
SPKGS[v14]=		single

OPTIONS_AVAILABLE=	PY313 PY314
OPTIONS_STANDARD=	none
VOPTS[v13]=		PY313=ON PY314=OFF
VOPTS[v14]=		PY313=OFF PY314=ON

DISTNAME=		build-1.4.2.dist-info

GENERATED=		yes

[PY313].RUN_DEPENDS_ON=			python-packaging:single:v13
					python-pyproject_hooks:single:v13
					python-colorama:single:v13
					python-importlib-metadata:single:v13
[PY313].USES_ON=			python:v13,wheel

[PY314].RUN_DEPENDS_ON=			python-packaging:single:v14
					python-pyproject_hooks:single:v14
					python-colorama:single:v14
					python-importlib-metadata:single:v14
[PY314].USES_ON=			python:v14,wheel

[FILE:2791:descriptions/desc.single]
# build

[![pre-commit.ci
status]](https://results.pre-commit.ci/latest/github/pypa/build/main)
[CI test]
[codecov]

[Documentation Status]
[PyPI version]
[Discord]

A simple, correct Python build frontend.

See the [documentation] for more information.

### Installation

`build` can be installed via `pip` or an equivalent via:

```console
$ pip install build
```

### Usage

```console
$ python -m build
```

This will build the package in an isolated environment, generating a
source-distribution and wheel in the directory `dist/`. See the
[documentation] for full information. Build is also
available via the command line as `pyproject-build` once installed.

### Common arguments

- `--sdist` (`-s`): Produce just an SDist
- `--wheel` (`-w`): Produce just a wheel
- `--metadata`: Produce just the metadata as JSON. Cannot be used with
`--sdist`/`--wheel`.
- `-C<option>=<value>`: A Config-setting, the PEP 517 way of passing
options to a backend. Can be passed multiple times. Matching options will
make a list. Note that setuptools has very limited support.
- `--config-json=<value>`: An alternative way to pass in complex config
settings as JSON strings. Can't be used with `-C`.
- `--installer`: Pick an installer for the isolated build (`pip` or `uv`).
- `--no-isolation` (`-n`): Disable build isolation.
- `--skip-dependency-check` (`-x`): Disable dependency checking when not
isolated; this should be done if some requirements or version ranges are
not required for non-isolated builds.
- `--outdir` (`-o`): The output directory (defaults to `dist`)

Some common combinations of arguments:

- `--sdist --wheel` (`-sw`): Produce an SDist and a wheel, both from the
source distribution. The default (if no flag is passed) is to build an
SDist and then build a wheel _from_ the SDist.
- `-nx`: Disable build isolation and dependency checking. Identical to pip
and uv's `--no-build-isolation` flag.
- `--metadata | jq -r .version`: get the version in a bash-like
environment.

### Integration with other tools

#### pipx

If you use [pipx][], such as in GitHub Actions, the following command will
download
and run build in one step:

```console
$ pipx run build
```

#### uv

If you want to use [uv][] to speed up the virtual environment creation, you
can
use `--installer=uv`. You can get a Python wheel for `uv` with the `[uv]`
extra. For example, using pipx like above:

```console
$ pipx run 'build[uv]' --installer uv
```

If you already have uv, you don't need the extra. For example:

```console
$ uvx --from build pyproject-build --installer uv
```

#### cibuildwheel

If you are using [cibuildwheel][], build is integrated and the default
builder in 3.0+. If you want to use `uv` as the installer, you can use:

```toml
[tool.cibuildwheel]
build-frontend = "build[uv]"
```


[FILE:118:distinfo]
7a4d8651ea877cb2a89458b1b198f2e69f536c95e89129dbf5d448045d60db88        24643 python-src/build-1.4.2-py3-none-any.whl