engine_config - command `engine-config --all`¶

This module provides access to ovirt-engine configuration parameters by parsing output of command engine-config --all.

class insights.parsers.engine_config.EngineConfigAll(context, extra_bad_lines=[])[source]¶

Bases: insights.core.CommandParser

Parsing output of command engine-config --all

The parser tries its best to get value & version for specified keyword. At the moment it works well for output which has keyword, value & version in a single line. It ignores keywords where is fails. It skip(rather fails) the keyword having multi-line output.

Typical output of engine-config --all command is:

MaxRerunVmOnVdsCount: 3 version: general
MaxStorageVdsTimeoutCheckSec: 30 version: general
ClusterRequiredRngSourcesDefault:  version: 3.6
ClusterRequiredRngSourcesDefault:  version: 4.0
ClusterRequiredRngSourcesDefault:  version: 4.1
HotUnplugCpuSupported: {"x86":"false","ppc":"false"} version: 3.6
HotUnplugCpuSupported: {"x86":"false","ppc":"false"} version: 4.0
HotUnplugCpuSupported: {"x86":"true","ppc":"true"} version: 4.1

Examples

>>> from insights.parsers.engine_config import EngineConfigAll
>>> from insights.tests import context_wrap
>>> output = EngineConfigAll(context_wrap(OUTPUT))}
>>> 'MaxRerunVmOnVdsCount' in output
True
>>> output['MaxRerunVmOnVdsCount']
['3']
>>> output.get('MaxRerunVmOnVdsCount')
['3']
>>> output['HotUnplugCpuSupported']
['{"x86":"false","ppc":"false"}', '{"x86":"false","ppc":"false"}', '{"x86":"true","ppc":"true"}']
>>> output['ClusterRequiredRngSourcesDefault']
[]
>>> output.head('HotUnplugCpuSupported')
'{"x86":"false","ppc":"false"}'
>>> output.last('HotUnplugCpuSupported')
'{"x86":"true","ppc":"true"}'
>>> output.get_version('HotUnplugCpuSupported')
['3.6', '4.0', '4.1']
>>> 'IDoNotExit' in output
False
>>> output['IDoNotExit']
[]
>>> output.get('IDoNotExit')
[]
>>> output.get_version('IDoNotExit')
[]
>>> output.head('IDoNotExist)
>>> output.last('IDoNotExist)

fields¶

List of KeyValue namedtupules for each line in the configuration file.

Type: list

keywords¶

Set of keywords present in the configuration file, each keyword has been converted to lowercase.

Type: set

get(keyword)[source]¶

A get value for keyword specified. A “dictionary like” method.

Example

>>> output.get('MaxStorageVdsTimeoutCheckSec')
['30']

Parameters: keyword (str) -- A key. For ex. HotUnplugCpuSupported.
Returns: Values associated with a keyword. Returns an empty list if, all the values are empty or keyword does not exist.
Return type: list

get_version(keyword)[source]¶

Get versions associated with a key.

Typical output is engine-config --all command:

MaxStorageVdsTimeoutCheckSec: 30 version: general
HotUnplugCpuSupported: {"x86":"false","ppc":"false"} version: 3.6
HotUnplugCpuSupported: {"x86":"false","ppc":"false"} version: 4.0
HotUnplugCpuSupported: {"x86":"true","ppc":"true"} version: 4.1

Examples

>>> output.get_version('MaxStorageVdsTimeoutCheckSec')
['general']
>>> output.get_version('HotUnplugCpuSupported')
['3.6', '4.0', '4.1']

Parameters: keyword (str) -- A key. For ex. HotUnplugCpuSupported.
Returns: Versions associated with a keyword. Returns an empty list if, all the versions are empty or keyword does not exist.
Return type: list

head(keyword)[source]¶

Get first element from values(list).

Example

>>> output['HotUnplugCpuSupported']
['{"x86":"false","ppc":"false"}', '{"x86":"false","ppc":"false"}', '{"x86":"true","ppc":"true"}']
>>> output.head('HotUnplugCpuSupported')
'{"x86":"false","ppc":"false"}'

Parameters: keyword (str) -- A key. For ex. HotUnplugCpuSupported.
Returns: First element from values(list) associated with a keyword else None
Return type: str

keyvalue¶

namedtuple: Represent name value pair as a namedtuple with case.

alias of KeyValue

last(keyword)[source]¶

Get last element from values(list).

Example

>>> output['HotUnplugCpuSupported']
['{"x86":"false","ppc":"false"}', '{"x86":"false","ppc":"false"}', '{"x86":"true","ppc":"true"}']
>>> output.last('HotUnplugCpuSupported')
'{"x86":"true","ppc":"true"}'

Parameters: keyword (str) -- A key. For ex. HotUnplugCpuSupported.
Returns: Last element from values(list) associated with a keyword else None.
Return type: str

parse_content(content)[source]¶

Parse each active line for keyword, values & version.

Parameters: content (list) -- Output of command engine-config --all.

engine_config - command engine-config --all¶

engine_config - command `engine-config --all`¶