Plugin Documentation

This report describes goals, parameters details, requirements and sample usage of this plugin.

Goals

Goals available for this plugin:

Goal	Description
rewrite:discover	Generate a report of the available recipes and styles found on the classpath. Can also be used to display information about a specific recipe. For example: `./mvnw rewrite:discover -Ddetail=true -Drecipe=org.openrewrite.java.format.AutoFormat`
rewrite:dryRun	Generate warnings to the console for any recipe that would make changes, but do not make changes. This variant of rewrite:dryRun will fork the maven life cycle and can be run as a "stand-alone" goal. It will execute the maven build up to the process-test-classes phase.
rewrite:dryRunNoFork	Generate warnings to the console for any recipe that would make changes, but do not make changes. This variant of rewrite:dryRun will not fork the maven life cycle and can be used (along with other goals) without triggering repeated life-cycle events. It will execute the maven build up to the process-test-classes phase.
rewrite:help	Display help information on rewrite-maven-plugin. Call `mvn rewrite:help -Ddetail=true -Dgoal=<goal-name>` to display parameter details.
rewrite:run	Run the configured recipes and apply the changes locally. This variant of rewrite:run will fork the maven life cycle and can be run as a "stand-alone" goal. It will execute the maven build up to the process-test-classes phase.
rewrite:runNoFork	Run the configured recipes and apply the changes locally. This variant of rewrite:run will not fork the maven life cycle and can be used (along with other goals) without triggering repeated life-cycle events.
rewrite:typetable	Create a TypeTable in `src/main/resources/META-INF/rewrite/classpath.tsv.zip` for `rewrite.recipeArtifactCoordinates`. `./mvnw rewrite:typetable`

System Requirements

The following specifies the minimum requirements to run this Maven plugin:

Maven	3.3.1
JDK	8

System Requirements History

The following specifies the minimum requirements to run this Maven plugin for historical versions:

Plugin Version	Maven	JDK
from 5.4.0 to 6.22.0	3.3.1	8
from 1.0.0 to 5.3.2	-	8

Usage

You should specify the version in your project's plugin configuration:

<project>
  ...
  <build>
    <!-- To define the plugin version in your parent POM -->
    <pluginManagement>
      <plugins>
        <plugin>
          <groupId>org.openrewrite.maven</groupId>
          <artifactId>rewrite-maven-plugin</artifactId>
          <version>6.23.0-SNAPSHOT</version>
        </plugin>
        ...
      </plugins>
    </pluginManagement>
    <!-- To use the plugin goals in your POM or parent POM -->
    <plugins>
      <plugin>
        <groupId>org.openrewrite.maven</groupId>
        <artifactId>rewrite-maven-plugin</artifactId>
      </plugin>
      ...
    </plugins>
  </build>
  ...
</project>

For more information, see "Guide to Configuring Plug-ins"