feat: add configuration system (#4)

Author: reubeno

cmd/azldev/azldev.go

@@ -7,6 +7,7 @@ import (
 	"os"
 
 	"github.com/microsoft/azure-linux-dev-tools/internal/app/azldev"
+	"github.com/microsoft/azure-linux-dev-tools/internal/app/azldev/cmds/config"
 	"github.com/microsoft/azure-linux-dev-tools/internal/app/azldev/cmds/docs"
 	"github.com/microsoft/azure-linux-dev-tools/internal/app/azldev/cmds/version"
 )
@@ -28,6 +29,7 @@ func InstantiateApp() *azldev.App {
 
 	// Give top level command packages an opportunity to register their commands (or in some cases,
 	// request post-init callbacks).
+	config.OnAppInit(app)
 	docs.OnAppInit(app)
 	version.OnAppInit(app)
 

cmd/azldev/azldev_test.go

@@ -22,6 +22,7 @@ func TestInstantiateApp(t *testing.T) {
 			t,
 			topLevelCommandNames,
 			[]string{
+				"config",
 				"docs",
 				"version",
 			},

defaultconfigs/content/defaults.toml

@@ -0,0 +1,2 @@
+[tools.imageCustomizer]
+containerTag = "mcr.microsoft.com/azurelinux/imagecustomizer:1"

defaultconfigs/defaultconfigs.go

@@ -0,0 +1,44 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+package defaultconfigs
+
+import (
+	"embed"
+	"fmt"
+	"path/filepath"
+
+	"github.com/microsoft/azure-linux-dev-tools/internal/global/opctx"
+	"github.com/microsoft/azure-linux-dev-tools/internal/utils/fileutils"
+)
+
+// Embedfs-relative path to the root directory of the embedded filesystem.
+const embedfsRootDir = "/content"
+
+// Name of the root default configuration file that should be loaded from these default files.
+const rootDefaultConfigFilename = "defaults.toml"
+
+// The embedded filesystem containing compiled-in default configuration files. This configuration
+// defines distro-level defaults for consistency.
+//
+//go:embed content/*
+var content embed.FS
+
+// CopyTo recursively copies the contents of the [content] embedded filesystem to the specified
+// destination path in the provided filesystem. Returns the path to the root configuration file
+// to load from the copied directory.
+func CopyTo(dryRunnable opctx.DryRunnable, fs opctx.FS, destPath string) (rootConfigFilePath string, err error) {
+	sourceFS := fileutils.WrapEmbedFS(&content)
+
+	err = fileutils.CopyDirRecursiveCrossFS(
+		dryRunnable,
+		sourceFS, embedfsRootDir,
+		fs, destPath,
+		fileutils.CopyDirOptions{},
+	)
+	if err != nil {
+		return "", fmt.Errorf("failed to copy default configs to '%s': %w", destPath, err)
+	}
+
+	return filepath.Join(destPath, rootDefaultConfigFilename), nil
+}

docs/user/reference/cli/azldev.md

@@ -3,20 +3,31 @@ module github.com/microsoft/azure-linux-dev-tools
 go 1.25.6
 
 require (
+	dario.cat/mergo v1.0.2
+	github.com/acarl005/stripansi v0.0.0-20180116102854-5a71ef0e047d
 	github.com/auribuo/stylishcobra v1.0.1
 	github.com/bmatcuk/doublestar/v4 v4.10.0
 	github.com/briandowns/spinner v1.23.2
+	github.com/brunoga/deep v1.3.1
 	github.com/charmbracelet/bubbles v1.0.0
 	github.com/charmbracelet/gum v0.17.0
 	github.com/charmbracelet/lipgloss v1.1.1-0.20250404203927-76690c660834
+	github.com/charmbracelet/x/term v0.2.2
+	github.com/go-playground/validator/v10 v10.30.1
 	github.com/google/renameio v1.0.1
+	github.com/invopop/jsonschema v0.13.0
+	github.com/jedib0t/go-pretty/v6 v6.7.8
+	github.com/knqyf263/go-rpm-version v0.0.0-20240918084003-2afd7dc6a38f
 	github.com/lmittmann/tint v1.1.3
 	github.com/magefile/mage v1.15.0
 	github.com/mark3labs/mcp-go v0.44.1
 	github.com/mattn/go-isatty v0.0.20
 	github.com/muesli/termenv v0.16.0
+	github.com/nxadm/tail v1.4.11
 	github.com/opencontainers/selinux v1.13.1
+	github.com/pelletier/go-toml/v2 v2.2.4
 	github.com/samber/lo v1.52.0
+	github.com/samber/slog-multi v1.7.1
 	github.com/spf13/afero v1.15.0
 	github.com/spf13/cobra v1.10.2
 	github.com/spf13/pflag v1.0.10
@@ -36,7 +47,6 @@ require (
 	github.com/charmbracelet/harmonica v0.2.0 // indirect
 	github.com/charmbracelet/x/ansi v0.11.6 // indirect
 	github.com/charmbracelet/x/cellbuf v0.0.15 // indirect
-	github.com/charmbracelet/x/term v0.2.2 // indirect
 	github.com/clipperhouse/displaywidth v0.9.0 // indirect
 	github.com/clipperhouse/stringish v0.1.1 // indirect
 	github.com/clipperhouse/uax29/v2 v2.5.0 // indirect
@@ -45,10 +55,14 @@ require (
 	github.com/davecgh/go-spew v1.1.1 // indirect
 	github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f // indirect
 	github.com/fatih/color v1.18.0 // indirect
+	github.com/fsnotify/fsnotify v1.9.0 // indirect
+	github.com/gabriel-vasile/mimetype v1.4.12 // indirect
+	github.com/go-playground/locales v0.14.1 // indirect
+	github.com/go-playground/universal-translator v0.18.1 // indirect
 	github.com/google/go-cmp v0.7.0 // indirect
 	github.com/google/uuid v1.6.0 // indirect
 	github.com/inconshreveable/mousetrap v1.1.0 // indirect
-	github.com/invopop/jsonschema v0.13.0 // indirect
+	github.com/leodido/go-urn v1.4.0 // indirect
 	github.com/lucasb-eyer/go-colorful v1.3.0 // indirect
 	github.com/mailru/easyjson v0.9.0 // indirect
 	github.com/mattn/go-colorable v0.1.14 // indirect
@@ -60,13 +74,16 @@ require (
 	github.com/rivo/uniseg v0.4.7 // indirect
 	github.com/rogpeppe/go-internal v1.14.1 // indirect
 	github.com/russross/blackfriday/v2 v2.1.0 // indirect
+	github.com/samber/slog-common v0.20.0 // indirect
 	github.com/spf13/cast v1.10.0 // indirect
 	github.com/wk8/go-ordered-map/v2 v2.1.8 // indirect
 	github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e // indirect
 	github.com/yosida95/uritemplate/v3 v3.0.2 // indirect
 	go.yaml.in/yaml/v3 v3.0.4 // indirect
+	golang.org/x/crypto v0.46.0 // indirect
 	golang.org/x/exp v0.0.0-20250819193227-8b4c13bb791b // indirect
 	golang.org/x/term v0.38.0 // indirect
 	golang.org/x/text v0.32.0 // indirect
+	gopkg.in/tomb.v1 v1.0.0-20141024135613-dd632973f1e7 // indirect
 	gopkg.in/yaml.v3 v3.0.1 // indirect
 )