Skip to content
message-square

GitHub Action

Code coverage comments

v2.2 Latest version

Code coverage comments

message-square

Code coverage comments

Comment code coverage from `lcov.info` or `clover.xml` file in commits or PRs

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Code coverage comments

uses: kcjpop/[email protected]

Learn more about this action in kcjpop/coverage-comments

Choose a version

A Github action to comment coverage data from a clover.xml or lcov.info file in commits/ PRs.

Features:

  • ☘️ Support clover.xml or lcov.info
  • 💬 Delete old comments to avoid spamming the conversation
  • ✨ Clean, minimal comment
  • 🥳 Emojis

To be developed:

  • Config param to specify coverage comments on commits, PRs, or both
  • Config param to show coverages of changed files only

"An example of how code coverage comment on a commit"

Usage

In your workflow:

jobs:
  your-job:
    runs-on: ubuntu-latest
+    # Require to specify permissions
+    permissions: write-all
    steps:
      - uses: actions/checkout@v3
      - uses: pnpm/action-setup@v2
        with:
          version: 7.30.0
      - run: pnpm install
      - run: pnpm test
+      # This needs to be run after a test job so coverage file will be available.
+      - uses: kcjpop/[email protected]
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          coverage-file: './coverage/clover.xml'

Configurations

Parameter Description Mandatory Default value
github-token Yes ${{ github.token }}
coverage-file Path to lcov.info or clover.xml file Yes
working-directory Set working directory if project is not in root folder No './'
delete-old-comments Keep only one coverage comment, to avoid spamming a PR with outdated info No true

Example: lcov.info is in a different folder

- uses: kcjpop/[email protected]
  with:
    github-token: ${{ secrets.GITHUB_TOKEN }}
    coverage-file: 'front/coverage/lcov.info'

Acknowledgements

This codebase is largely based on prior work of romeovs/lcov-reporter-action.