Skip to content

Commit

Permalink
Document the PyPI org policy (#1484)
Browse files Browse the repository at this point in the history
  • Loading branch information
hugovk authored Jan 10, 2025
1 parent 491dd99 commit 5649d76
Show file tree
Hide file tree
Showing 2 changed files with 25 additions and 0 deletions.
1 change: 1 addition & 0 deletions conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -200,6 +200,7 @@
"github": ("https://github.com/%s", "%s"),
"github-user": ("https://github.com/%s", "@%s"),
"pypi": ("https://pypi.org/project/%s/", "%s"),
"pypi-org": ("https://pypi.org/org/%s/", "%s"),
}

# sphinxext-opengraph config
Expand Down
24 changes: 24 additions & 0 deletions developer-workflow/development-cycle.rst
Original file line number Diff line number Diff line change
Expand Up @@ -370,6 +370,30 @@ administrators) to merge changes to that branch.
Multi-Factor Authentication must be enabled by the user in order to retain
access as a Release Manager of the branch.

PyPI organization policy
^^^^^^^^^^^^^^^^^^^^^^^^

The Python core team owns the :pypi-org:`cpython` and :pypi-org:`python`
organizations on PyPI for publishing packages.
The main benefits of adding packages to these organizations:

* Visibility: we can see our packages under a PyPI org page
* Maintainability: we can share granular PyPI access to improve the bus factor

The general policy on which organization to use:

* :pypi-org:`cpython`:
for development tools that are tied fairly closely to CPython development.
For example, :pypi:`blurb` and :pypi:`cherry-picker`.
Users generally shouldn’t have to care except for developing CPython itself
(although that doesn’t mean the tools necessarily have to be unusable for
anyone else).
* :pypi-org:`python`:
for general-audience projects that are maintained by the Python core team.
For example, :pypi:`pyperformance`, :pypi:`python-docs-theme` and
:pypi:`tzdata`.


Governance
----------

Expand Down

0 comments on commit 5649d76

Please sign in to comment.