Use ruff formatter in DABs templates (replacing Black) (#4196)

lennartkats-db · claude · web-flow · commit ec58ff2e0ae4 · 2026-01-12T09:15:27.000Z
## Changes This switches the code formatter to ruff and sets the line length to 120 a described in #3675. ## Why * ruff mindshare, performance, and ability to combine linting and formatting ## Tests * Standard acceptance tests --------- Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
diff --git a/NEXT_CHANGELOG.md b/NEXT_CHANGELOG.md
@@ -12,6 +12,7 @@ To disable this, set the environment variable DATABRICKS_CACHE_ENABLED to false.
 * Enable caching user identity by default ([#4202](https://github.com/databricks/cli/pull/4202))
 * Fix false positive folder permission warnings and make them more actionable ([#4216](https://github.com/databricks/cli/pull/4216))
 * Pass additional Azure DevOps system variables ([#4236](https://github.com/databricks/cli/pull/4236))
+* Replace Black formatter with Ruff in Python bundle templates for faster, all-in-one linting and formatting ([#4196](https://github.com/databricks/cli/pull/4196))
 
 ### Dependency updates
 
diff --git a/acceptance/bundle/templates/default-minimal/output/my_default_minimal/.vscode/extensions.json b/acceptance/bundle/templates/default-minimal/output/my_default_minimal/.vscode/extensions.json
@@ -2,6 +2,6 @@
     "recommendations": [
         "databricks.databricks",
         "redhat.vscode-yaml",
-        "ms-python.black-formatter"
+        "charliermarsh.ruff"
     ]
 }
diff --git a/acceptance/bundle/templates/default-minimal/output/my_default_minimal/.vscode/settings.json b/acceptance/bundle/templates/default-minimal/output/my_default_minimal/.vscode/settings.json
@@ -33,7 +33,7 @@
     "python.testing.unittestEnabled": false,
     "python.testing.pytestEnabled": true,
     "[python]": {
-        "editor.defaultFormatter": "ms-python.black-formatter",
+        "editor.defaultFormatter": "charliermarsh.ruff",
         "editor.formatOnSave": true,
     },
 }
diff --git a/acceptance/bundle/templates/default-python/classic/output/my_default_python/.vscode/extensions.json b/acceptance/bundle/templates/default-python/classic/output/my_default_python/.vscode/extensions.json
@@ -2,6 +2,6 @@
     "recommendations": [
         "databricks.databricks",
         "redhat.vscode-yaml",
-        "ms-python.black-formatter"
+        "charliermarsh.ruff"
     ]
 }
diff --git a/acceptance/bundle/templates/default-python/classic/output/my_default_python/.vscode/settings.json b/acceptance/bundle/templates/default-python/classic/output/my_default_python/.vscode/settings.json
@@ -33,7 +33,7 @@
     "python.testing.unittestEnabled": false,
     "python.testing.pytestEnabled": true,
     "[python]": {
-        "editor.defaultFormatter": "ms-python.black-formatter",
+        "editor.defaultFormatter": "charliermarsh.ruff",
         "editor.formatOnSave": true,
     },
 }
diff --git a/acceptance/bundle/templates/default-python/classic/output/my_default_python/pyproject.toml b/acceptance/bundle/templates/default-python/classic/output/my_default_python/pyproject.toml
@@ -14,6 +14,7 @@ dependencies = [
 [dependency-groups]
 dev = [
     "pytest",
+    "ruff",
     "databricks-dlt",
     "databricks-connect>=15.4,<15.5",
     "ipykernel",
@@ -26,5 +27,5 @@ main = "my_default_python.main:main"
 requires = ["hatchling"]
 build-backend = "hatchling.build"
 
-[tool.black]
-line-length = 125
+[tool.ruff]
+line-length = 120
diff --git a/acceptance/bundle/templates/default-python/serverless/output/my_default_python/.vscode/extensions.json b/acceptance/bundle/templates/default-python/serverless/output/my_default_python/.vscode/extensions.json
@@ -2,6 +2,6 @@
     "recommendations": [
         "databricks.databricks",
         "redhat.vscode-yaml",
-        "ms-python.black-formatter"
+        "charliermarsh.ruff"
     ]
 }
diff --git a/acceptance/bundle/templates/default-python/serverless/output/my_default_python/.vscode/settings.json b/acceptance/bundle/templates/default-python/serverless/output/my_default_python/.vscode/settings.json
@@ -33,7 +33,7 @@
     "python.testing.unittestEnabled": false,
     "python.testing.pytestEnabled": true,
     "[python]": {
-        "editor.defaultFormatter": "ms-python.black-formatter",
+        "editor.defaultFormatter": "charliermarsh.ruff",
         "editor.formatOnSave": true,
     },
 }
diff --git a/acceptance/bundle/templates/default-python/serverless/output/my_default_python/pyproject.toml b/acceptance/bundle/templates/default-python/serverless/output/my_default_python/pyproject.toml
@@ -14,6 +14,7 @@ dependencies = [
 [dependency-groups]
 dev = [
     "pytest",
+    "ruff",
     "databricks-dlt",
     "databricks-connect>=15.4,<15.5",
     "ipykernel",
@@ -26,5 +27,5 @@ main = "my_default_python.main:main"
 requires = ["hatchling"]
 build-backend = "hatchling.build"
 
-[tool.black]
-line-length = 125
+[tool.ruff]
+line-length = 120
diff --git a/acceptance/bundle/templates/lakeflow-pipelines/python/output/my_lakeflow_pipelines/.vscode/extensions.json b/acceptance/bundle/templates/lakeflow-pipelines/python/output/my_lakeflow_pipelines/.vscode/extensions.json
@@ -2,6 +2,6 @@
     "recommendations": [
         "databricks.databricks",
         "redhat.vscode-yaml",
-        "ms-python.black-formatter"
+        "charliermarsh.ruff"
     ]
 }
diff --git a/acceptance/bundle/templates/lakeflow-pipelines/python/output/my_lakeflow_pipelines/.vscode/settings.json b/acceptance/bundle/templates/lakeflow-pipelines/python/output/my_lakeflow_pipelines/.vscode/settings.json
@@ -33,7 +33,7 @@
     "python.testing.unittestEnabled": false,
     "python.testing.pytestEnabled": true,
     "[python]": {
-        "editor.defaultFormatter": "ms-python.black-formatter",
+        "editor.defaultFormatter": "charliermarsh.ruff",
         "editor.formatOnSave": true,
     },
 }
diff --git a/acceptance/bundle/templates/lakeflow-pipelines/python/output/my_lakeflow_pipelines/pyproject.toml b/acceptance/bundle/templates/lakeflow-pipelines/python/output/my_lakeflow_pipelines/pyproject.toml
@@ -14,6 +14,7 @@ dependencies = [
 [dependency-groups]
 dev = [
     "pytest",
+    "ruff",
     "databricks-dlt",
     "databricks-connect>=15.4,<15.5",
     "ipykernel",
@@ -29,5 +30,5 @@ build-backend = "hatchling.build"
 [tool.hatch.build.targets.wheel]
 packages = ["src"]
 
-[tool.black]
-line-length = 125
+[tool.ruff]
+line-length = 120
diff --git a/acceptance/bundle/templates/lakeflow-pipelines/sql/output/my_lakeflow_pipelines/.vscode/extensions.json b/acceptance/bundle/templates/lakeflow-pipelines/sql/output/my_lakeflow_pipelines/.vscode/extensions.json
@@ -2,6 +2,6 @@
     "recommendations": [
         "databricks.databricks",
         "redhat.vscode-yaml",
-        "ms-python.black-formatter"
+        "charliermarsh.ruff"
     ]
 }
diff --git a/acceptance/bundle/templates/lakeflow-pipelines/sql/output/my_lakeflow_pipelines/.vscode/settings.json b/acceptance/bundle/templates/lakeflow-pipelines/sql/output/my_lakeflow_pipelines/.vscode/settings.json
@@ -33,7 +33,7 @@
     "python.testing.unittestEnabled": false,
     "python.testing.pytestEnabled": true,
     "[python]": {
-        "editor.defaultFormatter": "ms-python.black-formatter",
+        "editor.defaultFormatter": "charliermarsh.ruff",
         "editor.formatOnSave": true,
     },
 }
diff --git a/acceptance/bundle/templates/pydabs/init-classic/output/my_pydabs/pyproject.toml b/acceptance/bundle/templates/pydabs/init-classic/output/my_pydabs/pyproject.toml
@@ -14,6 +14,7 @@ dependencies = [
 [dependency-groups]
 dev = [
     "pytest",
+    "ruff",
     "databricks-dlt",
     "databricks-connect>=15.4,<15.5",
     "ipykernel",
@@ -27,5 +28,5 @@ main = "my_pydabs.main:main"
 requires = ["hatchling"]
 build-backend = "hatchling.build"
 
-[tool.black]
-line-length = 125
+[tool.ruff]
+line-length = 120
diff --git a/libs/template/templates/default/template/{{.project_name}}/.vscode/extensions.json b/libs/template/templates/default/template/{{.project_name}}/.vscode/extensions.json
@@ -2,6 +2,6 @@
     "recommendations": [
         "databricks.databricks",
         "redhat.vscode-yaml",
-        "ms-python.black-formatter"
+        "charliermarsh.ruff"
     ]
 }
diff --git a/libs/template/templates/default/template/{{.project_name}}/.vscode/settings.json b/libs/template/templates/default/template/{{.project_name}}/.vscode/settings.json
@@ -33,7 +33,7 @@
     "python.testing.unittestEnabled": false,
     "python.testing.pytestEnabled": true,
     "[python]": {
-        "editor.defaultFormatter": "ms-python.black-formatter",
+        "editor.defaultFormatter": "charliermarsh.ruff",
         "editor.formatOnSave": true,
     },
 }
diff --git a/libs/template/templates/default/template/{{.project_name}}/pyproject.toml.tmpl b/libs/template/templates/default/template/{{.project_name}}/pyproject.toml.tmpl
@@ -14,6 +14,7 @@ dependencies = [
 [dependency-groups]
 dev = [
     "pytest",
+    "ruff",
     "databricks-dlt",
     "databricks-connect{{template "conservative_db_connect_version_spec"}}",
     "ipykernel",
@@ -38,5 +39,5 @@ build-backend = "hatchling.build"
 packages = ["src"]
 {{- end }}
 
-[tool.black]
-line-length = 125
+[tool.ruff]
+line-length = 120

Original file line number	Diff line number	Diff line change
`@@ -2,6 +2,6 @@`
`2`	`2`	`"recommendations": [`
`3`	`3`	`"databricks.databricks",`
`4`	`4`	`"redhat.vscode-yaml",`
`5`		`- "ms-python.black-formatter"`
	`5`	`+ "charliermarsh.ruff"`
`6`	`6`	`]`
`7`	`7`	`}`
Original file line number	Diff line number	Diff line change
`@@ -33,7 +33,7 @@`
`33`	`33`	`"python.testing.unittestEnabled": false,`
`34`	`34`	`"python.testing.pytestEnabled": true,`
`35`	`35`	`"[python]": {`
`36`		`- "editor.defaultFormatter": "ms-python.black-formatter",`
	`36`	`+ "editor.defaultFormatter": "charliermarsh.ruff",`
`37`	`37`	`"editor.formatOnSave": true,`
`38`	`38`	`},`
`39`	`39`	`}`