diff options
Diffstat (limited to 'config/dispenser.go')
-rw-r--r-- | config/dispenser.go | 159 |
1 files changed, 0 insertions, 159 deletions
diff --git a/config/dispenser.go b/config/dispenser.go deleted file mode 100644 index 13cd85425..000000000 --- a/config/dispenser.go +++ /dev/null @@ -1,159 +0,0 @@ -package config - -import ( - "errors" - "fmt" -) - -// dispenser is a type that dispenses tokens, similarly to -// a lexer, except that it can do so with some notion of -// structure. Its methods implement part of the -// middleware.Controller interface, so refer to that -// documentation for more info. -type dispenser struct { - filename string - cursor int - nesting int - tokens []token -} - -// Next loads the next token. Returns true if a token -// was loaded; false otherwise. If false, all tokens -// have already been consumed. -func (d *dispenser) Next() bool { - if d.cursor < len(d.tokens)-1 { - d.cursor++ - return true - } - return false -} - -// NextArg loads the next token if it is on the same -// line. Returns true if a token was loaded; false -// otherwise. If false, all tokens on the line have -// been consumed. -func (d *dispenser) NextArg() bool { - if d.cursor < 0 { - d.cursor++ - return true - } - if d.cursor >= len(d.tokens) { - return false - } - if d.cursor < len(d.tokens)-1 && - d.tokens[d.cursor].line == d.tokens[d.cursor+1].line { - d.cursor++ - return true - } - return false -} - -// NextLine loads the next token only if it is not on the same -// line as the current token, and returns true if a token was -// loaded; false otherwise. If false, there is not another token -// or it is on the same line. -func (d *dispenser) NextLine() bool { - if d.cursor < 0 { - d.cursor++ - return true - } - if d.cursor >= len(d.tokens) { - return false - } - if d.cursor < len(d.tokens)-1 && - d.tokens[d.cursor].line < d.tokens[d.cursor+1].line { - d.cursor++ - return true - } - return false -} - -// NextBlock can be used as the condition of a for loop -// to load the next token as long as it opens a block or -// is already in a block. It returns true if a token was -// loaded, or false when the block's closing curly brace -// was loaded and thus the block ended. Nested blocks are -// not (currently) supported. -func (d *dispenser) NextBlock() bool { - if d.nesting > 0 { - d.Next() - if d.Val() == "}" { - d.nesting-- - return false - } - return true - } - if !d.NextArg() { // block must open on same line - return false - } - if d.Val() != "{" { - d.cursor-- // roll back if not opening brace - return false - } - d.Next() - d.nesting++ - return true -} - -// Val gets the text of the current token. If there is no token -// loaded, it returns empty string. -func (d *dispenser) Val() string { - if d.cursor < 0 || d.cursor >= len(d.tokens) { - return "" - } else { - return d.tokens[d.cursor].text - } -} - -// Args is a convenience function that loads the next arguments -// (tokens on the same line) into an arbitrary number of strings -// pointed to in targets. If there are fewer tokens available -// than string pointers, the remaining strings will not be changed -// and false will be returned. If there were enough tokens available -// to fill the arguments, then true will be returned. -func (d *dispenser) Args(targets ...*string) bool { - enough := true - for i := 0; i < len(targets); i++ { - if !d.NextArg() { - enough = false - break - } - *targets[i] = d.Val() - } - return enough -} - -// RemainingArgs loads any more arguments (tokens on the same line) -// into a slice and returns them. Open curly brace tokens also indicate -// the end of arguments, and the curly brace is not included in -// the return value nor is it loaded. -func (d *dispenser) RemainingArgs() []string { - var args []string - - for d.NextArg() { - if d.Val() == "{" { - d.cursor-- - break - } - args = append(args, d.Val()) - } - - return args -} - -// ArgErr returns an argument error, meaning that another -// argument was expected but not found. In other words, -// a line break or open curly brace was encountered instead of -// an argument. -func (d *dispenser) ArgErr() error { - if d.Val() == "{" { - return d.Err("Unexpected token '{', expecting argument") - } - return d.Err("Wrong argument count or unexpected line ending after '" + d.Val() + "'") -} - -// Err generates a custom parse error with a message of msg. -func (d *dispenser) Err(msg string) error { - msg = fmt.Sprintf("%s:%d - Parse error: %s", d.filename, d.tokens[d.cursor].line, msg) - return errors.New(msg) -} |