1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
|
============
Installation
============
``build`` can be installed via `pip`_ or an equivalent:
.. code-block:: sh
$ pip install build
You can also check out the latest `git tag`_, download a tarball_ from GitHub, or
manually fetch the artifacts from the `project page`_ on PyPI. `Attestations
<https://github.com/pypa/build/attestations>`_ are available after 1.2.1 and
can be verified with the ``gh`` CLI tool:
.. code-block:: sh
$ python -m pip --no-cache-dir download --no-deps build
$ gh attestation verify build*.whl --repo pypa/build
Build plans to support `PEP 740 <https://peps.python.org/pep-0740>`_ if
accepted.
.. tip::
If you prefer, or are already using virtualenv_ in your workflow, you can
install ``build`` with the optional ``virtualenv`` dependency:
.. code-block:: sh
$ 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).
There is also a ``uv`` extra, which can be used for ``--installer=uv`` if
you don't have another install of ``uv`` available.
Bootstrapping
=============
This package can build itself only with the ``tomli`` (can be omitted in Python 3.11+)
and ``pyproject-hooks`` dependencies.
The ``--skip-dependency-check`` flag should be used in this case.
Compatibility
=============
``build`` is verified to be compatible with the following Python
versions:
- 3.8
- 3.9
- 3.10
- 3.11
- 3.12
- PyPy3
.. _pipx: https://github.com/pipxproject/pipx
.. _pip: https://github.com/pypa/pip
.. _PyPI: https://pypi.org/
.. _tox: https://tox.readthedocs.org/
.. _virtualenv: https://virtualenv.pypa.io
.. _venv: https://docs.python.org/3/library/venv.html
.. _tarball: https://github.com/pypa/build/releases
.. _git tag: https://github.com/pypa/build/tags
.. _project page: https://pypi.org/project/build/
.. _tomli: https://github.com/hukkin/tomli
.. |3DCE51D60930EBA47858BA4146F633CBB0EB4BF2| replace:: ``3DCE51D60930EBA47858BA4146F633CBB0EB4BF2``
.. _3DCE51D60930EBA47858BA4146F633CBB0EB4BF2: https://keyserver.ubuntu.com/pks/lookup?op=get&search=0x3dce51d60930eba47858ba4146f633cbb0eb4bf2
|
