Skip to content

Commit 64b6a1f

Browse files
Julianbhrutledge
andauthored
Divorce the section on pip installing extras from setuptools (pypa#1130)
Per more recent PEPs (e.g. 621), extras may be produced by build tools other than setuptools if the packager isn't using setuptools as the build system. In this document, which is mostly about installing, it seems simpler then to avoid mentioning that setuptools defines the extras and to simply show the user how to do the install without mentioning what tool is involved in defining them. Co-authored-by: Brian Rutledge <[email protected]>
1 parent d530ba1 commit 64b6a1f

File tree

1 file changed

+6
-5
lines changed

1 file changed

+6
-5
lines changed

source/tutorials/installing-packages.rst

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -641,10 +641,13 @@ default, pip only finds stable versions.
641641
642642
py -m pip install --pre SomeProject
643643
644-
Installing Setuptools "Extras"
645-
==============================
644+
Installing "Extras"
645+
===================
646646

647-
Install `setuptools extras`_.
647+
Extras are optional "variants" of a package, which may include
648+
additional dependencies, and thereby enable additional functionality
649+
from the package. If you wish to install an extra for a package which
650+
you know publishes one, you can include it in the pip installation command:
648651

649652
.. tab:: Unix/macOS
650653

@@ -681,5 +684,3 @@ Install `setuptools extras`_.
681684
.. [4] The compatible release specifier was accepted in :pep:`440`
682685
and support was released in :ref:`setuptools` v8.0 and
683686
:ref:`pip` v6.0
684-
685-
.. _setuptools extras: https://setuptools.readthedocs.io/en/latest/userguide/dependency_management.html#optional-dependencies

0 commit comments

Comments
 (0)