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

jaraco · web-flow · commit 05cb3c84f142 · 2025-05-26T20:36:39.000-04:00
Set a deadline for pkg_resources removal
diff --git a/newsfragments/3085.feature.1.rst b/newsfragments/3085.feature.1.rst
@@ -0,0 +1 @@
+Set a deadline for the removal of pkg_resources later this year (December).
diff --git a/pkg_resources/__init__.py b/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,
 )
 
diff --git a/pytest.ini b/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

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+Set a deadline for the removal of pkg_resources later this year (December).`