gha-timer 0.1.0

Time and group logs for GitHub actions

gha_timer

Time and group logs for GitHub actions

Quickstart

Start a timer:

$ gha-timer start

Get the elapsed time:

$ gha-timer elapsed --outcome success
                                                                      ✓ 10.8s
$ gha-timer elapsed --outcome failure
                                                                      ✕ 20.2s
$ gha-timer elapsed --outcome cancelled
                                                                      ✕ 33.6s
$ gha-timer elapsed --outcome skipped  
                                                                      ✕ 37.3s

Stop the timer:

$ gha-timer stop

Use the --name option to add group log lines:

$ gha-timer start --name "Build the project"
::group::Build the project
$ gha-timer elapsed --outcome success --name "Build the project"
::endgroup::Build the project
                                                                      ✓ 19.2s

Specify a custom configuration file with --config (or just create a ~/.timerrc) to control the color and icon for each outcome (steps.<step_id>.outcome: success, failure, cancelled, or skipped). Below is the default configuration:

success:
  color: green
  icon: "✓"
failure:
  color: red
  icon: "✕"
cancelled:
  color: yellow
  icon: "✕"
skipped:
  color: gray
  icon: "✕"

Supported colors are: red, green, yellow, blue, cyan, bright_red, bright_green, white, gray, and bg_grey.

Recommended Installation

Install the Python package and dependency management tool poetry using official documentation. You must have Python 3.11 or greater available on your system path, which could be managed by mamba, pyenv, or another package manager. Finally, install the dependencies of the project with:

poetry install

To check successful installation, run:

poetry run gha_timer hello --name Fulcrum

Installing into a Mamba Environment

Install the Python package and dependency management tool poetry and the environment manager mamba using official documentation. Create and activate a virtual environment with Python 3.11 or greater:

mamba create -n gha_timer python=3.11
mamba activate gha_timer

Then, because Poetry will auto-detect an activated environment, install the project with:

poetry install

To check successful installation, run:

gha_timer hello --name Fulcrum

Development and Testing

See the contributing guide for more information.