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: 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.1.dev6+gbf9816a'

the version of the current Cumin module.

Type:

str

Subpackages and Submodules