mirror of
https://github.com/python/cpython.git
synced 2026-01-04 06:22:20 +00:00
d6abb72a79
svn+ssh://svn.python.org/python/branches/py3k ................ r77236 | georg.brandl | 2010-01-02 15:51:12 +0100 (Sa, 02 Jan 2010) | 1 line #7592: remove duplicate description. ................ r77383 | georg.brandl | 2010-01-09 10:48:46 +0100 (Sa, 09 Jan 2010) | 9 lines Merged revisions 77382 via svnmerge from svn+ssh://pythondev@svn.python.org/python/trunk ........ r77382 | georg.brandl | 2010-01-09 10:47:11 +0100 (Sa, 09 Jan 2010) | 1 line #7422: make it clear that getargspec() only works on Python functions. ........ ................ r77399 | georg.brandl | 2010-01-09 23:39:42 +0100 (Sa, 09 Jan 2010) | 1 line Remove redundant brackets in signatures. ................ r77857 | georg.brandl | 2010-01-30 18:54:04 +0100 (Sa, 30 Jan 2010) | 1 line #7814: fix wrong example function usage. ................ r78238 | georg.brandl | 2010-02-19 10:10:15 +0100 (Fr, 19 Feb 2010) | 1 line #5341: fix parenthesis placement. ................ r78861 | georg.brandl | 2010-03-12 11:04:37 +0100 (Fr, 12 Mär 2010) | 1 line Make tool compatible with 2.x and 3.x. ................ r78862 | georg.brandl | 2010-03-12 11:06:40 +0100 (Fr, 12 Mär 2010) | 13 lines Merged revisions 78859-78860 via svnmerge from svn+ssh://pythondev@svn.python.org/python/trunk ........ r78859 | georg.brandl | 2010-03-12 10:57:43 +0100 (Fr, 12 Mär 2010) | 1 line Get rid of backticks. ........ r78860 | georg.brandl | 2010-03-12 11:02:03 +0100 (Fr, 12 Mär 2010) | 1 line Fix warnings from "make check". ........ ................ r78958 | georg.brandl | 2010-03-14 11:51:01 +0100 (So, 14 Mär 2010) | 37 lines Merged revisions 78101,78115,78117,78182,78188,78245,78386,78496 via svnmerge from svn+ssh://pythondev@svn.python.org/python/trunk ........ r78101 | georg.brandl | 2010-02-08 01:04:54 +0100 (Mo, 08 Feb 2010) | 1 line Fix test_fnmatch. ........ r78115 | georg.brandl | 2010-02-08 23:40:51 +0100 (Mo, 08 Feb 2010) | 1 line Fix missing string formatting placeholder. ........ r78117 | georg.brandl | 2010-02-08 23:48:37 +0100 (Mo, 08 Feb 2010) | 1 line Convert test failure from output-producing to self.fail(). ........ r78182 | georg.brandl | 2010-02-14 09:18:23 +0100 (So, 14 Feb 2010) | 1 line #7926: fix stray parens. ........ r78188 | georg.brandl | 2010-02-14 14:38:12 +0100 (So, 14 Feb 2010) | 1 line #7926: fix-up wording. ........ r78245 | georg.brandl | 2010-02-19 20:36:08 +0100 (Fr, 19 Feb 2010) | 1 line #7967: PyXML is no more. ........ r78386 | georg.brandl | 2010-02-23 22:48:57 +0100 (Di, 23 Feb 2010) | 1 line #6544: fix refleak in kqueue, occurring in certain error conditions. ........ r78496 | georg.brandl | 2010-02-27 15:58:08 +0100 (Sa, 27 Feb 2010) | 1 line Link to http://www.python.org/dev/workflow/ from bugs page. ........ ................
72 lines
3.1 KiB
ReStructuredText
72 lines
3.1 KiB
ReStructuredText
.. _package-upload:
|
|
|
|
***************************************
|
|
Uploading Packages to the Package Index
|
|
***************************************
|
|
|
|
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
|
|
: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 :file:`setup.py`, but that only distributions named on the command
|
|
line for the invocation including the :command:`upload` command are uploaded.
|
|
|
|
The :command:`upload` command uses the username, password, and repository URL
|
|
from the :file:`$HOME/.pypirc` file (see section :ref:`pypirc` for more on this
|
|
file). If a :command:`register` command was previously called in the same command,
|
|
and if the password was entered in the prompt, :command:`upload` will reuse the
|
|
entered password. This is useful if you do not want to store a clear text
|
|
password in the :file:`$HOME/.pypirc` file.
|
|
|
|
You can specify another PyPI server with the :option:`--repository=*url*` option::
|
|
|
|
python setup.py sdist bdist_wininst upload -r http://example.com/pypi
|
|
|
|
See section :ref:`pypirc` for more on defining several servers.
|
|
|
|
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.
|
|
|
|
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).
|
|
|
|
PyPI package display
|
|
====================
|
|
|
|
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.
|
|
|
|
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.
|
|
|
|
The ``long_description`` field can be attached to a text file located
|
|
in the package::
|
|
|
|
from distutils.core import setup
|
|
|
|
setup(name='Distutils',
|
|
long_description=open('README.txt'))
|
|
|
|
In that case, :file:`README.txt` is a regular reStructuredText text file located
|
|
in the root of the package besides :file:`setup.py`.
|
|
|
|
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::
|
|
|
|
$ python setup.py --long-description | rst2html.py > output.html
|
|
|
|
:mod:`docutils` will display a warning if there's something wrong with your syntax.
|