138 lines
5.5 KiB
Plaintext
138 lines
5.5 KiB
Plaintext
Metadata-Version: 2.4
|
|
Name: build
|
|
Version: 1.3.0
|
|
Summary: A simple, correct Python build frontend
|
|
Author-email: Filipe Laíns <lains@riseup.net>, Bernát Gábor <gaborjbernat@gmail.com>, layday <layday@protonmail.com>, Henry Schreiner <henryschreineriii@gmail.com>
|
|
Requires-Python: >= 3.9
|
|
Description-Content-Type: text/markdown
|
|
License-Expression: MIT
|
|
Classifier: Programming Language :: Python :: 3
|
|
Classifier: Programming Language :: Python :: 3 :: Only
|
|
Classifier: Programming Language :: Python :: 3.9
|
|
Classifier: Programming Language :: Python :: 3.10
|
|
Classifier: Programming Language :: Python :: 3.11
|
|
Classifier: Programming Language :: Python :: 3.12
|
|
Classifier: Programming Language :: Python :: 3.13
|
|
Classifier: Programming Language :: Python :: 3.14
|
|
Classifier: Programming Language :: Python :: Implementation :: CPython
|
|
Classifier: Programming Language :: Python :: Implementation :: PyPy
|
|
License-File: LICENSE
|
|
Requires-Dist: packaging >= 19.1
|
|
Requires-Dist: pyproject_hooks
|
|
Requires-Dist: colorama; os_name == "nt"
|
|
Requires-Dist: importlib-metadata >= 4.6; python_full_version < "3.10.2"
|
|
Requires-Dist: tomli >= 1.1.0; python_version < "3.11"
|
|
Requires-Dist: uv >= 0.1.18 ; extra == "uv"
|
|
Requires-Dist: virtualenv >= 20.11 ; extra == "virtualenv" and ( python_version < '3.10')
|
|
Requires-Dist: virtualenv >= 20.17 ; extra == "virtualenv" and ( python_version >= '3.10' and python_version < '3.14')
|
|
Requires-Dist: virtualenv >= 20.31 ; extra == "virtualenv" and ( python_version >= '3.14')
|
|
Project-URL: changelog, https://build.pypa.io/en/stable/changelog.html
|
|
Project-URL: homepage, https://build.pypa.io
|
|
Project-URL: issues, https://github.com/pypa/build/issues
|
|
Project-URL: source, https://github.com/pypa/build
|
|
Provides-Extra: uv
|
|
Provides-Extra: virtualenv
|
|
|
|
# build
|
|
|
|
[](https://results.pre-commit.ci/latest/github/pypa/build/main)
|
|
[](https://github.com/pypa/build/actions/workflows/test.yml)
|
|
[](https://codecov.io/gh/pypa/build)
|
|
|
|
[](https://build.pypa.io/en/latest/?badge=latest)
|
|
[](https://pypi.org/project/build/)
|
|
[](https://discord.gg/pypa)
|
|
|
|
A simple, correct Python build frontend.
|
|
|
|
See the [documentation](https://build.pypa.io) 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](https://build.pypa.io) 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
|
|
- `-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 and 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.
|
|
|
|
### 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]"
|
|
```
|
|
|
|
(Be sure to pre-install uv before running cibuildwheel for this one!)
|
|
|
|
#### Conda-forge
|
|
|
|
On conda-forge, this package is called [python-build][].
|
|
|
|
### Code of Conduct
|
|
|
|
Everyone interacting in the build's codebase, issue trackers, chat rooms, and mailing lists is expected to follow
|
|
the [PSF Code of Conduct].
|
|
|
|
[psf code of conduct]: https://github.com/pypa/.github/blob/main/CODE_OF_CONDUCT.md
|
|
[pipx]: https://pipx.pypa.io
|
|
[uv]: https://docs.astral.sh/uv/
|
|
[cibuildwheel]: https://cibuildwheel.pypa.io
|
|
[python-build]: https://github.com/conda-forge/python-build-feedstock
|
|
|