
python-checkins at python
Nov 24, 2009, 2:20 AM
Post #1 of 1
(89 views)
Permalink
|
|
r76476 - in peps/trunk: pep-0345.txt pep-0386.txt
|
|
Author: tarek.ziade Date: Tue Nov 24 10:14:32 2009 New Revision: 76476 Log: added three fields for the project URLs: Repository-URL, Repository-Browser-URL, Bug-Tracker-URL Modified: peps/trunk/pep-0345.txt peps/trunk/pep-0386.txt Modified: peps/trunk/pep-0345.txt ============================================================================== --- peps/trunk/pep-0345.txt (original) +++ peps/trunk/pep-0345.txt Tue Nov 24 10:14:32 2009 @@ -9,7 +9,7 @@ Content-Type: text/x-rst Created: 28-Apr-2005 Python-Version: 2.5 -Post-History: +Post-History: Replaces: 314 @@ -162,7 +162,7 @@ Maintainer (optional) A string containing the maintainer's name at a minimum; additional contact information may be provided. - + Note that this field is intended for use when a package is being maintained by someone other than the original author: it should be omitted if it is identical to ``Author``. @@ -295,7 +295,7 @@ version numbers, separated by commas. Conditional operators must be one of "<", ">", "<=", ">=", "==", and "!=". Version numbers must be in the format specified in `PEP 386`_. - If no operator is provided with a version, the "==" operator + If no operator is provided with a version, the "==" operator is used by default. Any number of conditional operators can be specified, e.g. @@ -326,7 +326,7 @@ RDBMS bindings for use by a given ORM: each project might declare that it provides ``ORM-bindings``, allowing other projects to depend only on having at most one of them installed. - + A version declaration may be supplied (without a comparison operator); the distribution's version number will be implied if none is specified. Version numbers must be in the format specified in @@ -342,7 +342,7 @@ Each entry contains a string describing a distutils project which this package renders obsolete, meaning that the two packages should not be installed at the same time. - + Version declarations can be supplied. Version numbers must be in the format specified in `PEP 386`_. @@ -387,10 +387,10 @@ A version declaration is a series of conditional operators and version numbers, separated by commas. Conditional operators - must be one of "<", ">", "<=", ">=", "==", and "!=". If no + must be one of "<", ">", "<=", ">=", "==", and "!=". If no operator is provided with a version, the "==" operator is used by default. - Because they refer to non-Python software releases, version numbers + Because they refer to non-Python software releases, version numbers for this field are **not** required to conform to the format specified in `PEP 386`_: they should correspond to the version scheme used by the external dependency. @@ -416,6 +416,31 @@ Copyright: Python Software Foundation, 2005 Copyright: Public Domain + +Repository-URL + A string containing the URL for the project repository. + + Example:: + + Repository-URL: http://svn.python.org/projects/python/trunk/ + + +Repository-Browse-URL + A string containing the URL for the project browsable repository. + + Example:: + + Repository-Browse-URL: http://svn.python.org/view/python/trunk + + +Bug-Tracker-URL + A string containing the URL for the package's bug tracker + + Example:: + + Bug-Tracker-URL: http://bugs.python.org/ + + Version Specifiers ================== @@ -432,13 +457,13 @@ Here are some example of fields using such markers:: - Requires-Dist: pywin32, bar > 1.0; sys.platform == 'win32' + Requires-Dist: pywin32 > 1.0; sys.platform == 'win32' Obsoletes-Dist: pywin31; sys.platform == 'win32' Requires-Dist: foo; os.machine == 'i386' Requires-Dist: bar; python_version == '2.4' or python_version == '2.5' Requires-External: libxslt; 'linux' in sys.platform -These markers are using a micro-language that can be interpreted using a +These markers are using a micro-language that can be interpreted using a function ``interpret_marker`` provided in the ``distutils.util`` module in the stdlib:: @@ -446,7 +471,7 @@ >>> interpret_marker("sys.platform == 'win32'") True -Depending if the execution environment meets the requirements, the function +Depending if the execution environment meets the requirements, the function will return True or False. The micro-language behind this is the simplest possible: it compares only @@ -496,6 +521,9 @@ - Requires-Dist - Provides-Dist - Obsoletes-Dist + - Repository-URL + - Repository-Browser-URL + - Bug-Tracker-URL * Deprecated fields: @@ -532,7 +560,7 @@ Fred Drake, Anthony Baxter and Matthias Klose have all contributed to the ideas presented in this PEP. -Tres Seaver, Jim Fulton, Marc-André Lemburg, Tarek Ziadé and other people at +Tres Seaver, Jim Fulton, Marc-André Lemburg, Tarek Ziadé and other people at the Distutils-SIG have contributed to the new updated version. Modified: peps/trunk/pep-0386.txt ============================================================================== --- peps/trunk/pep-0386.txt (original) +++ peps/trunk/pep-0386.txt Tue Nov 24 10:14:32 2009 @@ -283,7 +283,7 @@ be a ``1.2.0-r678`` release. We used ``post`` instead of ``r`` because the ``r`` is ambiguous as to whether it indicates a pre- or post-release. -Last, ``.post456.dev34`` indicates a dev parker for a post release, that sorts +Last, ``.post456.dev34`` indicates a dev marker for a post release, that sorts before a ``.post345`` marker. This can be used to do development versions of post releases. _______________________________________________ Python-checkins mailing list Python-checkins [at] python http://mail.python.org/mailman/listinfo/python-checkins
|