Package com.gradle.develocity.agent.gradle.test

Interface TestRetryConfiguration

public interface TestRetryConfiguration

Task extension for configuring Test Retry.

Since:

3.17

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	TestRetryConfiguration.ClassRetryCriteria	The set of criteria specifying which test classes must be retried as a whole unit if retries are enabled and the test class passes the configured filter.
static interface	TestRetryConfiguration.Filter	A filter for specifying which tests may be retried.

Method Summary

Modifier and Type	Method	Description
void	classRetry(Action<? super TestRetryConfiguration.ClassRetryCriteria> action)	The set of criteria specifying which test classes must be retried as a whole unit if retries are enabled and the test class passes the configured filter.
void	filter(Action<? super TestRetryConfiguration.Filter> action)	The filter for specifying which tests may be retried.
TestRetryConfiguration.ClassRetryCriteria	getClassRetry()	The set of criteria specifying which test classes must be retried as a whole unit if retries are enabled and the test class passes the configured filter.
Property<java.lang.Boolean>	getFailOnPassedAfterRetry()	Whether tests that initially fail and then pass on retry should fail the task.
TestRetryConfiguration.Filter	getFilter()	The filter for specifying which tests may be retried.
Property<java.lang.Integer>	getMaxFailures()	The maximum number of test failures that are allowed before retrying is disabled.
Property<java.lang.Integer>	getMaxRetries()	The maximum number of times to retry an individual test.

Method Detail

getFailOnPassedAfterRetry

@Input
Property<java.lang.Boolean> getFailOnPassedAfterRetry()

Whether tests that initially fail and then pass on retry should fail the task.

This setting defaults to false, which results in the task not failing if all tests pass on retry.

This setting has no effect if AbstractTestTask.getIgnoreFailures() is set to true.

Returns:

whether tests that initially fails and then pass on retry should fail the task

getMaxRetries

@Internal
Property<java.lang.Integer> getMaxRetries()

The maximum number of times to retry an individual test.

This setting defaults to 0, which results in no retries. Any value less than 1 disables retrying.

Returns:

the maximum number of times to retry an individual test

getMaxFailures

@Internal
Property<java.lang.Integer> getMaxFailures()

The maximum number of test failures that are allowed before retrying is disabled.

The count applies to each round of test execution. For example, if maxFailures is 5 and 4 tests initially fail and then 3 again on retry, this will not be considered too many failures and retrying will continue (if maxRetries > 1). If 5 or more tests were to fail initially then no retry would be attempted.

This setting defaults to 0, which results in no limit. Any value less than 1 results in no limit.

Returns:

the maximum number of test failures that are allowed before retrying is disabled

getFilter

@Internal
TestRetryConfiguration.Filter getFilter()

The filter for specifying which tests may be retried.

filter

void filter(Action<? super TestRetryConfiguration.Filter> action)

The filter for specifying which tests may be retried.

getClassRetry

@Internal
TestRetryConfiguration.ClassRetryCriteria getClassRetry()

The set of criteria specifying which test classes must be retried as a whole unit if retries are enabled and the test class passes the configured filter.

classRetry

void classRetry(Action<? super TestRetryConfiguration.ClassRetryCriteria> action)

The set of criteria specifying which test classes must be retried as a whole unit if retries are enabled and the test class passes the configured filter.