Skip to content

Commit e7f4f97

Browse files

File tree

1 file changed

+11
-11
lines changed

1 file changed

+11
-11
lines changed

README.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -8,21 +8,21 @@ When running on `pull_request` events, a comment will be added to the PR with de
88

99
## Usage
1010

11-
This action's step needs to run after your test suite has outputted a coverage report file. Most major test runners can be configured to do so, very likely with the adition of a test coverage library, such as `simplecov` for `ruby`, `coverage.py` for `python`, or `istanbul` or `jest` for `javascript`, etc.
11+
This action's step needs to run after your test suite has outputted a coverage report file. Most major test runners can be configured to do so, very likely with the addition of a test coverage library, such as `simplecov` for `ruby`, `coverage.py` for `python`, or `istanbul` or `jest` for `javascript`, etc.
1212

1313
### Inputs:
1414

1515
| Name | Requirement | Description |
1616
| ---------------------------- | ----------- | ----------- |
17-
| `github-token` | _required_ | Default if not specified: `${{ github.token }}`. Can be also specified this way: `github-token: ${{ secrets.GITHUB_TOKEN }}`; Coveralls uses this token to verify the appropriate repo at Coveralls and send any new status updates based on your coverage results. This variable is built into Github Actions, so __do not add it to your secrets store__. [More Info](https://help.github.com/en/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)|
17+
| `github-token` | _required_ | Default if not specified: `${{ github.token }}`. Can also be specified this way: `github-token: ${{ secrets.GITHUB_TOKEN }}`; Coveralls uses this token to verify the appropriate repo at Coveralls and send any new status updates based on your coverage results. This variable is built into Github Actions, so __do not add it to your secrets store__. [More Info](https://help.github.com/en/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)|
1818
| `file` | _optional_ | Default: all coverage files that could be found. Local path to the coverage report file produced by your test suite. An error will be thrown if no file was found. This is the file that will be sent to the Coveralls API. Leave empty if you want to combine many files reports. |
1919
| `files` | _optional_ | Default: all coverage files that could be found. Space-separated list of coverage report files produced by your test suite. Example: `files: coverage/test1.lcov coverage/test2.lcov` |
2020
| `format` | _optional_ | Force coverage report format. If not specified, coveralls will try to detect the format based on file extension and/or content. Possible values: `lcov`, `simplecov`, `cobertura`, `jacoco`, `gcov`, `golang`, `python`. See also [supported coverage report formats list](https://github.com/coverallsapp/coverage-reporter#supported-coverage-report-formats). |
2121
| `flag-name` | _optional (unique required if parallel)_ | Job flag name, e.g. "Unit", "Functional", or "Integration". Will be shown in the Coveralls UI. |
2222
| `build-number` | _optional_ | Default: autodetected from CI. This should be the same for all jobs in a parallel build. Override this is useful if your CI tool assigns a different build number for each parallel build. |
2323
| `parallel` | _optional_ | Set to true for parallel (or matrix) based steps, where multiple posts to Coveralls will be performed in the check. `flag-name` needs to be set and unique, e.g. `flag-name: run ${{ join(matrix.*, ' - ') }}` |
2424
| `parallel-finished` | _optional_ | Set to true in the last job, after the other parallel jobs steps have completed, this will send a webhook to Coveralls to set the build complete. |
25-
| `carryforward` | _optional_ | Comma separated flags used to carryforward results from previous builds if some of the parallel jobs are missing. Used only with `parallel-finished`. |
25+
| `carryforward` | _optional_ | Comma-separated flags used to carry forward results from previous builds if some of the parallel jobs are missing. Used only with `parallel-finished`. |
2626
| `coveralls-endpoint` | _optional_ | Hostname and protocol: `https://<host>`; Specifies a [Coveralls Enterprise](https://enterprise.coveralls.io/) hostname. |
2727
| `allow-empty` | _optional_ | Default: `false`. Don't fail if coverage report is empty or contains no coverage data. |
2828
| `base-path` | _optional_ | Path to the root folder of the project the coverage was collected in. Should be used in monorepos so that coveralls can process filenames from your coverage reports correctly (e.g. packages/my-subproject) |
@@ -60,10 +60,10 @@ jobs:
6060

6161
- uses: actions/checkout@v4
6262

63-
- name: Use Node.js 16.x
64-
uses: actions/setup-node@v3
63+
- name: Install Node.js
64+
uses: actions/setup-node@v4
6565
with:
66-
node-version: 16.x
66+
node-version: lts/*
6767

6868
- name: npm install, make test-coverage
6969
run: |
@@ -91,10 +91,10 @@ jobs:
9191
- 2
9292
steps:
9393
- uses: actions/checkout@v4
94-
- name: Use Node.js 16.x
95-
uses: actions/setup-node@v3
94+
- name: Install Node.js
95+
uses: actions/setup-node@v4
9696
with:
97-
node-version: 16.x
97+
node-version: lts/*
9898

9999
- name: npm install
100100
run: npm install
@@ -133,7 +133,7 @@ The "Coveralls Finished" step needs to run after all other steps have completed;
133133
4. The commit on GitHub shows a new check for Coveralls with details "First build on function-f at 92.0%", and links to the Job on Coveralls.
134134
5. Line-by-line results indicate the new function is missing coverage.
135135
6. Create a pull request with the new branch.
136-
7. The `pull_request` check runs and the resulting coverage data triggers a `fail` status.
136+
7. The `pull_request` check runs, and the resulting coverage data triggers a `fail` status.
137137
8. A detailed comment is posted.
138138

139139
## Troubleshooting:
@@ -142,7 +142,7 @@ The "Coveralls Finished" step needs to run after all other steps have completed;
142142

143143
Ensure that:
144144

145-
1. Your workflow invokes the Coveralls action runs on pull requests, e.g.:
145+
1. Your workflow invokes the Coveralls action that runs on pull requests, e.g.:
146146

147147
```yaml
148148
on: ["push", "pull_request"]

0 commit comments

Comments
 (0)