databricks-cli/libs/filer
shreyas-goenka 41a21af556
Refactor `bundle init` (#2074)
## Summary of changes
This PR introduces three new abstractions: 
1. `Resolver`: Resolves which reader and writer to use for a template.
2. `Writer`: Writes a template project to disk. Prompts the user if
necessary.
3. `Reader`: Reads a template specification from disk, built into the
CLI or from GitHub.

Introducing these abstractions helps decouple reading a template from
writing it. When I tried adding telemetry for the `bundle init` command,
I noticed that the code in `cmd/init.go` was getting convoluted and hard
to test. A future change could have accidentally logged PII when a user
initialised a custom template.

Hedging against that risk is important here because we use a generic
untyped `map<string, string>` representation in the backend to log
telemetry for the `databricks bundle init`. Otherwise, we risk
accidentally breaking our compliance with our centralization
requirements.

### Details

After this PR there are two classes of templates that can be
initialized:
1. A `databricks` template: This could be a builtin template or a
template outside the CLI like mlops-stacks, which is still owned and
managed by Databricks. These templates log their telemetry arguments and
template name.
2. A `custom` template: These are templates created by and managed by
the end user. In these templates we do not log the template name and
args. Instead a generic placeholder string of "custom" is logged in our
telemetry system.

NOTE: The functionality of the `databricks bundle init` command remains
the same after this PR. Only the internal abstractions used are changed.

## Tests
New unit tests. Existing golden and unit tests. Also a fair bit of
manual testing.
2025-01-20 12:09:28 +00:00
..
completer Enable testifylint and fix the issues (#2065) 2025-01-02 12:03:41 +01:00
dbfs_client.go Upgraded Go version to 1.21 (#664) 2023-08-15 13:50:40 +00:00
fake_filer.go Enable perfsprint linter and apply autofix (#2071) 2025-01-07 10:49:23 +00:00
fake_filer_test.go Consolidate test helpers for `io/fs` (#1906) 2024-11-15 15:37:21 +00:00
filer.go Enable perfsprint linter and apply autofix (#2071) 2025-01-07 10:49:23 +00:00
filer_test.go Use `filer.Filer` to write template instantiation (#1911) 2024-11-20 11:11:31 +01:00
files_client.go Enable linter 'copyloopvar' and fix the issues (#2160) 2025-01-16 11:20:50 +00:00
fs.go Add fs.FS adapter for the filer interface (#422) 2023-06-02 12:49:59 +00:00
fs_test.go Enable intrange linter and apply autofix (#2069) 2025-01-03 09:25:07 +00:00
local_client.go Enable gofumpt and goimports in golangci-lint (#1999) 2024-12-12 10:28:42 +01:00
local_root_path.go Remove unnecessary `filepath.FromSlash` calls (#1458) 2024-05-29 15:30:26 +00:00
local_root_path_test.go Make local files default for fs commands (#506) 2023-06-23 16:07:09 +02:00
slice.go Upgraded Go version to 1.21 (#664) 2023-08-15 13:50:40 +00:00
slice_test.go Enable gofumpt and goimports in golangci-lint (#1999) 2024-12-12 10:28:42 +01:00
workspace_files_cache.go Implement readahead cache for Workspace API calls (#1582) 2024-07-18 09:45:10 +00:00
workspace_files_cache_test.go Enable perfsprint linter and apply autofix (#2071) 2025-01-07 10:49:23 +00:00
workspace_files_client.go Enable linter 'mirror' and autofix existing issues (#2070) 2025-01-03 10:13:12 +00:00
workspace_files_client_test.go Move bespoke status call to main workspace files filer (#1570) 2024-07-05 11:32:29 +00:00
workspace_files_extensions_client.go Refactor `bundle init` (#2074) 2025-01-20 12:09:28 +00:00
workspace_files_extensions_client_test.go Refactor `bundle init` (#2074) 2025-01-20 12:09:28 +00:00
workspace_root_path.go Make local files default for fs commands (#506) 2023-06-23 16:07:09 +02:00
workspace_root_path_test.go Make local files default for fs commands (#506) 2023-06-23 16:07:09 +02:00