bootstrap

Documentation

Index

• Constants
• func AddAptPackages(ctx *Context, names ...string)
• func ChangedAptSources(ctx *Context)
• func Configure(opts ...option)
• func Get[T any](ctx *Context, k InfoKey[T]) (T, bool)
• func NewPlan() *plan
• func Run(ctx context.Context) error
• func Save[T any](ctx *Context, k InfoKey[T], v T)
• func Set[T any](ctx *Context, k InfoKey[T], v T)
• func Sim(ctx context.Context) error
• func WithAptPackages(stepName string, packages ...string) option
• func WithChildCmdBuilders(fns ...func() *cobra.Command) option
• func WithChildCmds(cmds ...*cobra.Command) option
• func WithExtraAptInstall(name string, opts ...StepOpt) option
• func WithExtraAptUpdate(name string, opts ...StepOpt) option
• func WithSteps(steps ...*Step) option
• type Context
  • func NewContext(ctx context.Context) *Context
• type InfoKey
  • func NewKey[T any](name string) InfoKey[T]
• type Step
  • func AddAptPackagesStep(stepName string, packages ...string) *Step
  • func NewStep(name string, run func(*Context) error, opts ...StepOpt) *Step
  • func (s *Step) With(opts ...StepOpt) *Step
• type StepOpt
  • func AfterSteps(names ...string) StepOpt
  • func BeforeSteps(names ...string) StepOpt
  • func SimFunc(f func(*Context) error) StepOpt

Constants

const StepNameAptInstall = "apt install"

Name of the step registered by [AddAptInstall]. This step will install pending packages enqueued with AddAptPackages. Set any step that uses that to be before this step.

const StepNameAptUpdate = "apt update"

Name of the step registered by [AddAptUpdate]. Steps that modify apt sources should reference this as a `before` constraint.

Functions

func AddAptPackages

func AddAptPackages(ctx *Context, names ...string)

AddAptPackages adds the given package names to the pending list of packages to install. They will be installed by the next `apt install` step, either the "main" one, or one registered by WithExtraAptInstall.

The caller is responsible for ensuring that such a step runs after this.

func ChangedAptSources

func ChangedAptSources(ctx *Context)

ChangedAptSources will mark the apt sources list as dirty, so a secondary `apt update` step registered with WithExtraAptUpdate will actually run.

func Configure

func Configure(opts ...option)

func Get

func Get[T any](ctx *Context, k InfoKey[T]) (T, bool)

func NewPlan

func NewPlan() *plan

func Run

func Run(ctx context.Context) error

func Save

func Save[T any](ctx *Context, k InfoKey[T], v T)

func Set

func Set[T any](ctx *Context, k InfoKey[T], v T)

func Sim

func Sim(ctx context.Context) error

func WithAptPackages

func WithAptPackages(
	stepName string,
	packages ...string,
) option

WithAptPackages is an option for Configure that will register a step to mark the given package(s) to be installed by the main `apt install` step.

func WithChildCmdBuilders

func WithChildCmdBuilders(fns ...func() *cobra.Command) option

func WithChildCmds

func WithChildCmds(cmds ...*cobra.Command) option

func WithExtraAptInstall

func WithExtraAptInstall(name string, opts ...StepOpt) option

WithExtraAptInstall adds a secondary `apt install` step with the given name. It will always run after the main `apt install` step. You may pass additional ordering constraints in the options.

You likely want to pair this with WithExtraAptUpdate, one or more steps to add new apt sources that call ChangedAptSources and AddAptPackages.

func WithExtraAptUpdate

func WithExtraAptUpdate(name string, opts ...StepOpt) option

WithExtraAptUpdate adds a secondary `apt update` step with the given name. It will always run after the main `apt update` step. You may pass additional ordering constraints in the options.

func WithSteps

func WithSteps(steps ...*Step) option

Types

type Context

type Context = internal.Context

func NewContext

func NewContext(ctx context.Context) *Context

type InfoKey

type InfoKey[T any] = internal.InfoKey[T]

func NewKey

func NewKey[T any](name string) InfoKey[T]

type Step

type Step struct {
	// contains filtered or unexported fields
}

func AddAptPackagesStep

func AddAptPackagesStep(
	stepName string,
	packages ...string,
) *Step

func NewStep

func NewStep(
	name string,
	run func(*Context) error,
	opts ...StepOpt,
) *Step

NewStep creates a new bootstrap step with the given name and run function.

Dependencies, simulation (dry-run) mode special case, and other options can be set via the additional option arguments.

func (*Step) With

func (s *Step) With(opts ...StepOpt) *Step

type StepOpt

type StepOpt func(*Step)

func AfterSteps

func AfterSteps(names ...string) StepOpt

AfterSteps adds normal dependencies to the step

func BeforeSteps

func BeforeSteps(names ...string) StepOpt

BeforeSteps adds reverse dependencies to the step

func SimFunc

func SimFunc(f func(*Context) error) StepOpt

SimFunc sets the simulation function that will be run instead of just printing the step name in Sim (dry run) invocations.