environment

Documentation

Overview

Package environment providies utilities for managing environment variables.

Index

• func Initialize(wd string) ([]string, error)
• func Map(key string, env []string) string
• func Mapper(str string, env []string) (string, error)
• func Merge(orig, update []string) []string
• func Prune(env []string) []string
• func SliceMapper(slice []string, env []string) ([]string, error)

Functions

func Initialize

func Initialize(wd string) ([]string, error)

Initialize sets a bunch of environment variables and then returns the name of them in a string slice. It will also determine what version control, if any is in use, and set variables for it as well.

func Map

func Map(key string, env []string) string

Map will return the value matching a KEY=VAL pair in the given environment.

func Mapper

func Mapper(str string, env []string) (string, error)

Mapper will replace ${TEMPLATE} patterns in the string with the KEY=VAL pairs in the given environment. This function will replace patterns recursively, so if VAL has the form ${TEMPLATE}, it will be replaced again.

func Merge

func Merge(orig, update []string) []string

Merge combines two environments and returns the result.

func Prune

func Prune(env []string) []string

Prune removes all empty-value variables from the environment.

func SliceMapper

func SliceMapper(slice []string, env []string) ([]string, error)

SliceMapper calls Mapper for each item in a slice and returns a new slice.