Code structure

The datumctl codebase is organized primarily within the internal directory, following common Go practices.

• internal/cmd/: Contains the definitions for all CLI commands, structured using the Cobra library.
  • internal/cmd/auth/: Commands related to authentication (login, logout, list, get-token, update-kubeconfig).
  • internal/cmd/organizations/: Commands for managing organization resources (currently list).
  • internal/cmd/root.go: Defines the root datumctl command and ties subcommands together.
• internal/authutil/: Provides shared utilities and types specifically for authentication handling.
  • credentials.go: Defines the StoredCredentials struct, functions for interacting with the keyring (GetActiveCredentials, GetStoredCredentials), OIDC token source creation (GetTokenSource), and hostname derivation (DeriveAPIHostname). Constants for keyring service/keys are also defined here.
• internal/keyring/: A simple wrapper around the go-keyring library, primarily adding timeouts to keyring operations.
• internal/output/: Contains helpers for formatting CLI output (e.g., CLIPrint for tables, JSON, YAML).
• internal/resourcemanager/: (Example) Likely contains clients and logic for interacting with specific Datum Cloud API resource types (like Organizations).

• main.go: The main application entrypoint. It typically sets up and executes the root Cobra command defined in internal/cmd/root.go.

Key external dependencies include:

• github.com/spf13/cobra: CLI framework.
• golang.org/x/oauth2: OAuth2 client library.
• github.com/coreos/go-oidc/v3/oidc: OpenID Connect client library.
• github.com/zalando/go-keyring: Secure credential storage.
• k8s.io/client-go/tools/clientcmd: Kubernetes client configuration API (for update-kubeconfig).
• github.com/pkg/browser: For opening the web browser during login.