Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
tom-tan authored Feb 1, 2022
1 parent f2c4f9d commit 8863f61
Showing 1 changed file with 54 additions and 1 deletion.
55 changes: 54 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,55 @@
# cwl-run-tests
Action for running tests for CWL workflows

It is a custom Github Action for running tests for CWL workflows.

## Example

```yaml
jobs:
test:
runs-on: ubuntu-latest
steps:
# setup CWL runner
- uses: actions/checkout@v2
- name: Setup python for cwltool
uses: actions/setup-python@v2
with:
python-version: '3.9.x'
- name: Install cwltool
run: pip install cwltool
- uses: actions/setup-node@v2
with:
node-version: '14.x'

- name: Run tests
id: run-tests
uses: tom-tan/cwl-run-tests@v1.0.0
with:
test-list: test.yml
runner: cwltool
timeout: 30
result-title: Example test results

- name: Do something with resulted JUnit XML file
run: |
echo ${{ steps.run-conformance.outputs.result }}
```
## Input parameters
| Parameters | Required | Default | Description |
|---|---|---|---|
| `test-list` | true | - | file that lists test cases in cwltest format |
| `runner` | true | - | full path to CWL runner to be tested |
| `timeout` | false | 30 | timeout in seconds |
| `skip-python-install` | false | false | skip installing python interpreter |
| `allow-failure` | false | false | whether this action always succeeds even if some tests fail |
| `result-title` | false | `"Test result"` | title for test result |

The `skip-python-install` parameter is useful when CWL runner requires specific version of Python.

## Output parameters

| Parameters | Description |
|---|---|
| `result` | file name that stores the result of conformance tests in JUnit XMl format |

0 comments on commit 8863f61

Please sign in to comment.