diff options
author | richard <devnull@localhost> | 2002-11-15 23:26:28 +0000 |
---|---|---|
committer | richard <devnull@localhost> | 2002-11-15 23:26:28 +0000 |
commit | 7a336e253f06ccc075d80929d7a1cf25f66db12f (patch) | |
tree | 0cd8b7e9cfba2d1dfbca4916c3e1d0fa2ff2a719 | |
parent | 536b73f17e0889c6cbca0ddebf1e706040e2da27 (diff) | |
download | decorator-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.txt | 78 |
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/ + + |