Package io.github.artsok

Annotation Type ParameterizedRepeatedIfExceptionsTest

@Target(METHOD)
@Retention(RUNTIME)
@TestTemplate
@ExtendWith(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	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	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

static final String CURRENT_REPETITION_PLACEHOLDER

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

TOTAL_REPETITIONS_PLACEHOLDER

static final String TOTAL_REPETITIONS_PLACEHOLDER

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

REPEATED_DISPLAY_NAME

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")
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")
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")
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")
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

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

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

Class<? extends Throwable>[] exceptions

Pool of exceptions

Returns:

Exception that handlered

Default:

{java.lang.Throwable.class}

repeats

int repeats

Number of repeats

Returns:

N-times repeat test if it failed

Default:

1

minSuccess

int minSuccess

Minimum success

Returns:

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

Default:

1

suspend

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