blueprint/module_ctx.go

package blueprint

import (
	"fmt"
	"path/filepath"
)

type Module interface {
	GenerateBuildActions(ModuleContext)
}

type ModuleContext interface {
	ModuleName() string
	ModuleDir() string
	Config() Config

	ModuleErrorf(fmt string, args ...interface{})
	PropertyErrorf(property, fmt string, args ...interface{})

	Variable(name, value string)
	Rule(name string, params RuleParams, argNames ...string) Rule
	Build(params BuildParams)

	VisitDepsDepthFirst(visit func(Module))
	VisitDepsDepthFirstIf(pred func(Module) bool, visit func(Module))
}

var _ ModuleContext = (*moduleContext)(nil)

type moduleContext struct {
	context *Context
	config  Config
	module  Module
	scope   *localScope
	info    *moduleInfo

	errs []error

	actionDefs localBuildActions
}

func (m *moduleContext) ModuleName() string {
	return m.info.properties.Name
}

func (m *moduleContext) ModuleDir() string {
	return filepath.Dir(m.info.relBlueprintFile)
}

func (m *moduleContext) Config() Config {
	return m.config
}

func (m *moduleContext) ModuleErrorf(format string, args ...interface{}) {
	m.errs = append(m.errs, &Error{
		Err: fmt.Errorf(format, args...),
		Pos: m.info.pos,
	})
}

func (m *moduleContext) PropertyErrorf(property, format string,
	args ...interface{}) {

	pos, ok := m.info.propertyPos[property]
	if !ok {
		panic(fmt.Errorf("property %q was not set for this module", property))
	}

	m.errs = append(m.errs, &Error{
		Err: fmt.Errorf(format, args...),
		Pos: pos,
	})
}

func (m *moduleContext) Variable(name, value string) {
	v, err := m.scope.AddLocalVariable(name, value)
	if err != nil {
		panic(err)
	}

	m.actionDefs.variables = append(m.actionDefs.variables, v)
}

func (m *moduleContext) Rule(name string, params RuleParams,
	argNames ...string) Rule {

	// TODO: Verify that params.Pool is accessible in this module's scope.

	r, err := m.scope.AddLocalRule(name, &params, argNames...)
	if err != nil {
		panic(err)
	}

	m.actionDefs.rules = append(m.actionDefs.rules, r)

	return r
}

func (m *moduleContext) Build(params BuildParams) {
	// TODO: Verify that params.Rule is accessible in this module's scope.

	def, err := parseBuildParams(m.scope, &params)
	if err != nil {
		panic(err)
	}

	m.actionDefs.buildDefs = append(m.actionDefs.buildDefs, def)
}

func (m *moduleContext) VisitDepsDepthFirst(visit func(Module)) {
	m.context.visitDepsDepthFirst(m.module, visit)
}

func (m *moduleContext) VisitDepsDepthFirstIf(pred func(Module) bool,
	visit func(Module)) {

	m.context.visitDepsDepthFirstIf(m.module, pred, visit)
}