Class SProcUnitRules

Initializes the ruleset and operational parameters.

For parameters refer to called setrules and setkargs.

Overrides: object.__init__

Sets supported parameters.

Applicable for the initial call of self.__init__(), and later modification.

Tolerates unknown keyword parameters, pops own.

Args:

**kargs: Parameter specific for the operation,

debug: Sets debug for rule application.

verbose: Sets verbose for rule application.

Returns:

When successful returns 'True', else returns either 'False', or raises an exception.

Raises:

passed through exceptions:

Initialize and reset parameters and previous results.

Args:

**kargs:

setdefault: Sets the predefined default dictionary,

see 'rules_default'.

debug:

True: see re.DEBUG, when set

False: default:=unset

dotall:

True: see re.DOTALL, when set

False: default:=unset

exitign:

True: Ignores exit at all.

False: Does not ignore exit value.

exittype:

False|'nok': Success when exit is not 0.

True|'ok': Success when exit is 0.

'value': Success when exit is equal <exit-value>.

exitval=<exit-value>: A specific exit value indicating

success.

ignorecase:

True: see re.IGNORECASE, when set

False: default:=unset

multiline:

True: see re.MULTILINE, when set

False: default:=unset

priotype:

False|'nok': One failure state sets the whole case

to failure. This is the default.

True|'ok': One success state sets the whole case

to success.

weight: Choose larger values of counters.

<customcallback>: Custom callback with signature:

customcallback(self,ret)

self: Current instance.

ret: Data provided to apply.

reset: A reset dictionary, see 'rules_reset'.

result: Required sum of all matches for success,

else failure.

resultnok: Required sum of NOK matches for failure,

else success.

resultok: Required sum of OK matches for success,

else failure.

stderrnok: List of regular expressions for match on

STDERR, indicating failure.

Could contain app-cached precompiled 're'.

stderrok: List of regular expressions for match on

STDERR, indicating success.

Could contain app-cached precompiled 're'.

stdoutnok: List of regular expressions for match on

STDOUT, indicating failure.

Could contain app-cached precompiled 're'.

stdoutok: List of regular expressions for match on

STDOUT, indicating success.

Could contain app-cached precompiled 're'.

unicode:

True: see re.UNICODE, when set

False: default:=unset

Returns:

When successful returns 'True', else returns either 'False', or raises an exception.

Raises:

passed through exceptions:

Apply rules on the input ret and weight the result.

The provided match patterns and values are matched onto the input, and the number of matches is counted.

The number of required matches of sub-patterns has to be defined within the regexpr, e.g. by:

'abv{4}[^v]+'

this matches on:

abvvvv

Args:

ret: Tuple received from 'SystemCalls'.

Returns:

When successful returns 'True', else returns either 'False', or raises an exception.

Raises:

passed through exceptions:

State values of current applied unittest.

The applied parameters are available by 'repr()'.

Args:

ret: Tuple received from 'SystemCalls'.

Returns:

Returns the state of the last 'apply' operation. this is the result of the 'filter' and 'countres' described in the manual by the syntax-tree:

r = {
  '_exitcond' = self._exitcond,   # resulting after applied self.exittype
  'exit' = self._exitret, # see _exitcond
  'stderrnok' = self.stderrnok_matched,
  'stderrok' = self.stderrok_matched,
  'stdoutnok' = self.stdoutnok_matched,
  'stdoutok' = self.stdoutok_matched,

  'result' = self.result_cnt,
  'resultnok' = self.resultnok_cnt,
  'resultok' = self.resultok_cnt,
}

Raises:

passed through exceptions:

Overrides: object.__str__

Overrides: object.__repr__

rules_default

Value:

{'_exitcond': False, '_exitret': 0, 'cflags': 0, 'debug': 0, 'default': True, 'dotall': 0, 'exitign': False, 'exittype': 8, ...