Skip to content

Commit

Permalink
Initial README with basic instructions
Browse files Browse the repository at this point in the history
  • Loading branch information
dbramwell committed Mar 29, 2022
1 parent 5ea1821 commit 9e1fa85
Showing 1 changed file with 31 additions and 0 deletions.
31 changes: 31 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
# TestProject Job Runner

A github action to run automated testing jobs via [TestProject](https://testproject.io/)

## Usage
Example:
```yaml
on: [push]

jobs:
run_testproject_job:
runs-on: ubuntu-latest
name: Run TestProject Job
steps:
- name: Step to run TestProject Job
uses: dbramwell/testproject-job-runner
with:
api-key: ${{ secrets.TESTPROJECT_API_KEY }}
project-id: 'abcdefghijklmnopqrstuv'
job-id: 'abcdefghijklmnopqrstuv'
```
### Options
| Option | Description | Required | Default |
|------------------------|---------------------------------------------------------------------|----------|---------|
| `api-key` | TestProject API Key with permissions to execute the TestProject job | True | None |
| `project-id` | TestProject Project Id | True | None |
| `job-id` | TestProject Job Id | True | None |
| `execution-parameters` | String in JSON format defining [TestProject job execution parameters](https://api.testproject.io/docs/v2/#/Jobs/Jobs_RunJobAsync) | False | "{}" |
| `json-report` | Set to "on" to download json report to `$GITHUB_WORKSPACE/{job-id}-report.json` | False | Off |
| `junit-report` | Set to "on" to download junit report to `$GITHUB_WORKSPACE/{job-id}-report.xml` | False | Off |
| `pdf-report` | Set to "on" to download pdf report to `$GITHUB_WORKSPACE/{job-id}-report.pdf` | False | Off |

0 comments on commit 9e1fa85

Please sign in to comment.