@@ -22,19 +22,19 @@ three possible TOML tables in this file.
22
22
23
23
.. note ::
24
24
25
- There is a significant difference between the ``[build-system] `` and
26
- ``[project] `` tables. The former should always be present, regardless of
27
- which build backend you use (since it *defines * the tool you use). The latter
28
- is understood by *most * build backends, but some build backends use a
29
- different format.
25
+ The ``[build-system] `` table should always be present,
26
+ regardless of which build backend you use (``[build-system] `` *defines * the
27
+ build tool you use).
30
28
31
- At the time of writing this (November 2023), Poetry _ is a notable build
32
- backend that does not use the ``[project] `` table (it uses the
33
- ``[tool.poetry] `` table instead).
29
+ On the other hand, the ``[project] `` table is understood by *most * build
30
+ backends, but some build backends use a different format.
34
31
32
+ As of August 2024, Poetry _ is a notable build backend that does not use
33
+ the ``[project] `` table, it uses the ``[tool.poetry] `` table instead.
35
34
Also, the setuptools _ build backend supports both the ``[project] `` table,
36
- and the older format in ``setup.cfg `` or ``setup.py ``. For new projects, it
37
- is recommended to use the ``[project] `` table, and keep ``setup.py `` only if
35
+ and the older format in ``setup.cfg `` or ``setup.py ``.
36
+
37
+ For new projects, use the ``[project] `` table, and keep ``setup.py `` only if
38
38
some programmatic configuration is needed (such as building C extensions),
39
39
but the ``setup.cfg `` and ``setup.py `` formats are still valid. See
40
40
:ref: `setup-py-deprecated `.
0 commit comments