specs_matcher¶

oslo_utils.specs_matcher.make_grammar()¶

Creates the grammar to be used by a spec matcher.

The grammar created supports the following operations.

Numerical values:

• =  : equal to or greater than. This is equivalent to >= and is supported for legacy reasons

• != : Float/integer value not equal

• <= : Float/integer value less than or equal

• <  : Float/integer value less than

• == : Float/integer value equal

• >= : Float/integer value greater than or equal

• >  : Float/integer value greater

String operations:

• s!= : Not equal

• s<  : Less than

• s<= : Less than or equal

• s== : Equal

• s>  : Greater than

• s>= : Greater than or equal

Other operations:

• <all-in> : All items ‘in’ value

• <in>     : Item ‘in’ value, like a substring in a string.

• <or>     : Logical ‘or’

If no operator is specified the default is s== (string equality comparison)

Example operations:

• ">= 60" Is the numerical value greater than or equal to 60

• "<or> spam <or> eggs" Does the value contain spam or eggs

• "s== 2.1.0" Is the string value equal to 2.1.0

• "<in> gcc" Is the string gcc contained in the value string

• "<all-in> aes mmx" Are both aes and mmx in the value

Returns

A pyparsing.MatchFirst object. See https://pythonhosted.org/pyparsing/ for details on pyparsing.

oslo_utils.specs_matcher.match(cmp_value, spec)¶

Match a given value to a given spec DSL.

This uses the grammar defined by make_grammar()

Parameters

• cmp_value – Value to be checked for match.

• spec – The comparison specification string, for example ">= 70" or "s== string_value". See make_grammar() for examples of a specification string.

Returns

True if cmp_value is a match for spec. False otherwise.