internal

type ClientConfig interface {
	// RawConfig returns the merged result of all overrides
	RawConfig() (cmdutils.Config, error)
	// ConfigAccess returns the rules for loading/persisting the config.
	ConfigAccess() ConfigAccess
}

type ClientConfigLoader interface {
	ConfigAccess
	// Load returns the latest config
	Load() (*cmdutils.Config, error)
}

type ClientConfigLoadingRules struct {
	Precedence []string

	// MigrationRules is a map of destination files to source files.  If a destination file is not present,
	// then the source file is checked.
	// If the source file is present, then it is copied to the destination file BEFORE any further loading happens.
	MigrationRules map[string]string

	// DoNotResolvePaths indicates whether or not to resolve paths with respect to the originating files.
	// This is phrased as a negative so that a default object that doesn't set this will usually get
	// the behavior it wants.
	DoNotResolvePaths bool

	// DefaultClientConfig is an optional field indicating what rules to use to calculate a default configuration.
	// This should match the overrides passed in to ClientConfig loader.
	DefaultClientConfig ClientConfig

	// WarnIfAllMissing indicates whether the configuration files pointed by pulsarCONFIG environment
	// variable are present or not.
	// In case of missing files, it warns the user about the missing files.
	WarnIfAllMissing bool
}

type ConfigAccess interface {
	// GetLoadingPrecedence returns the slice of files that should be used for loading and inspecting the config
	GetLoadingPrecedence() []string
	// GetStartingConfig returns the config that subcommands should being operating against.
	// It may or may not be merged depending on loading rules
	GetStartingConfig() (*cmdutils.Config, error)
	// GetDefaultFilename returns the name of the file you should write into (create if necessary),
	// if you're trying to create a new stanza as opposed to updating an existing one.
	GetDefaultFilename() string
}

type DeferredLoadingClientConfig struct {
	// contains filtered or unexported fields
}

type DirectClientConfig struct {
	// contains filtered or unexported fields
}

type PathOptions struct {
	// GlobalFile is the full path to the file to load as the global (final) option
	GlobalFile string

	// GlobalFileSubpath is an optional value used for displaying help
	GlobalFileSubpath string

	LoadingRules *ClientConfigLoadingRules
}