1# BOM Migration — Gradle TOML Version Catalog (`libs.versions.toml`)
2 
3OpenRewrite does not yet support TOML version catalogs ([openrewrite/rewrite#4400](https://github.com/openrewrite/rewrite/issues/4400)). Handle manually.
4 
5Check for `gradle/libs.versions.toml`. If it exists and contains Azure entries, apply these steps. Always update `build.gradle` / `build.gradle.kts` references in tandem.
6 
7> 💡 **Tip:** TOML alias `azure-sdk-bom` becomes accessor `libs.azure.sdk.bom` (hyphens→dots). CamelCase `azureSdkBom` becomes `libs.azureSdkBom`. Match the project's existing convention.
8 
9## Step 1 — Add or upgrade the BOM
10 
11In `gradle/libs.versions.toml`:
12```toml
13[versions]
14azureSdkBom = "{bom_version}"
15 
16[libraries]
17azure-sdk-bom = { group = "com.azure", name = "azure-sdk-bom", version.ref = "azureSdkBom" }
18```
19 
20In `build.gradle` (Groovy DSL):
21```groovy
22implementation enforcedPlatform(libs.azure.sdk.bom)
23```
24 
25In `build.gradle.kts` (Kotlin DSL):
26```kotlin
27implementation(enforcedPlatform(libs.azure.sdk.bom))
28```
29 
30## Step 2 — Remove explicit versions from BOM-managed libraries
31 
32For each `com.azure.*` library in `[libraries]` that the BOM manages, drop `version.ref` / `version` and remove orphaned `[versions]` entries.
33 
34```toml
35# Before
36[versions]
37azureIdentity = "1.15.0"
38[libraries]
39azureIdentity = { group = "com.azure", name = "azure-identity", version.ref = "azureIdentity" }
40 
41# After
42[libraries]
43azureIdentity = { group = "com.azure", name = "azure-identity" }
44```
45 
46## Step 3 — Replace legacy entries with modern equivalents
47 
48For each `com.microsoft.azure.*` library: replace `group`/`name` with the modern `com.azure.*` equivalent, drop `version.ref`/`version` if BOM-managed, remove orphaned `[versions]` entries, and update alias references in `build.gradle` and `[bundles]`.
49 
50```toml
51# Before
52[versions]
53azureSdk = "1.41.4"
54azureStorage = "8.6.6"
55[libraries]
56azure = { group = "com.microsoft.azure", name = "azure", version.ref = "azureSdk" }
57azureStorage = { group = "com.microsoft.azure", name = "azure-storage", version.ref = "azureStorage" }
58 
59# After (BOM-managed)
60[libraries]
61azureResourcemanager = { group = "com.azure.resourcemanager", name = "azure-resourcemanager" }
62azureStorageBlob = { group = "com.azure", name = "azure-storage-blob" }
63```
64 
65Update `build.gradle` and `[bundles]` to use the new aliases.
66 
67## TOML patterns to recognise
68 
69Libraries may use any of these forms — handle all of them:
70```toml
71lib = { group = "g", name = "a", version.ref = "v" }
72lib = { module = "g:a", version.ref = "v" }
73lib = { module = "g:a", version = "1.0" }
74lib = { group = "g", name = "a", version = { strictly = "1.0" } }
75```
76