Move warning definition above implicit behavior on import. Fixes #2846.

jaraco · jaraco · commit 30f070eeb27a · 2021-11-03T17:59:05.000-04:00
diff --git a/changelog.d/2486.misc.rst b/changelog.d/2486.misc.rst
@@ -0,0 +1 @@
+Move PkgResourcesDeprecationWarning above implicitly-called function so that it's in the namespace when version warnings are generated in an environment that contains them.
diff --git a/pkg_resources/__init__.py b/pkg_resources/__init__.py
@@ -3244,6 +3244,15 @@ def _initialize(g=globals()):
     )
 
 
+class PkgResourcesDeprecationWarning(Warning):
+    """
+    Base class for warning about deprecations in ``pkg_resources``
+
+    This class is not derived from ``DeprecationWarning``, and as such is
+    visible by default.
+    """
+
+
 @_call_aside
 def _initialize_master_working_set():
     """
@@ -3282,12 +3291,3 @@ def _initialize_master_working_set():
     # match order
     list(map(working_set.add_entry, sys.path))
     globals().update(locals())
-
-
-class PkgResourcesDeprecationWarning(Warning):
-    """
-    Base class for warning about deprecations in ``pkg_resources``
-
-    This class is not derived from ``DeprecationWarning``, and as such is
-    visible by default.
-    """

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+Move PkgResourcesDeprecationWarning above implicitly-called function so that it's in the namespace when version warnings are generated in an environment that contains them.`