Coverage monitor

A GitHub Action that monitor coverage.

Usage

Pre-requisites

Create a workflow .yml file in your repositories .github/workflows directory.

Inputs

Options	Description
github_token	Required. The GITHUB_TOKEN secret.
coverage_path	Required. Path to coverage reports.
coverage_format	Format of coverage, supported: auto, clover and json-summary. Defaults to auto.
working_dir	The working directory of the action. Defaults to workflow workspace.
clover_file	Deprecated. Path to Clover XML file. Prefer coverage_path instead of clover_file.
threshold_alert	Mark the build as unstable when coverage is less than this threshold. Defaults to 50.
threshold_warning	Warning when coverage is less than this threshold. Defaults to 90.
threshold_metric	A metric to check threshold on, supported: statements, lines, methods or branches. Defaults to lines.
check	Whether check the coverage thresholds. Default to true. Ignored when event does not support checks, is not pull_request.
status_context	A string label to differentiate this status from the status of other systems. Defaults to Coverage Report.
comment	Whether comment the coverage report. Default to true. Ignored when event does not support comments, is not pull_request.
comment_context	A string label to differentiate the comment posted by this action. Defaults to Coverage Report.
comment_mode	A mode for comments, supported: replace, update or insert. Defaults to replace.
comment_footer	Whether comment may contain footer. Defaults to true.

Example workflow

name: Tests
on: [pull_request]

jobs:
  build:
    runs-on: ubuntu-latest

    permissions:
        contents: read
        pull-requests: write
        statuses: write

    steps:
      - uses: actions/checkout@v4

      - name: Test
        run: npm test

      - name: Monitor coverage
        uses: slavcodev/coverage-monitor-action@v1
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          coverage_path: "logs/clover.xml"
          threshold_alert: 10
          threshold_warning: 50
          threshold_metric: "lines"

Permissions for the GITHUB_TOKEN

The action requires access to certain resources, thus requires the secret GITHUB_TOKEN with certain permissions.

The minimum required permissions includes the following (without considering the other steps of your job):

permissions:
    # Access to your repository.
    contents: read
    # Access to pull request. The `write` access if you the `comment` is enabled
    # within the action, otherwise can be `read`. 
    pull-requests: write
    # Access to pull request statuses. The `write` access if you the `check` is enabled
    # within the action, otherwise can be `read`.
    statuses: write

Refer to the documentation on settings at the following URLs:

• Automatic Token Authentication - GitHub Docs
• Assigning Permissions to Jobs - GitHub Docs
• Permissions required for GitHub Apps - GitHub Docs

Preview

Contributing

We would love for you to contribute, pull requests are welcome! Please see the CONTRIBUTING.md for more information.

License

MIT License