Publishing¶

After your project is built, you can distribute it using the publish command.

The -p/--publisher option controls which publisher to use, with the default being pypi.

Artifact selection¶

By default, the dist directory located at the root of your project will be used:

$ hatch publish
dist/hatch_demo-1rc0-py3-none-any.whl ... success
dist/hatch_demo-1rc0.tar.gz ... success

[hatch-demo]
https://pypi.org/project/hatch-demo/1rc0/

You can instead pass specific paths as arguments:

hatch publish /path/to/artifacts foo-1.tar.gz

Only files ending with .whl or .tar.gz will be published.

Repository¶

You can select the repository (package index) with which to upload using the -r/--repo option or by setting the HATCH_PYPI_REPO environment variable.

Rather than specifying the full URL of a repository, you can use a named repository from a publish.pypi.repos table defined in Hatch's config file:

[publish.pypi.repos]
repo1 = "url1"
...

The following repository names are reserved by Hatch and cannot be overridden:

The main repository is used by default.

Authentication¶

The first time you publish to a repository you need to authenticate using the -u/--user (environment variable HATCH_PYPI_USER) and -a/--auth (environment variable HATCH_PYPI_AUTH) options. You will be prompted if either option is not provided.

The user that most recently published to the chosen repository is cached, with their credentials saved to the system keyring, so that they will no longer need to provide authentication information.

For automated releases, it is recommended that you use per-project API tokens.