Package env provides conveniences for working with environment variables, particularly in the context of executing external commands.

Change describes a change in a value in the environment.

type Change struct {
    Key    string
    MValue string
    NValue string
}

func (c Change) String() string

Diff describes differences between two environments, "M" and "N".

type Diff struct {
    OnlyInM Map
    Changes []Change
    OnlyInN Map
}

Map is a convenient representation of a set of environment variables.

type Map map[string]string

func Merge(maps ...Map) Map

Merge merges environment variable maps. In case of key collisions, values which appear later in the maps list take precedence.

func Parse(kvs ...string) Map

Parse parses a list of environment variables in "key=value" format. Values not in "key=value" format are ignored.

func Variables() Map

Variables returns a Map of the process environment.

func (m Map) Diff(n Map) Diff

Diff computes differences between m and n.

func (m Map) Encode() []string

Encode encodes the Map as a slice of "key=value" pairs, suitable for use with the os/exec package.

func (m Map) Format(s fmt.State, verb rune)

Format implements fmt.Formatter for Map as follows:

If the verb is anything but 'v', Format produces no output.

If the '+' flag is specified, Format emits newline separated "key=value" pairs. Otherwise, it emits space-separated "key=value" pairs.

Values are sorted lexicographically by key.

func (m Map) String() string

String encodes the Map as space-separated "key=value" pairs, sorted lexicographically by key.

acln.ro/env