[Python-checkins] python/nondist/peps pep-0314.txt,1.1,1.2

2003年4月12日 13:16:22 -0700

Update of /cvsroot/python/python/nondist/peps
In directory sc8-pr-cvs1:/tmp/cvs-serv10630
Modified Files:
	pep-0314.txt 
Log Message:
Add Requires and Provides fields
Index: pep-0314.txt
===================================================================
RCS file: /cvsroot/python/python/nondist/peps/pep-0314.txt,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
*** pep-0314.txt	12 Apr 2003 19:45:01 -0000	1.1
--- pep-0314.txt	12 Apr 2003 20:16:20 -0000	1.2
***************
*** 1,10 ****
! PEP: 241
! Title: Metadata for Python Software Packages
 Version: $Revision$
 Author: A.M. Kuchling <amk@amk.ca>
 Type: Standards Track
! Created: 12-Mar-2001
! Status: Final
! Post-History: 19-Mar-2001

 Introduction
--- 1,10 ----
! PEP: 314
! Title: Metadata for Python Software Packages v1.1
 Version: $Revision$
 Author: A.M. Kuchling <amk@amk.ca>
 Type: Standards Track
! Created: 12-Apr-2003
! Status: Draft
! Post-History: 

 Introduction
***************
*** 14,17 ****
--- 14,19 ----
 semantics and usage.

+ This document specifies version 1.1 of the metadata format.
+ Version 1.0 is specified in PEP 241.

 Including Metadata in Packages
***************
*** 49,58 ****
 Metadata-Version

! Version of the file format; currently "1.0" is the only
! legal value here. 

 Example: 

! Metadata-Version: 1.0

 Name
--- 51,60 ----
 Metadata-Version

! Version of the file format; currently "1.0" and "1.1" are the
! only legal values here.

 Example: 

! Metadata-Version: 1.1

 Name
***************
*** 169,173 ****
 resellers can automatically know that they're free to
 redistribute the software. Other licenses will require
! a careful reading by a human to determine the software can be
 repackaged and resold.

--- 171,175 ----
 resellers can automatically know that they're free to
 redistribute the software. Other licenses will require
! a careful reading by a human to determine how the software can be
 repackaged and resold.

***************
*** 212,226 ****
 License: MIT

! Acknowledgements

! Many changes and rewrites to this document were suggested by the
! readers of the Distutils SIG. In particular, Sean Reifschneider
! often contributed actual text for inclusion in this PEP.
! 
! The list of licenses was compiled using the SourceForge license
! list and the CTAN license list compiled by Graham Williams; Carey
! Evans also offered several useful suggestions on this list.

 Copyright
--- 214,279 ----
 License: MIT

+ Requires (multiple use)
+ 
+ Each entry contains a string describing some other component or
+ module required by this package. 

! The format of a requirement string is simple: an arbitrary
! sequence of characters, optionally followed by a version
! declaration within parentheses. Leading and trailing whitespace
! are ignored, and whitespace within the string is normalized to a
! single space.

! A version declaration is a series of conditional operators and
! version numbers, separated by commas. Conditional operators
! must be one of "<", ">", "<=", ">=", "=", and "!=". Version
! numbers must be in the format accepted by the
! distutils.version.StrictVersion class: two or three
! dot-separated numeric components, with an optional "pre-release"
! tag on the end consisting of the letter 'a' or 'b' followed by a
! number. Example version numbers are "1.0", "2.3a2", "1.3.99", 
! 
! XXX Do we really need = and !=?
! 
! XXX Should it be == or =?
! 
! XXX Should we support LooseVersion instead of StrictVersion?
! LooseVersions aren't comparable...
! 
! Any number of conditional operators can be specified, e.g.
! ">1.0, !=1.3.4, <2.0".

+ All of the following are possible requirement strings: "rfc822",
+ "", "zlib (>=1.1.4)", "XML parser".
+ 
+ There's no canonical list of what strings should be used; the
+ Python community is left to choose its own standards.
+ 
+ Example: 
+ 
+ Requires: re
+ Requires: sys
+ Requires: zlib
+ Requires: pyexpat (>1.0)
+ Requires: DB-API 2.0 module
+ 
+ Provides (multiple use)
+ 
+ Each entry contains a string describing some other component or
+ module that will be provided by this package once it is
+ installed. These strings should match the ones used in
+ Requirements fields. Version declarations cannot be supplied;
+ instead the package's version number will be used.
+ 
+ Example: 
+ 
+ Provides: xml
+ Provides: xml.utils
+ Provides: xml.utils.iso8601
+ Provides: xml.dom
+ 
+ Acknowledgements
+ 
+ None yet. 

 Copyright