Metadata-Version: 1.1
Name: testcube-client
Version: 0.2.8
Summary: A Python client for testcube. (https://github.com/tobyqin/testcube)
Home-page: https://github.com/tobyqin/testcube-client
Author: Toby Qin
Author-email: toby.qin@live.com
License: MIT license
Description: ===============
        testcube-client
        ===============
        
        
        .. image:: https://img.shields.io/pypi/v/testcube-client.svg
                :target: https://pypi.python.org/pypi/testcube-client
        
        .. image:: https://img.shields.io/travis/tobyqin/testcube-client.svg
                :target: https://travis-ci.org/tobyqin/testcube-client
        
        .. image:: https://pyup.io/repos/github/tobyqin/testcube-client/shield.svg
             :target: https://pyup.io/repos/github/tobyqin/testcube-client/
             :alt: Updates
        
        
        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.
        
        
        .. _TestCube: https://github.com/tobyqin/testcube
        
        
        =======
        History
        =======
        
        0.2.6 (2017-06-19)
        ------------------
        * Always summarize run duration from test cases.
        
        0.2.5 (2017-06-19)
        ------------------
        * Bug fix - unicode exception message in python 2.
        
        0.2.4 (2017-06-16)
        ------------------
        * Bug fix - multiple cache hits error.
        
        0.2.2 (2017-06-13)
        ------------------
        * Support --force command when register a server.
        
        0.2.2 (2017-06-13)
        ------------------
        * Sum the testsuite time from testcases if there is no time attribute in result xmls.
        
        0.2.1 (2017-06-13)
        ------------------
        * Fix document moved header issue when server deployed in IIS server.
        
        0.2.0 (2017-06-12)
        ------------------
        * Add cache to improve performance.
        
        0.1.4 (2017-06-12)
        ------------------
        * 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.
        
Keywords: testcube,testcube-client,test platform,test client
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.5
