Package: kiwitcms-junit.xml-plugin
This package allows you to read junit.xml files and
send the results toKiwi TCMS.Installationpip install kiwitcms-junit.xml-pluginConfiguration and environmentMinimal config file~/.tcms.conf:[tcms]
url = https://tcms.server/xml-rpc/
username = your-username
password = your-passwordFor more info seetcms-api docs.This plugin is only concerned with parsing the junit.xml format and executingtcms-apifunctions which will create/reuse test cases, test plans and test runs.tcms-apibehavior 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 foundhere.The above configuration creates a separate TestPlan for each branch, seeTP-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-apihas 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.xmlChangelogv12.8.1 (22 Dec 2023)Update tcms-api from 12.7 to 12.8.1Relax the requirement on tcms-api to allow for easier upgradesv12.7 (10 Dec 2023)Update junitparser from 2.8.0 to 3.1.0Update tcms-api from 12.2 to 12.7Calculatestop_dateonly whenstart_dateis valid (Michael Kaye)v12.2.999 (18 Apr 2023)Readstart_datefrom<testsuite timestamp>if it exists. FixesIssue #89Internal refactoring.WARNING:contains backwards incompatible changes fortestcase_summary()andtestexecution_timestamps()methods which will
break inherited classesv12.2 (04 Apr 2023)Report TestExecution timestamps if present in XMLv12.1 (21 Mar 2023)Decode byte strings before sending comments to RPC (Sergey Lazarev)Format comments as Markdown when rendering the raw XML valuesAppend stdout/stderr information to failure/error commentsUpdates around CI and expanded test matrixv12.0 (16 Mar 2023)Provide a--summary-templatefor optional customization of the
summary generated from the test cases (Michael Kaye)Update junitparser from 2.5.0 to 2.8.0Update tcms-api from 11.3 to 11.4Refactoring and code formattingAdd CodeQL workflow for GitHub code scanningv11.3 (18 May 2022)Update tcms-api from 11.2 to 11.3Print information about created records if-vor--verboseis specified on the command lineAllow multiple XML files to be specified on the command linev11.2 (16 May 2022)Update junitparser from 2.2.0 to 2.5.0Update tcms-api from 11.0 to 11.2Annotate plugin with name & version informationTrim TestCase.summary to 255 characters. FixesIssue #44Updates around testing of this packagev11.0 (05 Dec 2021)Future compatible with upcoming Kiwi TCMS v11.0Update tcms-api to 11.0Update junitparser from 2.0.0 to 2.2.0Fix pylint issuesv10.0 (02 Mar 2021)Compatible with Kiwi TCMS v10.0Update tcms-api to 10.0v9.0 (13 Jan 2021)Compatible with Kiwi TCMS v9.0Update tcms-api to 9.0Update junitparser to 2.0.0Adjusted code to handle jUnit v2.0 filesv8.4 (28 Oct 2020)Update tcms-api to 8.6.0Update junitparser to 1.6.0v8.3 (10 Apr 2020)Update totcms-api v8.3.0which usesgssapifor KerberosRequires MIT Kerberos for Windows if installed on Windowsv8.2 (03 Apr 2020)This version works only with Kiwi TCMS v8.2 or later!Update to tcms-api==8.2.0Patch for changed return value inplugin_helpers.Backend.test_case_get_or_create()Callplugin_helpers.backend.finish_test_run()when donev8.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.0Require tcms-api==8.0.1v0.5 (07 January 2020)Update junitparser from 1.3.4 to 1.41v0.4 (20 September 2019)Update junitparser from 1.3.2 to 1.3.4Support XML files with <testsuites> root tag (Katalon Studio).
FixesIssue #9v0.3 (10 April 2019)Works with Kiwi TCMS v6.7 or newerUses new names of API methods