Skip to content

PEP 805: Safe Parallel Python - #5101

Open
markshannon wants to merge 8 commits into
python:mainfrom
markshannon:pep-805
Open

PEP 805: Safe Parallel Python#5101
markshannon wants to merge 8 commits into
python:mainfrom
markshannon:pep-805

Conversation

@markshannon

@markshannon markshannon commented Aug 20, 2026

Copy link
Copy Markdown
Member

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

@markshannon
markshannon requested a review from a team as a code owner August 20, 2026 15:25
Comment thread peps/pep-0805/appendix-examples.rst
@markshannon

markshannon commented Aug 20, 2026

Copy link
Copy Markdown
Member Author

I don't understand this message:

/home/runner/work/peps/peps/peps/pep-0554.rst:1832: WARNING: duplicate label c-api, other instance in /home/runner/work/peps/peps/peps/pep-0805.rst

Why is it a problem if PEP 554 and PEP 805 use the same label? They aren't connected.
PEP 805 does reference PEP 554. I'll try using a different label.

Comment thread peps/pep-0805.rst Outdated
@read-the-docs-community

read-the-docs-community Bot commented Aug 20, 2026

Copy link
Copy Markdown

Comment thread peps/pep-0805.rst Outdated

@hugovk hugovk left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I don't understand this message:

/home/runner/work/peps/peps/peps/pep-0554.rst:1832: WARNING: duplicate label c-api, other instance in /home/runner/work/peps/peps/peps/pep-0805.rst

Why is it a problem if PEP 554 and PEP 805 use the same label? They aren't connected. PEP 805 does reference PEP 554. I'll try using a different label.

Explicit labels are global across the whole PEPs build, so :ref:s can point to a label in any other document in the build and not just within a single file.

So using a unique label is the correct fix.

Comment thread peps/pep-0805/appendix-examples.rst Outdated
Comment thread peps/pep-0805/appendix-implementation.rst Outdated
Comment thread peps/pep-0805.rst Outdated
Comment thread peps/pep-0805.rst Outdated
Comment thread peps/pep-0805.rst Outdated
Comment thread peps/pep-0805.rst Outdated
Comment thread peps/pep-0805.rst Outdated
Comment thread peps/pep-0805/appendix-examples.rst Outdated
Comment thread peps/pep-0805.rst
Comment thread peps/pep-0805.rst

@hugovk hugovk left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I don't understand this message:

/home/runner/work/peps/peps/peps/pep-0554.rst:1832: WARNING: duplicate label c-api, other instance in /home/runner/work/peps/peps/peps/pep-0805.rst

Why is it a problem if PEP 554 and PEP 805 use the same label? They aren't connected. PEP 805 does reference PEP 554. I'll try using a different label.

Explicit labels are global across the whole PEPs build, so :ref:s can point to a label in any other document in the build and not just within a single file.

So using a unique label is the correct fix.

Comment thread peps/pep-0805.rst
Comment thread peps/pep-0805.rst
Comment thread peps/pep-0805.rst
Comment thread peps/pep-0805.rst
Comment thread peps/pep-0805/appendix-implementation.rst
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.

6 participants