Skip to content
You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
activity

GitHub Action

Report NYC coverage

v1

Report NYC coverage

activity

Report NYC coverage

GitHub Action that posts the report in a comment on a GitHub Pull Request from coverage data generated by nyc (istanbul)

Installation

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

              

- name: Report NYC coverage

uses: sidx1024/report-nyc-coverage-github-action@v1

Learn more about this action in sidx1024/report-nyc-coverage-github-action

Choose a version

GitHub Action: Report NYC coverage

GitHub Action that posts the report in a comment on a GitHub Pull Request from coverage data generated by nyc (istanbul)

Typical Usage

on: [pull_request]

jobs:
  my_app_job:
    runs-on: ubuntu-latest
    name: My App
    steps:
      - name: Checkout
        uses: actions/checkout@v3
        with:
          fetch-depth: 0 # required to detect changed files
          ref: ${{ github.event.pull_request.head.sha }}

      - name: Run tests
        run: npm run test

      - name: Generate NYC report
        run: |
          npx nyc report \
            --reporter json-summary \
            --report-dir nyc-coverage-report \
            --exclude-after-remap false

      - name: Report NYC coverage
        uses: sidx1024/nyc-coverage-reporter-action@main
        with:
          # Path to coverage output directory generated by "nyc report".
          coverage_output_directory: "nyc-coverage-report"

Usage

- uses: sidx1024/nyc-coverage-reporter-action@main
  with:
    # Path to coverage output directory generated by "nyc report".
    coverage_output_directory: ""

    # Template markdown file to be used for GitHub PR comment. Optional.
    # Default: comment-template.md
    comment_template_file: ""

    # An alternative GitHub token, other than the default provided by GitHub Actions
    # runner. Optional.
    # Default: ${{ github.token }}
    github_token: ""

    # Absolute path to the source files. The path will be trimmed from the coverage
    # data. Optional. Default is the github workspace directory with a trailing slash.
    # Default: ${{ format('{0}/', github.workspace) }}
    sources_base_path: ""
Input Description Default Required
coverage_output_directory Path to coverage output directory generated by "nyc report". true
comment_template_file Template markdown file to be used for GitHub PR comment. Optional. comment-template.md false
github_token An alternative GitHub token, other than the default provided by GitHub Actions runner. Optional. ${{ github.token }} false
sources_base_path Absolute path to the source files. The path will be trimmed from the coverage data. Optional. Default is the github workspace directory with a trailing slash. ${{ format('{0}/', github.workspace) }} false
Output Description Default Required
total_lines_coverage_percent Total lines coverage percent (XX.XX%)
total_branches_coverage_percent Total branches coverage percent (XX.XX%)
total_statements_coverage_percent Total statements coverage percent (XX.XX%)
total_functions_coverage_percent Total functions coverage percent (XX.XX%)
files_coverage_table HTML table content containing the file path and corresponding coverage percent for all files
changed_files_coverage_table HTML table content containing the file path and corresponding coverage percent for files changed in the PR
comment_body The comment body in HTML format