Test IT TMS adapter for Robot Framework

Test IT

Getting Started

Installation

pip install testit-adapter-robotframework

Usage

Configuration

File

  1. Create connection_config.ini file in the root directory of the project:

    [testit]
URL = <url>
privateToken = <token>
projectId = <id>
configurationId = <id>
testRunId = <optional id>
testRunName = <optional name>
adapterMode = <optional>

# This section are optional. It enables debug mode.
[debug]
tmsProxy = {"http": "http://localhost:8888", "https": "http://localhost:8888"}

  2. Fill parameters with your configuration, where:

    • URL - location of the TMS instance

    • privateToken - API secret key

      1. go to the https://{DOMAIN}/user-profile profile
      2. copy the API secret key

    • projectId - ID of project in TMS instance.

      1. create a project
      2. open DevTools -> network
      3. go to the project https://{DOMAIN}/projects/20/tests
      4. GET-request project, Preview tab, copy id field

    • configurationId - ID of configuration in TMS instance.

      1. create a project
      2. open DevTools -> network
      3. go to the project https://{DOMAIN}/projects/20/tests
      4. GET-request configurations, Preview tab, copy id field

    • testRunId - id of the created test run in TMS instance. testRunId is optional. If it is not provided, it is created automatically.

    • testRunName - parameter for specifying the name of test run in TMS instance. testRunName is optional. If it is not provided, it is created automatically.

    • adapterMode - adapter mode. Default value - 0. The adapter supports following modes:

      • 0 - in this mode, the adapter filters tests by test run ID and configuration ID, and sends the results to the test run.
      • 1 - in this mode, the adapter sends all results to the test run without filtering.
      • 2 - in this mode, the adapter creates a new test run and sends results to the new test run.

    • tmsProxy - it enables debug mode. tmsProxy is optional.

  3. Import TMSLibrary in your RobotFramework Tests (see examples directory)

ENV

You can use environment variables (environment variables take precedence over file variables):

  • TMS_URL - location of the TMS instance.

  • TMS_PRIVATE_TOKEN - API secret key.

  • TMS_PROJECT_ID - ID of a project in TMS instance.

  • TMS_CONFIGURATION_ID - ID of a configuration in TMS instance.

  • TMS_ADAPTER_MODE - adapter mode. Default value - 0.

  • TMS_TEST_RUN_ID - ID of the created test-run in TMS instance. TMS_TEST_RUN_ID is optional. If it is not provided, it is created automatically.

  • TMS_TEST_RUN_NAME - name of the new test-run.TMS_TEST_RUN_NAME is optional. If it is not provided, it is created automatically.

  • TMS_CONFIG_FILE - name of the configuration file. TMS_CONFIG_FILE is optional. If it is not provided, it is used default file name.

  • TMS_PROXY - it enables debug mode. TMS_PROXY is optional.

Command line

You also can use CLI variables, that sent to Robot Framework via -v option (CLI variables take precedence over environment variables):

  • tmsUrl - location of the TMS instance.

  • tmsPrivateToken - API secret key.

  • tmsProjectId - ID of a project in TMS instance.

  • tmsConfigurationId - ID of a configuration in TMS instance.

  • tmsAdapterMode - adapter mode. Default value - 0.

  • tmsTestRunId - ID of the created test-run in TMS instance. tmsTestRunId is optional. If it is not provided, it is created automatically.

  • tmsTestRunName - name of the new test-run.tmsTestRunName is optional. If it is not provided, it is created automatically.

  • tmsConfigFile - name of the configuration file. tmsConfigFile is optional. If it is not provided, it is used default file name.

  • tmsProxy - it enables debug mode. tmsProxy is optional.

Examples

Launch with a connection_config.ini file in the root directory of the project:

$ robot -v testit <test directory>

Launch with command-line parameters (parameters are case-insensitive):

$ robot -v testit -v tmsUrl:<url> -v tmsPrivateToken:<token> -v tmsProjectId:<id> -v tmsConfigurationId:<id> -v tmsTestRunId:<optional id> -v tmsTestRunName:<optional name> -v tmsProxy:'{"http":"http://localhost:8888","https":"http://localhost:8888"}' -v tmsConfigFile:<optional file> <test directory>

Tags

Tags can be used to specify information about autotest. Tags are space sensitive, use only one space between words.

Description of tags:

  • testit.workItemsId - linking an autotest to a test case
  • testit.displayName - name of the autotest in the Test IT system (default - name of test)
  • testit.externalId - ID of the autotest within the project in the Test IT System
  • testit.title - title in the autotest card (default - name of test)
  • testit.description - description in the autotest card (default - documentation of test)
  • testit.links - links in the autotest card
  • testit.labels - labels in the autotest card

Description of methods:

  • Add Links - links in the autotest result
  • Add Link - add one link in the autotest result
  • Add Attachments - uploading files in the autotest result
  • Add Attachment - upload given content with given filename in the autotest result
  • Add Message - information about autotest in the autotest result

Parallel execution

You can also run your test in parallel with Pabot.

$ pabot --pabotlib -v testit <test directory>

All other settings are the same as for standard execution.

Examples

*** Settings ***
Documentation      Main Suite with examples
Library            testit_adapter_robotframework.TMSLibrary

*** Variables ***
&{SIMPLE_LINK}             url=http://google.com
&{FULL_LINK}               url=http://google.co.uk   title=Google     type=Related   description=just a link

@{LINKS}               ${SIMPLE_LINK}   ${FULL_LINK}


*** Test Cases ***
Simple Test
    [Setup]  Setup
    Do Something
    Do Another Thing
    Log  I'am a step
    [Teardown]  Teardown

Simple Test with link as variable
    [Tags]   testit.links:${SIMPLE_LINK}
    [Setup]  Setup
    Do Something
    Do Another Thing
    Log  I'am a step
    [Teardown]  Teardown

Simple Test with link as dict
    [Tags]   testit.links:${{{'url': 'http://google.com', 'type':'Issue'}}}
    [Setup]  Setup
    Do Something
    Do Another Thing
    Log  I'am a step
    [Teardown]  Teardown

Simple Test with WorkitemId as string
    [Tags]   testit.workitemsID:123
    [Setup]  Setup
    Do Something
    Do Another Thing
    Log  I'am a step
    [Teardown]  Teardown

Simple Test with WorkitemId as list
    [Tags]   testit.workitemsID:${{[123, '456']}}
    [Setup]  Setup
    Do Something
    Do Another Thing
    Log  I'am a step
    [Teardown]  Teardown

Simple Test with Title or Description or DisplayName with simple formatting
    [Documentation]  Tags are space sensitive, use only one space between words
    [Tags]   testit.displayName:This works     testit.title:'This also works'
    ...    testit.description:"This works too"
    [Setup]  Setup
    Do Something
    Do Another Thing
    Log  I'am a step
    [Teardown]  Teardown

Test With All Params
    [Documentation]  It's better to use this kind of formatting for different data types in tags
    [Tags]   testit.externalID:123    testit.title:${{'Different title'}}   testit.displayName:${{'Different name'}}
    ...     testit.description:${{'Different description'}}    testit.workitemsID:${{[123, '456']}}
    ...     testit.links:${{{'url': 'http://google.com', 'type':'Issue'}}}   testit.labels:${{['smoke', 'lol']}}
    [Setup]  Setup
    Log    Something
    Log    Another
    [Teardown]  Teardown

Test With Add Link
    [Setup]  Setup
    Do Something
    Do Another Thing
    Add Links    @{LINKS}
#    You can also add one link (default type is Defect)
    Add Link    http://ya.ru
    Add Link    http://ya.ru    type=Issue
    Add Link    ${SIMPLE_LINK}[url]
    [Teardown]  Teardown

Test With Add Attachment
    [Setup]  Setup
    Do Something
    Do Another Thing
    ${V}   Get Variables
    Add Attachment    '${V}'    file.txt
    Add Attachments    images/banner.png     images/icon.png
    [Teardown]  Teardown

Test With Add Message
    [Setup]  Setup
    Do Something
    Do Another Thing
    Add Message    Wow, it's my error message!
    Fail
    [Teardown]  Teardown

Contributing

You can help to develop the project. Any contributions are greatly appreciated.

  • If you have suggestions for adding or removing projects, feel free to open an issue to discuss it, or directly create a pull request after you edit the README.md file with necessary changes.
  • Please make sure you check your spelling and grammar.
  • Create individual PR for each suggestion.
  • Please also read through the Code Of Conduct before posting your first idea as well.

License

Distributed under the Apache-2.0 License. See LICENSE for more information.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (5.1.0.post580)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for TestIT from gravatar.com TestIT

Credits

Author: Integration team

License

Apache-2.0

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

testit-adapter-robotframework-2.0.4.tar.gz (11.3 kB view details)

Uploaded Source

File details

Details for the file testit-adapter-robotframework-2.0.4.tar.gz.

File metadata

File hashes

Hashes for testit-adapter-robotframework-2.0.4.tar.gz
Algorithm Hash digest
SHA256 82f649af4db58cc2e70b574763aaa060752a92803aa510b4d62acf30faa9e4b7
MD5 529f311b2da8494b55c62812a3d75f9f
BLAKE2b-256 44dc3c820c1f9a57a3b9ff61444b493e073e26fc54b0d0a926b8d1916c3b1834

See more details on using hashes here.

Release history Release notifications | RSS feed

5.1.0.post580

5.1.0

5.0.0.post580

5.0.0

4.3.2.post580

4.3.1.post580

4.3.0.post580

4.2.12

4.2.11

4.2.10

4.2.9

4.2.8.post570

4.2.8

4.2.7.post570

4.2.6.post570

4.2.6

4.2.6rc2 pre-release

4.2.6rc1 pre-release

4.2.5.post570

4.2.5

4.2.4.post570

4.2.4

4.2.3.post570

4.2.3

4.2.2.post570

4.2.2

4.2.1.post570

4.2.0.post570

4.2.0

4.1.14

4.1.13

4.1.12.post570

4.1.12

4.1.11

4.1.10.post570

4.1.10

4.1.9.post570

4.1.9

4.1.8.post570

4.1.8

4.1.7.post570

4.1.7

4.1.6.post570

4.1.6

4.1.5.post570

4.1.4.post570

4.1.4

4.1.3.post570

4.1.3

4.1.2.post570

4.1.2

4.1.1.post570

4.1.1

4.1.0.post570

4.1.0

4.0.0

3.12.4

3.12.3

3.12.2

3.12.1

3.12.0

3.11.6.post560

3.11.5.post560

3.11.4.post560

3.11.3.post560

3.11.2.post560

3.11.2

3.11.1.post560

3.11.1

3.11.0.post560

3.10.10rc1 pre-release

3.10.9.post550

3.10.9

3.10.8.post550

3.10.8

3.10.7.post550

3.10.7

3.10.6

3.10.5.post550

3.10.5

3.10.4.post550

3.10.4

3.10.2

3.10.1.post550

3.10.1

3.10.0

3.9.2.post540

3.9.1.post540

3.9.1

3.9.0

3.8.0

3.7.2.post540

3.7.2.post530

3.7.2

3.7.1.post540

3.7.1.post530

3.7.1

3.7.0.post540

3.7.0.post530

3.7.0

3.6.7.post540

3.6.7.post530

3.6.7

3.6.6.post540

3.6.6.post530

3.6.6

3.6.5.post540

3.6.5.post530

3.6.5

3.6.4.post530

3.6.4

3.6.3

3.6.2

3.6.1.post530

3.6.1

3.6.0.post530

3.6.0

3.5.5.post530

3.5.4

3.5.3

3.5.2

3.5.1

3.5.0

3.4.1

3.4.0

3.3.2

3.3.1

3.3.0

3.2.6

3.2.5

3.2.4

3.2.3

3.2.2

3.2.1

3.2.0

3.1.1

3.1.0

3.0.2

3.0.1

3.0.0

2.8.3

2.8.2

2.8.1

2.8.0

2.7.1

2.7.0

2.6.0

2.5.3

2.5.2

2.5.1

2.5.0

2.4.3

2.4.2

2.4.1

2.4.0

2.3.1

2.3.0

2.2.4

2.2.3

2.2.2

2.2.1

2.2.0

2.1.11

2.1.10

2.1.9

2.1.8

2.1.7

2.1.6

2.1.5

2.1.4

2.1.3

2.1.2

2.1.1

2.1.0

2.0.10

2.0.9

2.0.8

2.0.7

2.0.6

This release

2.0.4

2.0.3

2.0.2

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page