Usage of colin in Python code

The colin CLI is only a wrapper around the colin’s python library.

All functionality can be accessed directly from the python code:

Module colin.core.colin

Functions

get_checks(target_type=None, tags=None, ruleset_name=None, ruleset_file=None, ruleset=None, logging_level=30, checks_paths=None, skips=None) : Get the sanity checks for the target.

param skips:

name of checks to skip

param target_type:

TargetType enum

param tags:

list of str (if not None, the checks will be filtered by tags.)

param ruleset_name:

str (e.g. fedora; if None, default would be used)

param ruleset_file:

fileobj instance holding ruleset configuration

param ruleset:

dict, content of a ruleset file

param logging_level:

logging level (default logging.WARNING)

param checks_paths:

list of str, directories where the checks are present

return:

list of check instances

run(target, target_type, tags=None, ruleset_name=None, ruleset_file=None, ruleset=None, logging_level=30, checks_paths=None, pull=None, insecure=False, skips=None, timeout=None) : Runs the sanity checks for the target.

param timeout:

timeout per-check (in seconds)

param skips:

name of checks to skip

param target:

str (image name, oci or dockertar) or ImageTarget or path/file-like object for dockerfile

param target_type:

string, either image, dockerfile, dockertar

param tags:

list of str (if not None, the checks will be filtered by tags.)

param ruleset_name:

str (e.g. fedora; if None, default would be used)

param ruleset_file:

fileobj instance holding ruleset configuration

param ruleset:

dict, content of a ruleset file

param logging_level:

logging level (default logging.WARNING)

param checks_paths:

list of str, directories where the checks are present

param pull:

bool, pull the image from registry

param insecure:

bool, pull from an insecure registry (HTTP/invalid TLS)

return:

Results instance