Populate since attribute in @API declarations

Issue: #436
junit-team · Sep 8, 2017 · a1a607b · a1a607b
1 parent 475e7fa
commit a1a607b
Show file tree

Hide file tree

Showing 220 changed files with 232 additions and 230 deletions.
diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/AfterAll.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/AfterAll.java
@@ -62,6 +62,6 @@
 @Target({ ElementType.ANNOTATION_TYPE, ElementType.METHOD })
 @Retention(RetentionPolicy.RUNTIME)
 @Documented
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public @interface AfterAll {
 }
diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/AfterEach.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/AfterEach.java
@@ -58,6 +58,6 @@
 @Target({ ElementType.ANNOTATION_TYPE, ElementType.METHOD })
 @Retention(RetentionPolicy.RUNTIME)
 @Documented
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public @interface AfterEach {
 }
diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/Assertions.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/Assertions.java
@@ -10,7 +10,6 @@
 
 package org.junit.jupiter.api;
 
-import static org.junit.platform.commons.meta.API.Status.EXPERIMENTAL;
 import static org.junit.platform.commons.meta.API.Status.STABLE;
 
 import java.time.Duration;
@@ -37,7 +36,7 @@
  * @see org.opentest4j.AssertionFailedError
  * @see Assumptions
  */
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public final class Assertions {
 
 	///CLOVER:OFF
@@ -1089,7 +1088,6 @@ public static void assertAll(String heading, Executable... executables) throws M
 	 * @see #assertAll(String, Executable...)
 	 * @see #assertAll(Stream)
 	 */
-	@API(status = EXPERIMENTAL)
 	public static void assertAll(String heading, Stream<Executable> executables) throws MultipleFailuresError {
 		AssertAll.assertAll(heading, executables);
 	}

diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/Assumptions.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/Assumptions.java
@@ -38,7 +38,7 @@
  * @see TestAbortedException
  * @see Assertions
  */
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public final class Assumptions {
 
 	///CLOVER:OFF

diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/BeforeAll.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/BeforeAll.java
@@ -62,6 +62,6 @@
 @Target({ ElementType.ANNOTATION_TYPE, ElementType.METHOD })
 @Retention(RetentionPolicy.RUNTIME)
 @Documented
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public @interface BeforeAll {
 }
diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/BeforeEach.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/BeforeEach.java
@@ -58,6 +58,6 @@
 @Target({ ElementType.ANNOTATION_TYPE, ElementType.METHOD })
 @Retention(RetentionPolicy.RUNTIME)
 @Documented
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public @interface BeforeEach {
 }
diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/Disabled.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/Disabled.java
@@ -32,7 +32,7 @@
 @Target({ ElementType.TYPE, ElementType.METHOD })
 @Retention(RetentionPolicy.RUNTIME)
 @Documented
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public @interface Disabled {
 
 	/**

diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/DisplayName.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/DisplayName.java
@@ -34,7 +34,7 @@
 @Target({ ElementType.TYPE, ElementType.METHOD })
 @Retention(RetentionPolicy.RUNTIME)
 @Documented
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public @interface DisplayName {
 
 	/**

diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/DynamicContainer.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/DynamicContainer.java
@@ -29,7 +29,7 @@
  *
  * @since 5.0
  */
-@API(status = EXPERIMENTAL)
+@API(status = EXPERIMENTAL, since = "5.0")
 public class DynamicContainer extends DynamicNode {
 
 	/**

diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/DynamicNode.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/DynamicNode.java
@@ -22,7 +22,7 @@
  *
  * @since 5.0
  */
-@API(status = EXPERIMENTAL)
+@API(status = EXPERIMENTAL, since = "5.0")
 public abstract class DynamicNode {
 
 	private final String displayName;

diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/DynamicTest.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/DynamicTest.java
@@ -44,7 +44,7 @@
  * @see TestFactory
  * @see Executable
  */
-@API(status = EXPERIMENTAL)
+@API(status = EXPERIMENTAL, since = "5.0")
 public class DynamicTest extends DynamicNode {
 
 	/**

diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/Nested.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/Nested.java
@@ -29,6 +29,6 @@
 @Target(ElementType.TYPE)
 @Retention(RetentionPolicy.RUNTIME)
 @Documented
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public @interface Nested {
 }
diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/RepeatedTest.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/RepeatedTest.java
@@ -53,7 +53,7 @@
 @Target({ ElementType.ANNOTATION_TYPE, ElementType.METHOD })
 @Retention(RetentionPolicy.RUNTIME)
 @Documented
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 @TestTemplate
 public @interface RepeatedTest {
 

diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/RepetitionInfo.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/RepetitionInfo.java
@@ -33,7 +33,7 @@
  * @see RepeatedTest
  * @see TestInfo
  */
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public interface RepetitionInfo {
 
 	/**

diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/Tag.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/Tag.java
@@ -46,7 +46,7 @@
 @Retention(RetentionPolicy.RUNTIME)
 @Documented
 @Repeatable(Tags.class)
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public @interface Tag {
 
 	/**

diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/Tags.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/Tags.java
@@ -34,7 +34,7 @@
 @Target({ ElementType.TYPE, ElementType.METHOD })
 @Retention(RetentionPolicy.RUNTIME)
 @Documented
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public @interface Tags {
 
 	/**

diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/Test.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/Test.java
@@ -47,7 +47,7 @@
 @Target({ ElementType.ANNOTATION_TYPE, ElementType.METHOD })
 @Retention(RetentionPolicy.RUNTIME)
 @Documented
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 @Testable
 public @interface Test {
 }
diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/TestFactory.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/TestFactory.java
@@ -52,7 +52,7 @@
 @Target({ ElementType.ANNOTATION_TYPE, ElementType.METHOD })
 @Retention(RetentionPolicy.RUNTIME)
 @Documented
-@API(status = EXPERIMENTAL)
+@API(status = EXPERIMENTAL, since = "5.0")
 @Testable
 public @interface TestFactory {
 }
diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/TestInfo.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/TestInfo.java
@@ -31,7 +31,7 @@
  * @see Test
  * @see DisplayName
  */
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public interface TestInfo {
 
 	/**

diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/TestInstance.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/TestInstance.java
@@ -10,13 +10,17 @@
 
 package org.junit.jupiter.api;
 
+import static org.junit.platform.commons.meta.API.Status.STABLE;
+
 import java.lang.annotation.Documented;
 import java.lang.annotation.ElementType;
 import java.lang.annotation.Inherited;
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
 
+import org.junit.platform.commons.meta.API;
+
 /**
  * {@code @TestInstance} is a type-level annotation that is used to configure
  * the {@linkplain Lifecycle lifecycle} of test instances for the annotated
@@ -57,6 +61,7 @@
 @Retention(RetentionPolicy.RUNTIME)
 @Inherited
 @Documented
+@API(status = STABLE, since = "5.0")
 public @interface TestInstance {
 
 	/**

diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/TestReporter.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/TestReporter.java
@@ -28,7 +28,7 @@
  * @since 5.0
  */
 @FunctionalInterface
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public interface TestReporter {
 
 	/**

diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/TestTemplate.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/TestTemplate.java
@@ -57,7 +57,7 @@
 @Target({ ElementType.ANNOTATION_TYPE, ElementType.METHOD })
 @Retention(RetentionPolicy.RUNTIME)
 @Documented
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 @Testable
 public @interface TestTemplate {
 }
diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/extension/AfterAllCallback.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/extension/AfterAllCallback.java
@@ -32,7 +32,7 @@
  * @see AfterTestExecutionCallback
  */
 @FunctionalInterface
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public interface AfterAllCallback extends Extension {
 
 	/**

diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/extension/AfterEachCallback.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/extension/AfterEachCallback.java
@@ -37,7 +37,7 @@
  * @see AfterAllCallback
  */
 @FunctionalInterface
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public interface AfterEachCallback extends Extension {
 
 	/**

diff --git a/...jupiter-api/src/main/java/org/junit/jupiter/api/extension/AfterTestExecutionCallback.java b/...jupiter-api/src/main/java/org/junit/jupiter/api/extension/AfterTestExecutionCallback.java
@@ -36,7 +36,7 @@
  * @see AfterAllCallback
  */
 @FunctionalInterface
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public interface AfterTestExecutionCallback extends Extension {
 
 	/**

diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/extension/BeforeAllCallback.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/extension/BeforeAllCallback.java
@@ -32,7 +32,7 @@
  * @see AfterTestExecutionCallback
  */
 @FunctionalInterface
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public interface BeforeAllCallback extends Extension {
 
 	/**

diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/extension/BeforeEachCallback.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/extension/BeforeEachCallback.java
@@ -35,7 +35,7 @@
  * @see AfterAllCallback
  */
 @FunctionalInterface
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public interface BeforeEachCallback extends Extension {
 
 	/**

diff --git a/...upiter-api/src/main/java/org/junit/jupiter/api/extension/BeforeTestExecutionCallback.java b/...upiter-api/src/main/java/org/junit/jupiter/api/extension/BeforeTestExecutionCallback.java
@@ -36,7 +36,7 @@
  * @see AfterAllCallback
  */
 @FunctionalInterface
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public interface BeforeTestExecutionCallback extends Extension {
 
 	/**

diff --git a/...-jupiter-api/src/main/java/org/junit/jupiter/api/extension/ConditionEvaluationResult.java b/...-jupiter-api/src/main/java/org/junit/jupiter/api/extension/ConditionEvaluationResult.java
@@ -22,7 +22,7 @@
  *
  * @since 5.0
  */
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public class ConditionEvaluationResult {
 
 	/**

diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/extension/ExecutionCondition.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/extension/ExecutionCondition.java
@@ -29,7 +29,7 @@
  * @see org.junit.jupiter.api.Disabled
  */
 @FunctionalInterface
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public interface ExecutionCondition extends Extension {
 
 	/**

diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/extension/ExtendWith.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/extension/ExtendWith.java
@@ -49,7 +49,7 @@
 @Documented
 @Inherited
 @Repeatable(Extensions.class)
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public @interface ExtendWith {
 
 	/**

diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/extension/Extension.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/extension/Extension.java
@@ -22,6 +22,6 @@
  *
  * @since 5.0
  */
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public interface Extension {
 }
diff --git a/...er-api/src/main/java/org/junit/jupiter/api/extension/ExtensionConfigurationException.java b/...er-api/src/main/java/org/junit/jupiter/api/extension/ExtensionConfigurationException.java
@@ -21,7 +21,7 @@
  *
  * @since 5.0
  */
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public class ExtensionConfigurationException extends JUnitException {
 
 	private static final long serialVersionUID = 1L;

diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/extension/ExtensionContext.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/extension/ExtensionContext.java
@@ -38,7 +38,7 @@
  * @see Store
  * @see Namespace
  */
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public interface ExtensionContext {
 
 	/**

diff --git a/...-jupiter-api/src/main/java/org/junit/jupiter/api/extension/ExtensionContextException.java b/...-jupiter-api/src/main/java/org/junit/jupiter/api/extension/ExtensionContextException.java
@@ -22,7 +22,7 @@
  *
  * @since 5.0
  */
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public class ExtensionContextException extends JUnitException {
 
 	private static final long serialVersionUID = 1L;

diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/extension/Extensions.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/extension/Extensions.java
@@ -37,7 +37,7 @@
 @Retention(RetentionPolicy.RUNTIME)
 @Documented
 @Inherited
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public @interface Extensions {
 
 	/**

diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/extension/ParameterContext.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/extension/ParameterContext.java
@@ -33,7 +33,7 @@
  * @see java.lang.reflect.Method
  * @see java.lang.reflect.Constructor
  */
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public interface ParameterContext {
 
 	/**

diff --git a/...piter-api/src/main/java/org/junit/jupiter/api/extension/ParameterResolutionException.java b/...piter-api/src/main/java/org/junit/jupiter/api/extension/ParameterResolutionException.java
@@ -22,7 +22,7 @@
  * @since 5.0
  * @see ParameterResolver
  */
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public class ParameterResolutionException extends JUnitException {
 
 	private static final long serialVersionUID = 1L;

diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/extension/ParameterResolver.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/extension/ParameterResolver.java
@@ -37,7 +37,7 @@
  * @see #resolveParameter(ParameterContext, ExtensionContext)
  * @see ParameterContext
  */
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public interface ParameterResolver extends Extension {
 
 	/**

diff --git a/...iter-api/src/main/java/org/junit/jupiter/api/extension/TestExecutionExceptionHandler.java b/...iter-api/src/main/java/org/junit/jupiter/api/extension/TestExecutionExceptionHandler.java
@@ -30,7 +30,7 @@
  * @since 5.0
  */
 @FunctionalInterface
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public interface TestExecutionExceptionHandler extends Extension {
 
 	/**

diff --git a/...-jupiter-api/src/main/java/org/junit/jupiter/api/extension/TestInstancePostProcessor.java b/...-jupiter-api/src/main/java/org/junit/jupiter/api/extension/TestInstancePostProcessor.java
@@ -27,7 +27,7 @@
  * @since 5.0
  * @see #postProcessTestInstance(Object, ExtensionContext)
  */
-@API(status = STABLE)
+@API(status = STABLE, since = "5.0")
 public interface TestInstancePostProcessor extends Extension {
 
 	/**