Skip to content

Commit fc6f420

Browse files
jeanaswebknjaz
authored andcommitted
Sort tools alphabetically
1 parent 620222c commit fc6f420

File tree

1 file changed

+15
-13
lines changed

1 file changed

+15
-13
lines changed

source/guides/tool-recommendations.rst

Lines changed: 15 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -63,11 +63,21 @@ environment, for reproducibility purposes.
6363
Build backends
6464
==============
6565

66-
Popular :term:`build backends <build backend>` for pure-Python packages include:
66+
Popular :term:`build backends <build backend>` for pure-Python packages include,
67+
in alphabetical order:
68+
69+
- Flit-core_ (developed with but separate from :ref:`Flit`). It is meant to be a
70+
minimal and opinionated build backend. It is not extensible.
6771

6872
- Hatchling_, which is developed along with :ref:`Hatch`, but is separate and can
6973
be used without Hatch. Hatchling is extensible through a plugin system.
7074

75+
- PDM-backend_ (developed with but separate from :ref:`PDM`). It provides build
76+
hooks for extensibility.
77+
78+
- Poetry-core_ (developed with but separate from :ref:`Poetry`). It is extensible
79+
through plugins.
80+
7181
- :ref:`setuptools` (which used to be the only build backend). It can be configured
7282
programmatically through the :file:`setup.py` file (but for basic metadata,
7383
:file:`pyproject.toml` is preferred).
@@ -80,15 +90,6 @@ Popular :term:`build backends <build backend>` for pure-Python packages include:
8090
<pyproject-guide-build-system-table>` of :file:`pyproject.toml` instead), or
8191
the ``easy_install`` command (cf. :ref:`pip vs easy_install`).
8292

83-
- Flit-core_ (developed with but separate from :ref:`Flit`). It is meant to be a
84-
minimal and opinionated build backend. It is not extensible.
85-
86-
- PDM-backend_ (developed with but separate from :ref:`PDM`). It provides build
87-
hooks for extensibility.
88-
89-
- Poetry-core_ (developed with but separate from :ref:`Poetry`). It is extensible
90-
through plugins.
91-
9293
Do **not** use :ref:`distutils`, which is deprecated, and has been removed from
9394
the standard library in Python 3.12, although it still remains available from
9495
setuptools.
@@ -139,13 +140,14 @@ Integrated workflow tools
139140
These are tools that combine many features in one command line application, such
140141
as automatically managing virtual environments for a project, building
141142
distributions, uploading to PyPI, or creating and using (tool-specific) lock
142-
files. They often call the tools mentioned above under the hood.
143+
files. They often call the tools mentioned above under the hood. In alphabetical
144+
order:
143145

144-
- :ref:`Hatch`,
145146
- :ref:`Flit`,
147+
- :ref:`Hatch`,
146148
- :ref:`PDM`,
149+
- :ref:`Pipenv`,
147150
- :ref:`Poetry`.
148-
- :ref:`Pipenv`
149151

150152

151153
.. _flit-core: https://pypi.org/project/flit-core/

0 commit comments

Comments
 (0)