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