envfile

package

v0.6.1 Latest Latest Go to latest Published: Jun 16, 2026 License: MPL-2.0 Imports: 6 Imported by: 0

Details

Package envfile loads simple dotenv-style files without overriding process environment values.

This section is empty.

This section is empty.

func LookupPath(projectRoot string, explicit string) (string, bool, error)

LookupPath resolves the env file for a project root. explicit wins. Without an explicit path, .env.<GOWDK_ENV> wins over .env when it exists.

type Entry struct {
	Name  string
	Value string
}

Entry is one parsed env-file assignment.

func ParseFile(path string) ([]Entry, error)

ParseFile parses KEY=value and export KEY=value lines. Values may be quoted with single or double quotes. Blank lines and # comments are ignored.

type LoadResult struct {
	Path     string
	Loaded   bool
	Applied  []string
	Skipped  []string
	Explicit bool
}

LoadResult describes one env-file load without exposing values.

func LoadIntoEnv(path string, explicit bool) (LoadResult, error)

LoadIntoEnv loads path and sets only names that are not already present in the process environment. Existing process values always win.