Deprecate org.assertj.core.annotations.Beta in favor of org.assertj.core.annotation.Beta

Author: scordio

assertj-core/src/main/java/org/assertj/core/annotation/Beta.java

@@ -0,0 +1,44 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
+ * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations under the License.
+ *
+ * Copyright 2012-2025 the original author or authors.
+ */
+package org.assertj.core.annotation;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * Signifies that a public API (public class, method or field) is subject to incompatible changes,
+ * or even removal, in a future release. An API bearing this annotation is exempt from any
+ * compatibility guarantees made by its containing library. Note that the presence of this
+ * annotation implies nothing about the quality or performance of the API in question, only the fact
+ * that it is not "API-frozen."
+ * <p>
+ * It is generally safe for <i>applications</i> to depend on beta APIs, at the cost of some extra
+ * work during upgrades. However it is generally inadvisable for <i>libraries</i> (which get
+ * included on users' CLASSPATHs, outside the library developers' control) to do so.
+ * <p>
+ * Idea borrowed from Guava.
+ *
+ * @since 3.27.4
+ */
+@Retention(RetentionPolicy.CLASS)
+@Target({
+    ElementType.ANNOTATION_TYPE,
+    ElementType.CONSTRUCTOR,
+    ElementType.FIELD,
+    ElementType.METHOD,
+    ElementType.TYPE
+})
+public @interface Beta {
+}

assertj-core/src/main/java/org/assertj/core/annotations/Beta.java

@@ -29,6 +29,8 @@
  * included on users' CLASSPATHs, outside the library developers' control) to do so.
  * <p>
  * Idea borrowed from Guava.
+ *
+ * @deprecated use {@link org.assertj.core.annotation.Beta} instead.
  */
 @Retention(RetentionPolicy.CLASS)
 @Target({
@@ -38,5 +40,6 @@
     ElementType.METHOD,
     ElementType.TYPE
 })
+@Deprecated
 public @interface Beta {
 }

assertj-core/src/main/java/org/assertj/core/api/AbstractCollectionAssert.java

@@ -21,7 +21,7 @@
 import java.util.NavigableSet;
 import java.util.Set;
 
-import org.assertj.core.annotations.Beta;
+import org.assertj.core.annotation.Beta;
 
 /**
  * Base class for all implementations of assertions for {@link Collection}s.

assertj-core/src/main/java/org/assertj/core/api/AbstractIterableAssert.java

@@ -49,7 +49,7 @@
 import java.util.function.Predicate;
 import java.util.stream.Stream;
 
-import org.assertj.core.annotations.Beta;
+import org.assertj.core.annotation.Beta;
 import org.assertj.core.api.filter.FilterOperator;
 import org.assertj.core.api.filter.Filters;
 import org.assertj.core.api.iterable.ThrowingExtractor;

assertj-core/src/main/java/org/assertj/core/api/AbstractIteratorAssert.java

@@ -16,7 +16,7 @@
 
 import java.util.Iterator;
 
-import org.assertj.core.annotations.Beta;
+import org.assertj.core.annotation.Beta;
 import org.assertj.core.internal.Iterators;
 import org.assertj.core.util.VisibleForTesting;
 

assertj-core/src/main/java/org/assertj/core/api/AbstractMapAssert.java

@@ -40,7 +40,7 @@
 import java.util.function.Function;
 import java.util.stream.Stream;
 
-import org.assertj.core.annotations.Beta;
+import org.assertj.core.annotation.Beta;
 import org.assertj.core.api.recursive.assertion.RecursiveAssertionConfiguration;
 import org.assertj.core.api.recursive.comparison.RecursiveComparisonConfiguration;
 import org.assertj.core.description.Description;

assertj-core/src/main/java/org/assertj/core/api/AbstractObjectArrayAssert.java

@@ -45,7 +45,7 @@
 import java.util.function.Predicate;
 import java.util.stream.Stream;
 
-import org.assertj.core.annotations.Beta;
+import org.assertj.core.annotation.Beta;
 import org.assertj.core.api.filter.FilterOperator;
 import org.assertj.core.api.filter.Filters;
 import org.assertj.core.api.iterable.ThrowingExtractor;

assertj-core/src/main/java/org/assertj/core/api/AbstractOptionalAssert.java

@@ -25,7 +25,7 @@
 import java.util.function.Consumer;
 import java.util.function.Function;
 
-import org.assertj.core.annotations.Beta;
+import org.assertj.core.annotation.Beta;
 import org.assertj.core.api.recursive.assertion.RecursiveAssertionConfiguration;
 import org.assertj.core.api.recursive.comparison.RecursiveComparisonConfiguration;
 import org.assertj.core.internal.ComparatorBasedComparisonStrategy;

assertj-core/src/main/java/org/assertj/core/api/RecursiveAssertionAssert.java

@@ -18,7 +18,7 @@
 import java.util.Objects;
 import java.util.function.Predicate;
 
-import org.assertj.core.annotations.Beta;
+import org.assertj.core.annotation.Beta;
 import org.assertj.core.api.recursive.assertion.DefaultRecursiveAssertionIntrospectionStrategy;
 import org.assertj.core.api.recursive.assertion.RecursiveAssertionConfiguration;
 import org.assertj.core.api.recursive.assertion.RecursiveAssertionDriver;

assertj-core/src/main/java/org/assertj/core/api/junit/jupiter/SoftAssertionsExtension.java

@@ -28,7 +28,7 @@
 import java.util.Optional;
 import java.util.concurrent.ConcurrentLinkedQueue;
 
-import org.assertj.core.annotations.Beta;
+import org.assertj.core.annotation.Beta;
 import org.assertj.core.api.AbstractSoftAssertions;
 import org.assertj.core.api.AssertionErrorCollector;
 import org.assertj.core.api.BDDSoftAssertions;