Change Gradle dependency
org.openrewrite.gradle.ChangeDependency
Change a Gradle dependency coordinates. The newGroupId
or newArtifactId
MUST be different from before.
Recipe source
GitHub, Issue Tracker, Maven Central
groupId: org.openrewrite
artifactId: rewrite-gradle
version: 8.24.0
Options
Type | Name | Description | Example |
---|---|---|---|
| oldGroupId | The old groupId to replace. The groupId is the first part of a dependency coordinate 'com.google.guava:guava:VERSION'. Supports glob expressions. |
|
| oldArtifactId | The old artifactId to replace. The artifactId is the second part of a dependency coordinate 'com.google.guava:guava:VERSION'. Supports glob expressions. |
|
| newGroupId | Optional. The new groupId to use. Defaults to the existing group id. |
|
| newArtifactId | Optional. The new artifactId to use. Defaults to the existing artifact id. |
|
| newVersion | Optional. An exact version number or node-style semver selector used to select the version number. You can also use |
|
| versionPattern | Optional. Allows 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 |
|
| overrideManagedVersion | Optional. If the old dependency has a managed version, this flag can be used to explicitly set the version on the new dependency. WARNING: No check is done on the NEW dependency to verify if it is managed, it relies on whether the OLD dependency had a managed version. The default for this flag is |
Usage
This recipe has required configuration parameters. Recipes with required configuration parameters cannot be activated directly. To activate this recipe you must create a new recipe which fills in the required parameters. In your rewrite.yml
create a new recipe with a unique name. For example: com.yourorg.ChangeDependencyExample
. Here's how you can define and customize such a recipe within your rewrite.yml:
Now that com.yourorg.ChangeDependencyExample
has been defined activate it in your build file:
Add the following to your
build.gradle
file:
Run
gradle rewriteRun
to run the recipe.
See how this recipe works across multiple open-source repositories
The community edition of the Moderne platform enables you to easily run recipes across thousands of open-source repositories.
Please contact Moderne for more information about safely running the recipes on your own codebase in a private SaaS.
Contributors
Shannon Pamperl, Joan Viladrosa, Jonathan Schnéider, Tim te Beek
Last updated