Deprecate the setup.py bdist_wheel code path

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,21 @@ 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, "
+            "which will be removed in a future version."
+        ),
+        replacement=(
+            "to use the standardized build interface by "
+            "setting the `--use-pep517` option, "
+            "(possibly combined with `--no-build-isolation`), "
+            f"or adding a `pyproject.toml` file to the source tree of {name!r}"
+        ),
+        gone_in="25.3",
+        issue=6334,
+    )
+
     wheel_args = make_setuptools_bdist_wheel_args(
         setup_py_path,
         global_options=global_options,

src/pip/_internal/req/req_install.py

@@ -925,7 +925,7 @@ def check_legacy_setup_py_options(
             reason="--build-option and --global-option are deprecated.",
             issue=11859,
             replacement="to use --config-settings",
-            gone_in=None,
+            gone_in="25.3",
         )
         logger.warning(
             "Implying --no-binary=:all: due to the presence of "

tests/functional/test_install_index.py

@@ -27,6 +27,8 @@ def test_find_links_no_doctype(script: PipTestEnvironment, data: TestData) -> No
     result = script.pip(
         "install",
         "simple==1.0",
+        "--use-pep517",
+        "--no-build-isolation",
         "--no-index",
         "--find-links",
         script.scratch_path,