Emit a SetuptoolsDeprecationWarning when setup_requires is used. Ref #…

…2823.
pypa · Oct 22, 2021 · beb4968 · beb4968
1 parent fee9d17
commit beb4968
Show file tree

Hide file tree

Showing 2 changed files with 4 additions and 0 deletions.
diff --git a/changelog.d/2823.change.rst b/changelog.d/2823.change.rst
@@ -0,0 +1 @@
+Officially deprecated support for ``setup_requires``. Users are encouraged instead to migrate to PEP 518 ``build-system.requires`` in ``pyproject.toml``. Users reliant on ``setup_requires`` should consider pinning to this major version to avoid disruption.
diff --git a/setuptools/__init__.py b/setuptools/__init__.py
@@ -144,6 +144,9 @@ def finalize_options(self):
     # Honor setup.cfg's options.
     dist.parse_config_files(ignore_option_errors=True)
     if dist.setup_requires:
+        raise SetuptoolsDeprecationWarning(
+            "setup_requires is deprecated. Supply build "
+            "dependencies using PEP 517 pyproject.toml build-requires.")
         dist.fetch_build_eggs(dist.setup_requires)
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		Officially deprecated support for ``setup_requires``. Users are encouraged instead to migrate to PEP 518 ``build-system.requires`` in ``pyproject.toml``. Users reliant on ``setup_requires`` should consider pinning to this major version to avoid disruption.