added three fields for the project URLs: Repository-URL, Repository-Browser-URL, Bug-Tracker-URL

This commit is contained in:
Tarek Ziadé 2009-11-24 09:14:32 +00:00
parent 7c738150a2
commit 031bafc608
2 changed files with 40 additions and 12 deletions

View File

@ -9,7 +9,7 @@ Type: Standards Track
Content-Type: text/x-rst
Created: 28-Apr-2005
Python-Version: 2.5
Post-History:
Post-History:
Replaces: 314
@ -162,7 +162,7 @@ Author-email
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 @@ Requires-Dist (multiple use)
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 @@ Provides-Dist (multiple use)
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 @@ Obsoletes-Dist (multiple use)
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 @@ Requires-External (multiple use)
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
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 @@ environment.
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 @@ in the stdlib::
>>> 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 @@ Summary of Differences From PEP 314
- Requires-Dist
- Provides-Dist
- Obsoletes-Dist
- Repository-URL
- Repository-Browser-URL
- Bug-Tracker-URL
* Deprecated fields:
@ -532,7 +560,7 @@ Acknowledgements
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.

View File

@ -283,7 +283,7 @@ post-releases -- which apparently is used by a number of projects out there
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.