You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
A GitHub Action used to install and configure the Testspace client used for publishing test content to [Testspace.com](https://testspace.com).
4
+
# Testspace client Setup Action
5
+
A GitHub Action is used to install and configure the Testspace client used for publishing test results and reports to [Testspace.com](https://github.com/marketplace/testspace-com).
6
6
7
7
## Usage
8
8
Setting up the Testspace client:
@@ -14,21 +14,27 @@ with:
14
14
token: ${{ secrets.TESTSPACE_TOKEN }} # optional, only required for private repos
15
15
```
16
16
17
+
Once the client is setup for a job [test results](https://help.testspace.com/docs/publish/push-data-results#file-content) can be published to the Testspace server:
18
+
19
+
```
20
+
$ testspace results.xml
21
+
```
22
+
17
23
## Input
18
-
The Testspace client action requires a `domain` and optionally a token for pushing content.
24
+
The Testspace client action requires a `domain` and optionally a token for publishing test results.
19
25
20
26
*[Testspace domain](https://help.testspace.com/docs/dashboard/admin-signup) is the **organizational** name (*subdomain*) used when creating the account along with *.testspace.com*. The *.testspace.com* string is optional.
21
-
* [Testspace token](https://help.testspace.com/docs/dashboard/admin-user#account) is required when using a `private` repo.
27
+
*[Testspace access token](https://help.testspace.com/docs/dashboard/admin-user#account) is required when using a `private` repo.
22
28
23
-
## Example
24
-
The following hello world type of example:
29
+
## Examples
30
+
A few usage examples:
25
31
26
32
```
27
-
name: hello
33
+
name: CI
28
34
on:
29
35
push:
30
36
jobs:
31
-
build:
37
+
test:
32
38
runs-on: ubuntu-latest
33
39
steps:
34
40
- uses: actions/checkout@v2
@@ -37,12 +43,37 @@ jobs:
37
43
- uses: testspace-com/setup-testspace@v1
38
44
with:
39
45
domain: ${{github.repository_owner}}
40
-
- name: Push test results
46
+
- name: Publish Results to Testspace
41
47
run: |
42
48
testspace results.xml
43
49
if: always()
44
50
```
45
51
52
+
When using a **Matrix** it is recommended to use a `folder` to store the test results specific to each matric entry.
53
+
54
+
```
55
+
name: CI
56
+
on:
57
+
push:
58
+
jobs:
59
+
test:
60
+
runs-on: ${{ matrix.os }}
61
+
strategy:
62
+
matrix:
63
+
os: [ubuntu-latest, macos-latest, windows-latest]
64
+
steps:
65
+
..
66
+
- name: Publish Results to Testspace
67
+
run: |
68
+
testspace [ ${{ matrix.os }} ]results.xml
69
+
```
70
+
71
+
When using the [source directory](https://help.testspace.com/docs/publish/push-data-results#source) to organize your test results in corresponding `folders`.
72
+
73
+
```
74
+
$ testspace results.xml{path/to/test-source}
75
+
```
76
+
46
77
For more information on Publishing test results refer to the help [Overview on publishing](http://help.testspace.com/docs/publish/overview).
0 commit comments