OpenQuizz
Une application de gestion des contenus pédagogiques
VersionPredicate Class Reference

Public Member Functions

def __init__ (self, versionPredicateStr)
 
def __str__ (self)
 
def satisfied_by (self, version)
 

Data Fields

 pred
 

Detailed Description

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)'

Constructor & Destructor Documentation

◆ __init__()

def __init__ (   self,
  versionPredicateStr 
)
Parse a version predicate string.

Member Function Documentation

◆ __str__()

def __str__ (   self)

◆ satisfied_by()

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.

Field Documentation

◆ pred

pred

The documentation for this class was generated from the following file: