Delete API guardian from the library.

Usages of the annotation have never been fully consistent and users
should be using reflection to determine the JAR version on the
off chance they are manipulating this API programmatically.

API guardian has never been specified as part of the public API,
so this is not a breaking change.

Author: ascopes

.gitignore

@@ -2,6 +2,7 @@
 build/
 out/
 target/
+*.javaimport
 
 # Maven invoker plugin
 **/interpolated-pom.xml

java-compiler-testing/pom.xml

@@ -48,12 +48,6 @@
       <artifactId>fuzzywuzzy</artifactId>
     </dependency>
 
-    <dependency>
-      <groupId>org.apiguardian</groupId>
-      <artifactId>apiguardian-api</artifactId>
-      <optional>true</optional>
-    </dependency>
-
     <dependency>
       <groupId>org.assertj</groupId>
       <artifactId>assertj-core</artifactId>

java-compiler-testing/src/it/dogfood/pom.xml

@@ -74,11 +74,6 @@
       <scope>test</scope>
     </dependency>
 
-    <dependency>
-      <groupId>org.apiguardian</groupId>
-      <artifactId>apiguardian-api</artifactId>
-    </dependency>
-
     <dependency>
       <groupId>org.jspecify</groupId>
       <artifactId>jspecify</artifactId>

java-compiler-testing/src/main/java/io/github/ascopes/jct/assertions/AbstractContainerGroupAssert.java

@@ -21,8 +21,6 @@
 import io.github.ascopes.jct.containers.ContainerGroup;
 import java.util.ArrayList;
 import java.util.List;
-import org.apiguardian.api.API;
-import org.apiguardian.api.API.Status;
 import org.assertj.core.api.AbstractAssert;
 import org.assertj.core.api.AbstractListAssert;
 import org.assertj.core.api.ObjectAssert;
@@ -36,7 +34,6 @@
  * @author Ashley Scopes
  * @since 0.0.1
  */
-@API(since = "0.0.1", status = Status.STABLE)
 public abstract class AbstractContainerGroupAssert<I extends AbstractContainerGroupAssert<I, C>, C extends ContainerGroup>
     extends AbstractAssert<I, C> {
 

java-compiler-testing/src/main/java/io/github/ascopes/jct/assertions/AbstractEnumAssert.java

@@ -21,8 +21,6 @@
 
 import java.util.Collection;
 import java.util.List;
-import org.apiguardian.api.API;
-import org.apiguardian.api.API.Status;
 import org.assertj.core.api.AbstractAssert;
 import org.jspecify.annotations.Nullable;
 
@@ -34,7 +32,6 @@
  * @author Ashley Scopes
  * @since 0.0.1
  */
-@API(since = "0.0.1", status = Status.STABLE)
 public abstract class AbstractEnumAssert<A extends AbstractEnumAssert<A, E>, E extends Enum<E>>
     extends AbstractAssert<A, E> {
 

java-compiler-testing/src/main/java/io/github/ascopes/jct/assertions/AbstractJavaFileObjectAssert.java

@@ -27,8 +27,6 @@
 import java.nio.charset.StandardCharsets;
 import java.time.Instant;
 import javax.tools.JavaFileObject;
-import org.apiguardian.api.API;
-import org.apiguardian.api.API.Status;
 import org.assertj.core.api.AbstractAssert;
 import org.assertj.core.api.AbstractByteArrayAssert;
 import org.assertj.core.api.AbstractInstantAssert;
@@ -44,7 +42,6 @@
  * @author Ashley Scopes
  * @since 0.0.1
  */
-@API(since = "0.0.1", status = Status.STABLE)
 public abstract class AbstractJavaFileObjectAssert<I extends AbstractJavaFileObjectAssert<I, A>, A extends JavaFileObject>
     extends AbstractAssert<I, A> {
 

java-compiler-testing/src/main/java/io/github/ascopes/jct/assertions/ClassLoaderAssert.java

@@ -15,8 +15,6 @@
  */
 package io.github.ascopes.jct.assertions;
 
-import org.apiguardian.api.API;
-import org.apiguardian.api.API.Status;
 import org.assertj.core.api.AbstractAssert;
 import org.jspecify.annotations.Nullable;
 
@@ -29,7 +27,6 @@
  * @author Ashley Scopes
  * @since 0.0.1
  */
-@API(since = "0.0.1", status = Status.STABLE)
 public final class ClassLoaderAssert extends AbstractAssert<ClassLoaderAssert, ClassLoader> {
 
   /**

java-compiler-testing/src/main/java/io/github/ascopes/jct/assertions/DiagnosticKindAssert.java

@@ -18,8 +18,6 @@
 import java.util.EnumSet;
 import java.util.Set;
 import javax.tools.Diagnostic.Kind;
-import org.apiguardian.api.API;
-import org.apiguardian.api.API.Status;
 import org.jspecify.annotations.Nullable;
 
 /**
@@ -28,7 +26,6 @@
  * @author Ashley Scopes
  * @since 0.0.1
  */
-@API(since = "0.0.1", status = Status.STABLE)
 public final class DiagnosticKindAssert
     extends AbstractEnumAssert<DiagnosticKindAssert, Kind> {
 

java-compiler-testing/src/main/java/io/github/ascopes/jct/assertions/JavaFileObjectAssert.java

@@ -16,8 +16,6 @@
 package io.github.ascopes.jct.assertions;
 
 import javax.tools.JavaFileObject;
-import org.apiguardian.api.API;
-import org.apiguardian.api.API.Status;
 import org.jspecify.annotations.Nullable;
 
 /**
@@ -26,7 +24,6 @@
  * @author Ashley Scopes
  * @since 0.0.1
  */
-@API(since = "0.0.1", status = Status.STABLE)
 public final class JavaFileObjectAssert
     extends AbstractJavaFileObjectAssert<JavaFileObjectAssert, JavaFileObject> {
 

java-compiler-testing/src/main/java/io/github/ascopes/jct/assertions/JavaFileObjectKindAssert.java

@@ -18,8 +18,6 @@
 import static org.assertj.core.api.Assertions.assertThat;
 
 import javax.tools.JavaFileObject.Kind;
-import org.apiguardian.api.API;
-import org.apiguardian.api.API.Status;
 import org.assertj.core.api.AbstractStringAssert;
 import org.jspecify.annotations.Nullable;
 
@@ -29,7 +27,6 @@
  * @author Ashley Scopes
  * @since 0.0.1
  */
-@API(since = "0.0.1", status = Status.STABLE)
 public final class JavaFileObjectKindAssert
     extends AbstractEnumAssert<JavaFileObjectKindAssert, Kind> {
 

java-compiler-testing/src/main/java/io/github/ascopes/jct/assertions/JctAssertions.java

@@ -26,8 +26,6 @@
 import javax.tools.Diagnostic;
 import javax.tools.JavaFileManager.Location;
 import javax.tools.JavaFileObject;
-import org.apiguardian.api.API;
-import org.apiguardian.api.API.Status;
 import org.jspecify.annotations.Nullable;
 
 /**
@@ -36,7 +34,6 @@
  * @author Ashley Scopes
  * @since 0.0.1
  */
-@API(since = "0.0.1", status = Status.STABLE)
 @SuppressWarnings("unused")
 public final class JctAssertions extends UtilityClass {
 

java-compiler-testing/src/main/java/io/github/ascopes/jct/assertions/JctCompilationAssert.java

@@ -25,8 +25,6 @@
 import javax.tools.Diagnostic.Kind;
 import javax.tools.JavaFileManager.Location;
 import javax.tools.StandardLocation;
-import org.apiguardian.api.API;
-import org.apiguardian.api.API.Status;
 import org.assertj.core.api.AbstractAssert;
 import org.assertj.core.api.StringAssert;
 import org.jspecify.annotations.Nullable;
@@ -37,7 +35,6 @@
  * @author Ashley Scopes
  * @since 0.0.1
  */
-@API(since = "0.0.1", status = Status.STABLE)
 public final class JctCompilationAssert
     extends AbstractAssert<JctCompilationAssert, JctCompilation> {
 
@@ -249,8 +246,8 @@ public OutputContainerGroupAssert outputGroup(Location location) {
    *
    * @return the assertions to perform on the class package outputs.
    * @throws AssertionError if the compilation was null, or no group for the location was found.
+   * @since 0.6.4
    */
-  @API(since = "0.6.4", status = Status.STABLE)
   public PackageContainerGroupAssert classOutputPackages() {
     return outputGroup(StandardLocation.CLASS_OUTPUT).packages();
   }
@@ -262,8 +259,8 @@ public PackageContainerGroupAssert classOutputPackages() {
    *
    * @return the assertions to perform on the class module outputs.
    * @throws AssertionError if the compilation was null, or no group for the location was found.
+   * @since 0.6.4
    */
-  @API(since = "0.6.4", status = Status.STABLE)
   public ModuleContainerGroupAssert classOutputModules() {
     return outputGroup(StandardLocation.CLASS_OUTPUT).modules();
   }
@@ -275,8 +272,8 @@ public ModuleContainerGroupAssert classOutputModules() {
    *
    * @return the assertions to perform on the source package outputs.
    * @throws AssertionError if the compilation was null, or no group for the location was found.
+   * @since 0.6.4
    */
-  @API(since = "0.6.4", status = Status.STABLE)
   public PackageContainerGroupAssert sourceOutputPackages() {
     return outputGroup(StandardLocation.SOURCE_OUTPUT).packages();
   }
@@ -288,8 +285,8 @@ public PackageContainerGroupAssert sourceOutputPackages() {
    *
    * @return the assertions to perform on the source module outputs.
    * @throws AssertionError if the compilation was null, or no group for the location was found.
+   * @since 0.6.4
    */
-  @API(since = "0.6.4", status = Status.STABLE)
   public ModuleContainerGroupAssert sourceOutputModules() {
     return outputGroup(StandardLocation.SOURCE_OUTPUT).modules();
   }
@@ -301,8 +298,8 @@ public ModuleContainerGroupAssert sourceOutputModules() {
    *
    * @return the assertions to perform on the class path.
    * @throws AssertionError if the compilation was null, or no group for the location was found.
+   * @since 0.6.4
    */
-  @API(since = "0.6.4", status = Status.STABLE)
   public PackageContainerGroupAssert classPathPackages() {
     return packageGroup(StandardLocation.CLASS_PATH);
   }
@@ -314,8 +311,8 @@ public PackageContainerGroupAssert classPathPackages() {
    *
    * @return the assertions to perform on the source path.
    * @throws AssertionError if the compilation was null, or no group for the location was found.
+   * @since 0.6.4
    */
-  @API(since = "0.6.4", status = Status.STABLE)
   public PackageContainerGroupAssert sourcePathPackages() {
     return packageGroup(StandardLocation.SOURCE_PATH);
   }
@@ -327,8 +324,8 @@ public PackageContainerGroupAssert sourcePathPackages() {
    *
    * @return the assertions to perform on the source path.
    * @throws AssertionError if the compilation was null, or no group for the location was found.
+   * @since 0.6.4
    */
-  @API(since = "0.6.4", status = Status.STABLE)
   public ModuleContainerGroupAssert moduleSourcePathModules() {
     return moduleGroup(StandardLocation.MODULE_SOURCE_PATH);
   }
@@ -340,8 +337,8 @@ public ModuleContainerGroupAssert moduleSourcePathModules() {
    *
    * @return the assertions to perform on the module path.
    * @throws AssertionError if the compilation was null, or no group for the location was found.
+   * @since 0.6.4
    */
-  @API(since = "0.6.4", status = Status.STABLE)
   public ModuleContainerGroupAssert modulePathModules() {
     return moduleGroup(StandardLocation.MODULE_PATH);
   }

java-compiler-testing/src/main/java/io/github/ascopes/jct/assertions/LocationAssert.java

@@ -19,8 +19,6 @@
 
 import io.github.ascopes.jct.repr.LocationRepresentation;
 import javax.tools.JavaFileManager.Location;
-import org.apiguardian.api.API;
-import org.apiguardian.api.API.Status;
 import org.assertj.core.api.AbstractAssert;
 import org.assertj.core.api.AbstractStringAssert;
 import org.jspecify.annotations.Nullable;
@@ -31,7 +29,6 @@
  * @author Ashley Scopes
  * @since 0.0.1
  */
-@API(since = "0.0.1", status = Status.STABLE)
 public final class LocationAssert extends AbstractAssert<LocationAssert, Location> {
 
   /**

java-compiler-testing/src/main/java/io/github/ascopes/jct/assertions/ModuleContainerGroupAssert.java

@@ -20,8 +20,6 @@
 import io.github.ascopes.jct.containers.ModuleContainerGroup;
 import io.github.ascopes.jct.filemanagers.ModuleLocation;
 import io.github.ascopes.jct.utils.StringUtils;
-import org.apiguardian.api.API;
-import org.apiguardian.api.API.Status;
 import org.jspecify.annotations.Nullable;
 
 /**
@@ -30,7 +28,6 @@
  * @author Ashley Scopes
  * @since 0.0.1
  */
-@API(since = "0.0.1", status = Status.STABLE)
 public final class ModuleContainerGroupAssert
     extends AbstractContainerGroupAssert<ModuleContainerGroupAssert, ModuleContainerGroup> {
 

java-compiler-testing/src/main/java/io/github/ascopes/jct/assertions/OutputContainerGroupAssert.java

@@ -16,8 +16,6 @@
 package io.github.ascopes.jct.assertions;
 
 import io.github.ascopes.jct.containers.OutputContainerGroup;
-import org.apiguardian.api.API;
-import org.apiguardian.api.API.Status;
 import org.jspecify.annotations.Nullable;
 
 /**
@@ -26,7 +24,6 @@
  * @author Ashley Scopes
  * @since 0.0.1
  */
-@API(since = "0.0.1", status = Status.STABLE)
 public final class OutputContainerGroupAssert
     extends AbstractContainerGroupAssert<OutputContainerGroupAssert, OutputContainerGroup> {
 

java-compiler-testing/src/main/java/io/github/ascopes/jct/assertions/PackageContainerGroupAssert.java

@@ -34,8 +34,6 @@
 import java.util.Set;
 import java.util.stream.Collectors;
 import java.util.stream.StreamSupport;
-import org.apiguardian.api.API;
-import org.apiguardian.api.API.Status;
 import org.assertj.core.api.AbstractPathAssert;
 import org.assertj.core.description.TextDescription;
 import org.assertj.core.error.MultipleAssertionsError;
@@ -47,7 +45,6 @@
  * @author Ashley Scopes
  * @since 0.0.1
  */
-@API(since = "0.0.1", status = Status.STABLE)
 public final class PackageContainerGroupAssert
     extends AbstractContainerGroupAssert<PackageContainerGroupAssert, PackageContainerGroup> {
 
@@ -185,7 +182,6 @@ public PackageContainerGroupAssert fileDoesNotExist(String... fragments) {
    * @throws NullPointerException     if any of the fragments are null.
    * @throws IllegalArgumentException if no fragments are provided.
    */
-
   public AbstractPathAssert<?> fileExists(String... fragments) {
     requireNonNullValues(fragments, "fragments");
     requireAtLeastOne(fragments, "fragments");

java-compiler-testing/src/main/java/io/github/ascopes/jct/assertions/PathFileObjectAssert.java

@@ -18,8 +18,6 @@
 import static org.assertj.core.api.Assertions.assertThat;
 
 import io.github.ascopes.jct.filemanagers.PathFileObject;
-import org.apiguardian.api.API;
-import org.apiguardian.api.API.Status;
 import org.assertj.core.api.AbstractPathAssert;
 import org.jspecify.annotations.Nullable;
 
@@ -29,7 +27,6 @@
  * @author Ashley Scopes
  * @since 0.0.1
  */
-@API(since = "0.0.1", status = Status.STABLE)
 public final class PathFileObjectAssert
     extends AbstractJavaFileObjectAssert<PathFileObjectAssert, PathFileObject> {
 

java-compiler-testing/src/main/java/io/github/ascopes/jct/assertions/StackTraceAssert.java

@@ -18,8 +18,6 @@
 import io.github.ascopes.jct.repr.StackTraceRepresentation;
 import java.util.ArrayList;
 import java.util.List;
-import org.apiguardian.api.API;
-import org.apiguardian.api.API.Status;
 import org.assertj.core.api.AbstractListAssert;
 import org.jspecify.annotations.Nullable;
 
@@ -32,7 +30,6 @@
  * @author Ashley Scopes
  * @since 0.0.1
  */
-@API(since = "0.0.1", status = Status.STABLE)
 public final class StackTraceAssert
     extends AbstractListAssert<StackTraceAssert, List<? extends StackTraceElement>, StackTraceElement, StackTraceElementAssert> {
 
@@ -61,3 +58,4 @@ protected StackTraceAssert newAbstractIterableAssert(
     return new StackTraceAssert(list);
   }
 }
+