[Python-checkins] python/dist/src/Doc/dist dist.tex,1.90,1.91

loewis at users.sourceforge.net loewis at users.sourceforge.net
Mon Mar 21 21:57:02 CET 2005

Update of /cvsroot/python/python/dist/src/Doc/dist
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv6855/Doc/dist

Modified Files:
Log Message:
Add the upload command. Make all dist commands register their
outputs with the distribution object.

Index: dist.tex
RCS file: /cvsroot/python/python/dist/src/Doc/dist/dist.tex,v
retrieving revision 1.90
retrieving revision 1.91
diff -u -d -r1.90 -r1.91
--- dist.tex	20 Mar 2005 22:19:46 -0000	1.90
+++ dist.tex	21 Mar 2005 20:56:27 -0000	1.91
@@ -1715,7 +1715,37 @@
 versions, the Hidden property should be set to yes. This must be edited
 through the web interface.
+\section{The .pypirc file}
+The format of the \file{.pypirc} file is formated as follows:
+repository: <repository-url>
+username: <username>
+password: <password>
+\var{repository} can be ommitted and defaults to
+\chapter{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 invokes immediately after building one or more distribution
+files, e.g. as
+python setup.py sdist bdist_wininst upload
+The \command{upload} command uses the username and password stored in
+in the file \file{$HOME/.pypirc}, see \ref{pypirc}.
@@ -2055,6 +2085,11 @@
 implemented by the class \class{distcmds.bdist_openpkg.bdist_openpkg}
 or \class{buildcmds.bdist_openpkg.bdist_openpkg}.
+\section{Adding new distribution types}
+Commands that create distributions (i.e. files in the dist directory)
+need to add (command, filename) pairs to \var{self.distribution.dist_files}
+so that \command{upload} can upload it to PyPI.
 \chapter{Command Reference}

More information about the Python-checkins mailing list