package root import ( "context" "fmt" "os" "strings" "github.com/databricks/bricks/internal/build" "github.com/databricks/bricks/libs/cmdio" "github.com/databricks/bricks/libs/log" "github.com/spf13/cobra" "golang.org/x/exp/slog" ) // RootCmd represents the base command when called without any subcommands var RootCmd = &cobra.Command{ Use: "bricks", Short: "Bricks CLI", // Cobra prints the usage string to stderr if a command returns an error. // This usage string should only be displayed if an invalid combination of flags // is specified and not when runtime errors occur (e.g. resource not found). // The usage string is include in [flagErrorFunc] for flag errors only. SilenceUsage: true, // Silence error printing by cobra. Errors are printed through cmdio. SilenceErrors: true, PersistentPreRunE: func(cmd *cobra.Command, args []string) error { ctx := cmd.Context() // Configure default logger. ctx, err := initializeLogger(ctx) if err != nil { return err } logger := log.GetLogger(ctx) logger.Info("start", slog.String("version", build.GetInfo().Version), slog.String("args", strings.Join(os.Args, ", "))) // Configure progress logger ctx, err = initializeProgressLogger(ctx) if err != nil { return err } // Configure our user agent with the command that's about to be executed. ctx = withCommandInUserAgent(ctx, cmd) ctx = withUpstreamInUserAgent(ctx) cmd.SetContext(ctx) return nil }, } // Wrap flag errors to include the usage string. func flagErrorFunc(c *cobra.Command, err error) error { return fmt.Errorf("%w\n\n%s", err, c.UsageString()) } // Execute adds all child commands to the root command and sets flags appropriately. // This is called by main.main(). It only needs to happen once to the rootCmd. func Execute() { // TODO: deferred panic recovery ctx := context.Background() // Run the command cmd, err := RootCmd.ExecuteContextC(ctx) if err != nil { // If cmdio logger initialization succeeds, then this function logs with the // initialized cmdio logger, otherwise with the default cmdio logger cmdio.LogError(cmd.Context(), err) } // Log exit status and error // We only log if logger initialization succeeded and is stored in command // context if logger, ok := log.FromContext(cmd.Context()); ok { if err == nil { logger.Info("completed execution", slog.String("exit_code", "0")) } else { logger.Error("failed execution", slog.String("exit_code", "1"), slog.String("error", err.Error())) } } if err != nil { os.Exit(1) } } func init() { RootCmd.SetFlagErrorFunc(flagErrorFunc) // The VS Code extension passes `-v` in debug mode and must be changed // to use the new flags in `./logger.go` prior to removing this flag. RootCmd.PersistentFlags().BoolP("verbose", "v", false, "") RootCmd.PersistentFlags().MarkHidden("verbose") }