exec

Documentation

Index

• func Run(cmd Cmd) (stdout string, stderr string, err error)
• func Which(arg string, cmds ...string) (cmd string, output string, err error)
• func WhichArgs(argv []string, cmds ...string) (cmd string, output string, err error)
• func WhichWithResolver(cmds []string, resolve WhichResolver) (string, string, error)
• type Cmd
• type WhichResolver

Functions

func Run

func Run(cmd Cmd) (stdout string, stderr string, err error)

Run executes a `Cmd`.

func Which

func Which(arg string, cmds ...string) (cmd string, output string, err error)

Which picks a command out of a list of candidates.

func WhichArgs

func WhichArgs(argv []string, cmds ...string) (cmd string, output string, err error)

WhichArgs is `Which` but passes multiple arguments to each candidate.

func WhichWithResolver

func WhichWithResolver(cmds []string, resolve WhichResolver) (string, string, error)

WhichWithResolver is `Which` with a custom resolution strategy.

Types

type Cmd

type Cmd struct {
	Name string   // Command name.
	Argv []string // Command arguments.
	Dir  string   // Command's working directory.

	// If neither Env nor WithEnv are set, the environment is inherited from os.Environ().
	Env     map[string]string // If set, the command's environment is _set_ to Env.
	WithEnv map[string]string // If set, the command's environment is _added_ to WithEnv.
}

Cmd represents a single command.

type WhichResolver

type WhichResolver func(cmd string) (output string, ok bool, err error)

A WhichResolver takes a candidate command and returns whether to choose it.