Skip to content

Latest commit

 

History

History
32 lines (26 loc) · 1.57 KB

artifact-migrations.md

File metadata and controls

32 lines (26 loc) · 1.57 KB
Raw

Artifact Migrations

Scala Steward can look for newer versions of artifacts with different group Ids, artifact ids, or both different.

Adding artifact migration rules to Scala Steward

By default, scala-steward applies the artifact migrations rules defined in the default list. When running Scala Steward you can also specify a file (via the --artifact-migrations command-line option) that contains additional migrations.

These files are in HOCON format and should look like this:

changes = [
  {
    groupIdBefore = com.geirsson
    groupIdAfter = org.scalameta
    artifactIdAfter = sbt-scalafmt
    initialVersion = 2.0.0
  }
]

In this example, scala-steward will look in the project for dependencies with the before group id, "com.geirsson", and artifact id "sbt-scalafmt". If found, scala-steward will search for updates using the after group id, "org.scalameta", artifact id "sbt-scalafmt", and version greater than the initial version, 2.0.0. If found, scala-steward will update to the after group id and latest version.

The fields groupIdBefore and artifactIdBefore are optional. If just groupIdBefore is specified, as in the previous example, then only the group id will get renamed. If just artifactIdBefore is specified, then only the artifact id will get renamed. Specifying both groupIdBefore and artifactIdBefore will rename both.