This document contains the change log for all Integration Test Framework releases since 0.1.0.

Please refer to the User Guide for a comprehensive overview and detailed instructions how to use the Integration Testing Framework.

Pre-release 0.10.0

Date of Release: ??, 2021

Scope:

  • Refactoring/Code cleanups

Enhancements

  • Fixed #180 - Enable debugging of plugin while running integration tests.

Details

Breaking Changes

  • Fixed #140 - Remove deprecated marked annotation elements and code

  • Fixed #142 - Reduce visibility of classes; If you have used the following classes ApplicationExecutor or DirectoryHelper in your code they have be made invisible for users. No alternative available.

  • Fixed #143 - Deprecate ExecutionResult.Error; If you have used that directly within your code you should change your code. This is being marked deprecated and will be removed with release 0.11.0.

  • Fixed #175 - Enhance the MavenProjectResult. Based on the enhancements we have added getTargetBaseDirectory() and getTargetCacheDirectory(). getTargetBaseDirectory() is the same as getBaseDir() to keep compatibility in release 0.10.0. The getBaseDir() has been marked deprecated and will be removed with release 0.11.0.

  • Fixed #163 - You have to change the configuration within your test pom.xml file. The configuration to filter the content of the resources-its directory.

    <testResource>
  <directory>src/test/resources-its</directory>
  <filtering>true</filtering>
</testResource>

    This is not allowed anymore. This means you have to bind the itf-maven-plugin with a supplemental goal in your pom file as shown in the following example:

    <plugin>
<groupId>com.soebes.itf.jupiter.extension</groupId>
<artifactId>itf-maven-plugin</artifactId>
<version>0.10.0</version>
<executions>
  <execution>
    <id>installing</id>
    <phase>pre-integration-test</phase>
    <goals>
      <goal>install</goal>
      <goal>resources-its</goal>
    </goals>
  </execution>
</executions>
</plugin>

    You have to add the supplemental goal resources-its in your configuration.

  • Fixed #186 - based on a typo in the method name isSuccesful() of the class MavenExecutionResult instead of isSuccessful() the method isSuccesful() is marked deprecated and should not being used anymore and will be removed with release 0.11.0. Replace it with isSuccessful().

  • Fixed #177 - Move creation of target structure into beforeEach. This change could influence your integration tests. So please check your build. If you have issues please report them.

Reporter of issues

  • Vincent Privat

Reporter of this release

  • ??

    • {pr-???} - ..

Contributors of this release

  • ??

    • {issue-??} - ??

Dependency Upgrades

Build Improvements

The full release notes can be found here Release 0.10.0.

Pre-release 0.9.0

Date of Release: August 12, 2020

Scope:

  • Refactoring/Code cleanups

    • Fixed #130 - Moving Conditions into separate package

    • Fixed #131 - Reduce visibility of MavenITExtension.

    • Fixed #132 - Remove StringInterpolator from public API

    • Fixed #134 - Maven test should use options = "--errors" by default

    • Fixed #135 - Split properties of @MavenTest across multiple (@Repeatable) annotations

    • Fixed #136 - Remove debug from MavenJupiterExtension annotation

    • Fixed #138 - Rename MavenOptions into MavenCLIOptions.

Details

Breaking Changes

  • Fixed #135 - Split properties of @MavenTest across multiple (@Repeatable) annotations

    • Deprecate the @MavenTest annotation elements goals, activeProfiles, options, systemProperties, debug with release 0.9.0.

      • Add replacements @MavenGoal, @MavenProfile, @MavenOption and @SystemProperty.

        • This means all the annotation elements of @MavenTest will be removed with release 0.10.0.

      • You have to migrate your code accordingly otherwise you will face compile errors with the upgrade to release 0.10.0.

      • The users guide has been updated to represent only the new annotations and no usage of annotation elements.

      • Changed the users guide accordingly to the new annotations.

  • Fixed #130 - Moving Conditions into separate package

    • The annotations DisabledForMavenVersion and EnabledForMavenVersion have been moved from com.soebes.itf.jupiter.extension into com.soebes.itf.jupiter.extension.condition package. The consequence is that you have to change your imports if you use them.

  • Fixed #138 - Rename MavenOptions into MavenCLIOptions.

  • Fixed #132 - Remove StringInterpolator from public API If you have used it you have to remove the usage. No replacement available.

  • Fixed #136 - Remove debug from MavenJupiterExtension annotation If you have used to turn on debugging via the annotation @MavenJupiterExtension this means you need to change your tests and use the @MavenTest(options=MavenCLIOptions.DEBUG) to get the same behaviour. Related to Fixed #135 you have to replace it with @MavenOption(MavenCLIOptions.DEBUG) or you can use @MavenDebug.

Reporter of this release

  • Andreas Sewe

    • Fixed #134 - Maven test should use options = "--errors" by default

    • Fixed #135 - Split properties of @MavenTest across multiple (@Repeatable) annotations

Contributors of this release

  • ??

    • {issue-??} - ??

Dependency Upgrades

Build Improvements

  • {issue-??} - ??

The full release notes can be found here Release 0.9.0.

Pre-release 0.8.0

Date of Release: July 11, 2020

Scope:

  • Bug Fixing and improvements.

  • Failure Plugin Fixed #113.

Details

  • Fixed #87 - Remove duplicate implementations for PomReader/PomUtils

  • Fixed #106 - Wrong usage of a function InstallMojo

  • Fixed #104 - Improve code based on SonarQube

  • Fixed #110 - Separate usersguide / release notes.

  • Fixed #112 - Fix Links to ReleaseNotes 0.7.0

  • Fixed #114 - Assertion on logoutput either debug/info does not work.

  • Fixed #117 - Output of builds should be consistently named *.log

  • Fixed #118 - Add error() for LogAssert.

  • Fixed #119 - Code Cleanups

  • Fixed #113 - Create a plugin which fails the build.

  • Fixed #121 - Change itf-extension-maven dependency scope from compile to test.

  • Fixed #122 - We should use itf-maven-plugin instead of maven-invoker-plugin for itf-failure-plugin

Breaking Changes

  • If you have used the names of the build output like mvn-stdout.out or mvn-stderr.out those names have been changed related to Fixed #117. This means you have to change your file names to mvn-stdout.log or mvn-stderr.log accordingly.

Reporter of this release

  • Roland Weisleder

Contributors of this release

Dependency Upgrades

  • Fixed #99 - Upgrade equalsverifier from 3.1.13 to 3.3

  • Fixed #101 - Upgrade smpp from 5.1.0 to 5.2.0

  • Fixed #108 - Upgrade smpp from 5.2.0 to 5.3.0

  • Fixed #116 - Upgrade asciidoctor-maven-plugin to 2.0.0

Build Improvements

  • Fixed #60 - Building on JDK15

  • Fixed #102 - JDK15 Build fails based on jacoco; Need to wait for a new release of JaCoCo.

  • Fixed #103 - Add SonarQube analysis

  • Fixed #105 - Change the used JDK for running SonarQube analysis

  • Fixed #107 - Remove empty module itf-executor

  • Fixed #108 - Reconfiguring cache handling in GitHub Actions.

  • Fixed #111 - Add .sdkmanrc.

  • Fixed #123 - Cache usage does not work.

  • Fixed #124 - Duplicate executions of builds on merge onto master.

The full release notes can be found here Release 0.8.0.

Pre-release 0.7.0

Date of Release: May 17, 2020

Scope:

Details

  • Fixed #98 - Version/dates in HTML documents.

Breaking Changes

  • None in this release.

Reporter of this release

  • Philippe Marschall

  • Sandra Parsick

    • Fixed #88 - System property maven.home is set but 'java.lang.IllegalStateException: We could not find the maven executable mvn somewhere' is thrown

Contributors of this release

  • none.

Dependency Upgrades

  • Fixed #85 - Upgrade AssertJ from 3.15.0 to 3.16.0

  • Fixed #89 - Upgrade AssertJ from 3.16.0 to 3.16.1

  • Fixed #86 - Upgrade xmlunit-assertj from 2.6.3 to 2.6.4

  • Fixed #95 - Upgrade Testcontainers from 1.14.1 to 1.14.2

  • Fixed #96 - Upgrade commons-compress from 1.19 to 1.20

  • Fixed #97 - Upgrade xmlunit-assertj from 2.6.4 to 2.7.0

Build Improvements

  • Fixed #90 - Improving build with cache usage on GitHub actions.

  • Fixed #91 - Cache is not correctly configured

The full release notes can be found here {release-0.7.0}[Release 0.7.0].

Pre-release 0.6.0

Date of Release: May 6, 2020

Scope:

  • Documentation cleanup

  • Better naming for MavenIT.

Details

  • Fixed #67 - Cleanup userguide

  • Fixed #68 - Rename @MavenIT into @MavenJupiterExtension.

  • Fixed #76 - "Getting started" is hard to find.

Breaking Changes

  • With Fixed #68 - we have renamed the @MavenIT annotation into @MavenJupiterExtension to make the intention more clear.

  • With Fixed #80 - We have removed the previously needed log4j dependencies at all. In testing projects there is no need anymore in adding log4j-core dependency.

Reporters of this release

  • Roland Weisleder

    • Fixed #76 - "Getting started" is hard to find.

    • Fixed #77 - Code in section "Configuration in Maven" (user guide) should be copy-pastable

    • Fixed #80 - Error message "Log4j2 could not find a logging implementation"

Contributors of this release

  • Sandra Parsick Fixed #78 - put section "configuration in maven" before section "Structuring Integration Tests"

GitHub Improvements

  • Fixed #69 - Add templates for issues/features requests

  • Fixed #74 - Recreate issue templaes

  • Fixed #75 - Separate documentation for master and release

  • Fixed #81 - Added CONTRIBUTION.md guide.

  • Fixed #84 - Rename CONTRIBUTION.md into CONTRIBUTING.md

The full release notes can be found here Release 0.6.0.

Pre-release 0.5.0

Date of Release: May 3, 2020

Scope:

  • Removed usage of internal API’s. Fixed #49, Fixed #52.

  • Fixing Bug while running several IT’s while using the same cache.

  • Fixing Bug related to @MavenProject Fixed #53.

Details

  • Fixed #48 - Accidentally deleting the local cache.

    • We should not delete the whole cache between executions cause a given @MavenRepository is otherwise useless for several methods.

  • Fixed #49 - Change to use only maintained API’s of JUnit Jupiter

  • Fixed #52 - Remove usage org.junit.platform.commons.logging

  • Fixed #53 - Deleting project under test during @MavenProject tests

  • Fixed #65 - Create github pull request template file.

Breaking Changes

  • The MavenVersion enum type has been moved from package com.soebes.itf.jupiter.maven to com.soebes.itf.jupiter.extension to take advantage of using internal classes.

Dependency Upgrades

  • Fixed #50 - Upgrade Testcontainers to most recent version 1.14.1

  • Fixed #51 - Upgrade smpp parent to version 5.0.3

  • Fixed #54 - Upgrade equalsverifier from 3.1.12 to 3.1.13

  • Fixed #55 - Upgrade log4j from 2.13.1 to 2.13.2

  • Fixed #56 - Upgrade mockito from 3.3.0 to 3.3.3

  • Fixed #57 - Upgrade smpp-parent from 5.0.3 to 5.1.0

Build Improvements

  • Fixed #58 - WARNING JAR will be empty in itf-documentation module.

  • Fixed #59 - Removed option -Dcheckstyle.skip=true

  • Fixed #61 - Bug in pipeline - Using wrong checkout

  • Fixed #62 - WARNING JAR will be empty in itf-examples

  • Fixed #63 - Cleanup pom and remove plugins which are inherited from smpp-parent

  • Fixed #64 - Automatic site publishing

  • Fixed #66 - Release failure based on missing javadoc/sources packages for itf-examples

The full release notes can be found here Release 0.5.0.

Pre-release 0.4.0

Date of Release: April 19, 2020

Scope:

  • Renamed invoker-repo into itf-repo

  • Added .predefined-repo for integration tests.

  • Support for finding Maven executable in a portable way.

Details

  • Fixed #40 - Changed from invoker-repo to itf-repo.

  • Fixed #41 - Activate apache-rat plugin to check all files for license

  • Fixed #42 - MavenRepository contains @ExtendWith

  • Fixed #43 - Create MavenPredefinedRepository annotation

  • Fixed #45 - Searching for the Maven executable in a portable way.

Breaking Changes

  • itf-maven-plugin uses now the location itf-repo instead invoker-repo. This can break tests which have been written with version 0.3.0 and before.

The full release notes can be found here Release 0.4.0.

Pre-release 0.3.0

Date of Release: April 18, 2020

Scope:

  • Working build on Windows.

  • Basic Maven Plugin for installation of artifacts.

  • License file in project.

  • Release Notes documentation.

Details

  • Fixed #32 - Build on Windows as well

  • Fixed #33

    • Create a maven plugin which handles the installation of artifacts

    • This removes the need to use maven-invoker-plugin with a weird configuration.

  • Fixed #34 - Add LICENSE file to the project

  • Fixed #36 - Create a release notes documentation.

  • Fixed #31

    • Imports in documentations are not correct anymore.

    • Fixed includes

    • building of html/pdf during the build.

    • Fixed site generation to render also docs in correct location.

    • Moved docs to itf-documentation project.

The full release notes can be found here Release 0.3.0.

Pre-release 0.2.0

Date of Release: April 15, 2020

Scope:

  • Changed package names and maven coordinates to make it possible to publish in Central Repository.

Details

  • Fixed #30 - Upgrade parent to 5.0.1 smpp

  • Fixed #29 - Change coordinates / Change Names

    • renamed groupId.

    • Renamed artifactId’s.

    • Renamed modules

    • Renamed packages.

    • Renamed documents.

    • Fixed docs.

The full release notes can be found here Release 0.2.0.

Pre-release 0.1.0

Date of Release: April 14, 2020

Scope:

  • First public release as github packages.

The full release notes can be found here Release 0.1.0.