Use maven embedder

README.adoc

@@ -30,6 +30,56 @@ ____
 compile 'org.springframework.rewrite:spring-rewrite-commons-launcher:{projectVersion}'
 ----
 
+=== Select Parser
+Currently, different ways to parse projects and execute recipes exist.
+They all fulfill specific needs or fill gaps of other implementations.
+
+==== `RewriteProjectParser`
+WARNING: This implementation is affected by <ADD ISSUE HERE>.
+
+Use MavenCli to parse a Maven project and a customized parser to create the OpenRewrite LST.
+This implementation allows for customizations and provides access to OpenRewrite LST.
+
+==== `OpenRewriteProjectParser`
+WARNING: This implementation is affected by <ADD ISSUE HERE> and <ADD ISSUE HERE>.
+
+Use MavenCli to parse Maven projects and instantiate OpenRewrite's `MAvenMojoProjectParser`.
+The parser provides access to OpenRewrite's LST.
+This implementation uses as much code as possible from OpenRewrite and Maven being the closest to the execution of OpenRewrite recipes inside OR's Maven plugin.
+
+==== `OpenRewriteRecipeLauncher`
+Use Maven Invoker to run OpenRewrite recipes in a separate process like from command line but started from inside a Java application.
+It
+
+
+[plantuml,"models",svg]
+.....
+
+class OpenRewritePluginLauncher
+
+class RewriteProjectParser
+
+class FlexRewriteProjectParser
+
+class ProjectResourceSet
+
+component srcMaven as "src-maven" {
+    component srcMavenInvoker as "src-maven-invoker" {
+    }
+    component srcMavenEmbedder as "src-maven-embedder" {
+    }
+}
+
+component srcGradle as "src-gradle" {
+    component srcGradleModel as "src-gradle-model" {
+    }
+    component srcGradleParser as "src-gradle-parser" {
+    }
+    component srcGradlePlugin as "src-gradle-plugin" {
+    }
+}
+}
+.....
 
 === Implement a Recipe Launcher
 

pom.xml

@@ -18,6 +18,9 @@
         <module>spring-rewrite-commons-starters</module>
         <module>spring-rewrite-commons-gradle</module>
         <module>spring-rewrite-commons-plugin-invoker</module>
+        <module>spring-rewrite-commons-test</module>
+        <module>spring-rewrite-commons-utils</module>
+        <module>spring-rewrite-commons-maven-embedder</module>
     </modules>
 
     <organization>
@@ -33,19 +36,20 @@
         <!-- prod dependencies -->
         <spring-boot.version>3.2.1</spring-boot.version>
         <rewrite.version>8.13.4</rewrite.version>
-        <rewrite-kotlin.version>1.8.4</rewrite-kotlin.version>
-        <rewrite-polyglot.version>1.8.11</rewrite-polyglot.version>
+        <rewrite-kotlin.version>1.10.0</rewrite-kotlin.version>
+        <rewrite-polyglot.version>1.9.2</rewrite-polyglot.version>
         <rewrite-maven-plugin.version>5.20.0</rewrite-maven-plugin.version>
         <jaxb-api.version>2.3.1</jaxb-api.version>
         <gradle-tooling-api.version>8.4</gradle-tooling-api.version>
-        <maven.version>3.9.1</maven.version>
+        <maven.version>3.9.6</maven.version>
         <maven-invoker.version>3.2.0</maven-invoker.version>
         <maven-shared-utils.version>3.4.2</maven-shared-utils.version>
 
         <!-- testing dependencies -->
-        <maven-resolver.version>1.9.13</maven-resolver.version>
+        <maven-resolver.version>1.9.18</maven-resolver.version>
+        <maven-embedder.version>3.9.6</maven-embedder.version>
         <maven-wagon-http.version>3.5.3</maven-wagon-http.version>
-        <plexus-cypher.version>1.8</plexus-cypher.version>
+        <plexus-cypher.version>2.0</plexus-cypher.version>
         <junit-pioneer.version>2.1.0</junit-pioneer.version>
 
         <!-- documentation dependencies -->
@@ -129,9 +133,75 @@
                 <artifactId>rewrite-core</artifactId>
                 <version>${rewrite.version}</version>
             </dependency>
+            <dependency>
+                <groupId>org.springframework.rewrite</groupId>
+                <artifactId>spring-rewrite-commons-test</artifactId>
+                <version>${project.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>org.apache.maven</groupId>
+                <artifactId>maven-embedder</artifactId>
+                <version>${maven-embedder.version}</version> <!-- Use the latest version available -->
+                <exclusions>
+                    <exclusion>
+                        <groupId>org.codehaus.plexus</groupId>
+                        <artifactId>plexus-component-annotations</artifactId>
+                    </exclusion>
+                    <!-- org.apache.maven:maven-embedder:jar:3.9.6 brings maven-shared-utils:3.3.4 while 3.4.2 is right -->
+                    <exclusion>
+                        <groupId>org.apache.maven.shared</groupId>
+                        <artifactId>maven-shared-utils</artifactId>
+                    </exclusion>
+                    <exclusion>
+                        <groupId>org.sonatype.plexus</groupId>
+                        <artifactId>plexus-cipher</artifactId>
+                    </exclusion>
+                </exclusions>
+            </dependency>
+            <dependency>
+                <groupId>org.apache.maven.shared</groupId>
+                <artifactId>maven-invoker</artifactId>
+                <version>${maven-invoker.version}</version>
+                <exclusions>
+                    <exclusion>
+                        <groupId>org.apache.maven.shared</groupId>
+                        <artifactId>maven-shared-utils</artifactId>
+                    </exclusion>
+                </exclusions>
+            </dependency>
+            <dependency>
+                <groupId>org.apache.maven</groupId>
+                <artifactId>maven-core</artifactId>
+                <version>${maven.version}</version>
+                <exclusions>
+<!--
+[ERROR] Dependency convergence error for org.apache.maven.shared:maven-shared-utils:jar:3.4.2 paths to dependency are:
+[ERROR] +-org.springframework.rewrite:spring-rewrite-commons-plugin-invoker-maven:jar:0.1.0-SNAPSHOT
+[ERROR]   +-org.apache.maven.shared:maven-shared-utils:jar:3.4.2:compile
+[ERROR] and
+[ERROR] +-org.springframework.rewrite:spring-rewrite-commons-plugin-invoker-maven:jar:0.1.0-SNAPSHOT
+[ERROR]   +-org.apache.maven:maven-compat:jar:3.9.6:compile
+[ERROR]     +-org.apache.maven:maven-core:jar:3.9.6:compile
+[ERROR]       +-org.apache.maven.shared:maven-shared-utils:jar:3.3.4:compile
+-->
+                    <exclusion>
+                        <groupId>org.apache.maven.shared</groupId>
+                        <artifactId>maven-shared-utils</artifactId>
+                    </exclusion>
+                </exclusions>
+            </dependency>
         </dependencies>
     </dependencyManagement>
 
+    <dependencies>
+        <dependency>
+            <groupId>org.openrewrite</groupId>
+            <artifactId>rewrite-bom</artifactId>
+            <version>${rewrite.version}</version>
+            <type>pom</type>
+        </dependency>
+    </dependencies>
+
     <build>
         <pluginManagement>
             <plugins>
@@ -239,6 +309,7 @@ limitations under the License.
                                 <!-- @formatter:on -->
                             </inlineHeader>
                             <excludes>
+                                <exclude>**/CLIReportingUtils.java</exclude>
                                 <exclude>**/internal/**</exclude>
                                 <exclude>**/demo/**</exclude>
                                 <exclude>**/.sdkmanrc</exclude>
@@ -272,6 +343,66 @@ limitations under the License.
                     </licenseSets>
                 </configuration>
             </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-enforcer-plugin</artifactId>
+                <version>3.3.0</version>
+                <executions>
+                    <execution>
+                        <id>enforce</id>
+                        <goals>
+                            <goal>enforce</goal>
+                        </goals>
+                        <configuration>
+                            <rules>
+                                <dependencyConvergence>
+                                    <excludes>
+                                        <exclude>org.jetbrains:annotations</exclude>
+                                        <exclude>org.ow2.asm:asm</exclude> <!-- through org.openrewrite.maven:rewrite-maven-plugin:jar:5.20.0:compile -->
+                                        <!--
+                                        [ERROR] +-org.springframework.rewrite:spring-rewrite-commons-maven-embedder:jar:0.1.0-SNAPSHOT
+                                        [ERROR]   +-org.apache.maven:maven-embedder:jar:3.9.3:compile
+                                        [ERROR]     +-javax.annotation:javax.annotation-api:jar:1.3.2:compile
+                                        [ERROR] and
+                                        [ERROR] +-org.springframework.rewrite:spring-rewrite-commons-maven-embedder:jar:0.1.0-SNAPSHOT
+                                        [ERROR]   +-org.apache.maven:maven-embedder:jar:3.9.3:compile
+                                        [ERROR]     +-org.eclipse.sisu:org.eclipse.sisu.plexus:jar:0.3.5:compile
+                                        [ERROR]       +-javax.annotation:javax.annotation-api:jar:1.2:compile
+                                        -->
+                                        <exclude>javax.annotation:javax.annotation-api</exclude>
+                                        <!--
+
+                                        -->
+                                        <exclude>org.codehaus.plexus:plexus-utils</exclude>
+                                        <exclude>org.codehaus.plexus:plexus-classworlds</exclude>
+                                        <exclude>com.google.guava:guava</exclude> <!-- from org.apache.maven:maven-embedder -->
+                                        <exclude>org.xerial.snappy:snappy-java</exclude> <!-- from org.openrewrite.maven:rewrite-maven-plugin -->
+                                        <exclude>org.ow2.asm:asm-util</exclude> <!-- from org.openrewrite:rewrite-java -->
+                                        <!--
+                                        [ERROR] Dependency convergence error for commons-io:commons-io:jar:2.11.0 paths to dependency are:
+                                        [ERROR] +-org.springframework.rewrite:spring-rewrite-commons-starter-boot-upgrade:jar:0.1.0-SNAPSHOT
+                                        [ERROR]   +-org.springframework.rewrite:spring-rewrite-commons-launcher:jar:0.1.0-SNAPSHOT:compile
+                                        [ERROR]     +-org.springframework.rewrite:spring-rewrite-commons-test:jar:0.1.0-SNAPSHOT:compile
+                                        [ERROR]       +-commons-io:commons-io:jar:2.11.0:compile
+                                        [ERROR] and
+                                        [ERROR] +-org.springframework.rewrite:spring-rewrite-commons-starter-boot-upgrade:jar:0.1.0-SNAPSHOT
+                                        [ERROR]   +-org.springframework.rewrite:spring-rewrite-commons-launcher:jar:0.1.0-SNAPSHOT:compile
+                                        [ERROR]     +-org.openrewrite.maven:rewrite-maven-plugin:jar:5.20.0:compile
+                                        [ERROR]       +-org.apache.maven.shared:maven-filtering:jar:3.3.1:compile
+                                        [ERROR]         +-commons-io:commons-io:jar:2.11.0:compile
+                                        [ERROR] and
+                                        [ERROR] +-org.springframework.rewrite:spring-rewrite-commons-starter-boot-upgrade:jar:0.1.0-SNAPSHOT
+                                        [ERROR]   +-org.openrewrite.recipe:rewrite-migrate-java:jar:2.7.1:compile
+                                        [ERROR]     +-commons-io:commons-io:jar:2.15.1:compile
+                                        -->
+                                        <exclude>commons-io:commons-io</exclude>
+                                    </excludes>
+                                </dependencyConvergence>
+                            </rules>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
         </plugins>
     </build>
     <profiles>

spring-rewrite-commons-docs/src/main/antora/modules/ROOT/pages/index.adoc

@@ -43,15 +43,7 @@ All examples can be found file://spring-rewrite-commons-examples[here].
 == Limitations
 The project has currently some limitations.
 
-. Only JDK 17 supported and required
-. No Gradle support. +
-  OpenRewrite provides a build tool plugin for Gradle projects.
-  This project currently only parses Maven projects.
-. No Kotlin support. +
-OpenRewrite can parse other languages than Java, especially Kotlin. This is not yet supported.
-. Inherited version will just be read from direct parent. Meaning a version from a parent with distance > 1 will be empty (`null`)
-. Maven profiles are currently ignored and 'default' profile is used
-. Styles are not supported +
-OpenRewrite styles are currently not supported.
-. Migrating projects for Maven plugins might fail +
-Maven plugin projects (modules) are currently ignored when building the reactor order.
+. JDK 17 is a requirement
+. Kotlin is not supported.
+. Styles are not supported
+. Migrating projects for Maven plugins might fail

spring-rewrite-commons-docs/src/main/antora/modules/ROOT/pages/testing.adoc

@@ -5,6 +5,32 @@ The `RewriteProjectParser`
 == Test Helper
 
 === TestProjectHelper
+
+The `TestProjectHelper` allows reading test projects from disk or to create them in memory.
+
+==== Clone a Git Repository
+[source,java]
+....
+
+.toAbsolutePath().normalize();
+TestProjectHelper.createTestProject(projectRoot)
+    .deleteDirIfExists()
+    .cloneGitProject("https://github.com/corona-warn-app/cwa-server.git")
+    .checkoutTag("v3.2.0")
+    .writeToFilesystem();
+....
+
+==== Read a project from testcode dir
+
+Projects used for testing can be provided in a `testcode` directory.
+Maven projects are read from `testcode/maven-projects`.
+
+Example: Get Path to `./testcode/maven-projects/my-test-project`:
+[source, java]
+....
+Path baseDir = TestProjectHelper.TestProjectHelper.getMavenProject("my-test-project");
+....
+
 === ParserParityTestHelper
 === ParserExecutionHelper
 === RewriteMavenProjectParser