The coverage-scope package ensures that a cobertura.xml
coverage format file
meets a minimum coverage threshold. It is specially designed to check if the
coverage of changed files in a pull request meets a minimum threshold,
preventing a decrease in coverage. The package also checks the total coverage of
the project.
The package currently has only been tested with the following coding languages:
- Python
- Rust
- Golang
- Dart
- C#
- Angular
- React
These are the only languages that have been tested. However, the logic should be applicable for other languages.
IMPORTANT: When checking out the repository, you need to set the fetch depth
to 0
the actions/checkout@v3
action.
- uses: actions/checkout@v3
with:
fetch-depth: 0
To use the GitHub actions for coverage-scope, you need to provide the
cobertura
coverage file in xml format, the branch you want to compare against
when measuring changed files coverage, and the minimum threshold for both the
total coverage and the changed files coverage.
- uses: dennisjensen95/[email protected]
with:
coverage-filepath: cobertura.xml
branch: main
threshold-total: 80
threshold-change: 90
I made this because I could not find a GitHub action that did this. I wanted specifically to allow pull requests to not have a total specific coverage and then only check if the changed files in the pull request met a minimum threshold. This is useful if you have a large project with a lot of legacy code, or you join a team that has not been testing, that you do not want to have to fix coverage for. This way you can ensure that new code meets a minimum threshold.