summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorrichard <devnull@localhost>2002-11-15 23:26:28 +0000
committerrichard <devnull@localhost>2002-11-15 23:26:28 +0000
commit7a336e253f06ccc075d80929d7a1cf25f66db12f (patch)
tree0cd8b7e9cfba2d1dfbca4916c3e1d0fa2ff2a719
parent536b73f17e0889c6cbca0ddebf1e706040e2da27 (diff)
downloaddecorator-7a336e253f06ccc075d80929d7a1cf25f66db12f.tar.gz
*** empty log message ***
-rw-r--r--doc/pep-0301.txt (renamed from doc/pep.txt)41
-rw-r--r--doc/pep.editor.feedback.20021102.txt78
2 files changed, 110 insertions, 9 deletions
diff --git a/doc/pep.txt b/doc/pep-0301.txt
index 7d1a5de..f17b258 100644
--- a/doc/pep.txt
+++ b/doc/pep-0301.txt
@@ -183,15 +183,19 @@ as usual and report any errors it would have reported during a normal
submission. This is useful for verifying correctness of Trove
discriminators.
-The index server will return custom headers (inspired by PEP 243)
-which the *register* command will use to give feedback to the user:
+The index server will indicate success or failure of the register or
+verify operation through a subset of the standard HTTP response codes:
-**X-Pypi-Status**
- Either "success" or "fail".
+===== ============== ================================================
+Code Meaning Register command implications
+===== ============== ================================================
+200 OK Everything worked just fine
+400 Bad request Data provided for submission was malformed
+401 Unauthorised The username or password supplied were incorrect
+403 Forbidden User does not have permission to update the
+ package information (not Owner or Maintainer)
+===== ============== ================================================
-**X-Pypi-Reason**
- A description of the reason for failure, or additional information
- in the case of a success.
Distutils Trove Categorisation
@@ -280,6 +284,22 @@ initial prototype had 45 visitors (not including myself), two of whom
used the *register* command to submit package information.
+Rejected Proposals
+==================
+
+Originally, the index server was to return custom headers (inspired by
+PEP 243):
+
+**X-Pypi-Status**
+ Either "success" or "fail".
+
+**X-Pypi-Reason**
+ A description of the reason for failure, or additional information
+ in the case of a success.
+
+However, it has been pointed out [8]_ that this is a bad scheme to use.
+
+
References
==========
@@ -304,6 +324,9 @@ References
.. [7] PEP 262, A Database of Installed Python Packages
(http://www.python.org/peps/pep-0262.html)
+.. [8] [PEP243] upload status is bogus
+ (http://mail.python.org/pipermail/distutils-sig/2001-March/002262.html)
+
Copyright
=========
@@ -314,8 +337,8 @@ This document has been placed in the public domain.
Acknowledgements
================
-Anthony Baxter and Martin v. Loewis for encouragement and feedback
-during initial drafting.
+Anthony Baxter, Martin v. Loewis and David Goodger for encouragement
+and feedback during initial drafting.
A.M. Kuchling for support including hosting the second prototype.
diff --git a/doc/pep.editor.feedback.20021102.txt b/doc/pep.editor.feedback.20021102.txt
new file mode 100644
index 0000000..ff0a459
--- /dev/null
+++ b/doc/pep.editor.feedback.20021102.txt
@@ -0,0 +1,78 @@
+From goodger@users.sourceforge.net Sat Nov 2 12:05:17 2002
+X-Sieve: cmu-sieve 2.0
+Return-Path: <goodger@users.sourceforge.net>
+Received: (from uucp@localhost)
+ by crown.off.ekorp.com (8.9.3/8.9.3) id BAA13375
+ for rjones@ekit-inc.com; Sat, 2 Nov 2002 01:04:56 GMT
+Received: from fep04-mail.bloor.is.net.cable.rogers.com(66.185.86.74)
+ via SMTP by mx3.ekorp.com, id smtpdAAAK2aGcA; Sat Nov 2 01:04:51 2002
+Received: from [65.48.132.88] by fep04-mail.bloor.is.net.cable.rogers.com
+ (InterMail vM.5.01.05.06 201-253-122-126-106-20020509) with ESMTP
+ id <20021102010412.IOBP4298.fep04-mail.bloor.is.net.cable.rogers.com@[65.48.132.88]>;
+ Fri, 1 Nov 2002 20:04:12 -0500
+User-Agent: Microsoft-Outlook-Express-Macintosh-Edition/5.0.3
+Date: Fri, 01 Nov 2002 20:05:17 -0500
+Subject: Re: New PEP: Distutils Enhancements
+From: David Goodger <goodger@users.sourceforge.net>
+To: Richard Jones <rjones@ekit-inc.com>,
+ <peps@python.org>
+Message-ID: <B9E88EFC.2B1B0%goodger@users.sourceforge.net>
+In-Reply-To: <200211011741.35931.rjones@ekit-inc.com>
+Mime-version: 1.0
+Content-type: text/plain;
+ charset="US-ASCII"
+Content-transfer-encoding: 7bit
+X-Authentication-Info: Submitted using SMTP AUTH LOGIN at fep04-mail.bloor.is.net.cable.rogers.com from [65.48.132.88] using ID <dgoodger5511@rogers.com> at Fri, 1 Nov 2002 20:04:12 -0500
+Status: R
+X-Status: N
+X-KMail-EncryptionState:
+X-KMail-SignatureState:
+
+(Surprise! You probably didn't know I was moonlighting as a deputy PEP
+editor. :)
+
+The PEP looks good, Richard. Some suggestions & questions:
+
+> Title: Distutils Enhancements
+
+Too generic IMO. How about "Package Index and Metadata for Distutils"?
+
+> The server should be hosted in the python.org domain,
+
+What server? No server mentioned before this. Instead of "The
+server", perhaps "A package metadata server"?
+
+> hopefully just one command-line command for more regular users.
+
+"hopefully just a one-line command for most users", perhaps?
+
+> The original PEP which proposed such a system
+
+"PEP xxx, the original PEP which proposed such a system"
+
+> The web interface implements the following commands/interfaces:
+
+For readability, I suggest inserting blank lines between definition
+list items. (They blob together now.)
+
+> A demonstration will be available at:
+>
+> http://www.amk.ca/cgi-bin/pypi.cgi
+
+Is it up now? I wasn't able to access it. When will it be available?
+Couldn't it be hosted on a permanent basis on sf.net (with **TEST**
+prominently displayed, of course)? The previous one at
+http://mechanicalcat.net:8081/ is not accessible either.
+
+> two of whom used the register command bo submit package information.
+ ^^
+
+"bo" should be "to".
+
+--
+David Goodger <goodger@users.sourceforge.net> Open-source projects:
+ - Python Docutils: http://docutils.sourceforge.net/
+ (includes reStructuredText: http://docutils.sf.net/rst.html)
+ - The Go Tools Project: http://gotools.sourceforge.net/
+
+