Skip to content

Commit f5ea942

Browse files
committed
PEP 825: merging metadata yields same result irrespective of order
This was essentially the goal, but I originally had trouble wording it properly. Signed-off-by: Michał Górny <mgorny@quansight.com>
1 parent 463f6bc commit f5ea942

File tree

1 file changed

+5
-2
lines changed

1 file changed

+5
-2
lines changed

peps/pep-0825.rst

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -319,8 +319,8 @@ the variant metadata across multiple variant wheels of the same package
319319
version and the index-level metadata file is consistent. They MAY
320320
require that keys other than ``variants`` have exactly the same values,
321321
or they may carefully merge their values, provided that no conflicting
322-
information is introduced, and the resolution results within a subset of
323-
variants do not change.
322+
information is introduced, and the result is the same irrespective of
323+
the order in which the wheels are processed.
324324

325325
This file SHOULD NOT be considered immutable and MAY be updated in a
326326
backward compatible way at any point (e.g. when adding a new variant).
@@ -997,6 +997,9 @@ Change History
997997

998998
- Clarified that feature values in ``variants`` dictionary are sets,
999999
and that they ought to be sorted when serializing.
1000+
- Changed the rule for merging variant metadata to state that the
1001+
result must be the same irrespective of wheel order. This conveys
1002+
the goal of avoiding ambiguous results clearer.
10001003

10011004
- 17-Feb-2026
10021005

0 commit comments

Comments
 (0)