Documentation
¶
Overview ¶
Package config loads user configuration from ~/.kunji/config.yaml and applies profile / environment overrides to cobra flag defaults.
Resolution order, highest priority first:
- CLI flag passed on the command line (handled by cobra during parsing)
- KUNJI_<FLAG_UPPER> environment variable
- The active profile's value for that flag
- The built-in default registered with the flag
"Active profile" is determined by:
- --profile <name> on the command line
- KUNJI_PROFILE environment variable
- default_profile field in the config file
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func DefaultPath ¶
func DefaultPath() string
DefaultPath returns the location we look for config at. Resolution order:
KUNJI_CONFIG env var (explicit override) ~/.kunji/config.yaml .kunji/config.yaml (cwd fallback)
Types ¶
type Config ¶
type Config struct {
Path string
// contains filtered or unexported fields
}
Config holds the parsed config plus the path it was loaded from. A zero Config (Path == "") is valid and means "no config file present".
func Load ¶
Load reads the config file at DefaultPath(). A missing file is not an error — it returns an empty Config so callers can use Apply unconditionally. Parse errors are returned so the user can fix a malformed config.
func (*Config) ActiveProfileName ¶
ActiveProfileName returns the profile to use. Resolution order:
--profile flag value (passed in via cliProfile) KUNJI_PROFILE env var default_profile from the config "" (caller treats this as "no profile")
func (*Config) Apply ¶
Apply walks the cobra command tree (rootCmd and every descendant) and overrides each flag's default with the value from the active profile or the environment. CLI flags passed on the command line still win because cobra only falls back to the default when a flag was not provided.
The env-var-name for a flag "foo-bar" is "KUNJI_FOO_BAR".
func (*Config) Lookup ¶
Lookup returns the value for key from the active profile (or the top-level default block if profileName is ""), and a found flag. Lookup returns the value for key from the active profile (or the top-level default block if profileName is ""), and a found flag.
Keys are normalized: dashes and underscores are interchangeable so users can write either `only_valid: true` or `only-valid: true` in YAML.
func (*Config) ProfileNames ¶
ProfileNames returns the configured profile names sorted alphabetically.
Source Files