?HAMA

Navigation

Breadcrumbs

/ / opt / alt / python37 / lib / python3.7 / site-packages / setuptools / _distutils

Create

Create File | Create Folder | Upload Files | Run Command

Edit File Size: 5.01 KB

//opt/alt/python37/lib/python3.7/site-packages/setuptools/_distutils/versionpredicate.py

Text Base64

"""Module for parsing and testing package version predicate strings.
"""
import re
import distutils.version
import operator

re_validPackage = re.compile(r"(?i)^\s*([a-z_]\w*(?:\.[a-z_]\w*)*)(.*)",
    re.ASCII)
# (package) (rest)

re_paren = re.compile(r"^\s*$(.*)$\s*$") # (list) inside of parentheses
re_splitComparison = re.compile(r"^\s*(<=|>=|<|>|!=|==)\s*([^\s,]+)\s*$")
# (comp) (version)

def splitUp(pred):
    """Parse a single version comparison.

Return (comparison string, StrictVersion)
    """
    res = re_splitComparison.match(pred)
    if not res:
        raise ValueError("bad package restriction syntax: %r" % pred)
    comp, verStr = res.groups()
    return (comp, distutils.version.StrictVersion(verStr))

compmap = {"<": operator.lt, "<=": operator.le, "==": operator.eq,
           ">": operator.gt, ">=": operator.ge, "!=": operator.ne}

class VersionPredicate:
    """Parse and test package version predicates.

>>> v = VersionPredicate('pyepat.abc (>1.0, <3333.3a1, !=1555.1b3)')

The `name` attribute provides the full dotted name that is given::

>>> v.name
    'pyepat.abc'

The str() of a `VersionPredicate` provides a normalized
    human-readable version of the expression::

>>> print(v)
    pyepat.abc (> 1.0, < 3333.3a1, != 1555.1b3)

The `satisfied_by()` method can be used to determine with a given
    version number is included in the set described by the version
    restrictions::

>>> v.satisfied_by('1.1')
    True
    >>> v.satisfied_by('1.4')
    True
    >>> v.satisfied_by('1.0')
    False
    >>> v.satisfied_by('4444.4')
    False
    >>> v.satisfied_by('1555.1b3')
    False

`VersionPredicate` is flexible in accepting extra whitespace::

>>> v = VersionPredicate(' pat( ==  0.1  )  ')
    >>> v.name
    'pat'
    >>> v.satisfied_by('0.1')
    True
    >>> v.satisfied_by('0.2')
    False

If any version numbers passed in do not conform to the
    restrictions of `StrictVersion`, a `ValueError` is raised::

>>> v = VersionPredicate('p1.p2.p3.p4(>=1.0, <=1.3a1, !=1.2zb3)')
    Traceback (most recent call last):
      ...
    ValueError: invalid version number '1.2zb3'

It the module or package name given does not conform to what's
    allowed as a legal module or package name, `ValueError` is
    raised::

>>> v = VersionPredicate('foo-bar')
    Traceback (most recent call last):
      ...
    ValueError: expected parenthesized list: '-bar'

>>> v = VersionPredicate('foo bar (12.21)')
    Traceback (most recent call last):
      ...
    ValueError: expected parenthesized list: 'bar (12.21)'

"""

def __init__(self, versionPredicateStr):
        """Parse a version predicate string.
        """
        # Fields:
        #    name:  package name
        #    pred:  list of (comparison string, StrictVersion)

versionPredicateStr = versionPredicateStr.strip()
        if not versionPredicateStr:
            raise ValueError("empty package restriction")
        match = re_validPackage.match(versionPredicateStr)
        if not match:
            raise ValueError("bad package name in %r" % versionPredicateStr)
        self.name, paren = match.groups()
        paren = paren.strip()
        if paren:
            match = re_paren.match(paren)
            if not match:
                raise ValueError("expected parenthesized list: %r" % paren)
            str = match.groups()[0]
            self.pred = [splitUp(aPred) for aPred in str.split(",")]
            if not self.pred:
                raise ValueError("empty parenthesized list in %r"
                                 % versionPredicateStr)
        else:
            self.pred = []

def __str__(self):
        if self.pred:
            seq = [cond + " " + str(ver) for cond, ver in self.pred]
            return self.name + " (" + ", ".join(seq) + ")"
        else:
            return self.name

def satisfied_by(self, version):
        """True if version is compatible with all the predicates in self.
        The parameter version must be acceptable to the StrictVersion
        constructor.  It may be either a string or StrictVersion.
        """
        for cond, ver in self.pred:
            if not compmap[cond](version, ver):
                return False
        return True

_provision_rx = None

def split_provision(value):
    """Return the name and optional version number of a provision.

The version number, if given, will be returned as a `StrictVersion`
    instance, otherwise it will be `None`.

>>> split_provision('mypkg')
    ('mypkg', None)
    >>> split_provision(' mypkg( 1.2 ) ')
    ('mypkg', StrictVersion ('1.2'))
    """
    global _provision_rx
    if _provision_rx is None:
        _provision_rx = re.compile(
            r"([a-zA-Z_]\w*(?:\.[a-zA-Z_]\w*)*)(?:\s*$\s*([^)\s]+)\s*$)?$",
            re.ASCII)
    value = value.strip()
    m = _provision_rx.match(value)
    if not m:
        raise ValueError("illegal provides specification: %r" % value)
    ver = m.group(2) or None
    if ver:
        ver = distutils.version.StrictVersion(ver)
    return m.group(1), ver

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Directory Contents

Dirs: 2 × Files: 30

Sort:

Enable drag-to-move

Name	Size	Perms	Modified	Actions
command DIR	-	drwxr-xr-x	2024-03-03 22:40:05	Edit Download recursive recursive
__pycache__ DIR	-	drwxr-xr-x	2024-03-03 22:40:05	Edit Download recursive recursive
archive_util.py	8.37 KB	lrw-r--r--	2023-11-13 21:35:13	Edit Download recursive recursive
bcppcompiler.py	14.54 KB	lrw-r--r--	2023-11-13 21:35:13	Edit Download recursive recursive
ccompiler.py	46.49 KB	lrw-r--r--	2023-11-13 21:35:13	Edit Download recursive recursive
cmd.py	17.66 KB	lrw-r--r--	2023-11-13 21:35:13	Edit Download recursive recursive
config.py	4.71 KB	lrw-r--r--	2023-11-13 21:35:13	Edit Download recursive recursive
core.py	8.67 KB	lrw-r--r--	2023-11-13 21:35:13	Edit Download recursive recursive
cygwinccompiler.py	16.54 KB	lrw-r--r--	2023-11-13 21:35:13	Edit Download recursive recursive
debug.py	139 B	lrw-r--r--	2023-11-13 21:35:13	Edit Download recursive recursive
dep_util.py	3.41 KB	lrw-r--r--	2023-11-13 21:35:13	Edit Download recursive recursive
dir_util.py	7.60 KB	lrw-r--r--	2023-11-13 21:35:13	Edit Download recursive recursive
dist.py	49.24 KB	lrw-r--r--	2023-11-13 21:35:13	Edit Download recursive recursive
errors.py	3.49 KB	lrw-r--r--	2023-11-13 21:35:13	Edit Download recursive recursive
extension.py	10.27 KB	lrw-r--r--	2023-11-13 21:35:13	Edit Download recursive recursive
fancy_getopt.py	17.37 KB	lrw-r--r--	2023-11-13 21:35:13	Edit Download recursive recursive
filelist.py	13.09 KB	lrw-r--r--	2023-11-13 21:35:13	Edit Download recursive recursive
file_util.py	7.96 KB	lrw-r--r--	2023-11-13 21:35:13	Edit Download recursive recursive
log.py	1.92 KB	lrw-r--r--	2023-11-13 21:35:13	Edit Download recursive recursive
msvc9compiler.py	29.74 KB	lrw-r--r--	2023-11-13 21:35:13	Edit Download recursive recursive
msvccompiler.py	22.99 KB	lrw-r--r--	2023-11-13 21:35:13	Edit Download recursive recursive
py35compat.py	455 B	lrw-r--r--	2023-11-13 21:35:13	Edit Download recursive recursive
py38compat.py	212 B	lrw-r--r--	2023-11-13 21:35:13	Edit Download recursive recursive
spawn.py	3.42 KB	lrw-r--r--	2023-11-13 21:35:13	Edit Download recursive recursive
sysconfig.py	21.12 KB	lrw-r--r--	2023-11-13 21:35:13	Edit Download recursive recursive
text_file.py	12.19 KB	lrw-r--r--	2023-11-13 21:35:13	Edit Download recursive recursive
unixccompiler.py	14.20 KB	lrw-r--r--	2023-11-13 21:35:13	Edit Download recursive recursive
util.py	19.90 KB	lrw-r--r--	2023-11-13 21:35:13	Edit Download recursive recursive
version.py	12.22 KB	lrw-r--r--	2023-11-13 21:35:13	Edit Download recursive recursive
versionpredicate.py	5.01 KB	lrw-r--r--	2023-11-13 21:35:13	Edit Download recursive recursive
_msvccompiler.py	20.33 KB	lrw-r--r--	2023-11-13 21:35:13	Edit Download recursive recursive
__init__.py	250 B	lrw-r--r--	2023-11-13 21:35:13	Edit Download recursive recursive