JUnit 5 plugin for Kiwi TCMS

Installation & usage

Add this into your pom.xml:

<dependency>
    <groupId>org.kiwitcms.java</groupId>
    <artifactId>kiwitcms-junit-plugin</artifactId>
    <version>x.y.z</version>
</dependency>

This plugin extends org.junit.jupiter.api.extension.Extension and has junit.jupiter.extensions.autodetection.enabled=true configured by default in pom.xml. This means Jupiter will pick it up automatically.

You may alternatively decorate your test suite with the KiwiTcmsExtension class but that should be redundant:

import org.junit.jupiter.api.Test;
import static org.hamcrest.MatcherAssert.assertThat;

import org.junit.jupiter.api.extension.ExtendWith;
import org.kiwitcms.java.junit.KiwiTcmsExtension;

@ExtendWith(KiwiTcmsExtension.class)
public class KiwiJsonRpcClientTest {
    @Test
    public void yourTest(){
        assertThat(...);
    }
}

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 test results and reporting them to the backend. 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)"

For a more detailed example see: http://kiwitcms.org/blog/atodorov/2019/02/22/how-to-use-kiwi-tcms-plugins-pt-1/

Changelog

Files signed with C0C5FF36, Kiwi TCMS <info@kiwitcms.org>

10.0 (02 Mar 2021)

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

• Upgrade jackson-databind from 2.10.0 to 2.12.0

9.0 (15 Jan 2021)

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

• Bump maven-checkstyle-plugin from 3.1.0 to 3.1.1
• Bump commons-configuration2 from 2.6 to 2.7
• Bump maven-javadoc-plugin from 3.1.1 to 3.2.0
• Bump mockito-core from 3.2.4 to 3.3.3
• Bump jackson-databind from 2.9.10.1 to 2.10.0
• Bump maven-surefire-plugin from 3.0.0-M4 to 3.0.0-M5
• Bump jacoco-maven-plugin from 0.8.5 to 0.8.6
• Bump mockito-core from 3.2.4 to 3.7.0
• Bump jackson-core from 2.10.2 to 2.12.1
• Remove unused method

8.0 (09 Feb 2020)

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

• Adjust field names for API changes coming in Kiwi TCMS v8.0
• Do not use deprecated product field when calling TestCase.create() API
• Bug-fix: take into account TCMS_RUN_ID environment variable
• Bump jackson-core from 2.10.0 to 2.10.2
• Bump maven-source-plugin from 3.2.0 to 3.2.1
• Bump maven-surefire-plugin from 3.0.0-M3 to 3.0.0-M4
• Bump mockito-core from 3.1.0 to 3.2.4

6.7.5 (10 Nov 2019)

Fixes moderate severity issue CVE-2019-16942, critical severity issue CVE-2019-16335 and critical severity issue CVE-2019-14540.

• Bump commons-beanutils from 1.9.3 to 1.9.4
• Bump jackson-core from 2.9.9 to 2.10.0
• Bump jackson-databind from 2.9.9 to 2.9.10.1
• Bump jacoco-maven-plugin from 0.8.4 to 0.8.5
• Bump junit-jupiter-api from 5.5.0 to 5.5.2
• Bump junit-jupiter-engine from 5.5.0 to 5.5.2
• Bump junit-platform-launcher from 1.5.0 to 1.5.2
• Bump hamcrest from 2.1 to 2.2
• Bump maven-javadoc-plugin from 3.1.0 to 3.1.1
• Bump maven-source-plugin from 3.1.0 to 3.2.0
• Bump mockito-core from 2.28.2 to 3.1.0

6.7.4 (06 July 2019)

• Bump junit-jupiter-api from 5.5.0-M1 to 5.5.0
• Bump junit-jupiter-engine from 5.5.0-M1 to 5.5.0
• Bump junit-platform-launcher from 1.4.2 to 1.5.0

6.7.3 (30 May 2019)

Fixes moderate severity issue CVE-2019-12086

• Test and build with openjdk8
• Bump jacoco-maven-plugin from 0.8.3 to 0.8.4
• Bump maven-compiler-plugin from 3.8.0 to 3.8.1
• Bump maven-source-plugin from 3.0.1 to 3.1.0
• Bump maven-checkstyle-plugin from 3.0.0 to 3.1.0
• Bump commons-configuration2 from 2.4 to 2.5
• Bump mockito-core from 2.27.0 to 2.28.2
• Bump jackson-core from 2.9.8 to 2.9.9
• Bump jackson-databind from 2.9.8 to 2.9.9

6.7.2 (01 May 2019)

• Don't create duplicate TestCases. Fixes Issue #50
• Still Beta quality

6.7.1 (15 April 2019)

• Don't create 2 test runs (Aneta Petkova). Fixes Issue #41
• Still Beta quality

6.7.0 (10 April 2019)

• Compatible with Kiwi TCMS v6.7 or newer. Fixes Issue #42
• Version string updated to reflect minimum server version
• Still Beta quality

1.0.3 (21 March 2019)

• Initial release. Beta quality!

Hacking

You need your ~/.m2/settings.xml to look something like this

<settings>
  <servers>
    <server>
      <id>ossrh</id>
      <username>kiwitcms-bot</username>
      <password>***</password>
    </server>
  </servers>

  <profiles>
    <profile>
      <id>ossrh</id>
      <activation>
        <activeByDefault>true</activeByDefault>
      </activation>
      <properties>
        <gpg.executable>gpg2</gpg.executable>
        <gpg.keyname>C0C5FF36</gpg.keyname>
      </properties>
    </profile>
  </profiles>
</settings>

To push a new release/SNAPSHOT update the version string in pom.xml and do

mvn clean deploy -P release

WARNING: consider setting junit.jupiter.extensions.autodetection.enabled=false im pom.xml if you are having problems building locally!

You will need Maven >= 3.3.9 which on RHEL/CentOS system can be obtained via SoftwareCollections:

scl enable rh-maven36 /bin/bash