aboutsummaryrefslogtreecommitdiffstats
path: root/setuptools.txt
diff options
context:
space:
mode:
authorPJ Eby <distutils-sig@python.org>2006-07-10 19:55:31 +0000
committerPJ Eby <distutils-sig@python.org>2006-07-10 19:55:31 +0000
commitf9e082742effbf51eeef3c3fa176c055bfa21e83 (patch)
treec9040f32a527045f4918c2f37f2ddd3fef7ec242 /setuptools.txt
parentdc749c307648324f56cd42b30173d21dde79c1b2 (diff)
downloadexternal_python_setuptools-f9e082742effbf51eeef3c3fa176c055bfa21e83.tar.gz
external_python_setuptools-f9e082742effbf51eeef3c3fa176c055bfa21e83.tar.bz2
external_python_setuptools-f9e082742effbf51eeef3c3fa176c055bfa21e83.zip
Include more detailed version ranges spec, and make Requirement.specs a
public/documented attribute. (backport from trunk) --HG-- branch : setuptools-0.6 extra : convert_revision : svn%3A6015fed2-1504-0410-9fe1-9d1591cc4771/sandbox/branches/setuptools-0.6%4050532
Diffstat (limited to 'setuptools.txt')
-rwxr-xr-xsetuptools.txt9
1 files changed, 9 insertions, 0 deletions
diff --git a/setuptools.txt b/setuptools.txt
index 467313f2..5dad2b9a 100755
--- a/setuptools.txt
+++ b/setuptools.txt
@@ -514,6 +514,15 @@ specifiers. A version specifier is one of the operators ``<``, ``>``, ``<=``,
separated by whitespace, but any whitespace or nonstandard characters within a
project name or version identifier must be replaced with ``-``.
+Version specifiers for a given project are internally sorted into ascending
+version order, and used to establish what ranges of versions are acceptable.
+Adjacent redundant conditions are also consolidated (e.g. ``">1, >2"`` becomes
+``">1"``, and ``"<2,<3"`` becomes ``"<3"``). ``"!="`` versions are excised from
+the ranges they fall within. A project's version is then checked for
+membership in the resulting ranges. (Note that providing conflicting conditions
+for the same version (e.g. "<2,>=2" or "==2,!=2") is meaningless and may
+therefore produce bizarre results.)
+
Here are some example requirement specifiers::
docutils >= 0.3