v1

Documentation

Index

• Constants
• type EnvsMap
  • func (e EnvsMap) Combine(e2 EnvsMap) EnvsMap
  • func (e EnvsMap) Format() []string
• type HookSpec
  • func (h *HookSpec) Run(envs EnvsMap, output bool) error
• type HooksMap
  • func (h HooksMap) Run(name string, envs EnvsMap, output bool) error
• type Spec

Constants

const Version = "v1"

Version indicates the version of the 'Spec' struct used to hold 'Hooks' information.

Types

type EnvsMap

type EnvsMap map[string]string

EnvsMap holds the (key, value) pairs associated with a set of environment variables.

func (EnvsMap) Combine

func (e EnvsMap) Combine(e2 EnvsMap) EnvsMap

Combine merges to EnvMaps together Overlapping enviroment variables from e2 take precendence over those in e.

func (EnvsMap) Format

func (e EnvsMap) Format() []string

Format converts an EnvMap into a list of strings, where each entry is of the form "key=value".

type HookSpec

type HookSpec struct {
	Command string   `json:"command"`
	Args    []string `json:"args"`
	Envs    EnvsMap  `json:"envs"`
	Workdir string   `json:"workdir"`
}

HookSpec holds the actual data associated with a runnable Hook.

func (*HookSpec) Run

func (h *HookSpec) Run(envs EnvsMap, output bool) error

Run executes a specific hook from a HookSpec. It injects the environment variables associated with the provided EnvMap, and optionally prints the output for each hook to stdout and stderr.

type HooksMap

type HooksMap map[string][]HookSpec

HooksMap holds (key, value) pairs mapping a list of HookSpec's to a named hook.

func (HooksMap) Run

func (h HooksMap) Run(name string, envs EnvsMap, output bool) error

Run executes all of the hooks associated with a given name in the HooksMap. It injects the environment variables associated with the provided EnvMap, and optionally prints the output for each hook to stdout and stderr.

type Spec

type Spec struct {
	Version string   `json:"version"`
	Hooks   HooksMap `json:"hooks"`
}

Spec is a versioned struct used to hold 'Hooks' information.