fish-shop/run-fishtape-tests

A GitHub action for running Fishtape tests.

---

Here's an example from the test workflow for Pond:

Prerequisites

This action requires the fish shell. You can install it using the fish-actions/install-fish action.

Usage

Add a suitable uses step to your GitHub workflow as shown below:

- name: Run Fishtape tests
  uses: fish-shop/run-fishtape-tests@v1

By default, all files under $GITHUB_WORKSPACE with a .fish file extension are recursively tested. To specify a different file pattern to match against, provide a value for the pattern input. For example, to check all .fish files starting in the tests directory and descending into subdirectories:

- name: Run Fishtape tests
  uses: fish-shop/run-fishtape-tests@v1
  with:
    pattern: tests/**.fish

Multiple space-separated pattern values are supported and can include wildcards and brace expansion:

- name: Run Fishtape tests
  uses: fish-shop/run-fishtape-tests@v1
  with:
    pattern: tests/*.fish fixtures/**.fish {dir1,dir2}/**.fish ???-*.fish

By default, TAP output is piped to tap-diff for improved readability. To disable this functionality and produce raw TAP output set raw-output to 'true':

- name: Run Fishtape tests (raw TAP output)
  uses: fish-shop/run-fishtape-tests@v1
  with:
    pattern: tests/**.fish
    raw-output: 'true'

Action versions

Use one of the following patterns when specifying the version reference for this action in your workflow (i.e. the {ref} value in uses: fish-shop/run-fishtape-tests@{ref}):

Pattern	Example	Description
vX	v1	the latest v1.* release including non-breaking changes and bug fixes
vX.Y	v1.1	the latest v1.1.* release including bug fixes
vX.Y.Z	v1.1.0	the v1.1.0 release only

Tip

The recommended pattern is vX (e.g. v1). This will ensure that the version of the action used in your workflow includes the latest non-breaking changes and bug fixes, and guarantees compatibility with previous versions of that major release number.

Using a main branch reference in your workflow is not recommended as this branch may include breaking changes intended for the next major release.

Other GitHub actions

A number of related composite actions are also available from the fish-shop 🐟. Check them out:

• fish-shop/install-plugin - A GitHub action for installing fish shell plugins
• fish-shop/install-plugin-manager - A GitHub action for installing a fish shell plugin manager
• fish-shop/syntax-check - A GitHub action for syntax checking fish shell files

Acknowledgements

• Fish market icon made by Freepik from www.flaticon.com

License

fish-shop/run-fishtape-tests is provided under the terms of the MIT License.

Contact

Email me at marc.ransome@fidgetbox.co.uk or create an issue.