Skip to content

Commit 330d33c

Browse files
jeanaswebknjaz
authored andcommitted
Present tox/nox along workflow tools
1 parent 44f086f commit 330d33c

File tree

1 file changed

+12
-17
lines changed

1 file changed

+12
-17
lines changed

source/guides/tool-recommendations.rst

Lines changed: 12 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -144,29 +144,24 @@ The other available method is to upload the package manually using :ref:`twine`.
144144
:ref:`deprecated <setup-py-deprecated>`, it is insecure.
145145

146146

147-
Task runners
148-
============
149-
150-
These tools allow you to define and invoke "tasks", such as running tests,
151-
compiling documentation, regenerating some files, etc. Each task can be executed
152-
in a dedicated virtual environment with the dependencies it requires. The most
153-
common tools for this are :doc:`tox <tox:index>` and :doc:`nox <nox:index>`.
154-
155-
156-
Integrated workflow tools
157-
=========================
147+
Workflow tools
148+
==============
158149

159-
These are tools that combine many features in one command line application, such
160-
as automatically managing virtual environments for a project, building
161-
distributions, uploading to PyPI, or creating and using (tool-specific) lock
162-
files. They often call the tools mentioned above under the hood. In alphabetical
163-
order:
150+
These tools are environment managers that automatically manage virtual
151+
environments for a project. They also act as "task runners", allowing you to
152+
define and invoke tasks such as running tests, compiling documentation,
153+
regenerating some files, etc. Some of them provide shortcuts for building
154+
distributions and uploading to PyPI, and some support lock files for
155+
applications. They often call the tools mentioned above under the hood. In
156+
alphabetical order:
164157

165158
- :ref:`Flit`,
166159
- :ref:`Hatch`,
160+
- :doc:`nox <nox:index>`,
167161
- :ref:`PDM`,
168162
- :ref:`Pipenv`,
169-
- :ref:`Poetry`.
163+
- :ref:`Poetry`,
164+
- :doc:`tox <tox:index>`.
170165

171166

172167
.. _hatchling: https://pypi.org/project/hatchling/

0 commit comments

Comments
 (0)