Skip to main content

junit.xml plugin for Kiwi TCMS test case management system

Project description

PyPI version Travis CI Code coverage Python updates TP for kiwitcms/junit.xml-plugin (master) Tidelift Become a sponsor Kiwi TCMS on Twitter

This package allows you to read junit.xml files and send the results to Kiwi TCMS.

Installation

pip install kiwitcms-junit.xml-plugin

Configuration and environment

Minimal config file ~/.tcms.conf:

[tcms]
url = https://tcms.server/xml-rpc/
username = your-username
password = your-password

For more info see tcms-api docs.

This plugin is only concerned with parsing the junit.xml format and executing tcms-api functions which will create/reuse test cases, test plans and test runs. tcms-api behavior is controlled via environment variables.

For example this is how our own environment looks like:

#!/bin/bash

if [ "$TRAVIS_EVENT_TYPE" == "push" ]; then
    # same as $TRAVIS_TAG when building tags
    export TCMS_PRODUCT_VERSION=$TRAVIS_BRANCH
fi

if [ "$TRAVIS_EVENT_TYPE" == "pull_request" ]; then
    export TCMS_PRODUCT_VERSION="PR-$TRAVIS_PULL_REQUEST"
fi

export TCMS_BUILD="$TRAVIS_BUILD_NUMBER-$(echo $TRAVIS_COMMIT | cut -c1-7)"

Further documentation and behavior specification can be found here.

The above configuration creates a separate TestPlan for each branch, see TP-7: [junit.xml] Plan for kiwitcms/junit.xml-plugin (master), a separate TestPlan for each pull request (recording possible multiple test runs) and separate TestPlan and TestRun for each tag on GitHub! tcms-api has default behavior for Travis CI and Jenkins and allows endless configuration via environment variables.

Usage

# define environment variables
tcms-junit.xml-plugin /path/to/junit.xml

Changelog

v11.2 (16 May 2022)

  • Update junitparser from 2.2.0 to 2.5.0

  • Update tcms-api from 11.0 to 11.2

  • Annotate plugin with name & version information

  • Trim TestCase.summary to 255 characters. Fixes Issue #44

  • Updates around testing of this package

v11.0 (05 Dec 2021)

  • Future compatible with upcoming Kiwi TCMS v11.0

  • Update tcms-api to 11.0

  • Update junitparser from 2.0.0 to 2.2.0

  • Fix pylint issues

v10.0 (02 Mar 2021)

  • Compatible with Kiwi TCMS v10.0

  • Update tcms-api to 10.0

v9.0 (13 Jan 2021)

  • Compatible with Kiwi TCMS v9.0

  • Update tcms-api to 9.0

  • Update junitparser to 2.0.0

  • Adjusted code to handle jUnit v2.0 files

v8.4 (28 Oct 2020)

  • Update tcms-api to 8.6.0

  • Update junitparser to 1.6.0

v8.3 (10 Apr 2020)

  • Update to tcms-api v8.3.0 which uses gssapi for Kerberos

  • Requires MIT Kerberos for Windows if installed on Windows

v8.2 (03 Apr 2020)

This version works only with Kiwi TCMS v8.2 or later!

  • Update to tcms-api==8.2.0

  • Patch for changed return value in plugin_helpers.Backend.test_case_get_or_create()

  • Call plugin_helpers.backend.finish_test_run() when done

v8.0.1 (10 February 2020)

This version works only with Kiwi TCMS v8.0 or later!

  • Adjust plugin due to API changes in Kiwi TCMS v8.0

  • Require tcms-api==8.0.1

v0.5 (07 January 2020)

  • Update junitparser from 1.3.4 to 1.41

v0.4 (20 September 2019)

  • Update junitparser from 1.3.2 to 1.3.4

  • Support XML files with <testsuites> root tag (Katalon Studio). Fixes Issue #9

v0.3 (10 April 2019)

  • Works with Kiwi TCMS v6.7 or newer

  • Uses new names of API methods

Project details


Download files

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

Source Distribution

kiwitcms-junit.xml-plugin-11.2.tar.gz (17.2 kB view details)

Uploaded Source

Built Distribution

kiwitcms_junit.xml_plugin-11.2-py3-none-any.whl (17.6 kB view details)

Uploaded Python 3

File details

Details for the file kiwitcms-junit.xml-plugin-11.2.tar.gz.

File metadata

File hashes

Hashes for kiwitcms-junit.xml-plugin-11.2.tar.gz
Algorithm Hash digest
SHA256 eaf8f8b4c72cf96fc4db9fcb0d57a32da1b3de5352f808a1304f40cf83f2a899
MD5 bc0b0d56e788190932957d6cfac72761
BLAKE2b-256 91b6ae8e9e224dfd011a9280618223ad105bd71363fb7cc75e5681319185c8f3

See more details on using hashes here.

File details

Details for the file kiwitcms_junit.xml_plugin-11.2-py3-none-any.whl.

File metadata

File hashes

Hashes for kiwitcms_junit.xml_plugin-11.2-py3-none-any.whl
Algorithm Hash digest
SHA256 8574f897f947e3b11c03644b0795f4ce54bcdabfc6a012f0c7efc1f52422b37e
MD5 f3911385d60932c8c8680da4f67fe83b
BLAKE2b-256 a716d59f71e1dab077d2b07109f2a0e7d5afb0ec18d96639dbfc9f9bc9974af4

See more details on using hashes here.

Supported by

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