Deprecate using setup.py bdist_wheel

Author: sbidoul

news/13319.removal.rst

@@ -0,0 +1,3 @@
+Deprecate the legacy ``setup.py bdist_wheel`` mechanism. To silence the warning,
+and future-proof their setup, users should enable ``--use-pep517`` or add a
+``pyproject.toml`` file to the projects they control.

src/pip/_internal/operations/build/wheel_legacy.py

@@ -3,6 +3,7 @@
 from typing import List, Optional
 
 from pip._internal.cli.spinners import open_spinner
+from pip._internal.utils.deprecation import deprecated
 from pip._internal.utils.setuptools_build import make_setuptools_bdist_wheel_args
 from pip._internal.utils.subprocess import call_subprocess, format_command_args
 
@@ -68,6 +69,18 @@ def build_wheel_legacy(
 
     Returns path to wheel if successfully built. Otherwise, returns None.
     """
+    deprecated(
+        reason=f"Building {name!r} using the legacy setup.py bdist_wheel mechanism.",
+        replacement=(
+            "to use the standardized build interface by "
+            "setting the `--use-pep517` option, "
+            "(possibly combined with `--no-build-isolation`), "
+            "or adding a `pyproject.toml` file to the source tree"
+        ),
+        gone_in="25.3",
+        issue=6334,
+    )
+
     wheel_args = make_setuptools_bdist_wheel_args(
         setup_py_path,
         global_options=global_options,