From 307f8b15e0166a184418c6c5b0b1443a3138b3d4 Mon Sep 17 00:00:00 2001 From: William Woodruff Date: Tue, 10 Feb 2026 12:29:08 -0500 Subject: [PATCH 1/2] Remove dead link to pkg_resources Signed-off-by: William Woodruff --- source/guides/packaging-namespace-packages.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/guides/packaging-namespace-packages.rst b/source/guides/packaging-namespace-packages.rst index 3d929d527..1fa3ea64d 100644 --- a/source/guides/packaging-namespace-packages.rst +++ b/source/guides/packaging-namespace-packages.rst @@ -159,8 +159,8 @@ Legacy namespace packages These two methods, that were used to create namespace packages prior to :pep:`420`, are now considered to be obsolete and should not be used unless you need compatibility -with packages already using this method. Also, :doc:`pkg_resources ` -has been deprecated. +with packages already using this method. Also, ``pkg_resources`` has been deprecated +(and is fully removed in setuptools 82.0.0). To migrate an existing package, all packages sharing the namespace must be migrated simultaneously. From b26e2c4fa6700f9a3d1386176cf53c4ebe1fe6a9 Mon Sep 17 00:00:00 2001 From: William Woodruff Date: Tue, 10 Feb 2026 16:35:09 -0500 Subject: [PATCH 2/2] Remove more dead references Signed-off-by: William Woodruff --- source/guides/multi-version-installs.rst | 4 ---- source/guides/packaging-namespace-packages.rst | 14 +++++++++----- 2 files changed, 9 insertions(+), 9 deletions(-) diff --git a/source/guides/multi-version-installs.rst b/source/guides/multi-version-installs.rst index a09bc900a..456ee22e2 100644 --- a/source/guides/multi-version-installs.rst +++ b/source/guides/multi-version-installs.rst @@ -37,7 +37,3 @@ time, but that approach does mean that standard command line invocations of the affected tools can't be used - it's necessary to write a custom wrapper script or use ``python3 -c ''`` to invoke the application's main entry point directly. - -Refer to the `pkg_resources documentation -`__ -for more details. diff --git a/source/guides/packaging-namespace-packages.rst b/source/guides/packaging-namespace-packages.rst index 1fa3ea64d..a3940b715 100644 --- a/source/guides/packaging-namespace-packages.rst +++ b/source/guides/packaging-namespace-packages.rst @@ -157,10 +157,16 @@ the `native namespace package example project`_. Legacy namespace packages ------------------------- +.. warning:: + + The information in this section is obsolete and is no longer functional + (as of Setuptools 82.0.0). It is only retained for historical reference. + + ``pkg_resources`` has been deprecated and was fully removed in Setuptools 82.0.0. + These two methods, that were used to create namespace packages prior to :pep:`420`, are now considered to be obsolete and should not be used unless you need compatibility -with packages already using this method. Also, ``pkg_resources`` has been deprecated -(and is fully removed in setuptools 82.0.0). +with packages already using this method. To migrate an existing package, all packages sharing the namespace must be migrated simultaneously. @@ -216,7 +222,7 @@ in the `pkgutil namespace example project`_. pkg_resources-style namespace packages ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -:doc:`Setuptools ` provides the `pkg_resources.declare_namespace`_ function and +:doc:`Setuptools ` previously provided the ``pkg_resources.declare_namespace`` function and the ``namespace_packages`` argument to :func:`~setuptools.setup`. Together these can be used to declare namespace packages. While this approach is no longer recommended, it is widely present in most existing namespace packages. @@ -285,7 +291,5 @@ to :func:`~setuptools.setup` in :file:`setup.py`. For example: A complete working example of two pkg_resources-style namespace packages can be found in the `pkg_resources namespace example project`_. -.. _pkg_resources.declare_namespace: - https://setuptools.readthedocs.io/en/latest/pkg_resources.html#namespace-package-support .. _pkg_resources namespace example project: https://github.com/pypa/sample-namespace-packages/tree/master/pkg_resources