Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 0 additions & 1 deletion source/discussions/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,6 @@ specific topic. If you're just trying to get stuff done, see

versioning
deploying-python-applications
pip-vs-easy-install
install-requires-vs-requirements
distribution-package-vs-import-package
package-formats
Expand Down
71 changes: 0 additions & 71 deletions source/discussions/pip-vs-easy-install.rst

This file was deleted.

11 changes: 4 additions & 7 deletions source/guides/tool-recommendations.rst
Original file line number Diff line number Diff line change
Expand Up @@ -44,10 +44,8 @@ For scientific software specifically, consider :ref:`Conda` or :ref:`Spack`.

.. todo:: Write a "pip vs. Conda" comparison, here or in a new discussion.

Do **not** use ``easy_install`` (part of :ref:`setuptools`), which is deprecated
in favor of pip (see :ref:`pip vs easy_install` for details). Likewise, do
**not** use ``python setup.py install`` or ``python setup.py develop``, which
are also deprecated (see :ref:`setup-py-deprecated` for background and
Do **not** use ``python setup.py install`` or ``python setup.py develop``, which
are deprecated (see :ref:`setup-py-deprecated` for background and
:ref:`modernize-setup-py-project` for migration advice).


Expand Down Expand Up @@ -100,10 +98,9 @@ in alphabetical order:
:file:`setup.py` only if programmatic configuration is needed. See
:ref:`setup-py-deprecated`.

Other examples of deprecated features you should **not** use include the
Another example of a deprecated feature you should **not** use is the
``setup_requires`` argument to ``setup()`` (use the :ref:`[build-system] table
<pyproject-guide-build-system-table>` in :file:`pyproject.toml` instead), and
the ``easy_install`` command (cf. :ref:`pip vs easy_install`).
<pyproject-guide-build-system-table>` in :file:`pyproject.toml` instead).

Do **not** use :ref:`distutils`, which is deprecated, and has been removed from
the standard library in Python 3.12, although it still remains available from
Expand Down
1 change: 0 additions & 1 deletion source/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -83,7 +83,6 @@ The :doc:`discussions/index` section provides in-depth explanations and discussi
about topics, such as:

* :doc:`discussions/deploying-python-applications`
* :doc:`discussions/pip-vs-easy-install`

Reference
=========
Expand Down
9 changes: 4 additions & 5 deletions source/key_projects.rst
Original file line number Diff line number Diff line change
Expand Up @@ -268,7 +268,6 @@ process, to check that their package descriptions will properly
display on PyPI.

.. _setuptools:
.. _easy_install:

Setuptools
==========
Expand All @@ -278,10 +277,10 @@ Setuptools
`GitHub <https://github.com/pypa/setuptools>`__ |
`PyPI <https://pypi.org/project/setuptools>`__

Setuptools (which includes ``easy_install``) is a collection of
enhancements to the Python distutils that allow you to more easily
build and distribute Python :term:`distributions <Distribution
Package>`, especially ones that have dependencies on other packages.
Setuptools is a collection of enhancements to the Python distutils
that allow you to more easily build and distribute Python
:term:`distributions <Distribution Package>`, especially ones that
have dependencies on other packages.

.. _trove-classifiers:

Expand Down
10 changes: 2 additions & 8 deletions source/specifications/externally-managed-environments.rst
Original file line number Diff line number Diff line change
Expand Up @@ -82,16 +82,10 @@ Python-specific package manager
A tool for installing, upgrading, and/or removing Python packages
in a manner that conforms to Python packaging standards.
The most popular Python-specific package
manager is pip_; other examples include the old `Easy
Install command <easy-install_>`_ as well as direct usage of a
``setup.py`` command.
manager is pip_. Another popular example is uv_.

.. _pip: https://pip.pypa.io/en/stable/
.. _easy-install: https://setuptools.readthedocs.io/en/latest/deprecated/easy_install.html

(Note that the ``easy_install`` command was removed in
setuptools version 52, released 23 January 2021.)

.. _uv: https://docs.astral.sh/uv/

(Conda_ is a bit of a special case, as the ``conda``
command can install much more than just Python packages, making it
Expand Down
Loading