From c4961cd3c3638ca30d04f1d679e815e707b9f42f Mon Sep 17 00:00:00 2001 From: Grigory Panov Date: Mon, 6 Jul 2026 10:34:14 +0200 Subject: [PATCH] Unveil local-env: make the command visible, add help + changelog Eighth and final PR in the stacked series. Flips the feature from implemented-but-hidden to released: - cmd/localenv/localenv.go: remove Hidden:true so `local-env` appears in `databricks --help` and completion. - acceptance/help/output.txt: regenerated global-help golden now lists local-env under Developer Tools. - NEXT_CHANGELOG.md: announce `databricks local-env python sync`. This is the only PR that changes user-visible surface; everything it exposes was reviewed and tested in PRs 1-7. Reverting this PR alone re-hides the feature without touching any implementation. Co-authored-by: Isaac --- .nextchanges/cli/local-env.md | 1 + acceptance/help/output.txt | 1 + cmd/localenv/localenv.go | 5 ----- 3 files changed, 2 insertions(+), 5 deletions(-) create mode 100644 .nextchanges/cli/local-env.md diff --git a/.nextchanges/cli/local-env.md b/.nextchanges/cli/local-env.md new file mode 100644 index 00000000000..55b3b79b2db --- /dev/null +++ b/.nextchanges/cli/local-env.md @@ -0,0 +1 @@ +Add `databricks local-env python sync` to provision a local Python environment (Python version, `databricks-connect` pin, and dependency constraints) matched to the selected Databricks compute target. A project with no `pyproject.toml` is initialized from scratch; an existing one is merged in place. Supports `--cluster`/`--serverless`/`--job` target selection, `--constraints-only` (skip `databricks-connect`), `--check` (dry run), and `--output json` for the VS Code extension. diff --git a/acceptance/help/output.txt b/acceptance/help/output.txt index c6642670d17..80276b972d7 100644 --- a/acceptance/help/output.txt +++ b/acceptance/help/output.txt @@ -169,6 +169,7 @@ Environments Developer Tools bundle Declarative Automation Bundles let you express data/AI/analytics projects as code. + local-env Manage local development environments matched to Databricks compute sync Synchronize a local directory to a workspace directory Additional Commands: diff --git a/cmd/localenv/localenv.go b/cmd/localenv/localenv.go index b93c36f7102..97a38b185d4 100644 --- a/cmd/localenv/localenv.go +++ b/cmd/localenv/localenv.go @@ -9,16 +9,11 @@ import ( // New returns the local-env command group. The group, subgroup, and verb names // come from the single command-name constants in libs/localenv so a rename is a // one-location change (spec ยง0 / invariant 8). -// -// The command is Hidden while the feature lands across the stacked PRs: it is -// wired and runnable for dogfooding, but stays out of help and completion until -// the final PR unveils it (removes this flag, adds the help line and changelog). func New() *cobra.Command { cmd := &cobra.Command{ Use: libslocalenv.CommandGroup, Short: "Manage local development environments matched to Databricks compute", GroupID: "development", - Hidden: true, Long: `Manage local development environments matched to a Databricks compute target. Derives the Python version, databricks-connect version, and dependency