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