ironic_inspector.plugins.rules module

Standard plugins for rules API.

class ironic_inspector.plugins.rules.AddTraitAction

Bases: RuleActionPlugin

REQUIRED_PARAMS = {'name'}

Set with names of required parameters.

apply(node_info, params, **kwargs)

Run action on successful rule match.

Parameters:

• node_info – NodeInfo object

• params – parameters as a dictionary

• kwargs – used for extensibility without breaking existing plugins

Raises:

utils.Error on failure

class ironic_inspector.plugins.rules.ContainsCondition

Bases: ReCondition

check(node_info, field, params, **kwargs)

Check if condition holds for a given field.

Parameters:

• node_info – NodeInfo object

• field – field value

• params – parameters as a dictionary, changing it here will change what will be stored in database

• kwargs – used for extensibility without breaking existing plugins

Raises:

ValueError – on unacceptable field value

Returns:

True if check succeeded, otherwise False

class ironic_inspector.plugins.rules.EmptyCondition

Bases: RuleConditionPlugin

ALLOW_NONE = True

Whether this condition accepts None when field is not found.

REQUIRED_PARAMS = {}

Set with names of required parameters.

check(node_info, field, params, **kwargs)

Check if condition holds for a given field.

Parameters:

• node_info – NodeInfo object

• field – field value

• params – parameters as a dictionary, changing it here will change what will be stored in database

• kwargs – used for extensibility without breaking existing plugins

Raises:

ValueError – on unacceptable field value

Returns:

True if check succeeded, otherwise False

class ironic_inspector.plugins.rules.EqCondition

Bases: SimpleCondition

op(b, /)

Same as a == b.

class ironic_inspector.plugins.rules.ExtendAttributeAction

Bases: RuleActionPlugin

FORMATTED_PARAMS = ['value']

List of params will be formatted with python format.

OPTIONAL_PARAMS = {'unique'}

Set with names of optional parameters.

REQUIRED_PARAMS = {'path', 'value'}

Set with names of required parameters.

apply(node_info, params, **kwargs)

Run action on successful rule match.

Parameters:

• node_info – NodeInfo object

• params – parameters as a dictionary

• kwargs – used for extensibility without breaking existing plugins

Raises:

utils.Error on failure

class ironic_inspector.plugins.rules.FailAction

Bases: RuleActionPlugin

REQUIRED_PARAMS = {'message'}

Set with names of required parameters.

apply(node_info, params, **kwargs)

Run action on successful rule match.

Parameters:

• node_info – NodeInfo object

• params – parameters as a dictionary

• kwargs – used for extensibility without breaking existing plugins

Raises:

utils.Error on failure

class ironic_inspector.plugins.rules.GeCondition

Bases: SimpleCondition

op(b, /)

Same as a >= b.

class ironic_inspector.plugins.rules.GtCondition

Bases: SimpleCondition

op(b, /)

Same as a > b.

class ironic_inspector.plugins.rules.LeCondition

Bases: SimpleCondition

op(b, /)

Same as a <= b.

class ironic_inspector.plugins.rules.LtCondition

Bases: SimpleCondition

op(b, /)

Same as a < b.

class ironic_inspector.plugins.rules.MatchesCondition

Bases: ReCondition

check(node_info, field, params, **kwargs)

Check if condition holds for a given field.

Parameters:

• node_info – NodeInfo object

• field – field value

• params – parameters as a dictionary, changing it here will change what will be stored in database

• kwargs – used for extensibility without breaking existing plugins

Raises:

ValueError – on unacceptable field value

Returns:

True if check succeeded, otherwise False

class ironic_inspector.plugins.rules.NeCondition

Bases: SimpleCondition

op(b, /)

Same as a != b.

class ironic_inspector.plugins.rules.NetCondition

Bases: RuleConditionPlugin

check(node_info, field, params, **kwargs)

Check if condition holds for a given field.

Parameters:

• node_info – NodeInfo object

• field – field value

• params – parameters as a dictionary, changing it here will change what will be stored in database

• kwargs – used for extensibility without breaking existing plugins

Raises:

ValueError – on unacceptable field value

Returns:

True if check succeeded, otherwise False

validate(params, **kwargs)

Validate params passed during creation.

Default implementation checks for presence of fields from REQUIRED_PARAMS and fails for unexpected fields (not from REQUIRED_PARAMS + OPTIONAL_PARAMS).

Parameters:

• params – params as a dictionary

• kwargs – used for extensibility without breaking existing plugins

Raises:

ValueError on validation failure

class ironic_inspector.plugins.rules.ReCondition

Bases: RuleConditionPlugin

validate(params, **kwargs)

Validate params passed during creation.

Default implementation checks for presence of fields from REQUIRED_PARAMS and fails for unexpected fields (not from REQUIRED_PARAMS + OPTIONAL_PARAMS).

Parameters:

• params – params as a dictionary

• kwargs – used for extensibility without breaking existing plugins

Raises:

ValueError on validation failure

class ironic_inspector.plugins.rules.RemoveTraitAction

Bases: RuleActionPlugin

REQUIRED_PARAMS = {'name'}

Set with names of required parameters.

apply(node_info, params, **kwargs)

Run action on successful rule match.

Parameters:

• node_info – NodeInfo object

• params – parameters as a dictionary

• kwargs – used for extensibility without breaking existing plugins

Raises:

utils.Error on failure

class ironic_inspector.plugins.rules.SetAttributeAction

Bases: RuleActionPlugin

FORMATTED_PARAMS = ['value']

List of params will be formatted with python format.

OPTIONAL_PARAMS = {'reset_interfaces', 'value'}

Set with names of optional parameters.

REQUIRED_PARAMS = {'path'}

Set with names of required parameters.

apply(node_info, params, **kwargs)

Run action on successful rule match.

Parameters:

• node_info – NodeInfo object

• params – parameters as a dictionary

• kwargs – used for extensibility without breaking existing plugins

Raises:

utils.Error on failure

validate(params, **kwargs)

Validate params passed during creation.

Default implementation checks for presence of fields from REQUIRED_PARAMS and fails for unexpected fields (not from REQUIRED_PARAMS + OPTIONAL_PARAMS).

Parameters:

• params – params as a dictionary

• kwargs – used for extensibility without breaking existing plugins

Raises:

ValueError on validation failure

class ironic_inspector.plugins.rules.SetCapabilityAction

Bases: RuleActionPlugin

FORMATTED_PARAMS = ['value']

List of params will be formatted with python format.

OPTIONAL_PARAMS = {'value'}

Set with names of optional parameters.

REQUIRED_PARAMS = {'name'}

Set with names of required parameters.

apply(node_info, params, **kwargs)

Run action on successful rule match.

Parameters:

• node_info – NodeInfo object

• params – parameters as a dictionary

• kwargs – used for extensibility without breaking existing plugins

Raises:

utils.Error on failure

class ironic_inspector.plugins.rules.SimpleCondition

Bases: RuleConditionPlugin

check(node_info, field, params, **kwargs)

Check if condition holds for a given field.

Parameters:

• node_info – NodeInfo object

• field – field value

• params – parameters as a dictionary, changing it here will change what will be stored in database

• kwargs – used for extensibility without breaking existing plugins

Raises:

ValueError – on unacceptable field value

Returns:

True if check succeeded, otherwise False

op = None

ironic_inspector.plugins.rules.coerce(value, expected)