From 7c2586d4113bcd5cba759dfb4f128586ef0884c8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20G=C3=B3rny?= Date: Tue, 21 Jul 2026 17:53:00 +0200 Subject: [PATCH 1/2] PEP 825: add explicit "implementation requirements" MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Michał Górny --- peps/pep-0825.rst | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/peps/pep-0825.rst b/peps/pep-0825.rst index 3b3e7d0a2d5..e982a2b6ee9 100644 --- a/peps/pep-0825.rst +++ b/peps/pep-0825.rst @@ -70,6 +70,26 @@ The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", document are to be interpreted as described in :rfc:`2119`. +Implementation requirements +--------------------------- + +This specification is written from the perspective of file format. +In the context of format definitions, the word "MUST" specifically +indicates that the requirement must be satisfied for the data to be +considered valid according to this specifications. + +Tools that produce the data formats according to this specification +(variant wheels, the index-level metadata file) MUST always produce +files that meet the requirements of this specification. + +Tools that consume the data formats according to this specification +SHOULD refuse to process the files that do not meet these requirements. +In this case, it is recommended to follow the same behavior as for +invalid Core Metadata in wheel files. For example, a wheel index may +reject the upload, while a package manager may skip the version +entirely. + + Variant wheel ------------- From 567a166599166c59f2176150346e7beae6c9517d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20G=C3=B3rny?= Date: Tue, 21 Jul 2026 18:24:29 +0200 Subject: [PATCH 2/2] Update peps/pep-0825.rst Co-authored-by: konsti-openai --- peps/pep-0825.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/peps/pep-0825.rst b/peps/pep-0825.rst index e982a2b6ee9..5733c215dac 100644 --- a/peps/pep-0825.rst +++ b/peps/pep-0825.rst @@ -73,7 +73,7 @@ document are to be interpreted as described in :rfc:`2119`. Implementation requirements --------------------------- -This specification is written from the perspective of file format. +This specification is written from the perspective of file format producers. In the context of format definitions, the word "MUST" specifically indicates that the requirement must be satisfied for the data to be considered valid according to this specifications.