New behaviour for RetryingTest for Assumptions

docs/retrying-test.adoc

@@ -40,6 +40,18 @@ void failsAlways() {
 The test `failsAlways` is executed three times (all of which fail).
 The first two executions are marked as ignored/aborted, while the last as failed - each contains the underlying exception.
 
+```java
+@RetryingTest(3)
+void aborted() {
+    // test code that is aborted e.g. because of an Assumption.
+}
+```
+
+If a test is aborted (e.g.: because of a failed Assumption) `@RetryingTest` won't try again after that.
+The test `aborted` is aborted before (or during) its first execution.
+The first execution is marked as aborted/skipped, containing the underlying cause.
+The test suite as a whole is also marked as aborted/skipped.
+
 == Combining `@RetryingTest` with `@Test` et al
 
 If `@RetryingTest` is combined with `@Test` or `TestTemplate`-based mechanisms (like `@RepeatedTest` or `@ParameterizedTest`), the test engine will execute it according to each annotation (i.e. more than once).

src/main/java/org/junitpioneer/jupiter/RetryingTestExtension.java

@@ -85,6 +85,10 @@ static FailedTestRetrier createFor(Method test) {
 		}
 
 		void failed(Throwable exception) {
+			if (exception instanceof TestAbortedException)
+				throw new TestAbortedException("Test execution was skipped, possibly because of a failed assumption.",
+					exception);
+
 			exceptionsSoFar++;
 
 			boolean allRetriesFailed = exceptionsSoFar == maxRetries;

src/test/java/org/junitpioneer/jupiter/RetryingTestTests.java

@@ -19,6 +19,7 @@
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
 
+import org.junit.jupiter.api.Assumptions;
 import org.junit.jupiter.api.Test;
 import org.junit.jupiter.api.TestTemplate;
 import org.junit.jupiter.api.parallel.Execution;
@@ -74,6 +75,14 @@ void failsAlways_executedThreeTimes_fails() {
 		assertThat(results.numberOfFailedTests()).isEqualTo(1);
 	}
 
+	@Test
+	void skipByAssumption_executedOnce_skipped() {
+		ExecutionResults results = PioneerTestKit.executeTestMethod(RetryingTestTestCase.class, "skipByAssumption");
+
+		assertThat(results.numberOfDynamicRegisteredTests()).isEqualTo(1);
+		assertThat(results.numberOfAbortedTests()).isEqualTo(1);
+	}
+
 	// TEST CASES -------------------------------------------------------------------
 
 	static class RetryingTestTestCase {
@@ -107,6 +116,11 @@ void failsAlways() {
 			throw new IllegalArgumentException();
 		}
 
+		@RetryingTest(3)
+		void skipByAssumption() {
+			Assumptions.assumeFalse(true);
+		}
+
 	}
 
 	@Target({ METHOD, ANNOTATION_TYPE })