@@ -18,24 +18,25 @@ Build system requirement
18
18
========================
19
19
20
20
After organizing all the scripts and files and getting ready for packaging,
21
- there needs to be a way to specify what programs and libraries are actually needed
22
- to do the packaging (in our case, ``setuptools `` of course).
23
- This needs to be specified in your ``pyproject.toml `` file
24
- (if you have forgot what this is, go to :doc: `/userguide/quickstart ` or :doc: `/build_meta `):
21
+ there needs to be a way to specify what programs and libraries (build backend)
22
+ are actually needed to build the package for distribution. For Setuptools, the
23
+ requisite library is ``setuptools ``. Specify the build backend in a
24
+ ``pyproject.toml `` file (see also :doc: `/userguide/quickstart ` or
25
+ :doc: `/build_meta `):
25
26
26
27
.. code-block :: toml
27
28
28
29
[build-system]
29
30
requires = ["setuptools"]
30
31
#...
31
32
32
- Please note that you should also include here any other ``setuptools `` plugin
33
- (e.g., :pypi: `setuptools-scm `, :pypi: `setuptools-golang `, :pypi: `setuptools-rust `)
33
+ Please note also to include any other ``setuptools `` plugins
34
+ (e.g., :pypi: `setuptools_scm `, :pypi: `setuptools-golang `, :pypi: `setuptools-rust `)
34
35
or build-time dependency (e.g., :pypi: `Cython `, :pypi: `cppy `, :pypi: `pybind11 `).
35
36
36
37
.. note ::
37
38
In previous versions of ``setuptools ``,
38
- this used to be accomplished with the ``setup_requires `` keyword but is
39
+ the ``setup_requires `` keyword performed a similar function but is
39
40
now considered deprecated in favor of the :pep: `517 ` style described above.
40
41
To peek into how this legacy keyword is used, consult our :doc: `guide on
41
42
deprecated practice (WIP) </deprecated/index>`.
0 commit comments