Skip to content

Commit 8863f61

Browse files
authored
Update README.md
1 parent f2c4f9d commit 8863f61

File tree

1 file changed

+54
-1
lines changed

1 file changed

+54
-1
lines changed

README.md

Lines changed: 54 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,55 @@
11
# cwl-run-tests
2-
Action for running tests for CWL workflows
2+
3+
It is a custom Github Action for running tests for CWL workflows.
4+
5+
## Example
6+
7+
```yaml
8+
jobs:
9+
test:
10+
runs-on: ubuntu-latest
11+
steps:
12+
# setup CWL runner
13+
- uses: actions/checkout@v2
14+
- name: Setup python for cwltool
15+
uses: actions/setup-python@v2
16+
with:
17+
python-version: '3.9.x'
18+
- name: Install cwltool
19+
run: pip install cwltool
20+
- uses: actions/setup-node@v2
21+
with:
22+
node-version: '14.x'
23+
24+
- name: Run tests
25+
id: run-tests
26+
uses: tom-tan/[email protected]
27+
with:
28+
test-list: test.yml
29+
runner: cwltool
30+
timeout: 30
31+
result-title: Example test results
32+
33+
- name: Do something with resulted JUnit XML file
34+
run: |
35+
echo ${{ steps.run-conformance.outputs.result }}
36+
```
37+
38+
## Input parameters
39+
40+
| Parameters | Required | Default | Description |
41+
|---|---|---|---|
42+
| `test-list` | true | - | file that lists test cases in cwltest format |
43+
| `runner` | true | - | full path to CWL runner to be tested |
44+
| `timeout` | false | 30 | timeout in seconds |
45+
| `skip-python-install` | false | false | skip installing python interpreter |
46+
| `allow-failure` | false | false | whether this action always succeeds even if some tests fail |
47+
| `result-title` | false | `"Test result"` | title for test result |
48+
49+
The `skip-python-install` parameter is useful when CWL runner requires specific version of Python.
50+
51+
## Output parameters
52+
53+
| Parameters | Description |
54+
|---|---|
55+
| `result` | file name that stores the result of conformance tests in JUnit XMl format |

0 commit comments

Comments
 (0)