runner

Documentation

Index

• Variables
• func IsBadActionError(err error) bool
• func NewBadActionError(actionName, problem string) error
• type Context
• type Factory
  • func NewFactory(state *uniter.State, paths context.Paths, ...) (Factory, error)
• type Runner
  • func NewRunner(context Context, paths context.Paths) Runner

Variables

var ErrActionNotAvailable = errors.New("action no longer available")

Functions

func IsBadActionError

func IsBadActionError(err error) bool

func NewBadActionError

func NewBadActionError(actionName, problem string) error

Types

type Context

type Context interface {
	jujuc.Context
	Id() string
	HookVars(paths context.Paths) ([]string, error)
	ActionData() (*context.ActionData, error)
	SetProcess(process context.HookProcess)
	HasExecutionSetUnitStatus() bool
	ResetExecutionSetUnitStatus()

	Prepare() error
	Flush(badge string, failure error) error
}

Context exposes jujuc.Context, and additional methods needed by Runner.

type Factory

type Factory interface {

	// NewCommandRunner returns an execution context suitable for running
	// an arbitrary script.
	NewCommandRunner(commandInfo context.CommandInfo) (Runner, error)

	// NewHookRunner returns an execution context suitable for running the
	// supplied hook definition (which must be valid).
	NewHookRunner(hookInfo hook.Info) (Runner, error)

	// NewActionRunner returns an execution context suitable for running the
	// action identified by the supplied id.
	NewActionRunner(actionId string) (Runner, error)
}

Factory represents a long-lived object that can create runners relevant to a specific unit.

func NewFactory

func NewFactory(
	state *uniter.State,
	paths context.Paths,
	contextFactory context.ContextFactory,
) (
	Factory, error,
)

NewFactory returns a Factory capable of creating runners for executing charm hooks, actions and commands.

type Runner

type Runner interface {

	// Context returns the context against which the runner executes.
	Context() Context

	// RunHook executes the hook with the supplied name.
	RunHook(name string) error

	// RunAction executes the action with the supplied name.
	RunAction(name string) error

	// RunCommands executes the supplied script.
	RunCommands(commands string) (*utilexec.ExecResponse, error)
}

Runner is responsible for invoking commands in a context.

func NewRunner

func NewRunner(context Context, paths context.Paths) Runner

NewRunner returns a Runner backed by the supplied context and paths.