Skip to content

Commit c8fafd8

Browse files
authored
Apply suggestions from code review
1 parent 0049ff8 commit c8fafd8

File tree

1 file changed

+7
-4
lines changed

1 file changed

+7
-4
lines changed

source/tutorials/packaging-projects.rst

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -107,12 +107,13 @@ Choosing a build backend
107107
-----------------------
108108

109109
Tools like :ref:`pip` and :ref:`build` do not actually convert your sources
110-
into a :term:`distribution package <Distribution Package>`;
110+
into a :term:`distribution package <Distribution Package>` (like a wheel);
111111
that job is performed by a _build backend_. The build backend determines how
112112
your project will specify its configuration, including metadata (information
113113
about the project, for example, the name and tags that are displayed on PyPI)
114-
and input files. Build backends have different levels of functionality, and
115-
you should choose one that suits your needs, but also meets your preferences.
114+
and input files. Build backends have different levels of functionality, such as
115+
whether they support building :term:`extension modules <Extension Module>`, and
116+
you should choose one that suits your needs and preferences.
116117

117118
You can choose from a number of backends; this tutorial uses :ref:`Hatchling
118119
<hatch>` by default, but it will work identically with :ref:`setuptools`,
@@ -165,7 +166,9 @@ for more details.
165166
166167
167168
The ``requires`` key is a list of packages that are needed to build your package.
168-
The front end should install them automatically when building your package.
169+
The frontend should install them automatically when building your package.
170+
Frontends usually run builds in isolated environments, so omitting dependencies
171+
here may cause build-time errors.
169172
This should always include your backend's package, and might have other build-time
170173
dependencies.
171174

0 commit comments

Comments
 (0)