← All recipes
Open source

Change Maven managed dependency groupId, artifactId and optionally the version

Recipe IDorg.openrewrite.maven.ChangeManagedDependencyGroupIdAndArtifactIdArtifactorg.openrewrite:rewrite-maven

Change the groupId, artifactId and optionally the version of a specified Maven managed dependency.

Single recipeApache 2.0

Add to your build

Get a download tokenSign in with GitHub or Google, and your token replaces YOUR_DOWNLOAD_TOKEN below. Free for open source recipes like this one.

~/.gradle/gradle.properties

codeGenomeUsername=you@example.com
codeGenomeToken=YOUR_DOWNLOAD_TOKEN

build.gradle.kts

plugins {
    id("org.openrewrite.rewrite") version("latest.release")
}

rewrite {
    activeRecipe("org.openrewrite.maven.ChangeManagedDependencyGroupIdAndArtifactId")
}

repositories {
    mavenCentral()
    maven {
        url = uri("https://artifacts.codegenomeproject.org/maven")
        credentials {
            username = providers.gradleProperty("codeGenomeUsername").get()
            password = providers.gradleProperty("codeGenomeToken").get()
        }
    }
}

dependencies {
    rewrite("org.openrewrite:rewrite-maven:8.92.8")
}

Then run

./gradlew rewriteRun

This recipe has required options, which a build sets in a rewrite.yml recipe that you activate instead.

Usage

You’ll need the Moderne CLI configured before running the command below.

mod run . --recipe org.openrewrite.maven.ChangeManagedDependencyGroupIdAndArtifactId --recipe-option "oldGroupId=org.openrewrite.recipe" --recipe-option "oldArtifactId=rewrite-testing-frameworks"

If the recipe isn’t available locally, install it with:

mod config recipes jar install org.openrewrite:rewrite-maven:RELEASE

Options

NameTypeDescription
oldGroupIdrequiredStringThe old groupId to replace. The groupId is the first part of a managed dependency coordinate com.google.guava:guava:VERSION. Supports glob expressions.
e.g. org.openrewrite.recipe
oldArtifactIdrequiredStringThe old artifactId to replace. The artifactId is the second part of a managed dependency coordinate com.google.guava:guava:VERSION. Supports glob expressions.
e.g. rewrite-testing-frameworks
newGroupIdStringThe new groupId to use. Defaults to the existing group id.
e.g. corp.internal.openrewrite.recipe
newArtifactIdStringThe new artifactId to use. Defaults to the existing artifact id.
e.g. rewrite-testing-frameworks
newVersionStringThe new version to use.
e.g. 2.0.0
versionPatternStringAllows version selection to be extended beyond the original Node Semver semantics. So for example,Setting 'version' to "25-29" can be paired with a metadata pattern of "-jre" to select Guava 29.0-jre
e.g. -jre

Data tables

Structured output this recipe can produce.

  • Maven metadata failuresAttempts to resolve maven metadata that failed.org.openrewrite.maven.table.MavenMetadataFailures
  • Source files that had resultsSource files that were modified by the recipe run.org.openrewrite.table.SourcesFileResults
  • Source files that had search resultsSearch results that were found during the recipe run.org.openrewrite.table.SearchResults
  • Source files that errored on a recipeThe details of all errors produced by a recipe run.org.openrewrite.table.SourcesFileErrors
  • Recipe performanceStatistics used in analyzing the performance of recipes.org.openrewrite.table.RecipeRunStats