Documentation
¶
Overview ¶
Package ast implements a (low level) parser and parse tree dumper for Dockerfiles.
Index ¶
Constants ¶
const DefaultEscapeToken = '\\'
DefaultEscapeToken is the default escape token
const (
UnknownInstMsg = "unknown instruction"
)
Variables ¶
var (
ErrDockerfileNotStringArray = errors.New("when using JSON array syntax, arrays must be comprised of strings only")
)
var (
ErrDockerfileUnknownInst = errors.New(UnknownInstMsg)
)
Functions ¶
This section is empty.
Types ¶
type Directive ¶
type Directive struct {
// contains filtered or unexported fields
}
Directive is the structure used during a build run to hold the state of parsing directives.
func NewDefaultDirective ¶
func NewDefaultDirective() *Directive
NewDefaultDirective returns a new Directive with the default escapeToken token
type NameValError ¶
type NameValError struct {
ParseError
}
type NewFormatNameValError ¶
type NewFormatNameValError struct {
NameValError
}
type Node ¶
type Node struct {
IsValid bool
Errors []string
Value string // actual content
ArgsRaw string
Next *Node // the next item in the current sexp
Children []*Node // the children of this sexp
Attributes map[string]bool // special attributes for this node
Original string // original line used before parsing
Flags []string // only top Node should have this set
StartLine int // the line in the original dockerfile where the node begins
EndLine int // the line in the original dockerfile where the node ends
}
Node is a structure used to represent a parse tree.
In the node there are three fields, Value, Next, and Children. Value is the current token's string value. Next is always the next non-child token, and children contains all the children. Here's an example:
(value next (child child-next child-next-next) next-next)
This data structure is frankly pretty lousy for handling complex languages, but lucky for us the Dockerfile isn't very complicated. This structure works a little more effectively than a "proper" parse tree for our needs.
type OldFormatNameValError ¶
type OldFormatNameValError struct {
NameValError
}
type ParseError ¶
func (ParseError) Error ¶
func (e ParseError) Error() string
Source Files