[Python-checkins] CVS: python/nondist/peps pep-0243.txt,1.2,1.3
Barry Warsaw
bwarsaw@users.sourceforge.net
Mon, 26 Mar 2001 23:51:35 -0800
Update of /cvsroot/python/python/nondist/peps
In directory usw-pr-cvs1:/tmp/cvs-serv19096
Modified Files:
pep-0243.txt
Log Message:
Sean's revision of 24-Mar-2001 (with minor editing by Barry).
Index: pep-0243.txt
===================================================================
RCS file: /cvsroot/python/python/nondist/peps/pep-0243.txt,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -r1.2 -r1.3
*** pep-0243.txt 2001/03/21 17:36:34 1.2
--- pep-0243.txt 2001/03/27 07:51:33 1.3
***************
*** 8,12 ****
Created: 18-Mar-2001
Python-Version: 2.1
! Post-History: 20-Mar-2001
--- 8,12 ----
Created: 18-Mar-2001
Python-Version: 2.1
! Post-History: 20-Mar-2001, 24-Mar-2001
***************
*** 35,42 ****
will be uploaded as a multi-part form encoded the same as a
regular HTML file upload request. This form is posted using
! ENCTYPE="multipart/form-data" encoding.
The upload will be made to the host "modules.python.org" on port
! 80/tcp. The form will consist of the following fields:
distribution -- The file containing the module software (for
--- 35,43 ----
will be uploaded as a multi-part form encoded the same as a
regular HTML file upload request. This form is posted using
! ENCTYPE="multipart/form-data" encoding [2].
The upload will be made to the host "modules.python.org" on port
! 80/tcp (POST http://modules.python.org:80/swalowpost.cgi). The form
! will consist of the following fields:
distribution -- The file containing the module software (for
***************
*** 48,72 ****
ord(byte))").
! pkginfo -- The file containing the distribution meta-data (as
! specified in PEP-241 [1]).
- infomd5sum -- The MD5 hash of the uploaded meta-data, encoded
- in ASCII representing the hexadecimal representation of the
- digest ("for byte in digest: s = s + ('%02x' % ord(byte))").
-
platform (optional) -- A string representing the target
platform for this distribution. This is only for binary
distributions. It is encoded as
! "<os_name>-<os_version>-<platform architecture>".
! signature (optional) -- A GPG signature of the uploaded
! distribution as signed by the author. This may be used by the
! cataloging system to automate acceptance of uploads.
Return Data
! The upload will report the status of the upload by sending the
! string "Upload status:" followed by one of the following:
SUCCESS -- Indicates that the upload has succeeded.
--- 49,84 ----
ord(byte))").
! pkginfo (optional) -- The file containing the distribution
! meta-data (as specified in PEP-241 [1]). Note that if this is
! not included, the distribution file is expected to be in .tar
! format (gzipped and bzipped compreesed are allowed) or .zip
! format, with a "PKG-INFO" file in the top-level directory it
! extracts ("package-1.00/PKG-INFO").
!
! infomd5sum (required if pkginfo field is present) -- The MD5 hash
! of the uploaded meta-data, encoded in ASCII representing the
! hexadecimal representation of the digest ("for byte in digest:
! s = s + ('%02x' % ord(byte))").
platform (optional) -- A string representing the target
platform for this distribution. This is only for binary
distributions. It is encoded as
! "<os_name>-<os_version>-<platform architecture>-<python
! version>".
!
! signature (optional) -- A OpenPGP-compatible signature [3] of
! the uploaded distribution as signed by the author. This may
! be used by the cataloging system to automate acceptance of
! uploads.
! protocol_version -- A string indicating the protocol version that
! the client supports. This document describes protocol version "1".
Return Data
! The status of the upload will be reported using HTTP non-standard
! ("X-*)" headers. The "X-Swalow-Status" header may have the following
! values:
SUCCESS -- Indicates that the upload has succeeded.
***************
*** 79,89 ****
Potential causes of this are resource shortages on the server,
administrative down-time, etc...
-
- Following the above string may be a human-readable string
- providing further information. This message continues to the end
- of the returned data-stream.
! Returned data which does not fit the above format should be
! treated as a temporary failure.
--- 91,109 ----
Potential causes of this are resource shortages on the server,
administrative down-time, etc...
! Optionally, there may be a "X-Swalow-Reason" header which includes a
! human-readable string which provides more detailed information about
! the "X-Swalow-Status".
!
! If there is no "X-Swalow-Status" header, or it does not contain one of
! the three strings above, it should be treated as a temporary failure.
!
! Example:
!
! >>> f = urllib.urlopen('http://modules.python.org:80/swalowpost.cgi')
! >>> s = f.headers['x-swalow-status']
! >>> s = s + ': ' + f.headers.get('x-swalow-reason', '<None>')
! >>> print s
! FAILURE: Required field "distribution" missing.
***************
*** 103,106 ****
--- 123,127 ----
<INPUT TYPE="text" NAME="platform"><BR>
<INPUT TYPE="text" NAME="signature"><BR>
+ <INPUT TYPE="hidden" NAME="protocol_version" VALUE="1"><BR>
<INPUT TYPE="SUBMIT" VALUE="Upload">
</FORM>
***************
*** 111,122 ****
The following are valid os names:
! debian
! hpux
! mandrake
! redhat
! solaris
! suse
! windows
! yellowdog
The above include a number of different types of distributions of
--- 132,137 ----
The following are valid os names:
! aix beos debian dos freebsd hpux mac macos mandrake netbsd
! openbsd qnx redhat solaris suse windows yellowdog
The above include a number of different types of distributions of
***************
*** 127,141 ****
Version is the official version string specified by the vendor for
! the particular release. For example, "nt" (Windows), "9.04"
! (HP-UX), "7.0" (RedHat, Mandrake).
The following are valid architectures:
! alpha
! hppa
! ix86
! powerpc
! sparc
! ultrasparc
--- 142,151 ----
Version is the official version string specified by the vendor for
! the particular release. For example, "2000" and "nt" (Windows),
! "9.04" (HP-UX), "7.0" (RedHat, Mandrake).
The following are valid architectures:
! alpha hppa ix86 powerpc sparc ultrasparc
***************
*** 154,157 ****
--- 164,173 ----
[1] Metadata for Python Software Package, Kuchling,
http://python.sourceforge.net/peps/pep-0241.html
+
+ [2] RFC 1867, Form-based File Upload in HTML
+ http://www.faqs.org/rfcs/rfc1867.html
+
+ [3] RFC 2440, OpenPGP Message Format
+ http://www.faqs.org/rfcs/rfc2440.html