marathonlabs/Run tests using Marathon Cloud
Run tests using Marathon Cloud
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Activelast commit May 13, 2026
- License
- MIT
Pinned Snippet
uses: marathonlabs/action-test@0b5b432cda2554084ca6c8088cfafbc2ebf4ce0e # 1.0.21tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| version | marathon-cloud cli version to use | yes | — |
| apiKey | API key for authenticating with Marathon Cloud | yes | — |
| application | Application binary path, e.g. apk file for Android or zip file of iOS Application | yes | — |
| testApplication | Test application binary path, e.g. apk file for Android or zip file of iOS Test Runner app or folder containing maestro flow | yes | — |
| platform | Testing platform. [Android,iOS,Maestro/Android,Maestro/iOS] | yes | — |
| osVersion | Android or iOS OS version. For Android one of [8.1, 9, 10, 11, 12, 13, 14, 15, 16]. For iOS one of [17.5, 18.2, 18.4] | no | — |
| systemImage | OS-specific system image. For Android one of [default,google_apis,google_apis_playstore]. For iOS only [default] | no | — |
| link | Link to commit | no | — |
| output | Output folder for test run results | no | — |
| outputGlob | Only files matching this glob will be downloaded, i.e. 'tests/**' will download only the JUnit xml files | no | — |
| isolated | Run each test in isolation, i.e. isolated batching | no | — |
| flavor | Type of tests to run. Default: [native]. Possible values: [native, js-test-appium, python-robotframework-appium] | no | — |
| filterFile | File containing test filters in YAML format, following the schema described at https://docs.marathonlabs.io/runner/configuration/filtering/#filtering-logic. For iOS see also https://docs.marathonlabs.io/runner/next/ios#test-plans. | no | — |
| wait | Wait for test run to finish if true, exits after triggering a run if false. Defaults to true | no | — |
| name | Name for run, for example it could be description of commit | no | — |
| device | Device type. For Android one of [phone, tv, watch]. For iOS one of [iPhone-11, iPhone-15, iPhone-15-Pro, iPhone-15-Pro-Max, iPhone-16, iPhone-16-Plus, iPhone-16-Pro, iPhone-16-Pro-Max] | no | — |
| xcodeVersion | Xcode version. Only for iOS. Possible values: [15.4, 16.2, 16.3] | no | — |
| xctestplanFilterFile | Test filters supplied as .xctestplan file | no | — |
| xctestplanTargetName | Target name to use for test filtering in .xctestplan | no | — |
| xctestrunEnv | xctestrun environment variables, format: 'VAR1=VALUE1,VAR2=VALUE2' | no | — |
| xctestrunTestEnv | xctestrun testing environment variables, format: 'VAR1=VALUE1,VAR2=VALUE2' | no | — |
| ignoreTestFailures | When tests fail and this option is true then GHA will exit with code 0. By default, GHA will exit with code 1 in case of test failures and 0 for passing tests [possible values: true, false] | no | — |
| pullFiles | Pull files from devices after the test run. The format is 'ROOT1:PATH1,ROOT2:PATH2' where ROOT is one of [EXTERNAL_STORAGE, APP_DATA] and PATH is a relative path to the target file or directory. Example: EXTERNAL_STORAGE:Documents/some-results,APP_DATA:files/my_folder/some_file.txt. Note: Files with the same name and path from different devices may overwrite each other. | no | — |
| resultFile | Result file path in a machine-readable format. You can specify the format via extension [yaml,json]. Default file: result.json | no | — |
| branch | Branch for run, for example it could be git branch like develop or feature/about-screen | no | — |
| project | The unique identifier (slug) for the project | no | — |
| grantedPermission | Grant permission to application. Important: Granting is conducted before each test batch (not each test). If you need to grant before each test, please use --isolated mode. Available permissions: calendar, contacts-limited, contacts, location, location-always, photos-add, photos, media-library, microphone, motion, reminders, siri. Format: 'motion,siri' | no | — |
| analyticsReadOnly | If true then test run will not affect any statistical measurements [possible values: true, false] | no | — |
| retryQuotaTestUncompleted | Number of allowed uncompleted executions per test | no | — |
| retryQuotaTestPreventive | Number of allowed preventive retries per test | no | — |
| retryQuotaTestReactive | Number of allowed reactive retries per test | no | — |
| noRetries | Disable all retries [possible values: true, false] | no | — |
| maestroEnv | maestro environment variables, format: 'MAESTRO_APP_ID=com.example,MAESTRO_OTHER_VAR=blahblah' | no | — |
| flows | maestro flows to execute, all the files specified should be inside the testApplication folder: 'flows/my-flow.yaml,flows/subfolder/flow.yaml' | no | — |
Outputs
no outputs