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 is a convenience function that loads any more arguments // (tokens on the same line) into a slice and returns them. Open curly // brace tokens indicate the end of arguments (the curly brace is not // included). 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("Unexpected line break after '" + d.Val() + "' (missing arguments?)") } // 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) }