Rename package.simple-repo-package-url and add `package.files.simpl…

…e-repo-package-url` Also tweak Core Metadata 2.4 to be simpler by outright banning varying metadata
python · brettcannon · Jul 24, 2024 · Mar 20, 2024 · Mar 21, 2024 · Mar 21, 2024
commit 92de818ead51a837a1dcc0d0f8a31f64b62bbe70
diff --git a/peps/pep-9999.rst b/peps/pep-9999.rst
@@ -142,13 +142,12 @@ Specification
 Core Metadata 2.4
 -----------------
 
-A new core metadata version of 2.4 is to be introduced. This new version will
-introduce a new field named `Differing-Metadata`. The absence of the field
-indicates that the metadata is consistent across all distribution files for a
-certain version. A value of ``all`` signifies **any** distribution file for a
-specific version *may* have differing metadata. A value of ``sdist`` signifies
-that only source distribution file for a specific version *may* have differing
-metadata while all other files have the same metadata.
+A new core metadata version of 2.4 is to be introduced. When metadata uses this
+version the contained metadata MUST be consistent across files for the same
+package and version unless it is marked as ``Dynamic``. This effectively means
+**all** wheel files will have the same metadata and source distributions _may_
+also have the same metadata **if** all the fields static (i.e. `Dynamic` is not
+set).
 
 This should allow for the reading of the metadata from any distribution file to
 know whether examining the other distribution files have the same or differing
@@ -262,8 +261,7 @@ other is disallowed.
 '''''''''''''''
 
 - Array of tables
-- Contains all data on the locked package versions
-- Lockers MUST NOT list the same package and version more than once
+- The array contains all data on the locked package versions
 - Lockers SHOULD record packages in order by ``package.name`` lexicographically
   and ``package.version`` by the sort order for `version specifiers`_
 - Lockers SHOULD record keys in the same order as written in this PEP to
@@ -307,12 +305,12 @@ other is disallowed.
   purpose
 
 
-``package.project-details-url``
-'''''''''''''''''''''''''''''''
+``package.simple-repo-package-url``
+'''''''''''''''''''''''''''''''''''
 
 - Optional
 - String
-- The `project detail` URL
+- Storess the `project detail`_ URL from the `Simple Repository API`_
 - Useful for generating Packaging URLs (aka *PURLs*)
 
 
@@ -405,6 +403,18 @@ other is disallowed.
   with
 
 
+``package.files.simple-repo-package-url``
+'''''''''''''''''''''''''''''''''''''''''
+
+- Optional
+- String
+- The value has the same meaning as ``package.simple-repo-package-url``
+- If set, it overrides the value from ``package.simple-repo-package-url`` for
+  this file **only**
+- This is to support :pep:`708` when some files override what's provided by
+  another `Simple Repository API`_ index
+
+
 ``package.files.origin``
 ''''''''''''''''''''''''