testcube-client 0.6.0

A Python client for testcube. (https://github.com/tobyqin/testcube)

testcube-client

A Python client for testcube.

• Free software: MIT license

• TestCube Project: https://github.com/tobyqin/testcube

• TestCube Client Project: https://github.com/tobyqin/testcube-client

Get Started

You should have python 2.7 or 3.x installed on your machine. Then follow steps here.

Installation

Install testcube-client via pip is the most easy way.

pip install testcube-client -U

Register to Server

You must have a TestCube server deployed at somewhere, then run --register command.:

testcube-client --register http://testcube-server:8000

Upload Run Results

Once you registered to a server, you will have 2 ways to upload test results, first choice is calling --start-run at the beginning and calling --finish--run when finished.:

# call --start-run before run started
testcube-client --start-run -name "nightly run for testcube"  --team Core --product TestCube

# call --finish-run after run finished
 testcube-client --finish-run --xunit-files "**/results/*.xml"

In this way, TestCube will record the exact start_time and end_time for the run.

Another choice is using --run command to upload test results like a batch.:

# put this command at the end of a run
testcube-client --run -n "smoke tests for testcube" -t XPower -p TestCube -v v1.0 -x "**/smoke*.xml"

With this choice, TestCube will use current time as end_time for the run, and guess start_time according to run duration.

Command-line Options

The optional arguments:

-h, --help            show this help message and exit
-r REGISTER, --register REGISTER
                      Register to the TestCube server, e.g.
                      http://server:8000
-run, --run           Upload run info at one time, require team,product,name
                      and xunit files.
-start, --start-run   Start a run, require team, product and a name.
-finish, --finish-run
                      Finish a run, require xunit files.

-x XUNIT_FILES, --xunit-files XUNIT_FILES
                      Specify the xunit xml results, e.g "**/result*.xml"
-n NAME, --name NAME  Specify the run name.
-t TEAM, --team TEAM  Specify the team name.
-p PRODUCT, --product PRODUCT
                      Specify the product name.
-v PRODUCT_VERSION, --product-version PRODUCT_VERSION
                      Specify the product version. [Optional]
-f, --force           Force the command, when force register, will clear all caches.

History

0.6.0 (2017-09-07)

• Able to upload result files using argument –result-files

0.5.0 (2017-07-07)

• Update due to testcube model changed, not compatible with prev versions

0.3.3 (2017-06-29)

• Improve run url in output.

• Bug fix - run duration data incorrect.

• Abort run if failed to analyze its xml.

• Always summarize run duration from test cases.

• Bug fix - unicode exception message in python 2.

• Bug fix - multiple cache hits error.

0.2.2 (2017-06-13)

• Support –force command when register a server.

• Sum the testsuite time from testcases if there is no time attribute in result xml.

• Fix document moved header issue when server deployed in IIS server.

• Add cache to improve performance.

• Fix import error.

0.1.3 (2017-06-12)

• Support register to TestCub server.

• Support –run command.

• Support –start-run command.

• Support –finish-run command.

0.1.0 (2017-06-08)

• First release on PyPI.