Merge pull request #31383 from scrocquesel/gh-31359

Add support for repeatable annotation-based test resources

docs/src/main/asciidoc/getting-started-testing.adoc

@@ -1187,6 +1187,30 @@ public class KubernetesServerTestResource
 }
 ----
 
+If you want to make the annotation repeatable, the containing annotation type must be annotated with `@QuarkusTestResourceRepeatable`.
+For example, this would define a repeatable `@WithRepeatableTestResource` annotation.
+
+[source,java]
+----
+@QuarkusTestResource(KubernetesServerTestResource.class)
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.TYPE)
+@Repeatable(WithRepeatableTestResource.List.class)
+public @interface WithRepeatableTestResource {
+
+    String key() default "";
+
+    @Target(ElementType.TYPE)
+    @Retention(RetentionPolicy.RUNTIME)
+    @QuarkusTestResourceRepeatable(WithRepeatableTestResource.class)
+    @interface List {
+        WithRepeatableTestResource[] value();
+    }
+}
+----
+
+
+
 == Hang Detection
 
 `@QuarkusTest` has support for hang detection to help diagnose any unexpected hangs. If no progress is made for a specified

test-framework/common/src/main/java/io/quarkus/test/common/QuarkusTestResourceRepeatable.java

@@ -0,0 +1,24 @@
+package io.quarkus.test.common;
+
+import java.lang.annotation.Annotation;
+import java.lang.annotation.Documented;
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * Used to indicate the type of the <em>repeatable annotation
+ * type</em> annotated with a {@code QuarkusTestResource} annotations.
+ *
+ */
+@Target(ElementType.ANNOTATION_TYPE)
+@Retention(RetentionPolicy.RUNTIME)
+@Documented
+public @interface QuarkusTestResourceRepeatable {
+
+    /**
+     * @return The class annotated with a {@code QuarkusTestResource} annotations.
+     */
+    Class<? extends Annotation> value();
+}

test-framework/common/src/main/java/io/quarkus/test/common/TestResourceManager.java

@@ -335,6 +335,17 @@ private void collectMetaAnnotations(Class<?> testClassFromTCCL, Function<Class<?
                         }
                         hasPerTestResources = true;
                         break;
+                    } else if (ann.annotationType() == QuarkusTestResourceRepeatable.class) {
+                        for (Annotation repeatableMetaAnn : testClassFromTCCL
+                                .getAnnotationsByType(((QuarkusTestResourceRepeatable) ann).value())) {
+                            QuarkusTestResource quarkusTestResource = repeatableMetaAnn.annotationType()
+                                    .getAnnotation(QuarkusTestResource.class);
+                            if (quarkusTestResource != null) {
+                                addTestResourceEntry(quarkusTestResource, repeatableMetaAnn, uniqueEntries);
+                                hasPerTestResources = true;
+                            }
+
+                        }
                     }
                 }
             }

test-framework/common/src/test/java/io/quarkus/test/common/TestResourceManagerTest.java

@@ -2,6 +2,11 @@
 
 import static org.assertj.core.api.Assertions.assertThat;
 
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Repeatable;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
 import java.util.Collections;
 import java.util.HashMap;
 import java.util.Map;
@@ -177,4 +182,55 @@ public int order() {
             return 2;
         }
     }
+
+    @Test
+    void testAnnotationBased() {
+        TestResourceManager manager = new TestResourceManager(RepeatableAnnotationBasedTestResourcesTest.class);
+        manager.init("test");
+        Map<String, String> props = manager.start();
+        Assertions.assertEquals("value", props.get("annotationkey1"));
+        Assertions.assertEquals("value", props.get("annotationkey2"));
+    }
+
+    public static class AnnotationBasedQuarkusTestResource
+            implements QuarkusTestResourceConfigurableLifecycleManager<WithAnnotationBasedTestResource> {
+
+        private String key;
+
+        @Override
+        public void init(WithAnnotationBasedTestResource annotation) {
+            this.key = annotation.key();
+        }
+
+        @Override
+        public Map<String, String> start() {
+            Map<String, String> props = new HashMap<>();
+            props.put(key, "value");
+            return props;
+        }
+
+        @Override
+        public void stop() {
+        }
+    }
+
+    @QuarkusTestResource(AnnotationBasedQuarkusTestResource.class)
+    @Retention(RetentionPolicy.RUNTIME)
+    @Target(ElementType.TYPE)
+    @Repeatable(WithAnnotationBasedTestResource.List.class)
+    public @interface WithAnnotationBasedTestResource {
+        String key() default "";
+
+        @Target(ElementType.TYPE)
+        @Retention(RetentionPolicy.RUNTIME)
+        @QuarkusTestResourceRepeatable(WithAnnotationBasedTestResource.class)
+        @interface List {
+            WithAnnotationBasedTestResource[] value();
+        }
+    }
+
+    @WithAnnotationBasedTestResource(key = "annotationkey1")
+    @WithAnnotationBasedTestResource(key = "annotationkey2")
+    public static class RepeatableAnnotationBasedTestResourcesTest {
+    }
 }