build

type Builder ¶

type Builder interface {
	Name() Kind
	// Detect reports whether this builder can build the tree in dir.
	Detect(dir string) bool
	Build(ctx context.Context, req Request, sink func(string)) error
}

type Dockerfile ¶

type Dockerfile struct {
	Run Runner
}

Dockerfile builds a tree with the Dockerfile at its root.

func (d Dockerfile) Build(ctx context.Context, req Request, sink func(string)) error

func (Dockerfile) Detect(dir string) bool

func (Dockerfile) Name() Kind

type Kind ¶

type Kind string

Kind names how a source runs: KindCompose for a tree that brings its own compose file, otherwise the Name of the builder that builds it.

const KindCompose Kind = "compose"

const KindDockerfile Kind = "dockerfile"

const KindRailpack Kind = "railpack"

type Railpack ¶

type Railpack struct {
	Run      Runner
	LookPath func(string) (string, error)
}

Railpack builds any tree by detecting its language and framework, so it accepts every directory and belongs last in a registry.

func (r Railpack) Build(ctx context.Context, req Request, sink func(string)) error

func (Railpack) Detect(string) bool

func (Railpack) Name() Kind

type Registry ¶

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

Registry holds builders in priority order.

func DefaultRegistry() *Registry

func NewRegistry(builders ...Builder) *Registry

func (r *Registry) Build(ctx context.Context, kind Kind, req Request, sink func(string)) error

func (r *Registry) Detect(dir string) Kind

func (r *Registry) Get(kind Kind) (Builder, bool)

type Request ¶

type Request struct {
	Dir     string
	Scratch string
	Tag     string
}

Request is one build: the source tree, a scratch directory outside it for builder-generated files, and the image tag to produce.

type Runner ¶

type Runner func(ctx context.Context, name string, args []string, sink func(string)) error

Runner executes one command, streaming its combined output lines to sink.