|
Original |
Translation |
|
997
|
python setup.py sdist bdist_wininst upload -r http://example.com/pypi
|
|
|
998
|
See section :ref:`pypirc` for more on defining several servers.
|
|
|
999
|
You can use the :option:`--sign` option to tell :command:`upload` to sign each uploaded file using GPG (GNU Privacy Guard). The :program:`gpg` program must be available for execution on the system :envvar:`PATH`. You can also specify which key to use for signing using the :option:`--identity=*name*` option.
|
|
|
1000
|
Other :command:`upload` options include :option:`--repository=<url>` or :option:`--repository=<section>` where *url* is the url of the server and *section* the name of the section in :file:`$HOME/.pypirc`, and :option:`--show-response` (which displays the full response text from the PyPI server for help in debugging upload problems).
|
|
|
1001
|
|
1002
|
The ``long_description`` field plays a special role at PyPI. It is used by the server to display a home page for the registered package.
|
|
|
1003
|
If you use the `reStructuredText <http://docutils.sourceforge.net/rst.html>`_ syntax for this field, PyPI will parse it and display an HTML output for the package home page.
|
|
|
1004
|
The ``long_description`` field can be attached to a text file located in the package::
|
|
|
1005
|
from distutils.core import setup setup(name='Distutils', long_description=open('README.txt'))
|
|
|
1006
|
In that case, :file:`README.txt` is a regular reStructuredText text file located in the root of the package besides :file:`setup.py`.
|
|
|
1007
|
To prevent registering broken reStructuredText content, you can use the :program:`rst2html` program that is provided by the :mod:`docutils` package and check the ``long_description`` from the command line::
|
|
|
1008
|
$ python setup.py --long-description | rst2html.py > output.html
|
|
|
1009
|
:mod:`docutils` will display a warning if there's something wrong with your syntax.
|
|