Deprecate junit-platform-gradle-plugin

Issue: junit-team#1317
Andrei94 · Jun 23, 2018 · 0adb374 · 0adb374
1 parent 55ad6fb
commit 0adb374
Show file tree

Hide file tree

Showing 7 changed files with 33 additions and 14 deletions.
diff --git a/...rm-gradle-plugin/src/main/groovy/org/junit/platform/gradle/plugin/EnginesExtension.groovy b/...rm-gradle-plugin/src/main/groovy/org/junit/platform/gradle/plugin/EnginesExtension.groovy
@@ -9,16 +9,18 @@
  */
 package org.junit.platform.gradle.plugin
 
-import static org.apiguardian.api.API.Status.EXPERIMENTAL
+import static org.apiguardian.api.API.Status.DEPRECATED
 
 import org.apiguardian.api.API
 
 /**
  * TestEngine configuration options for the JUnit Platform Gradle plugin.
  *
  * @since 1.0
+ * @deprecated Use Gradle's native support for JUnit Platform instead.
  */
-@API(status = EXPERIMENTAL, since = "1.0")
+@Deprecated
+@API(status = DEPRECATED, since = "1.2")
 class EnginesExtension {
 
 	/**

diff --git a/...rm-gradle-plugin/src/main/groovy/org/junit/platform/gradle/plugin/FiltersExtension.groovy b/...rm-gradle-plugin/src/main/groovy/org/junit/platform/gradle/plugin/FiltersExtension.groovy
@@ -9,7 +9,7 @@
  */
 package org.junit.platform.gradle.plugin
 
-import static org.apiguardian.api.API.Status.EXPERIMENTAL
+import static org.apiguardian.api.API.Status.DEPRECATED
 
 import org.apiguardian.api.API
 import org.gradle.api.Action
@@ -19,8 +19,10 @@ import org.junit.platform.engine.discovery.ClassNameFilter
  * Test discovery filter options for the JUnit Platform Gradle plugin.
  *
  * @since 1.0
+ * @deprecated Use Gradle's native support for JUnit Platform instead.
  */
-@API(status = EXPERIMENTAL, since = "1.0")
+@Deprecated
+@API(status = DEPRECATED, since = "1.2")
 class FiltersExtension {
 
 	/**

diff --git a/...dle-plugin/src/main/groovy/org/junit/platform/gradle/plugin/JUnitPlatformExtension.groovy b/...dle-plugin/src/main/groovy/org/junit/platform/gradle/plugin/JUnitPlatformExtension.groovy
@@ -9,7 +9,7 @@
  */
 package org.junit.platform.gradle.plugin
 
-import static org.apiguardian.api.API.Status.EXPERIMENTAL
+import static org.apiguardian.api.API.Status.DEPRECATED
 
 import org.apiguardian.api.API
 import org.gradle.api.Action
@@ -23,8 +23,10 @@ import org.junit.platform.console.options.Details
  * Core configuration options for the JUnit Platform Gradle plugin.
  *
  * @since 1.0
+ * @deprecated Use Gradle's native support for JUnit Platform instead.
  */
-@API(status = EXPERIMENTAL, since = "1.0")
+@Deprecated
+@API(status = DEPRECATED, since = "1.2")
 class JUnitPlatformExtension {
 
 	private final Project project

diff --git a/...gradle-plugin/src/main/groovy/org/junit/platform/gradle/plugin/JUnitPlatformPlugin.groovy b/...gradle-plugin/src/main/groovy/org/junit/platform/gradle/plugin/JUnitPlatformPlugin.groovy
@@ -9,7 +9,7 @@
  */
 package org.junit.platform.gradle.plugin
 
-import static org.apiguardian.api.API.Status.EXPERIMENTAL
+import static org.apiguardian.api.API.Status.DEPRECATED
 
 import org.apiguardian.api.API
 import org.gradle.api.GradleException
@@ -22,8 +22,10 @@ import org.junit.platform.console.ConsoleLauncher
 
 /**
  * @since 1.0
+ * @deprecated Use Gradle's native support for JUnit Platform instead.
  */
-@API(status = EXPERIMENTAL, since = "1.0")
+@Deprecated
+@API(status = DEPRECATED, since = "1.2")
 class JUnitPlatformPlugin implements Plugin<Project> {
 
 	private static final String EXTENSION_NAME = 'junitPlatform'
@@ -71,6 +73,11 @@ class JUnitPlatformPlugin implements Plugin<Project> {
 			it.with {
 				group = JavaBasePlugin.VERIFICATION_GROUP
 				description = 'Runs tests on the JUnit Platform.'
+				doFirst {
+					getLogger().warn("WARNING: The junit-platform-gradle-plugin is deprecated and will be discontinued in JUnit Platform 1.3.")
+					getLogger().warn("Please use Gradle's native support for running tests on the JUnit Platform (requires Gradle 4.6 or higher):")
+					getLogger().warn("https://junit.org/junit5/docs/current/user-guide/#running-tests-build-gradle")
+				}
 			}
 		}
 

diff --git a/...m-gradle-plugin/src/main/groovy/org/junit/platform/gradle/plugin/PackagesExtension.groovy b/...m-gradle-plugin/src/main/groovy/org/junit/platform/gradle/plugin/PackagesExtension.groovy
@@ -9,16 +9,18 @@
  */
 package org.junit.platform.gradle.plugin
 
-import static org.apiguardian.api.API.Status.EXPERIMENTAL
+import static org.apiguardian.api.API.Status.DEPRECATED
 
 import org.apiguardian.api.API
 
 /**
  * Package configuration options for the JUnit Platform Gradle plugin.
  *
  * @since 1.0
+ * @deprecated Use Gradle's native support for JUnit Platform instead.
  */
-@API(status = EXPERIMENTAL, since = "1.0")
+@Deprecated
+@API(status = DEPRECATED, since = "1.2")
 class PackagesExtension {
 
 	/**

diff --git a/...-gradle-plugin/src/main/groovy/org/junit/platform/gradle/plugin/SelectorsExtension.groovy b/...-gradle-plugin/src/main/groovy/org/junit/platform/gradle/plugin/SelectorsExtension.groovy
@@ -9,16 +9,18 @@
  */
 package org.junit.platform.gradle.plugin
 
-import static org.apiguardian.api.API.Status.EXPERIMENTAL
+import static org.apiguardian.api.API.Status.DEPRECATED
 
 import org.apiguardian.api.API
 
 /**
  * Discovery selector configuration options for the JUnit Platform Gradle plugin.
  *
  * @since 1.0
+ * @deprecated Use Gradle's native support for JUnit Platform instead.
  */
-@API(status = EXPERIMENTAL, since = "1.0")
+@Deprecated
+@API(status = DEPRECATED, since = "1.2")
 class SelectorsExtension {
 
 	/**

diff --git a/...tform-gradle-plugin/src/main/groovy/org/junit/platform/gradle/plugin/TagsExtension.groovy b/...tform-gradle-plugin/src/main/groovy/org/junit/platform/gradle/plugin/TagsExtension.groovy
@@ -9,16 +9,18 @@
  */
 package org.junit.platform.gradle.plugin
 
-import static org.apiguardian.api.API.Status.EXPERIMENTAL
+import static org.apiguardian.api.API.Status.DEPRECATED
 
 import org.apiguardian.api.API
 
 /**
  * Tag configuration options for the JUnit Platform Gradle plugin.
  *
  * @since 1.0
+ * @deprecated Use Gradle's native support for JUnit Platform instead.
  */
-@API(status = EXPERIMENTAL, since = "1.0")
+@Deprecated
+@API(status = DEPRECATED, since = "1.2")
 class TagsExtension {
 
 	/**