Skip to content

PEP 694: Address PEP Delegate's feedback#4794

Merged
warsaw merged 30 commits into
python:mainfrom
warsaw:pep-694-di-feedback
Jun 27, 2026
Merged

PEP 694: Address PEP Delegate's feedback#4794
warsaw merged 30 commits into
python:mainfrom
warsaw:pep-694-di-feedback

Conversation

@warsaw

@warsaw warsaw commented Jan 27, 2026

Copy link
Copy Markdown
Member

📚 Documentation preview 📚: https://pep-previews--4794.org.readthedocs.build/

* Remove the "action" keys in request bodies, and substitute for explicit end-points.  This feels much more
  REST-ish.  This is for both the publishing and file upload sessions.
* Add an `authentication` cross-reference anchor.
* Add a Recommendations for Client Implementers section for how clients like twine, uv, and GitHub
  actions *might* utilize the PEP 694 API.
* Update the Change Log accordingly.
@warsaw warsaw self-assigned this Jan 27, 2026
@warsaw warsaw marked this pull request as ready for review January 27, 2026 21:11
@warsaw warsaw requested a review from dstufft as a code owner January 27, 2026 21:11
@read-the-docs-community

read-the-docs-community Bot commented Jun 22, 2026

Copy link
Copy Markdown

Documentation build overview

📚 pep-previews | 🛠️ Build #33331968 | 📁 Comparing 6df4e94 against latest (ddffeed)

  🔍 Preview build  

3 files changed
± pep-0694/index.html
± pep-0764/index.html
± pep-0790/index.html

@willingc willingc left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Thanks @warsaw.

warsaw added 9 commits June 23, 2026 17:03
* Fixed: some discrepancies about when an open publishing session is reused or when a new session is created.

* Added: some language about creating a new publishing session for a name-version pair even if such has
  already been published.  However the new session disallows uploading a file that has already been published,
  since those are immutable.

* Added some client recommendations about multiple sessions.
* The file's contents are always the authoritative source of truth
* PyPI is actively moving toward extracting metadata from the file.

Also, add a little clarifying text to the Security Implications section.
@warsaw warsaw requested review from a team and CAM-Gerlach as code owners June 26, 2026 17:09
@warsaw warsaw merged commit da7b68f into python:main Jun 27, 2026
5 checks passed
@warsaw warsaw deleted the pep-694-di-feedback branch June 27, 2026 00:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants