liquid/template.go

package liquid

import (
	"bytes"

	"github.com/osteele/liquid/render"
)

// A Template is a compiled Liquid template. It knows how to evaluate itself within a variable binding environment, to create a rendered byte slice.
//
// Use Engine.ParseTemplate to create a template.
type Template struct {
	root   render.Node
	config *render.Config
}

func newTemplate(cfg *render.Config, source []byte) (*Template, SourceError) {
	root, err := cfg.Compile(string(source))
	if err != nil {
		return nil, err
	}
	return &Template{root, cfg}, nil
}

// Render executes the template with the specified variable bindings.
func (t *Template) Render(vars Bindings) ([]byte, SourceError) {
	buf := new(bytes.Buffer)
	err := render.Render(t.root, buf, vars, *t.config)
	if err != nil {
		return nil, err
	}
	return buf.Bytes(), nil
}

// RenderString is a convenience wrapper for Render, that has string input and output.
func (t *Template) RenderString(b Bindings) (string, SourceError) {
	bs, err := t.Render(b)
	if err != nil {
		return "", err
	}
	return string(bs), nil
}

// SetSourcePath sets the filename. This is used for error reporting,
// and as the reference path for relative pathnames in the {% include %} tag.
func (t *Template) SetSourcePath(filename string) {
	t.config.SourcePath = filename
}

// SetSourceLocation sets the source path as SetSourcePath, and also
// the line number of the first line of the template text, for use in
// error reporting.
func (t *Template) SetSourceLocation(filename string, lineNo int) {
	t.config.SourcePath = filename
	t.config.LineNo = lineNo
}