package env

import "gotest.tools/v3/env"

Package env provides functions to test code that read environment variables or the current working directory.

Index ¶

• func ChangeWorkingDir(t assert.TestingT, dir string) func()
• func Patch(t assert.TestingT, key, value string) func()
• func PatchAll(t assert.TestingT, env map[string]string) func()
• func ToMap(env []string) map[string]string

Examples ¶

• Patch
• PatchAll

Functions ¶

func ChangeWorkingDir ¶

func ChangeWorkingDir(t assert.TestingT, dir string) func()

ChangeWorkingDir to the directory, and return a function which restores the previous working directory.

When used with Go 1.14+ the previous working directory will be restored automatically when the test ends, unless the TEST_NOCLEANUP env var is set to true.

func Patch ¶

func Patch(t assert.TestingT, key, value string) func()

Patch changes the value of an environment variable, and returns a function which will reset the the value of that variable back to the previous state.

When used with Go 1.14+ the unpatch function will be called automatically when the test ends, unless the TEST_NOCLEANUP env var is set to true.

Deprecated: use t.SetEnv

{
	defer Patch(t, "PATH", "/custom/path")()
}

func PatchAll ¶

func PatchAll(t assert.TestingT, env map[string]string) func()

PatchAll sets the environment to env, and returns a function which will reset the environment back to the previous state.

When used with Go 1.14+ the unpatch function will be called automatically when the test ends, unless the TEST_NOCLEANUP env var is set to true.

{
	defer PatchAll(t, map[string]string{
		"ONE": "FOO",
		"TWO": "BAR",
	})()
}

func ToMap ¶

func ToMap(env []string) map[string]string

ToMap takes a list of strings in the format returned by os.Environ and returns a mapping of keys to values.

Source Files ¶

env.go