Merge pull request #5014 from pypa/debt/pkg_resources-deadline

Set a deadline for pkg_resources removal

Author: jaraco

newsfragments/3085.feature.1.rst

@@ -0,0 +1 @@
+Set a deadline for the removal of pkg_resources later this year (December).

pkg_resources/__init__.py

@@ -97,8 +97,11 @@
 
 warnings.warn(
  "pkg_resources is deprecated as an API. "
- "See https://setuptools.pypa.io/en/latest/pkg_resources.html",
- DeprecationWarning,
+ "See https://setuptools.pypa.io/en/latest/pkg_resources.html. "
+ "The pkg_resources package is slated for removal as early as "
+ "2025-11-30. Refrain from using this package or pin to "
+ "Setuptools<81.",
+ UserWarning,
  stacklevel=2,
 )
 

pytest.ini

@@ -84,8 +84,8 @@ filterwarnings=
 # Avoid errors when testing pkg_resources.declare_namespace
 ignore:.*pkg_resources\.declare_namespace.*:DeprecationWarning
 
-# suppress known deprecation
-ignore:pkg_resources is deprecated:DeprecationWarning
+# suppress known deprecation pypa/setuptools#3085
+ignore:pkg_resources is deprecated:UserWarning
 
 # Dependencies might not have been updated yet
 default:onerror argument is deprecated, use onexc instead