Skip to content

PEP 847: "Problem Details for the Simple Repository API" - #5119

Open
woodruffw wants to merge 15 commits into
python:mainfrom
astral-sh:ww/rfc9457
Open

PEP 847: "Problem Details for the Simple Repository API"#5119
woodruffw wants to merge 15 commits into
python:mainfrom
astral-sh:ww/rfc9457

Conversation

@woodruffw

@woodruffw woodruffw commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

Basic requirements (all PEP Types)

  • Read and followed PEP 1 & PEP 12
  • File created from the latest PEP template
  • PEP has next available number, & set in filename (pep-NNNN.rst), PR title (PEP 123: <Title of PEP>) and PEP header
    • Tip: find the next available number with pepotron — run uvx pepotron next (or pipx install pepotron then pep next)
  • Title clearly, accurately and concisely describes the content in 79 characters or less
  • Core dev/PEP editor listed as Author or Sponsor, and formally confirmed their approval
  • Author, Status (Draft), Type and Created headers filled out correctly
  • PEP-Delegate, Topic, Requires and Replaces headers completed if appropriate
  • Required sections included
    • Abstract (first section)
    • Copyright (last section; exact wording from template required)
  • Code is well-formatted (PEP 7/PEP 8) and is in code blocks, with the right lexer names if non-Python
  • PEP builds with no warnings, pre-commit checks pass and content displays as intended in the rendered HTML
  • Authors/sponsor added to .github/CODEOWNERS for the PEP

Standards Track requirements

  • PEP topic discussed in a suitable venue with general agreement that a PEP is appropriate
  • Suggested sections included (unless not applicable)
    • Motivation
    • Specification
    • Rationale
    • Backwards Compatibility
    • Security Implications
    • How to Teach This
    • Reference Implementation
    • Rejected Ideas
    • Open Issues
    • Acknowledgements
    • Footnotes
    • Change History
  • Python-Version set to valid (pre-beta) future Python version, if relevant
  • Any project stated in the PEP as supporting/endorsing/benefiting from the PEP formally confirmed such
  • Right before or after initial merging, PEP discussion thread created and linked to in Discussions-To and Post-History

@woodruffw
woodruffw requested a review from a team as a code owner September 8, 2026 16:54
@woodruffw

Copy link
Copy Markdown
Contributor Author

CCing @dstufft to confirm his sponsor/delegate roles 🙂

@woodruffw

Copy link
Copy Markdown
Contributor Author

(NB: per #4930 I'm not self-assigning a PEP number until Donald publicly acknowledges.)

Comment thread peps/pep-0847.rst
Zsolt Dollenstein <zsol.zsol@gmail.com>
Sponsor: Donald Stufft <donald@stufft.io>
PEP-Delegate: Donald Stufft <donald@stufft.io>
Discussions-To: https://discuss.python.org/t/pre-pep-discussion-rfc-9457-error-responses-for-package-registries/105453

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

NB: I will do a follow-up PR for the new PEP thread shortly after this merges.

@read-the-docs-community

read-the-docs-community Bot commented Sep 8, 2026

Copy link
Copy Markdown

Documentation build overview

📚 pep-previews | 🛠️ Build #34473796 | 📁 Comparing 628f84d against latest (24419b9)

  🔍 Preview build  

6 files changed · + 1 added · ± 5 modified

+ Added

± Modified

Comment thread peps/pep-9999.rst Outdated
@hugovk hugovk changed the title PEP XXXX: "Problem Details for the Simple Repository API" PEP 847: "Problem Details for the Simple Repository API" Sep 9, 2026
woodruffw and others added 15 commits September 9, 2026 11:03
Signed-off-by: William Woodruff <william@yossarian.net>
Signed-off-by: William Woodruff <william@yossarian.net>
Co-authored-by: Jelle Zijlstra <jelle@openai.com>
Signed-off-by: William Woodruff <william@yossarian.net>
Signed-off-by: William Woodruff <william@yossarian.net>
Signed-off-by: William Woodruff <william@yossarian.net>
Signed-off-by: William Woodruff <william@yossarian.net>
Co-authored-by: Jacob Coffee <jacob@z7x.org>
Signed-off-by: William Woodruff <william@yossarian.net>
Signed-off-by: William Woodruff <william@yossarian.net>
Signed-off-by: William Woodruff <william@yossarian.net>
Signed-off-by: William Woodruff <william@yossarian.net>
Signed-off-by: William Woodruff <william@yossarian.net>
Signed-off-by: William Woodruff <william@yossarian.net>
Signed-off-by: William Woodruff <william@yossarian.net>
@dstufft

dstufft commented Sep 9, 2026

Copy link
Copy Markdown
Member

Yes I'm fine with both roles.

@brianschubert brianschubert added the new-pep A new draft PEP submitted for initial review label Sep 9, 2026
@woodruffw

Copy link
Copy Markdown
Contributor Author

Should be good to go now!

@woodruffw

Copy link
Copy Markdown
Contributor Author

@hugovk @JelleZijlstra I think this is good for merge now, PLMK if there's anything else I can/should do!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

new-pep A new draft PEP submitted for initial review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants