Appsurify Script Installation
Index
Installation Instructions
Requirements
Python 3.6+
Installation Command
pip install appsurifyci --upgrade
Available Arguments
Required Arguments
| argument | options |
|---|---|
| apikey | Apikey from appsurify |
| url | Url of the appsurify instance i.e. "https://dummy.appsurify.com" |
| project | Name of the project |
| testsuite | Name of the testsuite |
| branch | Name of the branch the tests are running against |
| commit | SHA of the commit |
Recommended Arguments
| argument | options |
|---|---|
| runtemplate | Options - all tests, no tests (used just to push results from the prior command), prioritized tests (requires --percentage argument to be added and the percentage of tests to be run. See below for details |
| testtemplate | Options - mvn, cucumber mvn, sahi testrunner, sahi ant, testim, mocha, pytest, rspec, robotframework, cyprus, mstest, vstest, katalon, opentest. For additional integrations talk to the Appsurify team |
| runcommand | Command to execute tests in the target environment, if command is custom to your test suite |
| report | Location of xml reports created by the test run if this is not the default location for the test type |
Parameter Details - Tests Execution
| Option | Details |
|---|---|
| all tests | Will run all tests. Will fail on any failure. Recommended for nightly or weekly test executions |
| no tests | Will run no tests. Will fail on any failure. Recommended when starting with Appsurify to just upload data |
| prioritized tests | Requires the percentage argument. Will only fail the build on new/reopened defects. Recommended for your most frequent run type |
Example Usage
runtestswithappsurify --url "https://dummy.appsurify.com" --apikey "$APIKEY" --project "$PROJECT" --testsuite "$TESTSUITE" --runtemplate "prioritized tests" --testtemplate "mvn" --percentage "20" --commit "$COMMIT" --branch "$BRANCH"
Additional Arguments - For Customization
| argument | default | options/details |
|---|---|---|
| fail | newdefects, reopeneddefects | options newdefects, reopeneddefects, flakybrokentests, newflaky, reopenedflaky, failedtests, brokentests |
| rerun | "false" | whether failed tests should be rerun |
| maxrerun | 3 | the number of times failed tests should be rerun |
| failfast | "false" | whether after each set of test runs to determine if the build has failed (tests will still be rerun if this has been selected) |
| executioncommand | "" | Command to be executed following completion of the script [[teststorun]] will be replaced with the formatted list of tests to run |
| percentage | "" | Percentage of tests to be run if prioritized tests is selected in the runtemplate |
For CI specific integrations please contact Appsurify
Change Log
0.0.83
- multi repo to running tests
0.0.76
- multi repo to git script
0.0.72
- retries and timeouts for requests
0.0.67
- Additional logging for git
0.0.66
- Split for xunit azure
- Latest as option for commits
0.0.62
- Add support for Gradle cucumber and playwright
0.0.56
- Add Git script
0.0.33
- Improve azure functionality
- Set tests to run for variable on failure
0.0.31
- Add ability to run new tests
- Add ability to run all tests on weekend
0.0.26
- Add new runcommand param
- Add percentage
0.0.25
- Fix for invalid trx files
0.0.23
- Fix for webdriver io creating invalud Junit
- Fix for large trx files
- Improvement for specflow removing retry
0.0.22
- Include additional filter for Azure
0.0.21
- Change report to work for partial paths in Windows
0.0.19
- Update for Cypress
0.0.18
- Added recursive search for reports
0.0.17
- Add integration with Bitrise using --bitrise flag saves tests to env variable TESTS_TO_RUN
0.0.16
- Update for pipe output
0.0.12
- Update for pipe output
0.0.9
- Update for trainer
0.0.7 (08/02/2021)
- Update for Azure to run tests via saved variable
0.0.5 (08/02/2021)
- Default rerun to false
0.0.4 (08/02/2021)
- Add try catch to environment variable creation
0.0.3 (08/02/2021)
- Third Release
- Fix failfast tests
0.0.2 (07/02/2021)
- Second Release
0.0.1 (07/02/2021)
- First Release
1 maintainer
Release files for appsurifyci 0.1.51
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| appsurifyci-0.1.51.tar.gz | 101.0 kB | Details |
Release files / appsurifyci-0.1.51.tar.gz
| Download URL | appsurifyci-0.1.51.tar.gz |
|---|---|
| Size | 101.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a570890f575b46bcd72aac3801ebfe3d3e963eefd6dfc9206bec67f94c63be15
|
|
BLAKE2b-256 checksum How to use checksums |
ce11067b17dc2a2f1a5d7b0c168d1483efbc21fbeb0bf1ae8524462272228459
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.11.0
|
