Merge branch 'develop'

Tobias Stamann · Tobias Stamann · commit 990985c0f82d · 2024-01-27T00:10:34.000+01:00
diff --git a/README.md b/README.md
@@ -224,7 +224,37 @@ public void yourUnitTestWithPassedInElementAndProcessor() {
 
 }
 ```
- 
+
+### Testing generated and compiled classes
+Testing of the generated code can either be done by providing an integration test project or by using Cute as part of the compilation test.
+Unfortunately, testing generated code with Cute heavily relies on the Javas reflection api, since generated classes aren't available in your unit test code.
+But it's working flawlessly if your generated classes are implementing precompiled interfaces:
+
+````java
+@Test
+public void blackBoxTest_justCompileCodeAndDoClassTestWithImplementedInterface() {
+    Cute.blackBoxTest().given().noProcessors()
+        .andSourceFiles("/TestClassWithImplementedInterface.java")
+        .whenCompiled()
+        .thenExpectThat()
+        .compilationSucceeds()
+        .andThat()
+            .generatedClass("io.toolisticon.cute.TestClassWithImplementedInterface")
+            .testedSuccessfullyBy(new GeneratedClassesTestForSpecificClass() {
+                @Override
+                public void doTests(Class<?> clazz, CuteClassLoader cuteClassLoader) throws Exception{
+    
+                    SimpleTestInterface unit = (SimpleTestInterface) clazz.getConstructor().newInstance();
+                    MatcherAssert.assertThat(unit.saySomething(), Matchers.is("WHATS UP?"));
+    
+                }
+            })
+        .executeTest();
+}
+````
+
+Consider to prefer integration tests over Cute if no precompiled interface is implemented by the generated classes.
+
 # Projects using this toolkit library
 
 - [Annotation processor toolkit](https://github.com/toolisticon/annotation-processor-toolkit) : Toolkit that allows you to build annotation processors in a more comfortable way
diff --git a/coverage/pom.xml b/coverage/pom.xml
@@ -8,7 +8,7 @@
     <parent>
         <groupId>io.toolisticon.cute</groupId>
         <artifactId>cute-parent</artifactId>
-        <version>1.0.0_RC2</version>
+        <version>1.0.0</version>
     </parent>
 
     <name>coverage</name>
diff --git a/cute/pom.xml b/cute/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>io.toolisticon.cute</groupId>
         <artifactId>cute-parent</artifactId>
-        <version>1.0.0_RC2</version>
+        <version>1.0.0</version>
     </parent>
 
     <name>cute</name>
diff --git a/cute/src/main/java/io/toolisticon/cute/CuteApi.java b/cute/src/main/java/io/toolisticon/cute/CuteApi.java
@@ -872,7 +872,7 @@ public interface CompilerTestExpectThatInterface {
          * @param generatedClassesTest the test to execute
          * @return the next interface
          */
-        CompilerTestExpectAndThatInterface compiledClassesTestsSucceeds(@FluentApiBackingBeanMapping(value = "generatedClassesTest", action = MappingAction.ADD) GeneratedClassesTest generatedClassesTest);
+        CompilerTestExpectAndThatInterface generatedClassesTestedSuccessfullyBy(@FluentApiBackingBeanMapping(value = "generatedClassesTest", action = MappingAction.ADD) GeneratedClassesTest generatedClassesTest);
 
 
         /**
diff --git a/cute/src/test/java/io/toolisticon/cute/CuteTest.java b/cute/src/test/java/io/toolisticon/cute/CuteTest.java
@@ -1025,7 +1025,7 @@ public void blackBoxTest_justCompileCodeAndDoClassTest3() {
                 .whenCompiled()
                 .thenExpectThat()
                 .compilationSucceeds()
-                .andThat().compiledClassesTestsSucceeds(new GeneratedClassesTest() {
+                .andThat().generatedClassesTestedSuccessfullyBy(new GeneratedClassesTest() {
                     @Override
                     public void doTests(CuteClassLoader cuteClassLoader) throws Exception{
                         Class<?> clazz = cuteClassLoader.getClass("io.toolisticon.cute.TestClassWithInnerClasses");
@@ -1086,4 +1086,23 @@ public void doTests(Class<?> clazz, CuteClassLoader cuteClassLoader) throws Exce
                 .executeTest();
     }
 
+
+    @Test()
+    public void blackBoxTest_justCompileCodeAndDoClassTestWithImplementedInterfaceAndRelationsBetweenClasses() {
+        Cute.blackBoxTest().given().noProcessors()
+                .andSourceFiles("/compiletests/withmultiplerelatedsourcefiles/JustOutput.java", "/compiletests/withmultiplerelatedsourcefiles/TestClassWithImplementedInterface.java")
+                .whenCompiled()
+                .thenExpectThat()
+                .compilationSucceeds()
+                .andThat().generatedClass("io.toolisticon.cute.TestClassWithImplementedInterface").testedSuccessfullyBy(new GeneratedClassesTestForSpecificClass() {
+                    @Override
+                    public void doTests(Class<?> clazz, CuteClassLoader cuteClassLoader) throws Exception{
+
+                        SimpleTestInterface unit = (SimpleTestInterface) clazz.getConstructor().newInstance();
+                        MatcherAssert.assertThat(unit.saySomething(), Matchers.is("WHATS UP???"));
+
+                    }
+                })
+                .executeTest();
+    }
 }
diff --git a/cute/src/test/resources/compiletests/withmultiplerelatedsourcefiles/JustOutput.java b/cute/src/test/resources/compiletests/withmultiplerelatedsourcefiles/JustOutput.java
@@ -0,0 +1,8 @@
+package io.toolisticon.cute;
+
+public class JustOutput {
+
+    public static String getString() {
+        return "WHATS UP???";
+    }
+}
diff --git a/cute/src/test/resources/compiletests/withmultiplerelatedsourcefiles/TestClassWithImplementedInterface.java b/cute/src/test/resources/compiletests/withmultiplerelatedsourcefiles/TestClassWithImplementedInterface.java
@@ -0,0 +1,16 @@
+package io.toolisticon.cute;
+
+import io.toolisticon.cute.TestAnnotation;
+import io.toolisticon.cute.testcases.SimpleTestInterface;
+
+/**
+ * Test class for annotation processor tools.
+ */
+@TestAnnotation
+public class TestClassWithImplementedInterface implements SimpleTestInterface {
+
+    @Override
+    public String saySomething() {
+        return JustOutput.getString();
+    }
+}
diff --git a/extension/api/pom.xml b/extension/api/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>io.toolisticon.cute</groupId>
         <artifactId>extension-parent</artifactId>
-        <version>1.0.0_RC2</version>
+        <version>1.0.0</version>
     </parent>
 
     <name>extension-api</name>
diff --git a/extension/junit4/pom.xml b/extension/junit4/pom.xml
@@ -8,7 +8,7 @@
     <parent>
         <groupId>io.toolisticon.cute</groupId>
         <artifactId>extension-parent</artifactId>
-        <version>1.0.0_RC2</version>
+        <version>1.0.0</version>
     </parent>
 
     <name>extension-junit4</name>
diff --git a/extension/junit5/pom.xml b/extension/junit5/pom.xml
@@ -8,7 +8,7 @@
     <parent>
         <groupId>io.toolisticon.cute</groupId>
         <artifactId>extension-parent</artifactId>
-        <version>1.0.0_RC2</version>
+        <version>1.0.0</version>
     </parent>
 
     <name>extension-junit5</name>
diff --git a/extension/modulesupport/pom.xml b/extension/modulesupport/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>io.toolisticon.cute</groupId>
         <artifactId>extension-parent</artifactId>
-        <version>1.0.0_RC2</version>
+        <version>1.0.0</version>
     </parent>
 
     <name>extension-modulesupport</name>
diff --git a/extension/plainjava/pom.xml b/extension/plainjava/pom.xml
@@ -8,7 +8,7 @@
     <parent>
         <groupId>io.toolisticon.cute</groupId>
         <artifactId>extension-parent</artifactId>
-        <version>1.0.0_RC2</version>
+        <version>1.0.0</version>
     </parent>
 
     <name>extension-plainjava</name>
diff --git a/extension/pom.xml b/extension/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>io.toolisticon.cute</groupId>
         <artifactId>cute-parent</artifactId>
-        <version>1.0.0_RC2</version>
+        <version>1.0.0</version>
     </parent>
 
     <name>extension-parent</name>
diff --git a/extension/testng/pom.xml b/extension/testng/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>io.toolisticon.cute</groupId>
         <artifactId>extension-parent</artifactId>
-        <version>1.0.0_RC2</version>
+        <version>1.0.0</version>
     </parent>
 
     <name>extension-testng</name>
diff --git a/integration-test/java9/namedAutomaticModule/pom.xml b/integration-test/java9/namedAutomaticModule/pom.xml
@@ -8,7 +8,7 @@
     <parent>
         <groupId>io.toolisticon.cute</groupId>
         <artifactId>integration-test-java9-parent</artifactId>
-        <version>1.0.0_RC2</version>
+        <version>1.0.0</version>
     </parent>
 
     <name>integration-test-java9-namedAutomaticModule</name>
diff --git a/integration-test/java9/pom.xml b/integration-test/java9/pom.xml
@@ -8,7 +8,7 @@
     <parent>
         <groupId>io.toolisticon.cute</groupId>
         <artifactId>integration-test-parent</artifactId>
-        <version>1.0.0_RC2</version>
+        <version>1.0.0</version>
     </parent>
 
     <name>integration-test-java9-parent</name>
diff --git a/integration-test/java9/regularTestModule/pom.xml b/integration-test/java9/regularTestModule/pom.xml
@@ -8,7 +8,7 @@
     <parent>
         <groupId>io.toolisticon.cute</groupId>
         <artifactId>integration-test-java9-parent</artifactId>
-        <version>1.0.0_RC2</version>
+        <version>1.0.0</version>
     </parent>
 
     <name>integration-test-java9-regularModule</name>
diff --git a/integration-test/java9/test/pom.xml b/integration-test/java9/test/pom.xml
@@ -8,7 +8,7 @@
     <parent>
         <groupId>io.toolisticon.cute</groupId>
         <artifactId>integration-test-java9-parent</artifactId>
-        <version>1.0.0_RC2</version>
+        <version>1.0.0</version>
     </parent>
 
     <name>integration-test-java9-test</name>
diff --git a/integration-test/java9/unnamedAutomaticModule/pom.xml b/integration-test/java9/unnamedAutomaticModule/pom.xml
@@ -8,7 +8,7 @@
     <parent>
         <groupId>io.toolisticon.cute</groupId>
         <artifactId>integration-test-java9-parent</artifactId>
-        <version>1.0.0_RC2</version>
+        <version>1.0.0</version>
     </parent>
 
     <name>integration-test-java9-unnamedAutomaticModule</name>
diff --git a/integration-test/junit4/pom.xml b/integration-test/junit4/pom.xml
@@ -8,7 +8,7 @@
     <parent>
         <groupId>io.toolisticon.cute</groupId>
         <artifactId>integration-test-parent</artifactId>
-        <version>1.0.0_RC2</version>
+        <version>1.0.0</version>
     </parent>
 
     <name>integration-test-junit4</name>
diff --git a/integration-test/junit5/pom.xml b/integration-test/junit5/pom.xml
@@ -8,7 +8,7 @@
     <parent>
         <groupId>io.toolisticon.cute</groupId>
         <artifactId>integration-test-parent</artifactId>
-        <version>1.0.0_RC2</version>
+        <version>1.0.0</version>
     </parent>
 
     <name>integration-test-junit5</name>
diff --git a/integration-test/pom.xml b/integration-test/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>io.toolisticon.cute</groupId>
         <artifactId>cute-parent</artifactId>
-        <version>1.0.0_RC2</version>
+        <version>1.0.0</version>
     </parent>
 
     <name>integration-test-parent</name>
diff --git a/integration-test/testng/pom.xml b/integration-test/testng/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>io.toolisticon.cute</groupId>
         <artifactId>integration-test-parent</artifactId>
-        <version>1.0.0_RC2</version>
+        <version>1.0.0</version>
     </parent>
 
     <name>integration-test-testng</name>
diff --git a/legacy/pom.xml b/legacy/pom.xml
@@ -8,7 +8,7 @@
     <parent>
         <groupId>io.toolisticon.cute</groupId>
         <artifactId>cute-parent</artifactId>
-        <version>1.0.0_RC2</version>
+        <version>1.0.0</version>
     </parent>
 
     <name>cute-legacy</name>
diff --git a/pom.xml b/pom.xml
@@ -4,7 +4,7 @@
 
     <groupId>io.toolisticon.cute</groupId>
     <artifactId>cute-parent</artifactId>
-    <version>1.0.0_RC2</version>
+    <version>1.0.0</version>
     <packaging>pom</packaging>
 
     <name>cute-parent</name>
