From c93dac55cc91beac5d8730fb44765f2128c483d2 Mon Sep 17 00:00:00 2001 From: Thomas Robitaille Date: Wed, 29 Jan 2025 11:34:40 +0000 Subject: [PATCH] Add note about unrecognized extras --- peps/pep-0771.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/peps/pep-0771.rst b/peps/pep-0771.rst index a0017d17980..e49e219707f 100644 --- a/peps/pep-0771.rst +++ b/peps/pep-0771.rst @@ -229,6 +229,13 @@ Note that ``package[]`` would continue to be equivalent to ``package`` and would not be provided as a way to install without default extras (see the `Rejected Ideas`_ section for the rationale). +We also note that some tools such as `pip`_ currently ignore unrecognized +extras, and emit a warning to the user to indicate that the extra has not been +recognized. In this case, if no extras are recognized as being valid in a +dependency specification, we recommend that this case be treated as if the user +had not passed any explicit extras, and therefore any default extras should be +installed. + Installing without default extras ---------------------------------