New in version 2.5.
The Python Package Index (PyPI) not only stores the package info, but also
the package data if the author of the package wishes to. The distutils
command upload
pushes the distribution files to PyPI.
The command is invoked immediately after building one or more distribution files. For example, the command
python setup.py sdist bdist_wininst upload
will cause the source distribution and the Windows installer to be
uploaded to PyPI. Note that these will be uploaded even if they are
built using an earlier invocation of setup.py, but that only
distributions named on the command line for the invocation including
the upload
command are uploaded.
The upload
command uses the username, password, and repository
URL from the $HOME/.pypirc file (see section 6.1 for
more on this file).
You can use the --sign option to tell upload
to
sign each uploaded file using GPG (GNU Privacy Guard). The
gpg program must be available for execution on the system
PATH. You can also specify which key to use for signing
using the --identity=name option.
Other upload
options include
--repository=url (which lets you override the
repository setting from $HOME/.pypirc), and
--show-response (which displays the full response text
from the PyPI server for help in debugging upload problems).
See About this document... for information on suggesting changes.