Skip to content

GitHub Action for summarising TAP (Test Anything Protocol) test results

License

Notifications You must be signed in to change notification settings

pcolby/tap-summary

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

60 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TAP Summary

Automatic Tests

GitHub Action for summarising TAP (Test Anything Protocol) test results. It summarises a collection of TAP files (such a produced by Qt Tests), and writes the result as a Markdown table to the GitHub step summary by default, or some other destination file if overridden.

Usage

- uses: pcolby/tap-summary@v1

Note, this will use a default path of **/*.tap, which depends on Bash's globstar support, which is not available on macOS's default Bash (which is really old). For macOS, either provide paths that don't depend on globstar, or upgrade Bash (eg via brew). This is not necessary for Linux and Windows.

Inputs

path

One or more paths to TAP files. This will undergo Bash expansion, so things like environment variables can be used, and must be quoted or escaped as appropriate.

Defaults to **/*.tap.

- uses: pcolby/tap-summary@v1
  with:
    path: >-
      path/to/tap-file
      'path/to a file with spaces.tap'
      path/with/globstar/**/*.tap
    summary-file: path/to/output/file.md

summary-file

The file to append the test summary to. Defaults to $GITHUB_STEP_SUMMARY.

- uses: pcolby/tap-summary@v1
  with:
    summary-file: path/to/output/file.md

Outputs

summary-file

The file the test summary was appended to. This is mostly just for automated tests, where it allows the invoking workflow job to check the summary output when the input summary-file is defaulted.