Skip to content

Commit 64950f2

Browse files
committed
Talk about extra != "name" too
1 parent b7a5678 commit 64950f2

1 file changed

Lines changed: 9 additions & 7 deletions

File tree

source/specifications/dependency-specifiers.rst

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -458,13 +458,15 @@ DO NOT need to define these fields.
458458
The ``extra`` field is also special, as it expects set-like behaviour, but
459459
predates the addition of ``Set of strings`` as a defined marker field type.
460460
It only supports one operation, ``extra == "name"``, which is similar to
461-
``"name" in extras``. For dependency marker evaluations, the set of extra
462-
names used for these comparisons is the full set of requested extras for *that
463-
particular package*, whether requested directly in a top level dependency
464-
declaration, or indirectly in a transitive dependency declaration. Other
465-
comparison operations on ``extra`` are not defined and publishing tools SHOULD
466-
emit an error, index servers MAY disallow uploads containing such environment
467-
markers, while locking and installation tools SHOULD evaluate them as False.
461+
``"name" in extras``. ``extra != "name"`` SHOULD NOT be used anymore and MAY
462+
be rejected or evaluated to false. For dependency marker evaluations, the set
463+
of extra names used for these comparisons is the full set of requested extras
464+
for *that particular package*, whether requested directly in a top level
465+
dependency declaration, or indirectly in a transitive dependency declaration.
466+
Other comparison operations on ``extra`` are not defined and publishing tools
467+
SHOULD emit an error, index servers MAY disallow uploads containing such
468+
environment markers, while locking and installation tools SHOULD evaluate them
469+
as False.
468470

469471
Unlike the newer ``extras`` field, environment markers using this field SHOULD
470472
be accepted by both publishing tools and index servers. Marker evaluation

0 commit comments

Comments
 (0)