Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

config

package

Go to main page

Versions in this module

v1

v1.1.0-rc.1

Aug 24, 2026

v1.0.0

Aug 12, 2026

Changes in this version

+ const DefaultProfileName

+ const EnvAPIKey

+ const EnvLegacyAPIKey

+ const ReservedProfileName

+ var ErrNoProfile = errors.New("no profile configured")

+ var ErrProfileExists = errors.New("profile already exists")

+ var ErrProfileNotFound = errors.New("profile not found")

+ func ValidateProfileName(name string) error

type Config

+ CurrentProfile string

+ Profiles map[string]Profile

+ func Edit(mutate func(*Config) error) (Config, error)

+ func (c *Config) AddProfile(name string, profile Profile) error

+ func (c *Config) RemoveProfile(name string) error

+ func (c *Config) UpdateProfile(name string, profile Profile) error

+ func (c *Config) UseProfile(name string) error

+ func (c Config) Profile(name string) (Profile, error)

+ func (c Config) ProfileNames() []string

+ func (c Config) Resolve(profileName string) (Resolved, error)

+ type Profile struct

+ APIKey string

+ APIURL string

+ type Resolved struct

+ APIKey string

+ APIKeySource Source

+ APIURL string

+ APIURLSource Source

+ ConfigError error

+ EnvIgnored []string

+ MissingCurrentProfile string

+ Profile string

+ ProfilesConfigured bool

+ func Resolve(profileName string) (Resolved, error)

+ type Source string

+ const SourceDefault

+ const SourceEnvironment

+ const SourceProfile

v0

v0.2.0

Jun 29, 2026

v0.1.0

Jun 25, 2026

Changes in this version

+ const DefaultAPIURL

+ const EnvAPIURL

+ const EnvServiceKey

+ func ApplyEnv(cfg *Config)

+ func Path() (string, error)

+ func Save(cfg Config) error

+ type Config struct

+ APIURL string

+ ServiceKey string

+ func Default() Config

+ func Load() (Config, error)

+ func LoadWithEnv() (Config, error)