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
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

environment

package

Go to main page

Versions in this module

v1

v1.31.0

Mar 11, 2026

v1.30.1

Mar 11, 2026

Changes in this version

+ type MapEnvProvider struct

+ func NewMapEnvProvider(vars map[string]string) *MapEnvProvider

+ func (p *MapEnvProvider) Get(_ context.Context, name string) (string, bool)

+ type NoEnvProvider struct

+ func NewNoEnvProvider() *NoEnvProvider

+ func (p *NoEnvProvider) Get(context.Context, string) (string, bool)

v1.30.0

Mar 9, 2026

Changes in this version

+ const DockerDesktopEmail

+ const DockerDesktopTokenEnv

+ const DockerDesktopUsername

+ const SandboxTokensFileName

+ func AbsolutePath(parentDir, relOrAbsPath string) (string, error)

+ func AbsolutePaths(parentDir string, relOrAbsPaths []string) ([]string, error)

+ func Expand(ctx context.Context, value string, env Provider) (string, error)

+ func ExpandAll(ctx context.Context, values []string, env Provider) ([]string, error)

+ func InSandbox() bool

+ func SandboxTokensFilePath(dir string) string

+ func ToValues(envMap map[string]string) []string

+ type CredentialHelperProvider struct

+ func NewCredentialHelperProvider(command string, args ...string) *CredentialHelperProvider

+ func (p *CredentialHelperProvider) Get(ctx context.Context, name string) (string, bool)

+ type DockerDesktopProvider struct

+ func NewDockerDesktopProvider() *DockerDesktopProvider

+ func (p *DockerDesktopProvider) Get(ctx context.Context, name string) (string, bool)

+ type EnvFilesProvider struct

+ func NewEnvFilesProvider(absEnvFiles []string) (*EnvFilesProvider, error)

+ func (p *EnvFilesProvider) Get(_ context.Context, name string) (string, bool)

+ type EnvListProvider struct

+ func NewEnvListProvider(env []string) *EnvListProvider

+ func (p *EnvListProvider) Get(_ context.Context, name string) (string, bool)

+ type KeyValuePair struct

+ Key string

+ Value string

+ func ReadEnvFile(absolutePath string) ([]KeyValuePair, error)

+ func ReadEnvFiles(absolutePaths []string) ([]KeyValuePair, error)

+ type KeychainNotAvailableError struct

+ func (KeychainNotAvailableError) Error() string

+ type KeychainProvider struct

+ func NewKeychainProvider() (*KeychainProvider, error)

+ func (p *KeychainProvider) Get(ctx context.Context, name string) (string, bool)

+ type MultiProvider struct

+ func NewMultiProvider(providers ...Provider) *MultiProvider

+ func (p *MultiProvider) Get(ctx context.Context, name string) (string, bool)

+ type OsEnvProvider struct

+ func NewOsEnvProvider() *OsEnvProvider

+ func (p *OsEnvProvider) Get(_ context.Context, name string) (string, bool)

+ type PassNotAvailableError struct

+ func (PassNotAvailableError) Error() string

+ type PassProvider struct

+ func NewPassProvider() (*PassProvider, error)

+ func (p *PassProvider) Get(ctx context.Context, name string) (string, bool)

+ type Provider interface

+ Get func(ctx context.Context, name string) (string, bool)

+ func NewDefaultProvider() Provider

+ type RequiredEnvError struct

+ Missing []string

+ func (e *RequiredEnvError) Error() string

+ type RunSecretsProvider struct

+ func NewRunSecretsProvider() *RunSecretsProvider

+ func (p *RunSecretsProvider) Get(_ context.Context, name string) (string, bool)

+ type SandboxTokenProvider struct

+ func NewSandboxTokenProvider(path string) *SandboxTokenProvider

+ func (p *SandboxTokenProvider) Get(_ context.Context, name string) (string, bool)

+ type SandboxTokenWriter struct

+ func NewSandboxTokenWriter(path string, provider Provider, interval time.Duration) *SandboxTokenWriter

+ func (w *SandboxTokenWriter) Start(ctx context.Context)

+ func (w *SandboxTokenWriter) Stop()