congress.cfg_validator.parsing module

Unmarshaling of options sent by the agent.

class congress.cfg_validator.parsing.IdentifiedOpt(id_, ns_id, **kwargs)

Bases: oslo_config.cfg.Opt

A subclass of option that adds a unique id and a namespace id

ids are based on hashes

congress.cfg_validator.parsing.add_namespace(conf, ns_dict, ns_hash)

Add options from a kind to an already existing config

congress.cfg_validator.parsing.add_parsed_conf(conf, normalized)

Add a normalized values container to a config manager.

Parameters

  • conf – A cfg.ConfigOpts object.

  • normalized – A normalized values container, as introduced by oslo cfg._Namespace.

congress.cfg_validator.parsing.construct_conf_manager(namespaces)

Construct a config manager from a list of namespaces data.

Register options of given namespaces into a cfg.ConfigOpts object. A namespaces dict is typically cfg_validator.generator output. Options are provided an hash as an extra field.

Parameters

namespaces – A list of dict, containing options metadata.

Returns

A cfg.ConfigOpts.

congress.cfg_validator.parsing.make_group(name, title, help_msg)

Declares a new group

Parameters

  • name – group name

  • title – group title

  • help_msg – descriptive help message

Returns

an oslo config group representation or None for default.

congress.cfg_validator.parsing.make_opt(option, opt_hash, ns_hash)

Declares a new group

Parameters

  • name – an option retrieved from json.

  • opt_hash – the option hash

  • ns_hash – the hash of the namespace defining it.

Returns

an oslo config option representation augmented with the hashes.

congress.cfg_validator.parsing.make_type(type_descr)

Declares a new type

Parameters

type_descr – a type description read from json.

Returns

an oslo config type

congress.cfg_validator.parsing.parse_config_file(namespaces, path)

Parse a config file from its pre-loaded namespaces.

Parameters

  • namespaces – A list of dict, containing namespaces data.

  • path – Path to the configuration file to parse.

Returns

congress.cfg_validator.parsing.parse_value(cfgtype, value)

Parse and validate a value’s type, raising error if check fails.

Raises

ValueError, TypeError