Package spock.lang

Annotation Type PendingFeature

@Beta
@Retention(RUNTIME)
@Target(METHOD)
public @interface PendingFeature

Indicates that the feature is not fully implemented yet and should not be reported as error.

The use case is to annotate tests that can not yet run but should already be committed. The main difference to Ignore is that the test are executed, but test failures are ignored. If the test passes without an error, then it will be reported as failure since the PendingFeature annotation should be removed. This way the tests will become part of the normal tests instead of being ignored forever.

Groovy has the NotYetImplemented annotation which is similar but behaves a differently.

• it will mark failing tests as passed
• if at least one iteration of a data-driven test passes it will be reported as error

PendingFeature:

• it will mark failing tests as skipped
• if at least one iteration of a data-driven test fails it will be reported as skipped
• if every iteration of a data-driven test passes it will be reported as error

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element	Description
java.lang.Class<? extends java.lang.Throwable>[]	exceptions	Configures which types of Exceptions are expected in the pending feature.
java.lang.String	reason	The reason why this feature is pending

Element Detail

exceptions

java.lang.Class<? extends java.lang.Throwable>[] exceptions

Configures which types of Exceptions are expected in the pending feature. Subclasses are included if their parent class is listed.

Returns:

array of Exception classes to ignore.

Default:

{java.lang.Exception.class}

reason

java.lang.String reason

The reason why this feature is pending

Returns:

reason why this feature is pending

Default:

""