io.github.artsok

Annotation Type ParameterizedRepeatedIfExceptionsTest

@Target(value={METHOD,TYPE})
 @Retention(value=RUNTIME)
 @TestTemplate
 @ExtendWith(value=ParameterizedRepeatedExtension.class)
public @interface ParameterizedRepeatedIfExceptionsTest

Annotation which you can put to parameterized test method. Customize the number of repeats and set for what exception you want handled. By default set Throwable.class. All logic of this extension at ParameterizedRepeatedExtension

Author:

Artem Sokovets

Field Summary

Fields

Modifier and Type	Fields and Description
static String	ARGUMENTS_PLACEHOLDER Placeholder for the complete, comma-separated arguments list of the current invocation of a @ParameterizedTest method: {arguments}
static String	CURRENT_REPETITION_PLACEHOLDER Placeholder for the current repetition count of a @RepeatedTest method: {currentRepetition}
static String	DEFAULT_DISPLAY_NAME Default display name pattern for the current invocation of a @ParameterizedTest method: "[{index}] {arguments}"
static String	DISPLAY_NAME_PLACEHOLDER Placeholder for the display name of a @ParameterizedTest method: {displayName}
static String	INDEX_PLACEHOLDER Placeholder for the current invocation index of a @ParameterizedTest method (1-based): {index}
static String	REPEATED_DISPLAY_NAME Display name pattern for a repeated test
static String	TOTAL_REPETITIONS_PLACEHOLDER Placeholder for the total number of repetitions of a @RepeatedTest method: {totalRepetitions}

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
Class<? extends Throwable>[]	exceptions Pool of exceptions
int	minSuccess Minimum success
String	name The display name to be used for individual invocations of the parameterized test; never blank or consisting solely of whitespace.
String	repeatedName The display name to be used for individual repeated invocations of the parameterized test; never blank.
int	repeats Number of repeats
long	suspend Add break (cooldown) to each tests.

Field Detail

CURRENT_REPETITION_PLACEHOLDER

public static final String CURRENT_REPETITION_PLACEHOLDER

Placeholder for the current repetition count of a @RepeatedTest method: {currentRepetition}

TOTAL_REPETITIONS_PLACEHOLDER

public static final String TOTAL_REPETITIONS_PLACEHOLDER

Placeholder for the total number of repetitions of a @RepeatedTest method: {totalRepetitions}

REPEATED_DISPLAY_NAME

public static final String REPEATED_DISPLAY_NAME

Display name pattern for a repeated test

See Also:

CURRENT_REPETITION_PLACEHOLDER, TOTAL_REPETITIONS_PLACEHOLDER

DISPLAY_NAME_PLACEHOLDER

@API(status=EXPERIMENTAL,
     since="5.3")
public static final String DISPLAY_NAME_PLACEHOLDER

Placeholder for the display name of a @ParameterizedTest method: {displayName}

Since:

5.3

See Also:

name()

INDEX_PLACEHOLDER

@API(status=EXPERIMENTAL,
     since="5.3")
public static final String INDEX_PLACEHOLDER

Placeholder for the current invocation index of a @ParameterizedTest method (1-based): {index}

Since:

5.3

See Also:

name()

ARGUMENTS_PLACEHOLDER

@API(status=EXPERIMENTAL,
     since="5.3")
public static final String ARGUMENTS_PLACEHOLDER

Placeholder for the complete, comma-separated arguments list of the current invocation of a @ParameterizedTest method: {arguments}

Since:

5.3

See Also:

name()

DEFAULT_DISPLAY_NAME

@API(status=EXPERIMENTAL,
     since="5.3")
public static final String DEFAULT_DISPLAY_NAME

Default display name pattern for the current invocation of a @ParameterizedTest method: "[{index}] {arguments}"

Note that the default pattern does not include the display name of the @ParameterizedTest method.

Since:

5.3

See Also:

name(), DISPLAY_NAME_PLACEHOLDER, INDEX_PLACEHOLDER, ARGUMENTS_PLACEHOLDER

Element Detail

name

public abstract String name

The display name to be used for individual invocations of the parameterized test; never blank or consisting solely of whitespace.

Returns:

String

Default:

"[{index}] {arguments}"

repeatedName

public abstract String repeatedName

The display name to be used for individual repeated invocations of the parameterized test; never blank.

Returns:

String

Default:

" (Repeated if the test failed {currentRepetition} of {totalRepetitions})"

exceptions

public abstract Class<? extends Throwable>[] exceptions

Pool of exceptions

Returns:

Exception that handlered

Default:

java.lang.Throwable.class

repeats

public abstract int repeats

Number of repeats

Returns:

N-times repeat test if it failed

Default:

1

minSuccess

public abstract int minSuccess

Minimum success

Returns:

After n-times of passed tests will disable all remaining repeats.

Default:

1

suspend

public abstract long suspend

Add break (cooldown) to each tests. It matters, when you get some infrastructure problems and you want to run your tests through timeout.

Returns:

the length of time to sleep in milliseconds

Default:

0L