[WIP] surface LegacyVersion deprecation warnings

Author: sbidoul

src/pip/_vendor/packaging/specifiers.py

@@ -252,15 +252,17 @@ class LegacySpecifier(_IndividualSpecifier):
     def __init__(self, spec: str = "", prereleases: Optional[bool] = None) -> None:
         super().__init__(spec, prereleases)
 
-        warnings.warn(
-            "Creating a LegacyVersion has been deprecated and will be "
-            "removed in the next major release",
-            DeprecationWarning,
+        from pip._internal.utils.deprecation import deprecated
+
+        deprecated(
+            reason=(f"This form of version specifier ({spec}) has been deprecated."),
+            replacement="use PEP 440 compatible version specifiers",
+            gone_in="23.2",
         )
 
     def _coerce_version(self, version: UnparsedVersion) -> LegacyVersion:
         if not isinstance(version, LegacyVersion):
-            version = LegacyVersion(str(version))
+            version = LegacyVersion(str(version), silence_deprecation_warning=True)
         return version
 
     def _compare_equal(self, prospective: LegacyVersion, spec: str) -> bool:

src/pip/_vendor/packaging/version.py

@@ -104,15 +104,22 @@ def __ne__(self, other: object) -> bool:
 
 
 class LegacyVersion(_BaseVersion):
-    def __init__(self, version: str) -> None:
+    def __init__(
+        self,
+        version: str,
+        silence_deprecation_warning: bool = False,
+    ) -> None:
         self._version = str(version)
         self._key = _legacy_cmpkey(self._version)
 
-        warnings.warn(
-            "Creating a LegacyVersion has been deprecated and will be "
-            "removed in the next major release",
-            DeprecationWarning,
-        )
+        if not silence_deprecation_warning:
+            from pip._internal.utils.deprecation import deprecated
+
+            deprecated(
+                reason=(f"This form of version ({version}) has been deprecated."),
+                replacement="use PEP 440 compatible versions",
+                gone_in="23.2",
+            )
 
     def __str__(self) -> str:
         return self._version