Python API

Cumin Python API autodoc.

Automation and orchestration framework written in Python.

exception cumin.CuminError[source]

Bases: Exception

Base Exception class for all Cumin's custom Exceptions.

cumin.trace(self, msg, *args, **kwargs)[source]

Additional logging level for development debugging.

Parameters

according to logging.Logger interface for log levels.

class cumin.Config(config='/etc/cumin/config.yaml')[source]

Bases: dict

Singleton-like dictionary class to load the configuration from a given path only once.

Load the given configuration if not already loaded and return it.

Called by Python's data model for each new instantiation of the class.

Parameters

config (str, optional) -- path to the configuration file to load.

Returns

the configuration dictionary.

Return type

dict

Examples

>>> import cumin
>>> config = cumin.Config()
cumin.parse_config(config_file)[source]

Parse the YAML configuration file.

Parameters

config_file (str) -- the path of the configuration file to load.

Returns

the configuration dictionary.

Return type

dict

Raises

CuminError -- if unable to read or parse the configuration.

cumin.nodeset(nodes=None)[source]

Instantiate a ClusterShell NodeSet with the resolver defaulting to RESOLVER_NOGROUP.

This allow to avoid any conflict with Cumin grammars.

Returns

the instantiated NodeSet.

Return type

ClusterShell.NodeSet.NodeSet

cumin.nodeset_fromlist(nodelist)[source]

Instantiate a ClusterShell NodeSet from a list with the resolver defaulting to RESOLVER_NOGROUP.

This allow to avoid any conflict with Cumin grammars.

Returns

the instantiated NodeSet.

Return type

ClusterShell.NodeSet.NodeSet

cumin.ensure_kerberos_ticket(config: cumin.Config) None[source]

Ensure that there is a valid Kerberos ticket for the current user, according to the given configuration.

Parameters

config (cumin.Config) -- the Cumin's configuration dictionary.

cumin.__version__ = '4.2.0'

the version of the current Cumin module.

Type

str

Subpackages and Submodules