Reporting in Cloudgene¶
Cloudgene supports reporting by parsing the standard output (stdout) of each process it runs. This allows users to generate detailed logs and reports using specific output commands. The functionality is similar to GitHub Actions, utilizing annotations and groups to organize and present information effectively.
Example¶
Output Commands¶
Cloudgene recognizes a series of specific commands in the stdout that help classify and structure log messages. Below is a list of supported commands and their usage:
Error Messages¶
To log an error message:
General Messages¶
To log a general message:
Notices¶
To log a notice message:
Warnings¶
To log a warning message:
Debug Messages¶
To log a debug message:
Grouping Messages¶
Cloudgene allows grouping of related log messages to enhance readability. Groups can have a specified type (e.g., error, warning) to provide additional context. Use the following commands to start and end a group:
Start a Group¶
To start a group:
This will group subsequent log messages until the group is closed.End a Group¶
To end a group:
Example Group¶
echo "::group type=error::"
echo "This is a list:"
echo "- Line 1"
echo "- Line 2"
echo "::endgroup::"
Counters¶
Cloudgene supports setting and submitting counters, which can be useful for tracking various metrics during the execution of a process.
Set a Counter¶
To set a counter with a specific name and value:
Submit a Counter¶
To submit a counter, which can then be used for further processing or reporting: