From 985be06a61cad71cb3894983d7a094d180b4748c Mon Sep 17 00:00:00 2001 From: Anderson Bravalheri Date: Sat, 26 Mar 2022 10:29:22 +0000 Subject: [PATCH] docs: add note about opting into PEP 621 --- docs/options.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/options.md b/docs/options.md index 45f67873..8e71e37c 100644 --- a/docs/options.md +++ b/docs/options.md @@ -432,6 +432,12 @@ the package is compatible with all versions of Python that it can build. requires = ["setuptools>=42", "wheel"] build-backend = "setuptools.build_meta" + Note however, that adding a `[project]` table to your `pyproject.toml` may + trigger a series of validations as specified in + [PEP621](https://www.python.org/dev/peps/pep-0621/). Also consider that + adding `[project]`, if not done carefully, will change the behaviour of your + build (e.g. `setuptools` may ignore `install_requires` specified via + `setup.py` or `setup.cfg`). Currently, setuptools has not yet added support for reading this value from pyproject.toml yet, and so does not copy it to Requires-Python in the wheel