|
|
|
Distributing Python Modules |
|
|
|
7. Uploading Packages to the Package Index
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).
Release 2.5.2, documentation updated on 21st February, 2008.
See About this document... for information on suggesting changes.
|