Creating a PyPI project with a trusted publisher
Trusted publishers are not just for pre-existing PyPI projects: you can also use them to create a PyPI project!
This again reduces the number of steps needed to set up a fully automated PyPI publishing workflow: rather than having to manually upload a first release to "prime" the project on PyPI, you can configure a "pending" publisher that will create the project when used for the first time. "Pending" publishers are converted into "normal" publishers on first use, meaning that no further configuration is required.
The process for configuring a "pending" publisher are similar to those for a normal publisher, except that the page is under your account sidebar instead of any project's sidebar (since the project doesn't exist yet):
Clicking on "publishing" will bring you to the following form:
This form behaves the same as with publishers for existing projects, except that you also need to provide the name of the PyPI project that will be created.
For example, if you have a repository at
https://github.com/octo-org/sampleproject with a release workflow at
release.yml and an environment named
release that you would like to publish
to PyPI as
sampleproject, then you would do the following:
Clicking "Add" will register the "pending" publisher, and show it to you:
From this point on, the "pending" publisher can be used exactly like a "normal" publisher, and after first use it will convert it into a "normal" publisher.