templating

Documentation

Index

• func FuncMap() template.FuncMap
• func LoadAndRenderSteps(template *Template, opts *BaseRenderOptions) (string, error)
• type BaseRenderOptions
• type Config
  • func LoadConfig(path string) (*Config, error)
  • func (c *Config) GetRawValue() string
  • func (c *Config) GetValues() map[string]*Value
  • func (c *Config) IsValidConfig() bool
• type Engine
  • func NewEngine() *Engine
  • func (e *Engine) Render(t *Template, values Values) (map[string]string, error)
• type Template
  • func LoadTemplate(path string) (*Template, error)
  • func (t *Template) GetData() []byte
  • func (t *Template) GetName() string
• type Value
  • func (v *Value) GetValue() string
• type Values
  • func Deserialize(b []byte) (v Values, err error)
  • func DeserializeFromFile(fileName string) (Values, error)
  • func OverrideValues(c1 *Config, c2 *Config) (Values, error)
  • func OverrideValuesWithBuildInfo(c1 *Config, c2 *Config, options *BaseRenderOptions) (Values, error)
  • func (v Values) ToYAMLString() (string, error)

Functions

func FuncMap

func FuncMap() template.FuncMap

FuncMap returns a FuncMap representing all of the functionality of the engine.

func LoadAndRenderSteps

func LoadAndRenderSteps(template *Template, opts *BaseRenderOptions) (string, error)

LoadAndRenderSteps loads a template file and renders it according to an optional values file, --set values, and base render options.

Types

type BaseRenderOptions

type BaseRenderOptions struct {
	// Path to the steps file. Required.
	StepsFile string

	// Path to a values file. Optional.
	ValuesFile string

	// Override values. Optional.
	TemplateValues []string

	// ID is the build ID. Required.
	ID string

	// Commit is the commit used when running the build. Optional.
	Commit string

	// Repository is the repository used when running the build. Optional.
	Repository string

	// Branch is the branch used when running the build. Optional.
	Branch string

	// TriggeredBy is the reason the build was triggered. Required.
	TriggeredBy string

	// GitTag is a Git tag. Optional.
	GitTag string

	// Registry is the ACR being used. Optional.
	Registry string

	// Date is the date of the Build. Required.
	Date time.Time
}

BaseRenderOptions represents additional information for the composition of the final rendering.

type Config

type Config struct {
	RawValue string
	Values   map[string]*Value
}

Config represents configuration values.

func LoadConfig

func LoadConfig(path string) (*Config, error)

LoadConfig creates a Config from the specified path.

func (*Config) GetRawValue

func (c *Config) GetRawValue() string

GetRawValue returns the Config's value as a string.

func (*Config) GetValues

func (c *Config) GetValues() map[string]*Value

GetValues returns the Config's values.

func (*Config) IsValidConfig

func (c *Config) IsValidConfig() bool

IsValidConfig determines whether or not the Config is valid.

type Engine

type Engine struct {
	FuncMap    template.FuncMap
	StrictMode bool
}

Engine is a wrapper around Go templates.

func NewEngine

func NewEngine() *Engine

NewEngine creates a new engine.

func (*Engine) Render

func (e *Engine) Render(t *Template, values Values) (map[string]string, error)

Render renders a template.

type Template

type Template struct {
	Name string
	Data []byte
}

Template represents a template.

func LoadTemplate

func LoadTemplate(path string) (*Template, error)

LoadTemplate loads a Template from the specified path.

func (*Template) GetData

func (t *Template) GetData() []byte

GetData returns a Template's data.

func (*Template) GetName

func (t *Template) GetName() string

GetName returns a Template's name.

type Value

type Value struct {
	Value string
}

Value represents a configuration value.

func (*Value) GetValue

func (v *Value) GetValue() string

GetValue returns the Value's value.

type Values

type Values map[string]interface{}

Values represents a map of build values.

func Deserialize

func Deserialize(b []byte) (v Values, err error)

Deserialize will convert the specified bytes to a Values object.

func DeserializeFromFile

func DeserializeFromFile(fileName string) (Values, error)

DeserializeFromFile will parse the specified file name and convert it to a Values object.

func OverrideValues

func OverrideValues(c1 *Config, c2 *Config) (Values, error)

OverrideValues overrides the first config with the second.

func OverrideValuesWithBuildInfo

func OverrideValuesWithBuildInfo(c1 *Config, c2 *Config, options *BaseRenderOptions) (Values, error)

OverrideValuesWithBuildInfo overrides the specified config's values and provides a default set of values.

func (Values) ToYAMLString

func (v Values) ToYAMLString() (string, error)

ToYAMLString encodes the Values object into a YAML string.