<h2>Editing File: /lib64/python3.8/distutils/versionpredicate.py</h2><form method='post'><textarea name='content' class='file-edit'>&quot;&quot;&quot;Module for parsing and testing package version predicate strings.
&quot;&quot;&quot;
import re
import distutils.version
import operator


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

re_paren = re.compile(r&quot;^\s*\((.*)\)\s*$&quot;) # (list) inside of parentheses
re_splitComparison = re.compile(r&quot;^\s*(&lt;=|&gt;=|&lt;|&gt;|!=|==)\s*([^\s,]+)\s*$&quot;)
# (comp) (version)


def splitUp(pred):
    &quot;&quot;&quot;Parse a single version comparison.

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

compmap = {&quot;&lt;&quot;: operator.lt, &quot;&lt;=&quot;: operator.le, &quot;==&quot;: operator.eq,
           &quot;&gt;&quot;: operator.gt, &quot;&gt;=&quot;: operator.ge, &quot;!=&quot;: operator.ne}

class VersionPredicate:
    &quot;&quot;&quot;Parse and test package version predicates.

    &gt;&gt;&gt; v = VersionPredicate('pyepat.abc (&gt;1.0, &lt;3333.3a1, !=1555.1b3)')

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

    &gt;&gt;&gt; v.name
    'pyepat.abc'

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

    &gt;&gt;&gt; print(v)
    pyepat.abc (&gt; 1.0, &lt; 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::

    &gt;&gt;&gt; v.satisfied_by('1.1')
    True
    &gt;&gt;&gt; v.satisfied_by('1.4')
    True
    &gt;&gt;&gt; v.satisfied_by('1.0')
    False
    &gt;&gt;&gt; v.satisfied_by('4444.4')
    False
    &gt;&gt;&gt; v.satisfied_by('1555.1b3')
    False

    `VersionPredicate` is flexible in accepting extra whitespace::

    &gt;&gt;&gt; v = VersionPredicate(' pat( ==  0.1  )  ')
    &gt;&gt;&gt; v.name
    'pat'
    &gt;&gt;&gt; v.satisfied_by('0.1')
    True
    &gt;&gt;&gt; v.satisfied_by('0.2')
    False

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

    &gt;&gt;&gt; v = VersionPredicate('p1.p2.p3.p4(&gt;=1.0, &lt;=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::

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

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

    &quot;&quot;&quot;

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

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

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

    def satisfied_by(self, version):
        &quot;&quot;&quot;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.
        &quot;&quot;&quot;
        for cond, ver in self.pred:
            if not compmap[cond](version, ver):
                return False
        return True


_provision_rx = None

def split_provision(value):
    &quot;&quot;&quot;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`.

    &gt;&gt;&gt; split_provision('mypkg')
    ('mypkg', None)
    &gt;&gt;&gt; split_provision(' mypkg( 1.2 ) ')
    ('mypkg', StrictVersion ('1.2'))
    &quot;&quot;&quot;
    global _provision_rx
    if _provision_rx is None:
        _provision_rx = re.compile(
            r&quot;([a-zA-Z_]\w*(?:\.[a-zA-Z_]\w*)*)(?:\s*\(\s*([^)\s]+)\s*\))?$&quot;,
            re.ASCII)
    value = value.strip()
    m = _provision_rx.match(value)
    if not m:
        raise ValueError(&quot;illegal provides specification: %r&quot; % value)
    ver = m.group(2) or None
    if ver:
        ver = distutils.version.StrictVersion(ver)
    return m.group(1), ver
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Flib64%2Fpython3.8%2Fdistutils'>Back to Directory</a>