parse

type Env ¶

type Env []string

func (e Env) Get(name string) string

func (e Env) Has(name string) bool

func (e Env) Lookup(name string) (string, bool)

type Mode ¶ added in v1.2.0

type Mode int

A mode value is a set of flags (or 0). They control parser behavior.

const (
	Quick     Mode = iota // stop parsing after first error encoutered and return
	AllErrors             // report all errors
)

type Node ¶

type Node interface {
	Type() NodeType
	String() (string, error)
}

type NodeType ¶

type NodeType int

NodeType identifies the type of a node.

const (
	NodeText NodeType = iota
	NodeSubstitution
	NodeVariable
)

func (t NodeType) Type() NodeType

type Parser ¶

type Parser struct {
	Name     string // name of the processing template
	Env      Env
	Restrict *Restrictions
	Mode     Mode
	// contains filtered or unexported fields
}

Parser type initializer

func New(name string, env []string, r *Restrictions) *Parser

func (p *Parser) Parse(text string) (string, error)

type Pos ¶

type Pos int

Pos represents a byte position in the original input text from which this template was parsed.

type Restrictions ¶

type Restrictions struct {
	NoUnset bool
	NoEmpty bool
	NoDigit bool
}

The restrictions option controls the parsring restriction.

type SubstitutionNode ¶

type SubstitutionNode struct {
	NodeType
	ExpType  itemType
	Variable *VariableNode
	Default  Node // Default could be variable or text
}

func (t *SubstitutionNode) String() (string, error)

type TextNode ¶

type TextNode struct {
	NodeType
	Text string
}

func NewText(text string) *TextNode

func (t *TextNode) String() (string, error)

type VariableNode ¶

type VariableNode struct {
	NodeType
	Ident    string
	Env      Env
	Restrict *Restrictions
}

func NewVariable(ident string, env Env, restrict *Restrictions) *VariableNode

func (t *VariableNode) String() (string, error)