diff --git a/core-java/junit5-parameterized-tests/.gitignore b/core-java/junit5-parameterized-tests/.gitignore new file mode 100644 index 0000000..2266015 --- /dev/null +++ b/core-java/junit5-parameterized-tests/.gitignore @@ -0,0 +1,8 @@ +# Maven +target/ +.mvn/ + +# eclipse project file +.settings/ +.classpath +.project \ No newline at end of file diff --git a/core-java/junit5-parameterized-tests/README.md b/core-java/junit5-parameterized-tests/README.md new file mode 100644 index 0000000..6f79c72 --- /dev/null +++ b/core-java/junit5-parameterized-tests/README.md @@ -0,0 +1,3 @@ +# Related Blog Posts + +* [Parameterized tests with JUnit 5](https://reflectoring.io/junit5-parameterized-tests/) \ No newline at end of file diff --git a/core-java/junit5-parameterized-tests/mvnw b/core-java/junit5-parameterized-tests/mvnw new file mode 100755 index 0000000..b7f0646 --- /dev/null +++ b/core-java/junit5-parameterized-tests/mvnw @@ -0,0 +1,287 @@ +#!/bin/sh +# ---------------------------------------------------------------------------- +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +# ---------------------------------------------------------------------------- + +# ---------------------------------------------------------------------------- +# Apache Maven Wrapper startup batch script, version 3.1.1 +# +# Required ENV vars: +# ------------------ +# JAVA_HOME - location of a JDK home dir +# +# Optional ENV vars +# ----------------- +# MAVEN_OPTS - parameters passed to the Java VM when running Maven +# e.g. to debug Maven itself, use +# set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000 +# MAVEN_SKIP_RC - flag to disable loading of mavenrc files +# ---------------------------------------------------------------------------- + +if [ -z "$MAVEN_SKIP_RC" ] ; then + + if [ -f /usr/local/etc/mavenrc ] ; then + . /usr/local/etc/mavenrc + fi + + if [ -f /etc/mavenrc ] ; then + . /etc/mavenrc + fi + + if [ -f "$HOME/.mavenrc" ] ; then + . "$HOME/.mavenrc" + fi + +fi + +# OS specific support. $var _must_ be set to either true or false. +cygwin=false; +darwin=false; +mingw=false +case "`uname`" in + CYGWIN*) cygwin=true ;; + MINGW*) mingw=true;; + Darwin*) darwin=true + # Use /usr/libexec/java_home if available, otherwise fall back to /Library/Java/Home + # See https://developer.apple.com/library/mac/qa/qa1170/_index.html + if [ -z "$JAVA_HOME" ]; then + if [ -x "/usr/libexec/java_home" ]; then + JAVA_HOME="`/usr/libexec/java_home`"; export JAVA_HOME + else + JAVA_HOME="/Library/Java/Home"; export JAVA_HOME + fi + fi + ;; +esac + +if [ -z "$JAVA_HOME" ] ; then + if [ -r /etc/gentoo-release ] ; then + JAVA_HOME=`java-config --jre-home` + fi +fi + +# For Cygwin, ensure paths are in UNIX format before anything is touched +if $cygwin ; then + [ -n "$JAVA_HOME" ] && + JAVA_HOME=`cygpath --unix "$JAVA_HOME"` + [ -n "$CLASSPATH" ] && + CLASSPATH=`cygpath --path --unix "$CLASSPATH"` +fi + +# For Mingw, ensure paths are in UNIX format before anything is touched +if $mingw ; then + [ -n "$JAVA_HOME" ] && + JAVA_HOME="`(cd "$JAVA_HOME"; pwd)`" +fi + +if [ -z "$JAVA_HOME" ]; then + javaExecutable="`which javac`" + if [ -n "$javaExecutable" ] && ! [ "`expr \"$javaExecutable\" : '\([^ ]*\)'`" = "no" ]; then + # readlink(1) is not available as standard on Solaris 10. + readLink=`which readlink` + if [ ! `expr "$readLink" : '\([^ ]*\)'` = "no" ]; then + if $darwin ; then + javaHome="`dirname \"$javaExecutable\"`" + javaExecutable="`cd \"$javaHome\" && pwd -P`/javac" + else + javaExecutable="`readlink -f \"$javaExecutable\"`" + fi + javaHome="`dirname \"$javaExecutable\"`" + javaHome=`expr "$javaHome" : '\(.*\)/bin'` + JAVA_HOME="$javaHome" + export JAVA_HOME + fi + fi +fi + +if [ -z "$JAVACMD" ] ; then + if [ -n "$JAVA_HOME" ] ; then + if [ -x "$JAVA_HOME/jre/sh/java" ] ; then + # IBM's JDK on AIX uses strange locations for the executables + JAVACMD="$JAVA_HOME/jre/sh/java" + else + JAVACMD="$JAVA_HOME/bin/java" + fi + else + JAVACMD="`\\unset -f command; \\command -v java`" + fi +fi + +if [ ! -x "$JAVACMD" ] ; then + echo "Error: JAVA_HOME is not defined correctly." >&2 + echo " We cannot execute $JAVACMD" >&2 + exit 1 +fi + +if [ -z "$JAVA_HOME" ] ; then + echo "Warning: JAVA_HOME environment variable is not set." +fi + +# traverses directory structure from process work directory to filesystem root +# first directory with .mvn subdirectory is considered project base directory +find_maven_basedir() { + if [ -z "$1" ] + then + echo "Path not specified to find_maven_basedir" + return 1 + fi + + basedir="$1" + wdir="$1" + while [ "$wdir" != '/' ] ; do + if [ -d "$wdir"/.mvn ] ; then + basedir=$wdir + break + fi + # workaround for JBEAP-8937 (on Solaris 10/Sparc) + if [ -d "${wdir}" ]; then + wdir=`cd "$wdir/.."; pwd` + fi + # end of workaround + done + printf '%s' "$(cd "$basedir"; pwd)" +} + +# concatenates all lines of a file +concat_lines() { + if [ -f "$1" ]; then + echo "$(tr -s '\n' ' ' < "$1")" + fi +} + +BASE_DIR=$(find_maven_basedir "$(dirname $0)") +if [ -z "$BASE_DIR" ]; then + exit 1; +fi + +MAVEN_PROJECTBASEDIR=${MAVEN_BASEDIR:-"$BASE_DIR"}; export MAVEN_PROJECTBASEDIR +if [ "$MVNW_VERBOSE" = true ]; then + echo $MAVEN_PROJECTBASEDIR +fi + +########################################################################################## +# Extension to allow automatically downloading the maven-wrapper.jar from Maven-central +# This allows using the maven wrapper in projects that prohibit checking in binary data. +########################################################################################## +if [ -r "$BASE_DIR/.mvn/wrapper/maven-wrapper.jar" ]; then + if [ "$MVNW_VERBOSE" = true ]; then + echo "Found .mvn/wrapper/maven-wrapper.jar" + fi +else + if [ "$MVNW_VERBOSE" = true ]; then + echo "Couldn't find .mvn/wrapper/maven-wrapper.jar, downloading it ..." + fi + if [ -n "$MVNW_REPOURL" ]; then + wrapperUrl="$MVNW_REPOURL/org/apache/maven/wrapper/maven-wrapper/3.1.1/maven-wrapper-3.1.1.jar" + else + wrapperUrl="https://repo.maven.apache.org/maven2/org/apache/maven/wrapper/maven-wrapper/3.1.1/maven-wrapper-3.1.1.jar" + fi + while IFS="=" read key value; do + case "$key" in (wrapperUrl) wrapperUrl="$value"; break ;; + esac + done < "$BASE_DIR/.mvn/wrapper/maven-wrapper.properties" + if [ "$MVNW_VERBOSE" = true ]; then + echo "Downloading from: $wrapperUrl" + fi + wrapperJarPath="$BASE_DIR/.mvn/wrapper/maven-wrapper.jar" + if $cygwin; then + wrapperJarPath=`cygpath --path --windows "$wrapperJarPath"` + fi + + if command -v wget > /dev/null; then + QUIET="--quiet" + if [ "$MVNW_VERBOSE" = true ]; then + echo "Found wget ... using wget" + QUIET="" + fi + if [ -z "$MVNW_USERNAME" ] || [ -z "$MVNW_PASSWORD" ]; then + wget $QUIET "$wrapperUrl" -O "$wrapperJarPath" + else + wget $QUIET --http-user="$MVNW_USERNAME" --http-password="$MVNW_PASSWORD" "$wrapperUrl" -O "$wrapperJarPath" + fi + [ $? -eq 0 ] || rm -f "$wrapperJarPath" + elif command -v curl > /dev/null; then + QUIET="--silent" + if [ "$MVNW_VERBOSE" = true ]; then + echo "Found curl ... using curl" + QUIET="" + fi + if [ -z "$MVNW_USERNAME" ] || [ -z "$MVNW_PASSWORD" ]; then + curl $QUIET -o "$wrapperJarPath" "$wrapperUrl" -f -L + else + curl $QUIET --user "$MVNW_USERNAME:$MVNW_PASSWORD" -o "$wrapperJarPath" "$wrapperUrl" -f -L + fi + [ $? -eq 0 ] || rm -f "$wrapperJarPath" + else + if [ "$MVNW_VERBOSE" = true ]; then + echo "Falling back to using Java to download" + fi + javaSource="$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.java" + javaClass="$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.class" + # For Cygwin, switch paths to Windows format before running javac + if $cygwin; then + javaSource=`cygpath --path --windows "$javaSource"` + javaClass=`cygpath --path --windows "$javaClass"` + fi + if [ -e "$javaSource" ]; then + if [ ! -e "$javaClass" ]; then + if [ "$MVNW_VERBOSE" = true ]; then + echo " - Compiling MavenWrapperDownloader.java ..." + fi + # Compiling the Java class + ("$JAVA_HOME/bin/javac" "$javaSource") + fi + if [ -e "$javaClass" ]; then + # Running the downloader + if [ "$MVNW_VERBOSE" = true ]; then + echo " - Running MavenWrapperDownloader.java ..." + fi + ("$JAVA_HOME/bin/java" -cp .mvn/wrapper MavenWrapperDownloader "$MAVEN_PROJECTBASEDIR") + fi + fi + fi +fi +########################################################################################## +# End of extension +########################################################################################## + +MAVEN_OPTS="$(concat_lines "$MAVEN_PROJECTBASEDIR/.mvn/jvm.config") $MAVEN_OPTS" + +# For Cygwin, switch paths to Windows format before running java +if $cygwin; then + [ -n "$JAVA_HOME" ] && + JAVA_HOME=`cygpath --path --windows "$JAVA_HOME"` + [ -n "$CLASSPATH" ] && + CLASSPATH=`cygpath --path --windows "$CLASSPATH"` + [ -n "$MAVEN_PROJECTBASEDIR" ] && + MAVEN_PROJECTBASEDIR=`cygpath --path --windows "$MAVEN_PROJECTBASEDIR"` +fi + +# Provide a "standardized" way to retrieve the CLI args that will +# work with both Windows and non-Windows executions. +MAVEN_CMD_LINE_ARGS="$MAVEN_CONFIG $@" +export MAVEN_CMD_LINE_ARGS + +WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain + +exec "$JAVACMD" \ + $MAVEN_OPTS \ + $MAVEN_DEBUG_OPTS \ + -classpath "$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.jar" \ + "-Dmaven.multiModuleProjectDirectory=${MAVEN_PROJECTBASEDIR}" \ + ${WRAPPER_LAUNCHER} $MAVEN_CONFIG "$@" diff --git a/core-java/junit5-parameterized-tests/mvnw.cmd b/core-java/junit5-parameterized-tests/mvnw.cmd new file mode 100644 index 0000000..cba1f04 --- /dev/null +++ b/core-java/junit5-parameterized-tests/mvnw.cmd @@ -0,0 +1,187 @@ +@REM ---------------------------------------------------------------------------- +@REM Licensed to the Apache Software Foundation (ASF) under one +@REM or more contributor license agreements. See the NOTICE file +@REM distributed with this work for additional information +@REM regarding copyright ownership. The ASF licenses this file +@REM to you under the Apache License, Version 2.0 (the +@REM "License"); you may not use this file except in compliance +@REM with the License. You may obtain a copy of the License at +@REM +@REM http://www.apache.org/licenses/LICENSE-2.0 +@REM +@REM Unless required by applicable law or agreed to in writing, +@REM software distributed under the License is distributed on an +@REM "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +@REM KIND, either express or implied. See the License for the +@REM specific language governing permissions and limitations +@REM under the License. +@REM ---------------------------------------------------------------------------- + +@REM ---------------------------------------------------------------------------- +@REM Apache Maven Wrapper startup batch script, version 3.1.1 +@REM +@REM Required ENV vars: +@REM JAVA_HOME - location of a JDK home dir +@REM +@REM Optional ENV vars +@REM MAVEN_BATCH_ECHO - set to 'on' to enable the echoing of the batch commands +@REM MAVEN_BATCH_PAUSE - set to 'on' to wait for a keystroke before ending +@REM MAVEN_OPTS - parameters passed to the Java VM when running Maven +@REM e.g. to debug Maven itself, use +@REM set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000 +@REM MAVEN_SKIP_RC - flag to disable loading of mavenrc files +@REM ---------------------------------------------------------------------------- + +@REM Begin all REM lines with '@' in case MAVEN_BATCH_ECHO is 'on' +@echo off +@REM set title of command window +title %0 +@REM enable echoing by setting MAVEN_BATCH_ECHO to 'on' +@if "%MAVEN_BATCH_ECHO%" == "on" echo %MAVEN_BATCH_ECHO% + +@REM set %HOME% to equivalent of $HOME +if "%HOME%" == "" (set "HOME=%HOMEDRIVE%%HOMEPATH%") + +@REM Execute a user defined script before this one +if not "%MAVEN_SKIP_RC%" == "" goto skipRcPre +@REM check for pre script, once with legacy .bat ending and once with .cmd ending +if exist "%USERPROFILE%\mavenrc_pre.bat" call "%USERPROFILE%\mavenrc_pre.bat" %* +if exist "%USERPROFILE%\mavenrc_pre.cmd" call "%USERPROFILE%\mavenrc_pre.cmd" %* +:skipRcPre + +@setlocal + +set ERROR_CODE=0 + +@REM To isolate internal variables from possible post scripts, we use another setlocal +@setlocal + +@REM ==== START VALIDATION ==== +if not "%JAVA_HOME%" == "" goto OkJHome + +echo. +echo Error: JAVA_HOME not found in your environment. >&2 +echo Please set the JAVA_HOME variable in your environment to match the >&2 +echo location of your Java installation. >&2 +echo. +goto error + +:OkJHome +if exist "%JAVA_HOME%\bin\java.exe" goto init + +echo. +echo Error: JAVA_HOME is set to an invalid directory. >&2 +echo JAVA_HOME = "%JAVA_HOME%" >&2 +echo Please set the JAVA_HOME variable in your environment to match the >&2 +echo location of your Java installation. >&2 +echo. +goto error + +@REM ==== END VALIDATION ==== + +:init + +@REM Find the project base dir, i.e. the directory that contains the folder ".mvn". +@REM Fallback to current working directory if not found. + +set MAVEN_PROJECTBASEDIR=%MAVEN_BASEDIR% +IF NOT "%MAVEN_PROJECTBASEDIR%"=="" goto endDetectBaseDir + +set EXEC_DIR=%CD% +set WDIR=%EXEC_DIR% +:findBaseDir +IF EXIST "%WDIR%"\.mvn goto baseDirFound +cd .. +IF "%WDIR%"=="%CD%" goto baseDirNotFound +set WDIR=%CD% +goto findBaseDir + +:baseDirFound +set MAVEN_PROJECTBASEDIR=%WDIR% +cd "%EXEC_DIR%" +goto endDetectBaseDir + +:baseDirNotFound +set MAVEN_PROJECTBASEDIR=%EXEC_DIR% +cd "%EXEC_DIR%" + +:endDetectBaseDir + +IF NOT EXIST "%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config" goto endReadAdditionalConfig + +@setlocal EnableExtensions EnableDelayedExpansion +for /F "usebackq delims=" %%a in ("%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config") do set JVM_CONFIG_MAVEN_PROPS=!JVM_CONFIG_MAVEN_PROPS! %%a +@endlocal & set JVM_CONFIG_MAVEN_PROPS=%JVM_CONFIG_MAVEN_PROPS% + +:endReadAdditionalConfig + +SET MAVEN_JAVA_EXE="%JAVA_HOME%\bin\java.exe" +set WRAPPER_JAR="%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.jar" +set WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain + +set WRAPPER_URL="https://repo.maven.apache.org/maven2/org/apache/maven/wrapper/maven-wrapper/3.1.1/maven-wrapper-3.1.1.jar" + +FOR /F "usebackq tokens=1,2 delims==" %%A IN ("%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.properties") DO ( + IF "%%A"=="wrapperUrl" SET WRAPPER_URL=%%B +) + +@REM Extension to allow automatically downloading the maven-wrapper.jar from Maven-central +@REM This allows using the maven wrapper in projects that prohibit checking in binary data. +if exist %WRAPPER_JAR% ( + if "%MVNW_VERBOSE%" == "true" ( + echo Found %WRAPPER_JAR% + ) +) else ( + if not "%MVNW_REPOURL%" == "" ( + SET WRAPPER_URL="%MVNW_REPOURL%/org/apache/maven/wrapper/maven-wrapper/3.1.1/maven-wrapper-3.1.1.jar" + ) + if "%MVNW_VERBOSE%" == "true" ( + echo Couldn't find %WRAPPER_JAR%, downloading it ... + echo Downloading from: %WRAPPER_URL% + ) + + powershell -Command "&{"^ + "$webclient = new-object System.Net.WebClient;"^ + "if (-not ([string]::IsNullOrEmpty('%MVNW_USERNAME%') -and [string]::IsNullOrEmpty('%MVNW_PASSWORD%'))) {"^ + "$webclient.Credentials = new-object System.Net.NetworkCredential('%MVNW_USERNAME%', '%MVNW_PASSWORD%');"^ + "}"^ + "[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; $webclient.DownloadFile('%WRAPPER_URL%', '%WRAPPER_JAR%')"^ + "}" + if "%MVNW_VERBOSE%" == "true" ( + echo Finished downloading %WRAPPER_JAR% + ) +) +@REM End of extension + +@REM Provide a "standardized" way to retrieve the CLI args that will +@REM work with both Windows and non-Windows executions. +set MAVEN_CMD_LINE_ARGS=%* + +%MAVEN_JAVA_EXE% ^ + %JVM_CONFIG_MAVEN_PROPS% ^ + %MAVEN_OPTS% ^ + %MAVEN_DEBUG_OPTS% ^ + -classpath %WRAPPER_JAR% ^ + "-Dmaven.multiModuleProjectDirectory=%MAVEN_PROJECTBASEDIR%" ^ + %WRAPPER_LAUNCHER% %MAVEN_CONFIG% %* +if ERRORLEVEL 1 goto error +goto end + +:error +set ERROR_CODE=1 + +:end +@endlocal & set ERROR_CODE=%ERROR_CODE% + +if not "%MAVEN_SKIP_RC%"=="" goto skipRcPost +@REM check for post script, once with legacy .bat ending and once with .cmd ending +if exist "%USERPROFILE%\mavenrc_post.bat" call "%USERPROFILE%\mavenrc_post.bat" +if exist "%USERPROFILE%\mavenrc_post.cmd" call "%USERPROFILE%\mavenrc_post.cmd" +:skipRcPost + +@REM pause the script if MAVEN_BATCH_PAUSE is set to 'on' +if "%MAVEN_BATCH_PAUSE%"=="on" pause + +if "%MAVEN_TERMINATE_CMD%"=="on" exit %ERROR_CODE% + +cmd /C exit /B %ERROR_CODE% diff --git a/core-java/junit5-parameterized-tests/pom.xml b/core-java/junit5-parameterized-tests/pom.xml new file mode 100644 index 0000000..a269c87 --- /dev/null +++ b/core-java/junit5-parameterized-tests/pom.xml @@ -0,0 +1,33 @@ + + 4.0.0 + io.refactoring + junit5-parameterized-tests + 1.0.0-SNAPSHOT + + 11 + 11 + + 5.9.2 + 3.12.0 + 3.24.1 + + + + + + org.junit.jupiter + junit-jupiter-params + ${junit-jupiter-params.version} + test + + + + + org.apache.commons + commons-lang3 + ${commons-lang3.version} + + + + + \ No newline at end of file diff --git a/core-java/junit5-parameterized-tests/src/test/java/source/argument/conversion/ArgumentConversionTest.java b/core-java/junit5-parameterized-tests/src/test/java/source/argument/conversion/ArgumentConversionTest.java new file mode 100644 index 0000000..49ce885 --- /dev/null +++ b/core-java/junit5-parameterized-tests/src/test/java/source/argument/conversion/ArgumentConversionTest.java @@ -0,0 +1,43 @@ +package source.argument.conversion; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; + +import java.time.temporal.ChronoUnit; + +import org.junit.jupiter.params.ParameterizedTest; +import org.junit.jupiter.params.converter.ConvertWith; +import org.junit.jupiter.params.provider.ValueSource; + +public class ArgumentConversionTest { + + @ParameterizedTest + @ValueSource(ints = { 2, 4 }) + void checkWideningArgumentConversion(long number) { + assertEquals(0, number % 2); + } + + // --------------------------------------------------------------------------- + + @ParameterizedTest + @ValueSource(strings = "DAYS") + void checkImplicitArgumentConversion(ChronoUnit argument) { + assertNotNull(argument.name()); + } + + // --------------------------------------------------------------------------- + + @ParameterizedTest + @ValueSource(strings = { "Name1", "Name2" }) + void checkImplicitFallbackArgumentConversion(Person person) { + assertNotNull(person.getName()); + } + + // --------------------------------------------------------------------------- + + @ParameterizedTest + @ValueSource(ints = { 100 }) + void checkExplicitArgumentConversion(@ConvertWith(StringSimpleArgumentConverter.class) String argument) { + assertEquals("100", argument); + } +} diff --git a/core-java/junit5-parameterized-tests/src/test/java/source/argument/conversion/Person.java b/core-java/junit5-parameterized-tests/src/test/java/source/argument/conversion/Person.java new file mode 100644 index 0000000..7c1cdb6 --- /dev/null +++ b/core-java/junit5-parameterized-tests/src/test/java/source/argument/conversion/Person.java @@ -0,0 +1,18 @@ +package source.argument.conversion; + +public class Person { + + private String name; + + public Person(String name) { + this.name = name; + } + + public String getName() { + return name; + } + + public void setName(String name) { + this.name = name; + } +} diff --git a/core-java/junit5-parameterized-tests/src/test/java/source/argument/conversion/StringSimpleArgumentConverter.java b/core-java/junit5-parameterized-tests/src/test/java/source/argument/conversion/StringSimpleArgumentConverter.java new file mode 100644 index 0000000..fcae732 --- /dev/null +++ b/core-java/junit5-parameterized-tests/src/test/java/source/argument/conversion/StringSimpleArgumentConverter.java @@ -0,0 +1,13 @@ +package source.argument.conversion; + +import org.junit.jupiter.params.converter.ArgumentConversionException; +import org.junit.jupiter.params.converter.SimpleArgumentConverter; + +public class StringSimpleArgumentConverter extends SimpleArgumentConverter { + + @Override + protected Object convert(Object source, Class targetType) throws ArgumentConversionException { + return String.valueOf(source); + } + +} diff --git a/core-java/junit5-parameterized-tests/src/test/java/source/arguments/ArgumentsSourceTest.java b/core-java/junit5-parameterized-tests/src/test/java/source/arguments/ArgumentsSourceTest.java new file mode 100644 index 0000000..264f116 --- /dev/null +++ b/core-java/junit5-parameterized-tests/src/test/java/source/arguments/ArgumentsSourceTest.java @@ -0,0 +1,39 @@ +package source.arguments; + +import static org.junit.jupiter.api.Assertions.assertEquals; + +import java.util.stream.Stream; + +import org.apache.commons.lang3.StringUtils; +import org.junit.jupiter.api.extension.ExtensionContext; +import org.junit.jupiter.params.ParameterizedTest; +import org.junit.jupiter.params.provider.Arguments; +import org.junit.jupiter.params.provider.ArgumentsProvider; +import org.junit.jupiter.params.provider.ArgumentsSource; + +public class ArgumentsSourceTest { + + @ParameterizedTest + @ArgumentsSource(ExternalArgumentsProvider.class) + void checkExternalArgumentsSource(int number, String expected) { + assertEquals(StringUtils.equals(expected, "even") ? 0 : 1, number % 2, + "Supplied number " + number + " is not an " + expected + " number"); + } + + // --------------------------------------------------------------------------- + + @ParameterizedTest + @ArgumentsSource(NestedArgumentsProvider.class) + void checkNestedArgumentsSource(int number, String expected) { + assertEquals(StringUtils.equals(expected, "even") ? 0 : 1, number % 2, + "Supplied number " + number + " is not an " + expected + " number"); + } + + static class NestedArgumentsProvider implements ArgumentsProvider { + + @Override + public Stream provideArguments(ExtensionContext context) throws Exception { + return Stream.of(Arguments.of(2, "even"), Arguments.of(3, "odd")); + } + } +} diff --git a/core-java/junit5-parameterized-tests/src/test/java/source/arguments/ExternalArgumentsProvider.java b/core-java/junit5-parameterized-tests/src/test/java/source/arguments/ExternalArgumentsProvider.java new file mode 100644 index 0000000..2295fb0 --- /dev/null +++ b/core-java/junit5-parameterized-tests/src/test/java/source/arguments/ExternalArgumentsProvider.java @@ -0,0 +1,16 @@ +package source.arguments; + +import java.util.stream.Stream; + +import org.junit.jupiter.api.extension.ExtensionContext; +import org.junit.jupiter.params.provider.Arguments; +import org.junit.jupiter.params.provider.ArgumentsProvider; + +public class ExternalArgumentsProvider implements ArgumentsProvider { + + @Override + public Stream provideArguments(ExtensionContext context) throws Exception { + return Stream.of(Arguments.of(2, "even"), + Arguments.of(3, "odd")); + } +} diff --git a/core-java/junit5-parameterized-tests/src/test/java/source/arguments/aggregator/ArgumentsAccessorTest.java b/core-java/junit5-parameterized-tests/src/test/java/source/arguments/aggregator/ArgumentsAccessorTest.java new file mode 100644 index 0000000..99692a8 --- /dev/null +++ b/core-java/junit5-parameterized-tests/src/test/java/source/arguments/aggregator/ArgumentsAccessorTest.java @@ -0,0 +1,18 @@ +package source.arguments.aggregator; + +import static org.junit.jupiter.api.Assertions.assertTrue; + +import org.junit.jupiter.params.ParameterizedTest; +import org.junit.jupiter.params.aggregator.ArgumentsAccessor; +import org.junit.jupiter.params.provider.CsvSource; + +public class ArgumentsAccessorTest { + + @ParameterizedTest + @CsvSource({ "John, 20", + "Harry, 30" }) + void checkArgumentsAccessor(ArgumentsAccessor arguments) { + Person person = new Person(arguments.getString(0), arguments.getInteger(1)); + assertTrue(person.getAge() > 19, person.getName() + " is a teenager"); + } +} diff --git a/core-java/junit5-parameterized-tests/src/test/java/source/arguments/aggregator/ArgumentsAggregatorTest.java b/core-java/junit5-parameterized-tests/src/test/java/source/arguments/aggregator/ArgumentsAggregatorTest.java new file mode 100644 index 0000000..19b0aa3 --- /dev/null +++ b/core-java/junit5-parameterized-tests/src/test/java/source/arguments/aggregator/ArgumentsAggregatorTest.java @@ -0,0 +1,24 @@ +package source.arguments.aggregator; + +import static org.junit.jupiter.api.Assertions.assertTrue; + +import org.junit.jupiter.params.ParameterizedTest; +import org.junit.jupiter.params.aggregator.AggregateWith; +import org.junit.jupiter.params.provider.CsvSource; + +public class ArgumentsAggregatorTest { + + @ParameterizedTest + @CsvSource({ "John, 20", "Harry, 30" }) + void checkArgumentsAggregator(@AggregateWith(PersonArgumentsAggregator.class) Person person) { + assertTrue(person.getAge() > 19, person.getName() + " is a teenager"); + } + + // --------------------------------------------------------------------------- + + @ParameterizedTest + @CsvSource({ "John, 20", "Harry, 30" }) + void checkCustomAggregatorAnnotation(@CsvToPerson Person person) { + assertTrue(person.getAge() > 19, person.getName() + " is a teenager"); + } +} diff --git a/core-java/junit5-parameterized-tests/src/test/java/source/arguments/aggregator/CsvToPerson.java b/core-java/junit5-parameterized-tests/src/test/java/source/arguments/aggregator/CsvToPerson.java new file mode 100644 index 0000000..5186deb --- /dev/null +++ b/core-java/junit5-parameterized-tests/src/test/java/source/arguments/aggregator/CsvToPerson.java @@ -0,0 +1,15 @@ +package source.arguments.aggregator; + +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +import org.junit.jupiter.params.aggregator.AggregateWith; + +@Retention(RetentionPolicy.RUNTIME) +@Target(ElementType.PARAMETER) +@AggregateWith(PersonArgumentsAggregator.class) +public @interface CsvToPerson { + +} diff --git a/core-java/junit5-parameterized-tests/src/test/java/source/arguments/aggregator/Person.java b/core-java/junit5-parameterized-tests/src/test/java/source/arguments/aggregator/Person.java new file mode 100644 index 0000000..10c2b71 --- /dev/null +++ b/core-java/junit5-parameterized-tests/src/test/java/source/arguments/aggregator/Person.java @@ -0,0 +1,30 @@ +package source.arguments.aggregator; + +public class Person { + + private String name; + + private int age; + + public Person(String name, int age) { + this.name = name; + this.age = age; + } + + public String getName() { + return name; + } + + public void setName(String name) { + this.name = name; + } + + public int getAge() { + return age; + } + + public void setAge(int age) { + this.age = age; + } + +} diff --git a/core-java/junit5-parameterized-tests/src/test/java/source/arguments/aggregator/PersonArgumentsAggregator.java b/core-java/junit5-parameterized-tests/src/test/java/source/arguments/aggregator/PersonArgumentsAggregator.java new file mode 100644 index 0000000..743bfd8 --- /dev/null +++ b/core-java/junit5-parameterized-tests/src/test/java/source/arguments/aggregator/PersonArgumentsAggregator.java @@ -0,0 +1,16 @@ +package source.arguments.aggregator; + +import org.junit.jupiter.api.extension.ParameterContext; +import org.junit.jupiter.params.aggregator.ArgumentsAccessor; +import org.junit.jupiter.params.aggregator.ArgumentsAggregationException; +import org.junit.jupiter.params.aggregator.ArgumentsAggregator; + +public class PersonArgumentsAggregator implements ArgumentsAggregator { + + @Override + public Object aggregateArguments(ArgumentsAccessor arguments, ParameterContext context) + throws ArgumentsAggregationException { + return new Person(arguments.getString(0), arguments.getInteger(1)); + } + +} diff --git a/core-java/junit5-parameterized-tests/src/test/java/source/assertj/AssertJTest.java b/core-java/junit5-parameterized-tests/src/test/java/source/assertj/AssertJTest.java new file mode 100644 index 0000000..c9abf81 --- /dev/null +++ b/core-java/junit5-parameterized-tests/src/test/java/source/assertj/AssertJTest.java @@ -0,0 +1,27 @@ +package source.assertj; + +import java.util.function.Consumer; +import java.util.stream.Stream; + +import org.assertj.core.api.Assertions; +import org.junit.jupiter.params.ParameterizedTest; +import org.junit.jupiter.params.provider.Arguments; +import org.junit.jupiter.params.provider.MethodSource; + +public class AssertJTest { + + @ParameterizedTest + @MethodSource("checkNumberArgs") + void checkNumber(int number, Consumer consumer) { + + consumer.accept(number); + } + + static Stream checkNumberArgs() { + + Consumer evenConsumer = i -> Assertions.assertThat(i % 2).isZero(); + Consumer oddConsumer = i -> Assertions.assertThat(i % 2).isEqualTo(1); + + return Stream.of(Arguments.of(2, evenConsumer), Arguments.of(3, oddConsumer)); + } +} diff --git a/core-java/junit5-parameterized-tests/src/test/java/source/csv/CsvSourceTest.java b/core-java/junit5-parameterized-tests/src/test/java/source/csv/CsvSourceTest.java new file mode 100644 index 0000000..310907f --- /dev/null +++ b/core-java/junit5-parameterized-tests/src/test/java/source/csv/CsvSourceTest.java @@ -0,0 +1,17 @@ +package source.csv; + +import static org.junit.jupiter.api.Assertions.assertEquals; + +import org.apache.commons.lang3.StringUtils; +import org.junit.jupiter.params.ParameterizedTest; +import org.junit.jupiter.params.provider.CsvSource; + +public class CsvSourceTest { + + @ParameterizedTest + @CsvSource({ "2, even", + "3, odd"}) + void checkCsvSource(int number, String expected) { + assertEquals(StringUtils.equals(expected, "even") ? 0 : 1, number % 2); + } +} diff --git a/core-java/junit5-parameterized-tests/src/test/java/source/csv/file/CsvFileSourceTest.java b/core-java/junit5-parameterized-tests/src/test/java/source/csv/file/CsvFileSourceTest.java new file mode 100644 index 0000000..3c85441 --- /dev/null +++ b/core-java/junit5-parameterized-tests/src/test/java/source/csv/file/CsvFileSourceTest.java @@ -0,0 +1,27 @@ +package source.csv.file; + +import static org.junit.jupiter.api.Assertions.assertEquals; + +import org.apache.commons.lang3.StringUtils; +import org.junit.jupiter.params.ParameterizedTest; +import org.junit.jupiter.params.provider.CsvFileSource; + +public class CsvFileSourceTest { + + @ParameterizedTest + @CsvFileSource(files = "src/test/resources/csv-file-source.csv", numLinesToSkip = 1) + void checkCsvFileSource(int number, String expected) { + assertEquals(StringUtils.equals(expected, "even") ? 0 : 1, number % 2); + } + + // --------------------------------------------------------------------------- + + @ParameterizedTest + @CsvFileSource(files = "src/test/resources/csv-file-source_attributes.csv", + delimiterString = "|", + lineSeparator = "||", + numLinesToSkip = 1) + void checkCsvFileSourceAttributes(int number, String expected) { + assertEquals(StringUtils.equals(expected, "even") ? 0 : 1, number % 2); + } +} diff --git a/core-java/junit5-parameterized-tests/src/test/java/source/enumeration/EnumSourceTest.java b/core-java/junit5-parameterized-tests/src/test/java/source/enumeration/EnumSourceTest.java new file mode 100644 index 0000000..411d4df --- /dev/null +++ b/core-java/junit5-parameterized-tests/src/test/java/source/enumeration/EnumSourceTest.java @@ -0,0 +1,25 @@ +package source.enumeration; + +import static org.junit.jupiter.api.Assertions.assertNotNull; + +import java.time.temporal.ChronoUnit; + +import org.junit.jupiter.params.ParameterizedTest; +import org.junit.jupiter.params.provider.EnumSource; + +public class EnumSourceTest { + + @ParameterizedTest + @EnumSource(ChronoUnit.class) + void checkEnumSourceValue(ChronoUnit unit) { + assertNotNull(unit); + } + + // --------------------------------------------------------------------------- + + @ParameterizedTest + @EnumSource(names = { "DAYS", "HOURS" }) + void checkEnumSourceNames(ChronoUnit unit) { + assertNotNull(unit); + } +} diff --git a/core-java/junit5-parameterized-tests/src/test/java/source/method/ExternalMethodSource.java b/core-java/junit5-parameterized-tests/src/test/java/source/method/ExternalMethodSource.java new file mode 100644 index 0000000..e75378e --- /dev/null +++ b/core-java/junit5-parameterized-tests/src/test/java/source/method/ExternalMethodSource.java @@ -0,0 +1,11 @@ +package source.method; + +import java.util.stream.Stream; + +public class ExternalMethodSource { + + static Stream checkExternalMethodSourceArgs() { + return Stream.of("a1", "b2"); + } + +} diff --git a/core-java/junit5-parameterized-tests/src/test/java/source/method/ExternalMethodSourceTest.java b/core-java/junit5-parameterized-tests/src/test/java/source/method/ExternalMethodSourceTest.java new file mode 100644 index 0000000..aabcb7b --- /dev/null +++ b/core-java/junit5-parameterized-tests/src/test/java/source/method/ExternalMethodSourceTest.java @@ -0,0 +1,17 @@ +package source.method; + +import static org.junit.jupiter.api.Assertions.assertTrue; + +import org.apache.commons.lang3.StringUtils; +import org.junit.jupiter.params.ParameterizedTest; +import org.junit.jupiter.params.provider.MethodSource; + +public class ExternalMethodSourceTest { + + // Note: The test will try to load the external method + @ParameterizedTest + @MethodSource("source.method.ExternalMethodSource#checkExternalMethodSourceArgs") + void checkExternalMethodSource(String word) { + assertTrue(StringUtils.isAlphanumeric(word), "Supplied word is not alpha-numeric"); + } +} diff --git a/core-java/junit5-parameterized-tests/src/test/java/source/method/MethodSourceTest.java b/core-java/junit5-parameterized-tests/src/test/java/source/method/MethodSourceTest.java new file mode 100644 index 0000000..cd6b6cd --- /dev/null +++ b/core-java/junit5-parameterized-tests/src/test/java/source/method/MethodSourceTest.java @@ -0,0 +1,52 @@ +package source.method; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertTrue; + +import java.util.stream.Stream; + +import org.apache.commons.lang3.StringUtils; +import org.junit.jupiter.params.ParameterizedTest; +import org.junit.jupiter.params.provider.Arguments; +import org.junit.jupiter.params.provider.MethodSource; + +public class MethodSourceTest { + + // Note: The test will try to load the supplied method + @ParameterizedTest + @MethodSource("checkExplicitMethodSourceArgs") + void checkExplicitMethodSource(String word) { + assertTrue(StringUtils.isAlphanumeric(word), "Supplied word is not alpha-numeric"); + } + + static Stream checkExplicitMethodSourceArgs() { + return Stream.of("a1", "b2"); + } + + // --------------------------------------------------------------------------- + + // Note: The test will search for the source method that matches the test-case + // method name + @ParameterizedTest + @MethodSource + void checkImplicitMethodSource(String word) { + assertTrue(StringUtils.isAlphanumeric(word), "Supplied word is not alpha-numeric"); + } + + static Stream checkImplicitMethodSource() { + return Stream.of("a1", "b2"); + } + + // --------------------------------------------------------------------------- + + // Note: The test will automatically map arguments based on the index + @ParameterizedTest + @MethodSource + void checkMultiArgumentsMethodSource(int number, String expected) { + assertEquals(StringUtils.equals(expected, "even") ? 0 : 1, number % 2); + } + + static Stream checkMultiArgumentsMethodSource() { + return Stream.of(Arguments.of(2, "even"), Arguments.of(3, "odd")); + } +} diff --git a/core-java/junit5-parameterized-tests/src/test/java/source/null_empty/NullEmptySourceTest.java b/core-java/junit5-parameterized-tests/src/test/java/source/null_empty/NullEmptySourceTest.java new file mode 100644 index 0000000..02d6196 --- /dev/null +++ b/core-java/junit5-parameterized-tests/src/test/java/source/null_empty/NullEmptySourceTest.java @@ -0,0 +1,44 @@ +package source.null_empty; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertTrue; + +import org.junit.jupiter.params.ParameterizedTest; +import org.junit.jupiter.params.provider.EmptySource; +import org.junit.jupiter.params.provider.NullAndEmptySource; +import org.junit.jupiter.params.provider.NullSource; +import org.junit.jupiter.params.provider.ValueSource; + +public class NullEmptySourceTest { + + @ParameterizedTest + @NullSource + void checkNull(String value) { + assertEquals(null, value); + } + + // --------------------------------------------------------------------------- + + @ParameterizedTest + @EmptySource + void checkEmpty(String value) { + assertEquals("", value); + } + + // --------------------------------------------------------------------------- + + @ParameterizedTest + @NullAndEmptySource + void checkNullAndEmpty(String value) { + assertTrue(value == null || value.isEmpty()); + } + + // --------------------------------------------------------------------------- + + @ParameterizedTest + @NullAndEmptySource + @ValueSource(strings = { " ", " " }) + void checkNullEmptyAndBlank(String value) { + assertTrue(value == null || value.isBlank()); + } +} diff --git a/core-java/junit5-parameterized-tests/src/test/java/source/value/ValueSourceTest.java b/core-java/junit5-parameterized-tests/src/test/java/source/value/ValueSourceTest.java new file mode 100644 index 0000000..d27df98 --- /dev/null +++ b/core-java/junit5-parameterized-tests/src/test/java/source/value/ValueSourceTest.java @@ -0,0 +1,25 @@ +package source.value; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertTrue; + +import org.apache.commons.lang3.StringUtils; +import org.junit.jupiter.params.ParameterizedTest; +import org.junit.jupiter.params.provider.ValueSource; + +public class ValueSourceTest { + + @ParameterizedTest + @ValueSource(ints = { 2, 4 }) + void checkEvenNumber(int number) { + assertEquals(0, number % 2, "Supplied number is not an even number"); + } + + // --------------------------------------------------------------------------- + + @ParameterizedTest + @ValueSource(strings = { "a1", "b2" }) + void checkAlphanumeric(String word) { + assertTrue(StringUtils.isAlphanumeric(word), "Supplied word is not alpha-numeric"); + } +} diff --git a/core-java/junit5-parameterized-tests/src/test/resources/csv-file-source.csv b/core-java/junit5-parameterized-tests/src/test/resources/csv-file-source.csv new file mode 100644 index 0000000..f1f6267 --- /dev/null +++ b/core-java/junit5-parameterized-tests/src/test/resources/csv-file-source.csv @@ -0,0 +1,3 @@ +NUMBER, ODD_EVEN +2, even +3, odd \ No newline at end of file diff --git a/core-java/junit5-parameterized-tests/src/test/resources/csv-file-source_attributes.csv b/core-java/junit5-parameterized-tests/src/test/resources/csv-file-source_attributes.csv new file mode 100644 index 0000000..df408d3 --- /dev/null +++ b/core-java/junit5-parameterized-tests/src/test/resources/csv-file-source_attributes.csv @@ -0,0 +1,3 @@ +|| NUMBER | ODD_EVEN || +|| 2 | even || +|| 3 | odd || \ No newline at end of file