Making more messes with parser config

argh/argh.go

@@ -26,7 +26,7 @@ func tracef(format string, v ...any) {
 		return
 	}
 
-	if _, file, line, ok := runtime.Caller(2); ok {
+	if _, file, line, ok := runtime.Caller(1); ok {
 		format = fmt.Sprintf("%v:%v ", filepath.Base(file), line) + format
 	}
 

argh/cmd/argh-example/main.go

@@ -0,0 +1,46 @@
+package main
+
+import (
+	"encoding/json"
+	"fmt"
+	"log"
+	"os"
+
+	"git.meatballhat.com/x/box-o-sand/argh"
+	"github.com/davecgh/go-spew/spew"
+)
+
+func main() {
+	asJSON := os.Getenv("ARGH_OUTPUT_JSON") == "enabled"
+
+	log.SetFlags(0)
+
+	pt, err := argh.ParseArgs(os.Args, argh.NewParserConfig(
+		&argh.CommandConfig{
+			NValue:     argh.OneOrMoreValue,
+			ValueNames: []string{"topping"},
+			Flags: &argh.Flags{
+				Automatic: true,
+			},
+		},
+		nil,
+	))
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	ast := argh.NewQuerier(pt.Nodes).AST()
+
+	if asJSON {
+		b, err := json.MarshalIndent(ast, "", "  ")
+		if err != nil {
+			log.Fatal(err)
+		}
+
+		fmt.Println(string(b))
+
+		return
+	}
+
+	spew.Dump(ast)
+}

argh/cmd/argh/main.go

@@ -1,26 +0,0 @@
-package main
-
-import (
-	"encoding/json"
-	"fmt"
-	"log"
-	"os"
-
-	"git.meatballhat.com/x/box-o-sand/argh"
-)
-
-func main() {
-	log.SetFlags(0)
-
-	ast, err := argh.ParseArgs(os.Args, nil)
-	if err != nil {
-		log.Fatal(err)
-	}
-
-	b, err := json.MarshalIndent(ast, "", "  ")
-	if err != nil {
-		log.Fatal(err)
-	}
-
-	fmt.Println(string(b))
-}

argh/node.go

@@ -42,3 +42,5 @@ type StdinFlag struct{}
 type StopFlag struct{}
 
 type ArgDelimiter struct{}
+
+type Assign struct{}

argh/parser.go

@@ -1,332 +1,346 @@
-//go:generate stringer -type NValue
-
 package argh
 
 import (
 	"fmt"
 	"io"
 	"strings"
-
-	"github.com/pkg/errors"
 )
 
-var (
+type parser struct {
-	ErrSyntax = errors.New("syntax error")
-)
-
-func ParseArgs(args []string, pCfg *ParserConfig) (*ParseTree, error) {
-	reEncoded := strings.Join(args, string(nul))
-
-	return NewParser(
-		strings.NewReader(reEncoded),
-		pCfg,
-	).Parse()
-}
-
-type Parser struct {
 	s *Scanner
 
-	buf []scanEntry
-
 	cfg *ParserConfig
 
-	nodes []Node
+	errors ParserErrorList
-	node  Node
+
+	tok Token
+	lit string
+	pos Pos
+
+	buffered bool
 }
 
 type ParseTree struct {
 	Nodes []Node `json:"nodes"`
 }
 
-type scanEntry struct {
+func ParseArgs(args []string, pCfg *ParserConfig) (*ParseTree, error) {
-	tok Token
+	p := &parser{}
-	lit string
+	p.init(
-	pos Pos
+		strings.NewReader(strings.Join(args, string(nul))),
+		pCfg,
+	)
+
+	tracef("ParseArgs(...) parser=%+#v", p)
+
+	return p.parseArgs()
 }
 
-func NewParser(r io.Reader, pCfg *ParserConfig) *Parser {
+func (p *parser) addError(msg string) {
+	p.errors.Add(Position{Column: int(p.pos)}, msg)
+}
+
+func (p *parser) init(r io.Reader, pCfg *ParserConfig) {
+	p.errors = ParserErrorList{}
+
 	if pCfg == nil {
 		pCfg = POSIXyParserConfig
 	}
 
-	parser := &Parser{
+	p.cfg = pCfg
-		buf: []scanEntry{},
+
-		s:   NewScanner(r, pCfg.ScannerConfig),
+	p.s = NewScanner(r, pCfg.ScannerConfig)
-		cfg: pCfg,
+
+	p.next()
 }
 
-	tracef("NewParser parser=%+#v", parser)
+func (p *parser) parseArgs() (*ParseTree, error) {
-	tracef("NewParser pCfg=%+#v", pCfg)
+	if p.errors.Len() != 0 {
-
+		tracef("parseArgs() bailing due to initial error")
-	return parser
+		return nil, p.errors.Err()
 	}
 
-func (p *Parser) Parse() (*ParseTree, error) {
+	tracef("parseArgs() parsing %q as program command; cfg=%+#v", p.lit, p.cfg.Prog)
-	p.nodes = []Node{}
+	prog := p.parseCommand(&p.cfg.Prog)
 
-	for {
+	tracef("parseArgs() top level node is %T", prog)
-		br, err := p.parseArg()
+
-		if err != nil {
+	nodes := []Node{prog}
-			return nil, err
+	if v := p.parsePassthrough(); v != nil {
+		tracef("parseArgs() appending passthrough argument %v", v)
+		nodes = append(nodes, v)
 	}
 
-		if br {
+	tracef("parseArgs() returning ParseTree")
+
+	return &ParseTree{Nodes: nodes}, p.errors.Err()
+}
+
+func (p *parser) next() {
+	tracef("next() before scan: %v %q %v", p.tok, p.lit, p.pos)
+
+	p.tok, p.lit, p.pos = p.s.Scan()
+
+	tracef("next() after scan: %v %q %v", p.tok, p.lit, p.pos)
+}
+
+func (p *parser) parseCommand(cCfg *CommandConfig) Node {
+	tracef("parseCommand(%+#v)", cCfg)
+
+	node := &Command{
+		Name: p.lit,
+	}
+	values := map[string]string{}
+	nodes := []Node{}
+
+	identIndex := 0
+
+	for i := 0; p.tok != EOL; i++ {
+		if !p.buffered {
+			tracef("parseCommand(...) buffered=false; scanning next")
+			p.next()
+		}
+
+		p.buffered = false
+
+		tracef("parseCommand(...) for=%d values=%+#v", i, values)
+		tracef("parseCommand(...) for=%d nodes=%+#v", i, nodes)
+		tracef("parseCommand(...) for=%d tok=%s lit=%q pos=%v", i, p.tok, p.lit, p.pos)
+
+		tracef("parseCommand(...) cCfg=%+#v", cCfg)
+
+		if subCfg, ok := cCfg.GetCommandConfig(p.lit); ok {
+			subCommand := p.lit
+
+			nodes = append(nodes, p.parseCommand(&subCfg))
+
+			tracef("parseCommand(...) breaking after sub-command=%v", subCommand)
+			break
+		}
+
+		switch p.tok {
+		case ARG_DELIMITER:
+			tracef("parseCommand(...) handling %s", p.tok)
+
+			nodes = append(nodes, &ArgDelimiter{})
+
+			continue
+		case IDENT, STDIN_FLAG:
+			tracef("parseCommand(...) handling %s", p.tok)
+
+			if cCfg.NValue.Contains(identIndex) {
+				name := fmt.Sprintf("%d", identIndex)
+
+				tracef("parseCommand(...) checking for name of identIndex=%d", identIndex)
+
+				if len(cCfg.ValueNames) > identIndex {
+					name = cCfg.ValueNames[identIndex]
+					tracef("parseCommand(...) setting name=%s from config value names", name)
+				} else if len(cCfg.ValueNames) == 1 && (cCfg.NValue == OneOrMoreValue || cCfg.NValue == ZeroOrMoreValue) {
+					name = fmt.Sprintf("%s.%d", cCfg.ValueNames[0], identIndex)
+					tracef("parseCommand(...) setting name=%s from repeating value name", name)
+				}
+
+				values[name] = p.lit
+			}
+
+			if p.tok == STDIN_FLAG {
+				nodes = append(nodes, &StdinFlag{})
+			} else {
+				nodes = append(nodes, &Ident{Literal: p.lit})
+			}
+
+			identIndex++
+		case LONG_FLAG, SHORT_FLAG, COMPOUND_SHORT_FLAG:
+			tok := p.tok
+
+			flagNode := p.parseFlag(cCfg.Flags)
+
+			tracef("parseCommand(...) appending %s node=%+#v", tok, flagNode)
+
+			nodes = append(nodes, flagNode)
+		case ASSIGN:
+			tracef("parseCommand(...) error on bare %s", p.tok)
+
+			p.addError("invalid bare assignment")
+
+			break
+		default:
+			tracef("parseCommand(...) breaking on %s", p.tok)
 			break
 		}
 	}
 
-	return &ParseTree{Nodes: p.nodes}, nil
+	if len(nodes) > 0 {
+		node.Nodes = nodes
 	}
 
-func (p *Parser) parseArg() (bool, error) {
+	if len(values) > 0 {
-	tok, lit, pos := p.scan()
+		node.Values = values
-	if tok == ILLEGAL {
-		return false, errors.Wrapf(ErrSyntax, "illegal value %q at pos=%v", lit, pos)
 	}
 
-	if tok == EOL {
+	tracef("parseCommand(...) returning node=%+#v", node)
-		return true, nil
+	return node
 }
 
-	p.unscan(tok, lit, pos)
+func (p *parser) parseIdent() Node {
-
+	node := &Ident{Literal: p.lit}
-	node, err := p.scanNode()
+	return node
-
-	tracef("parseArg node=%+#v err=%+#v", node, err)
-
-	if err != nil {
-		return false, errors.Wrapf(err, "value %q at pos=%v", lit, pos)
 }
 
-	if node != nil {
+func (p *parser) parseFlag(flags *Flags) Node {
-		p.nodes = append(p.nodes, node)
+	switch p.tok {
-	}
+	case SHORT_FLAG:
-
+		tracef("parseFlag(...) parsing short flag with config=%+#v", flags)
-	return false, nil
+		return p.parseShortFlag(flags)
-}
+	case LONG_FLAG:
-
+		tracef("parseFlag(...) parsing long flag with config=%+#v", flags)
-func (p *Parser) scanNode() (Node, error) {
+		return p.parseLongFlag(flags)
-	tok, lit, pos := p.scan()
-
-	tracef("scanNode tok=%s lit=%q pos=%v", tok, lit, pos)
-
-	switch tok {
-	case ARG_DELIMITER:
-		return ArgDelimiter{}, nil
-	case ASSIGN:
-		return nil, errors.Wrapf(ErrSyntax, "bare assignment operator at pos=%v", pos)
-	case IDENT:
-		p.unscan(tok, lit, pos)
-		return p.scanCommandOrIdent()
 	case COMPOUND_SHORT_FLAG:
-		p.unscan(tok, lit, pos)
+		tracef("parseFlag(...) parsing compound short flag with config=%+#v", flags)
-		return p.scanCompoundShortFlag()
+		return p.parseCompoundShortFlag(flags)
-	case SHORT_FLAG, LONG_FLAG:
-		p.unscan(tok, lit, pos)
-		return p.scanFlag()
-	default:
 	}
 
-	return Ident{Literal: lit}, nil
+	panic(fmt.Sprintf("token %v cannot be parsed as flag", p.tok))
 }
 
-func (p *Parser) scanCommandOrIdent() (Node, error) {
+func (p *parser) parseShortFlag(flags *Flags) Node {
-	tok, lit, pos := p.scan()
+	node := &Flag{Name: string(p.lit[1])}
 
-	if len(p.nodes) == 0 {
+	flCfg, ok := flags.Get(node.Name)
-		p.unscan(tok, lit, pos)
+	if !ok {
-		values, err := p.scanValues(p.cfg.Prog.NValue, p.cfg.Prog.ValueNames)
+		p.addError(fmt.Sprintf("unknown flag %q", node.Name))
-		if err != nil {
+
-			return nil, err
+		return node
 	}
 
-		return Command{Name: lit, Values: values}, nil
+	return p.parseConfiguredFlag(node, flCfg)
 }
 
-	if cfg, ok := p.cfg.Prog.Commands[lit]; ok {
+func (p *parser) parseLongFlag(flags *Flags) Node {
-		p.unscan(tok, lit, pos)
+	node := &Flag{Name: string(p.lit[2:])}
-		values, err := p.scanValues(cfg.NValue, cfg.ValueNames)
+
-		if err != nil {
+	flCfg, ok := flags.Get(node.Name)
-			return nil, err
+	if !ok {
+		p.addError(fmt.Sprintf("unknown flag %q", node.Name))
+
+		return node
 	}
 
-		return Command{Name: lit, Values: values}, nil
+	return p.parseConfiguredFlag(node, flCfg)
 }
 
-	return Ident{Literal: lit}, nil
+func (p *parser) parseCompoundShortFlag(flags *Flags) Node {
-}
-
-func (p *Parser) scanFlag() (Node, error) {
-	tok, lit, pos := p.scan()
-
-	flagName := string(lit[1:])
-	if tok == LONG_FLAG {
-		flagName = string(lit[2:])
-	}
-
-	if cfg, ok := p.cfg.Prog.Flags[flagName]; ok {
-		p.unscan(tok, flagName, pos)
-
-		values, err := p.scanValues(cfg.NValue, cfg.ValueNames)
-		if err != nil {
-			return nil, err
-		}
-
-		return Flag{Name: flagName, Values: values}, nil
-	}
-
-	return Flag{Name: flagName}, nil
-}
-
-func (p *Parser) scanCompoundShortFlag() (Node, error) {
-	tok, lit, pos := p.scan()
-
 	flagNodes := []Node{}
 
-	withoutFlagPrefix := lit[1:]
+	withoutFlagPrefix := p.lit[1:]
 
 	for i, r := range withoutFlagPrefix {
+		node := &Flag{Name: string(r)}
+
 		if i == len(withoutFlagPrefix)-1 {
-			flagName := string(r)
+			flCfg, ok := flags.Get(node.Name)
-
+			if !ok {
-			if cfg, ok := p.cfg.Prog.Flags[flagName]; ok {
+				p.addError(fmt.Sprintf("unknown flag %q", node.Name))
-				p.unscan(tok, flagName, pos)
-
-				values, err := p.scanValues(cfg.NValue, cfg.ValueNames)
-				if err != nil {
-					return nil, err
-				}
-
-				flagNodes = append(flagNodes, Flag{Name: flagName, Values: values})
 
 				continue
 			}
+
+			flagNodes = append(flagNodes, p.parseConfiguredFlag(node, flCfg))
+
+			continue
 		}
 
-		flagNodes = append(
+		flagNodes = append(flagNodes, node)
-			flagNodes,
-			Flag{
-				Name: string(r),
-			},
-		)
 	}
 
-	return CompoundShortFlag{Nodes: flagNodes}, nil
+	return &CompoundShortFlag{Nodes: flagNodes}
 }
 
-func (p *Parser) scanValuesAndFlags() (map[string]string, []Node, error) {
+func (p *parser) parseConfiguredFlag(node *Flag, flCfg FlagConfig) Node {
-	return nil, nil, nil
+	values := map[string]string{}
-}
+	nodes := []Node{}
 
-func (p *Parser) scanValues(n NValue, valueNames []string) (map[string]string, error) {
+	identIndex := 0
-	_, lit, pos := p.scan()
 
-	tracef("scanValues lit=%q pos=%v n=%v valueNames=%+v", lit, pos, n, valueNames)
+	for i := 0; p.tok != EOL; i++ {
-
+		if !flCfg.NValue.Contains(identIndex) {
-	values, err := func() (map[string]string, error) {
+			tracef("parseConfiguredFlag(...) identIndex=%d exceeds expected=%v; breaking", identIndex, flCfg.NValue)
-		if n == ZeroValue {
-			return map[string]string{}, nil
-		}
-
-		ret := map[string]string{}
-		i := 0
-
-		for {
-			lit, err := p.scanIdent()
-			if err != nil {
-				if n == NValue(1) {
-					return nil, err
-				}
-
-				if n == OneOrMoreValue {
-					break
-				}
-			}
-
-			name := fmt.Sprintf("%d", i)
-			if len(valueNames)-1 >= i {
-				name = valueNames[i]
-			} else if len(valueNames) > 0 && strings.HasSuffix(valueNames[len(valueNames)-1], "+") {
-				name = strings.TrimSuffix(valueNames[len(valueNames)-1], "+")
-			}
-
-			ret[name] = lit
-
-			if n == NValue(1) && len(ret) == 1 {
 			break
 		}
 
-			i++
+		p.next()
+
+		switch p.tok {
+		case ARG_DELIMITER:
+			nodes = append(nodes, &ArgDelimiter{})
+
+			continue
+		case ASSIGN:
+			nodes = append(nodes, &Assign{})
+
+			continue
+		case IDENT, STDIN_FLAG:
+			name := fmt.Sprintf("%d", identIndex)
+
+			tracef("parseConfiguredFlag(...) checking for name of identIndex=%d", identIndex)
+
+			if len(flCfg.ValueNames) > identIndex {
+				name = flCfg.ValueNames[identIndex]
+				tracef("parseConfiguredFlag(...) setting name=%s from config value names", name)
+			} else if len(flCfg.ValueNames) == 1 && (flCfg.NValue == OneOrMoreValue || flCfg.NValue == ZeroOrMoreValue) {
+				name = fmt.Sprintf("%s.%d", flCfg.ValueNames[0], identIndex)
+				tracef("parseConfiguredFlag(...) setting name=%s from repeating value name", name)
+			} else {
+				tracef("parseConfiguredFlag(...) setting name=%s", name)
 			}
 
-		return ret, nil
+			values[name] = p.lit
-	}()
 
-	if err != nil {
+			if p.tok == STDIN_FLAG {
-		return nil, err
+				nodes = append(nodes, &StdinFlag{})
+			} else {
+				nodes = append(nodes, &Ident{Literal: p.lit})
 			}
 
-	if len(values) == 0 {
+			identIndex++
-		return nil, nil
+		default:
+			tracef("parseConfiguredFlag(...) breaking on %s %q %v; setting buffered=true", p.tok, p.lit, p.pos)
+			p.buffered = true
+
+			if len(nodes) > 0 {
+				node.Nodes = nodes
 			}
 
-	return values, nil
+			if len(values) > 0 {
+				node.Values = values
 			}
 
-func (p *Parser) scanIdent() (string, error) {
+			return node
-	tok, lit, pos := p.scan()
+		}
-
-	tracef("scanIdent scanned tok=%s lit=%q pos=%v", tok, lit, pos)
-
-	unscanBuf := []scanEntry{}
-
-	if tok == ASSIGN || tok == ARG_DELIMITER {
-		entry := scanEntry{tok: tok, lit: lit, pos: Pos(pos)}
-
-		tracef("scanIdent tok=%s; scanning next and pushing to unscan buffer entry=%+#v", tok, entry)
-
-		unscanBuf = append([]scanEntry{entry}, unscanBuf...)
-
-		tok, lit, pos = p.scan()
 	}
 
-	if tok == IDENT {
+	if len(nodes) > 0 {
-		return lit, nil
+		node.Nodes = nodes
 	}
 
-	entry := scanEntry{tok: tok, lit: lit, pos: Pos(pos)}
+	if len(values) > 0 {
-
+		node.Values = values
-	tracef("scanIdent tok=%s; unscanning entry=%+#v", tok, entry)
-
-	unscanBuf = append([]scanEntry{entry}, unscanBuf...)
-
-	for _, entry := range unscanBuf {
-		p.unscan(entry.tok, entry.lit, entry.pos)
 	}
 
-	return "", errors.Wrapf(ErrSyntax, "expected ident at pos=%v but got %s (%q)", pos, tok, lit)
+	return node
 }
 
-func (p *Parser) scan() (Token, string, Pos) {
+func (p *parser) parsePassthrough() Node {
-	if len(p.buf) != 0 {
+	nodes := []Node{}
-		entry, buf := p.buf[len(p.buf)-1], p.buf[:len(p.buf)-1]
-		p.buf = buf
 
-		tracef("scan returning buffer entry=%s %+#v", entry.tok, entry)
+	for ; p.tok != EOL; p.next() {
-		return entry.tok, entry.lit, entry.pos
+		nodes = append(nodes, &Ident{Literal: p.lit})
 	}
 
-	tok, lit, pos := p.s.Scan()
+	if len(nodes) == 0 {
-
+		return nil
-	tracef("scan returning next=%s %+#v", tok, scanEntry{tok: tok, lit: lit, pos: pos})
-
-	return tok, lit, pos
 	}
 
-func (p *Parser) unscan(tok Token, lit string, pos Pos) {
+	return &PassthroughArgs{Nodes: nodes}
-	entry := scanEntry{tok: tok, lit: lit, pos: pos}
-
-	tracef("unscan entry=%s %+#v", tok, entry)
-
-	p.buf = append(p.buf, entry)
 }

argh/parser2.go

@@ -1,313 +0,0 @@
-package argh
-
-import (
-	"fmt"
-	"io"
-	"strings"
-)
-
-type parser2 struct {
-	s *Scanner
-
-	cfg *ParserConfig
-
-	errors ScannerErrorList
-
-	tok Token
-	lit string
-	pos Pos
-
-	buffered bool
-}
-
-func ParseArgs2(args []string, pCfg *ParserConfig) (*ParseTree, error) {
-	parser := &parser2{}
-	parser.init(
-		strings.NewReader(strings.Join(args, string(nul))),
-		pCfg,
-	)
-
-	tracef("ParseArgs2(...) parser=%+#v", parser)
-
-	return parser.parseArgs()
-}
-
-func (p *parser2) init(r io.Reader, pCfg *ParserConfig) {
-	p.errors = ScannerErrorList{}
-
-	if pCfg == nil {
-		pCfg = POSIXyParserConfig
-	}
-
-	p.cfg = pCfg
-
-	p.s = NewScanner(r, pCfg.ScannerConfig)
-
-	p.next()
-}
-
-func (p *parser2) parseArgs() (*ParseTree, error) {
-	if p.errors.Len() != 0 {
-		tracef("parseArgs() bailing due to initial error")
-		return nil, p.errors.Err()
-	}
-
-	tracef("parseArgs() parsing %q as program command; cfg=%+#v", p.lit, p.cfg.Prog)
-	prog := p.parseCommand(&p.cfg.Prog)
-
-	tracef("parseArgs() top level node is %T", prog)
-
-	nodes := []Node{prog}
-	if v := p.parsePassthrough(); v != nil {
-		tracef("parseArgs() appending passthrough argument %v", v)
-		nodes = append(nodes, v)
-	}
-
-	tracef("parseArgs() returning ParseTree")
-
-	return &ParseTree{Nodes: nodes}, nil
-}
-
-func (p *parser2) next() {
-	tracef("next() before scan: %v %q %v", p.tok, p.lit, p.pos)
-
-	p.tok, p.lit, p.pos = p.s.Scan()
-
-	tracef("next() after scan: %v %q %v", p.tok, p.lit, p.pos)
-}
-
-func (p *parser2) parseCommand(cCfg *CommandConfig) Node {
-	tracef("parseCommand(%+#v)", cCfg)
-
-	node := &Command{
-		Name: p.lit,
-	}
-	values := map[string]string{}
-	nodes := []Node{}
-
-	identIndex := 0
-
-	for i := 0; p.tok != EOL; i++ {
-		if !p.buffered {
-			tracef("parseCommand(...) buffered=false; scanning next")
-			p.next()
-		}
-
-		p.buffered = false
-
-		tracef("parseCommand(...) for=%d values=%+#v", i, values)
-		tracef("parseCommand(...) for=%d nodes=%+#v", i, nodes)
-		tracef("parseCommand(...) for=%d tok=%s lit=%q pos=%v", i, p.tok, p.lit, p.pos)
-
-		if subCfg, ok := cCfg.Commands[p.lit]; ok {
-			subCommand := p.lit
-
-			nodes = append(nodes, p.parseCommand(&subCfg))
-
-			tracef("parseCommand(...) breaking after sub-command=%v", subCommand)
-			break
-		}
-
-		switch p.tok {
-		case ARG_DELIMITER:
-			tracef("parseCommand(...) handling %s", p.tok)
-
-			nodes = append(nodes, &ArgDelimiter{})
-
-			continue
-		case IDENT, STDIN_FLAG:
-			tracef("parseCommand(...) handling %s", p.tok)
-
-			if cCfg.NValue.Contains(identIndex) {
-				name := fmt.Sprintf("%d", identIndex)
-
-				tracef("parseCommand(...) checking for name of identIndex=%d", identIndex)
-
-				if len(cCfg.ValueNames) > identIndex {
-					name = cCfg.ValueNames[identIndex]
-					tracef("parseCommand(...) setting name=%s from config value names", name)
-				} else if len(cCfg.ValueNames) == 1 && (cCfg.NValue == OneOrMoreValue || cCfg.NValue == ZeroOrMoreValue) {
-					name = fmt.Sprintf("%s.%d", cCfg.ValueNames[0], identIndex)
-					tracef("parseCommand(...) setting name=%s from repeating value name", name)
-				}
-
-				values[name] = p.lit
-			}
-
-			if p.tok == STDIN_FLAG {
-				nodes = append(nodes, &StdinFlag{})
-			} else {
-				nodes = append(nodes, &Ident{Literal: p.lit})
-			}
-
-			identIndex++
-		case LONG_FLAG, SHORT_FLAG, COMPOUND_SHORT_FLAG:
-			tok := p.tok
-
-			flagNode := p.parseFlag(cCfg.Flags)
-
-			tracef("parseCommand(...) appending %s node=%+#v", tok, flagNode)
-
-			nodes = append(nodes, flagNode)
-		default:
-			tracef("parseCommand(...) breaking on %s", p.tok)
-			break
-		}
-	}
-
-	if len(nodes) > 0 {
-		node.Nodes = nodes
-	}
-
-	if len(values) > 0 {
-		node.Values = values
-	}
-
-	tracef("parseCommand(...) returning node=%+#v", node)
-	return node
-}
-
-func (p *parser2) parseIdent() Node {
-	node := &Ident{Literal: p.lit}
-	return node
-}
-
-func (p *parser2) parseFlag(flCfgMap map[string]FlagConfig) Node {
-	switch p.tok {
-	case SHORT_FLAG:
-		return p.parseShortFlag(flCfgMap)
-	case LONG_FLAG:
-		return p.parseLongFlag(flCfgMap)
-	case COMPOUND_SHORT_FLAG:
-		return p.parseCompoundShortFlag(flCfgMap)
-	}
-
-	panic(fmt.Sprintf("token %v cannot be parsed as flag", p.tok))
-}
-
-func (p *parser2) parseShortFlag(flCfgMap map[string]FlagConfig) Node {
-	node := &Flag{Name: string(p.lit[1])}
-
-	flCfg, ok := flCfgMap[node.Name]
-	if !ok {
-		return node
-	}
-
-	return p.parseConfiguredFlag(node, flCfg)
-}
-
-func (p *parser2) parseLongFlag(flCfgMap map[string]FlagConfig) Node {
-	node := &Flag{Name: string(p.lit[2:])}
-
-	flCfg, ok := flCfgMap[node.Name]
-	if !ok {
-		return node
-	}
-
-	return p.parseConfiguredFlag(node, flCfg)
-}
-
-func (p *parser2) parseCompoundShortFlag(flCfgMap map[string]FlagConfig) Node {
-	flagNodes := []Node{}
-
-	withoutFlagPrefix := p.lit[1:]
-
-	for i, r := range withoutFlagPrefix {
-		node := &Flag{Name: string(r)}
-
-		if i == len(withoutFlagPrefix)-1 {
-			flCfg, ok := flCfgMap[node.Name]
-			if ok {
-				flagNodes = append(flagNodes, p.parseConfiguredFlag(node, flCfg))
-
-				continue
-			}
-		}
-
-		flagNodes = append(flagNodes, node)
-	}
-
-	return &CompoundShortFlag{Nodes: flagNodes}
-}
-
-func (p *parser2) parseConfiguredFlag(node *Flag, flCfg FlagConfig) Node {
-	values := map[string]string{}
-	nodes := []Node{}
-
-	identIndex := 0
-
-	for i := 0; p.tok != EOL; i++ {
-		if !flCfg.NValue.Contains(identIndex) {
-			tracef("parseLongFlag(...) identIndex=%d exceeds expected=%s; breaking")
-			break
-		}
-
-		p.next()
-
-		switch p.tok {
-		case ARG_DELIMITER:
-			nodes = append(nodes, &ArgDelimiter{})
-
-			continue
-		case IDENT, STDIN_FLAG:
-			name := fmt.Sprintf("%d", identIndex)
-
-			tracef("parseLongFlag(...) checking for name of identIndex=%d", identIndex)
-
-			if len(flCfg.ValueNames) > identIndex {
-				name = flCfg.ValueNames[identIndex]
-				tracef("parseLongFlag(...) setting name=%s from config value names", name)
-			} else if len(flCfg.ValueNames) == 1 && (flCfg.NValue == OneOrMoreValue || flCfg.NValue == ZeroOrMoreValue) {
-				name = fmt.Sprintf("%s.%d", flCfg.ValueNames[0], identIndex)
-				tracef("parseLongFlag(...) setting name=%s from repeating value name", name)
-			}
-
-			values[name] = p.lit
-
-			if p.tok == STDIN_FLAG {
-				nodes = append(nodes, &StdinFlag{})
-			} else {
-				nodes = append(nodes, &Ident{Literal: p.lit})
-			}
-
-			identIndex++
-		default:
-			tracef("parseLongFlag(...) breaking on %s %q %v; setting buffered=true", p.tok, p.lit, p.pos)
-			p.buffered = true
-
-			if len(nodes) > 0 {
-				node.Nodes = nodes
-			}
-
-			if len(values) > 0 {
-				node.Values = values
-			}
-
-			return node
-		}
-	}
-
-	if len(nodes) > 0 {
-		node.Nodes = nodes
-	}
-
-	if len(values) > 0 {
-		node.Values = values
-	}
-
-	return node
-}
-
-func (p *parser2) parsePassthrough() Node {
-	nodes := []Node{}
-
-	for ; p.tok != EOL; p.next() {
-		nodes = append(nodes, &Ident{Literal: p.lit})
-	}
-
-	if len(nodes) == 0 {
-		return nil
-	}
-
-	return &PassthroughArgs{Nodes: nodes}
-}

argh/parser2_test.go

@@ -1,779 +0,0 @@
-package argh_test
-
-import (
-	"testing"
-
-	"git.meatballhat.com/x/box-o-sand/argh"
-	"github.com/davecgh/go-spew/spew"
-	"github.com/stretchr/testify/assert"
-)
-
-func TestParser2(t *testing.T) {
-	for _, tc := range []struct {
-		name   string
-		args   []string
-		cfg    *argh.ParserConfig
-		expErr error
-		expPT  []argh.Node
-		expAST []argh.Node
-		skip   bool
-	}{
-		{
-			name: "basic",
-			args: []string{
-				"pies", "-eat", "--wat", "hello", "mario",
-			},
-			cfg: &argh.ParserConfig{
-				Prog: argh.CommandConfig{
-					Commands: map[string]argh.CommandConfig{
-						"hello": argh.CommandConfig{
-							NValue:     1,
-							ValueNames: []string{"name"},
-						},
-					},
-				},
-			},
-			expPT: []argh.Node{
-				&argh.Command{
-					Name: "pies",
-					Nodes: []argh.Node{
-						&argh.ArgDelimiter{},
-						&argh.CompoundShortFlag{
-							Nodes: []argh.Node{
-								&argh.Flag{Name: "e"},
-								&argh.Flag{Name: "a"},
-								&argh.Flag{Name: "t"},
-							},
-						},
-						&argh.ArgDelimiter{},
-						&argh.Flag{Name: "wat"},
-						&argh.ArgDelimiter{},
-						&argh.Command{
-							Name: "hello",
-							Values: map[string]string{
-								"name": "mario",
-							},
-							Nodes: []argh.Node{
-								&argh.ArgDelimiter{},
-								&argh.Ident{Literal: "mario"},
-							},
-						},
-					},
-				},
-			},
-			expAST: []argh.Node{
-				&argh.Command{
-					Name: "pies",
-					Nodes: []argh.Node{
-						&argh.Flag{Name: "e"},
-						&argh.Flag{Name: "a"},
-						&argh.Flag{Name: "t"},
-						&argh.Flag{Name: "wat"},
-						&argh.Command{
-							Name: "hello",
-							Values: map[string]string{
-								"name": "mario",
-							},
-							Nodes: []argh.Node{
-								&argh.Ident{Literal: "mario"},
-							},
-						},
-					},
-				},
-			},
-		},
-		{
-			name: "bare",
-			args: []string{"pizzas"},
-			expPT: []argh.Node{
-				&argh.Command{
-					Name: "pizzas",
-				},
-			},
-			expAST: []argh.Node{
-				&argh.Command{
-					Name: "pizzas",
-				},
-			},
-		},
-		{
-			name: "one positional arg",
-			args: []string{"pizzas", "excel"},
-			cfg: &argh.ParserConfig{
-				Prog: argh.CommandConfig{NValue: 1},
-			},
-			expPT: []argh.Node{
-				&argh.Command{
-					Name:   "pizzas",
-					Values: map[string]string{"0": "excel"},
-					Nodes: []argh.Node{
-						&argh.ArgDelimiter{},
-						&argh.Ident{Literal: "excel"},
-					},
-				},
-			},
-			expAST: []argh.Node{
-				&argh.Command{
-					Name:   "pizzas",
-					Values: map[string]string{"0": "excel"},
-					Nodes: []argh.Node{
-						&argh.Ident{Literal: "excel"},
-					},
-				},
-			},
-		},
-		{
-			name: "many positional args",
-			args: []string{"pizzas", "excel", "wildly", "when", "feral"},
-			cfg: &argh.ParserConfig{
-				Prog: argh.CommandConfig{
-					NValue:     argh.OneOrMoreValue,
-					ValueNames: []string{"word"},
-				},
-			},
-			expPT: []argh.Node{
-				&argh.Command{
-					Name: "pizzas",
-					Values: map[string]string{
-						"word":   "excel",
-						"word.1": "wildly",
-						"word.2": "when",
-						"word.3": "feral",
-					},
-					Nodes: []argh.Node{
-						&argh.ArgDelimiter{},
-						&argh.Ident{Literal: "excel"},
-						&argh.ArgDelimiter{},
-						&argh.Ident{Literal: "wildly"},
-						&argh.ArgDelimiter{},
-						&argh.Ident{Literal: "when"},
-						&argh.ArgDelimiter{},
-						&argh.Ident{Literal: "feral"},
-					},
-				},
-			},
-			expAST: []argh.Node{
-				&argh.Command{
-					Name: "pizzas",
-					Values: map[string]string{
-						"word":   "excel",
-						"word.1": "wildly",
-						"word.2": "when",
-						"word.3": "feral",
-					},
-					Nodes: []argh.Node{
-						&argh.Ident{Literal: "excel"},
-						&argh.Ident{Literal: "wildly"},
-						&argh.Ident{Literal: "when"},
-						&argh.Ident{Literal: "feral"},
-					},
-				},
-			},
-		},
-		{
-			name: "long value-less flags",
-			args: []string{"pizzas", "--tasty", "--fresh", "--super-hot-right-now"},
-			expPT: []argh.Node{
-				&argh.Command{
-					Name: "pizzas",
-					Nodes: []argh.Node{
-						&argh.ArgDelimiter{},
-						&argh.Flag{Name: "tasty"},
-						&argh.ArgDelimiter{},
-						&argh.Flag{Name: "fresh"},
-						&argh.ArgDelimiter{},
-						&argh.Flag{Name: "super-hot-right-now"},
-					},
-				},
-			},
-			expAST: []argh.Node{
-				&argh.Command{
-					Name: "pizzas",
-					Nodes: []argh.Node{
-						&argh.Flag{Name: "tasty"},
-						&argh.Flag{Name: "fresh"},
-						&argh.Flag{Name: "super-hot-right-now"},
-					},
-				},
-			},
-		},
-		{
-			name: "long flags mixed",
-			args: []string{
-				"pizzas",
-				"--tasty",
-				"--fresh", "soon",
-				"--super-hot-right-now",
-				"--box", "square", "shaped", "hot",
-				"--please",
-			},
-			cfg: &argh.ParserConfig{
-				Prog: argh.CommandConfig{
-					Commands: map[string]argh.CommandConfig{},
-					Flags: map[string]argh.FlagConfig{
-						"fresh": argh.FlagConfig{NValue: 1},
-						"box":   argh.FlagConfig{NValue: argh.OneOrMoreValue},
-					},
-				},
-			},
-			expPT: []argh.Node{
-				&argh.Command{
-					Name: "pizzas",
-					Nodes: []argh.Node{
-						&argh.ArgDelimiter{},
-						&argh.Flag{Name: "tasty"},
-						&argh.ArgDelimiter{},
-						&argh.Flag{
-							Name:   "fresh",
-							Values: map[string]string{"0": "soon"},
-							Nodes: []argh.Node{
-								&argh.ArgDelimiter{},
-								&argh.Ident{Literal: "soon"},
-							},
-						},
-						&argh.ArgDelimiter{},
-						&argh.Flag{Name: "super-hot-right-now"},
-						&argh.ArgDelimiter{},
-						&argh.Flag{
-							Name:   "box",
-							Values: map[string]string{"0": "square", "1": "shaped", "2": "hot"},
-							Nodes: []argh.Node{
-								&argh.ArgDelimiter{},
-								&argh.Ident{Literal: "square"},
-								&argh.ArgDelimiter{},
-								&argh.Ident{Literal: "shaped"},
-								&argh.ArgDelimiter{},
-								&argh.Ident{Literal: "hot"},
-								&argh.ArgDelimiter{},
-							},
-						},
-						&argh.Flag{Name: "please"},
-					},
-				},
-			},
-			expAST: []argh.Node{
-				&argh.Command{
-					Name: "pizzas",
-					Nodes: []argh.Node{
-						&argh.Flag{Name: "tasty"},
-						&argh.Flag{
-							Name:   "fresh",
-							Values: map[string]string{"0": "soon"},
-							Nodes: []argh.Node{
-								&argh.Ident{Literal: "soon"},
-							},
-						},
-						&argh.Flag{Name: "super-hot-right-now"},
-						&argh.Flag{
-							Name:   "box",
-							Values: map[string]string{"0": "square", "1": "shaped", "2": "hot"},
-							Nodes: []argh.Node{
-								&argh.Ident{Literal: "square"},
-								&argh.Ident{Literal: "shaped"},
-								&argh.Ident{Literal: "hot"},
-							},
-						},
-						&argh.Flag{Name: "please"},
-					},
-				},
-			},
-		},
-		{
-			name: "short value-less flags",
-			args: []string{"pizzas", "-t", "-f", "-s"},
-			expPT: []argh.Node{
-				&argh.Command{
-					Name: "pizzas",
-					Nodes: []argh.Node{
-						&argh.ArgDelimiter{},
-						&argh.Flag{Name: "t"},
-						&argh.ArgDelimiter{},
-						&argh.Flag{Name: "f"},
-						&argh.ArgDelimiter{},
-						&argh.Flag{Name: "s"},
-					},
-				},
-			},
-			expAST: []argh.Node{
-				&argh.Command{
-					Name: "pizzas",
-					Nodes: []argh.Node{
-						&argh.Flag{Name: "t"},
-						&argh.Flag{Name: "f"},
-						&argh.Flag{Name: "s"},
-					},
-				},
-			},
-		},
-		{
-			name: "compound short flags",
-			args: []string{"pizzas", "-aca", "-blol"},
-			expPT: []argh.Node{
-				&argh.Command{
-					Name: "pizzas",
-					Nodes: []argh.Node{
-						&argh.ArgDelimiter{},
-						&argh.CompoundShortFlag{
-							Nodes: []argh.Node{
-								&argh.Flag{Name: "a"},
-								&argh.Flag{Name: "c"},
-								&argh.Flag{Name: "a"},
-							},
-						},
-						&argh.ArgDelimiter{},
-						&argh.CompoundShortFlag{
-							Nodes: []argh.Node{
-								&argh.Flag{Name: "b"},
-								&argh.Flag{Name: "l"},
-								&argh.Flag{Name: "o"},
-								&argh.Flag{Name: "l"},
-							},
-						},
-					},
-				},
-			},
-			expAST: []argh.Node{
-				&argh.Command{
-					Name: "pizzas",
-					Nodes: []argh.Node{
-						&argh.Flag{Name: "a"},
-						&argh.Flag{Name: "c"},
-						&argh.Flag{Name: "a"},
-						&argh.Flag{Name: "b"},
-						&argh.Flag{Name: "l"},
-						&argh.Flag{Name: "o"},
-						&argh.Flag{Name: "l"},
-					},
-				},
-			},
-		},
-		{
-			name: "mixed long short value flags",
-			args: []string{"pizzas", "-a", "--ca", "-b", "1312", "-lol"},
-			cfg: &argh.ParserConfig{
-				Prog: argh.CommandConfig{
-					Commands: map[string]argh.CommandConfig{},
-					Flags: map[string]argh.FlagConfig{
-						"b": argh.FlagConfig{NValue: 1},
-					},
-				},
-			},
-			expPT: []argh.Node{
-				&argh.Command{
-					Name: "pizzas",
-					Nodes: []argh.Node{
-						&argh.ArgDelimiter{},
-						&argh.Flag{Name: "a"},
-						&argh.ArgDelimiter{},
-						&argh.Flag{Name: "ca"},
-						&argh.ArgDelimiter{},
-						&argh.Flag{
-							Name:   "b",
-							Values: map[string]string{"0": "1312"},
-							Nodes: []argh.Node{
-								&argh.ArgDelimiter{},
-								&argh.Ident{Literal: "1312"},
-							},
-						},
-						&argh.ArgDelimiter{},
-						&argh.CompoundShortFlag{
-							Nodes: []argh.Node{
-								&argh.Flag{Name: "l"},
-								&argh.Flag{Name: "o"},
-								&argh.Flag{Name: "l"},
-							},
-						},
-					},
-				},
-			},
-			expAST: []argh.Node{
-				&argh.Command{
-					Name: "pizzas",
-					Nodes: []argh.Node{
-						&argh.Flag{Name: "a"},
-						&argh.Flag{Name: "ca"},
-						&argh.Flag{
-							Name:   "b",
-							Values: map[string]string{"0": "1312"},
-							Nodes: []argh.Node{
-								&argh.Ident{Literal: "1312"},
-							},
-						},
-						&argh.Flag{Name: "l"},
-						&argh.Flag{Name: "o"},
-						&argh.Flag{Name: "l"},
-					},
-				},
-			},
-		},
-		{
-			name: "nested commands with positional args",
-			args: []string{"pizzas", "fly", "freely", "sometimes", "and", "other", "times", "fry", "deeply", "--forever"},
-			cfg: &argh.ParserConfig{
-				Prog: argh.CommandConfig{
-					Commands: map[string]argh.CommandConfig{
-						"fly": argh.CommandConfig{
-							Commands: map[string]argh.CommandConfig{
-								"fry": argh.CommandConfig{},
-							},
-						},
-					},
-					Flags: map[string]argh.FlagConfig{},
-				},
-			},
-			expPT: []argh.Node{
-				&argh.Command{
-					Name: "pizzas",
-					Nodes: []argh.Node{
-						&argh.ArgDelimiter{},
-						&argh.Command{
-							Name: "fly",
-							Nodes: []argh.Node{
-								&argh.ArgDelimiter{},
-								&argh.Ident{Literal: "freely"},
-								&argh.ArgDelimiter{},
-								&argh.Ident{Literal: "sometimes"},
-								&argh.ArgDelimiter{},
-								&argh.Ident{Literal: "and"},
-								&argh.ArgDelimiter{},
-								&argh.Ident{Literal: "other"},
-								&argh.ArgDelimiter{},
-								&argh.Ident{Literal: "times"},
-								&argh.ArgDelimiter{},
-								&argh.Command{
-									Name: "fry",
-									Nodes: []argh.Node{
-										&argh.ArgDelimiter{},
-										&argh.Ident{Literal: "deeply"},
-										&argh.ArgDelimiter{},
-										&argh.Flag{Name: "forever"},
-									},
-								},
-							},
-						},
-					},
-				},
-			},
-			expAST: []argh.Node{
-				&argh.Command{
-					Name: "pizzas",
-					Nodes: []argh.Node{
-						&argh.Command{
-							Name: "fly",
-							Nodes: []argh.Node{
-								&argh.Ident{Literal: "freely"},
-								&argh.Ident{Literal: "sometimes"},
-								&argh.Ident{Literal: "and"},
-								&argh.Ident{Literal: "other"},
-								&argh.Ident{Literal: "times"},
-								&argh.Command{
-									Name: "fry",
-									Nodes: []argh.Node{
-										&argh.Ident{Literal: "deeply"},
-										&argh.Flag{Name: "forever"},
-									},
-								},
-							},
-						},
-					},
-				},
-			},
-		},
-		{
-			name: "compound flags with values",
-			args: []string{"pizzas", "-need", "sauce", "heat", "love", "-also", "over9000"},
-			cfg: &argh.ParserConfig{
-				Prog: argh.CommandConfig{
-					Flags: map[string]argh.FlagConfig{
-						"a": {NValue: argh.ZeroOrMoreValue},
-						"d": {NValue: argh.OneOrMoreValue},
-						"e": {},
-						"l": {},
-						"n": {},
-						"o": {NValue: 1, ValueNames: []string{"level"}},
-						"s": {NValue: argh.ZeroOrMoreValue},
-					},
-				},
-			},
-			expPT: []argh.Node{
-				&argh.Command{
-					Name: "pizzas",
-					Nodes: []argh.Node{
-						&argh.ArgDelimiter{},
-						&argh.CompoundShortFlag{
-							Nodes: []argh.Node{
-								&argh.Flag{Name: "n"},
-								&argh.Flag{Name: "e"},
-								&argh.Flag{Name: "e"},
-								&argh.Flag{
-									Name: "d",
-									Values: map[string]string{
-										"0": "sauce",
-										"1": "heat",
-										"2": "love",
-									},
-									Nodes: []argh.Node{
-										&argh.ArgDelimiter{},
-										&argh.Ident{Literal: "sauce"},
-										&argh.ArgDelimiter{},
-										&argh.Ident{Literal: "heat"},
-										&argh.ArgDelimiter{},
-										&argh.Ident{Literal: "love"},
-										&argh.ArgDelimiter{},
-									},
-								},
-							},
-						},
-						&argh.CompoundShortFlag{
-							Nodes: []argh.Node{
-								&argh.Flag{Name: "a"},
-								&argh.Flag{Name: "l"},
-								&argh.Flag{Name: "s"},
-								&argh.Flag{
-									Name: "o",
-									Values: map[string]string{
-										"level": "over9000",
-									},
-									Nodes: []argh.Node{
-										&argh.ArgDelimiter{},
-										&argh.Ident{Literal: "over9000"},
-									},
-								},
-							},
-						},
-					},
-				},
-			},
-			expAST: []argh.Node{
-				&argh.Command{
-					Name: "pizzas",
-					Nodes: []argh.Node{
-						&argh.Flag{Name: "n"},
-						&argh.Flag{Name: "e"},
-						&argh.Flag{Name: "e"},
-						&argh.Flag{
-							Name: "d",
-							Values: map[string]string{
-								"0": "sauce",
-								"1": "heat",
-								"2": "love",
-							},
-							Nodes: []argh.Node{
-								&argh.Ident{Literal: "sauce"},
-								&argh.Ident{Literal: "heat"},
-								&argh.Ident{Literal: "love"},
-							},
-						},
-						&argh.Flag{Name: "a"},
-						&argh.Flag{Name: "l"},
-						&argh.Flag{Name: "s"},
-						&argh.Flag{
-							Name: "o",
-							Values: map[string]string{
-								"level": "over9000",
-							},
-							Nodes: []argh.Node{
-								&argh.Ident{Literal: "over9000"},
-							},
-						},
-					},
-				},
-			},
-		},
-		{
-			name: "command specific flags",
-			args: []string{"pizzas", "fly", "--freely", "fry", "--deeply", "-wAt", "hugs"},
-			cfg: &argh.ParserConfig{
-				Prog: argh.CommandConfig{
-					Commands: map[string]argh.CommandConfig{
-						"fly": argh.CommandConfig{
-							Flags: map[string]argh.FlagConfig{
-								"freely": {},
-							},
-							Commands: map[string]argh.CommandConfig{
-								"fry": argh.CommandConfig{
-									Flags: map[string]argh.FlagConfig{
-										"deeply": {},
-										"w":      {},
-										"A":      {},
-										"t":      argh.FlagConfig{NValue: 1},
-									},
-								},
-							},
-						},
-					},
-					Flags: map[string]argh.FlagConfig{},
-				},
-			},
-			expPT: []argh.Node{
-				&argh.Command{
-					Name: "pizzas",
-					Nodes: []argh.Node{
-						&argh.ArgDelimiter{},
-						&argh.Command{
-							Name: "fly",
-							Nodes: []argh.Node{
-								&argh.ArgDelimiter{},
-								&argh.Flag{Name: "freely"},
-								&argh.ArgDelimiter{},
-								&argh.Command{
-									Name: "fry",
-									Nodes: []argh.Node{
-										&argh.ArgDelimiter{},
-										&argh.Flag{Name: "deeply"},
-										&argh.ArgDelimiter{},
-										&argh.CompoundShortFlag{
-											Nodes: []argh.Node{
-												&argh.Flag{Name: "w"},
-												&argh.Flag{Name: "A"},
-												&argh.Flag{
-													Name:   "t",
-													Values: map[string]string{"0": "hugs"},
-													Nodes: []argh.Node{
-														&argh.ArgDelimiter{},
-														&argh.Ident{Literal: "hugs"},
-													},
-												},
-											},
-										},
-									},
-								},
-							},
-						},
-					},
-				},
-			},
-			expAST: []argh.Node{
-				&argh.Command{
-					Name: "pizzas",
-					Nodes: []argh.Node{
-						&argh.Command{
-							Name: "fly",
-							Nodes: []argh.Node{
-								&argh.Flag{Name: "freely"},
-								&argh.Command{
-									Name: "fry",
-									Nodes: []argh.Node{
-										&argh.Flag{Name: "deeply"},
-										&argh.Flag{Name: "w"},
-										&argh.Flag{Name: "A"},
-										&argh.Flag{
-											Name:   "t",
-											Values: map[string]string{"0": "hugs"},
-											Nodes: []argh.Node{
-												&argh.Ident{Literal: "hugs"},
-											},
-										},
-									},
-								},
-							},
-						},
-					},
-				},
-			},
-		},
-		{
-			skip: true,
-
-			name: "total weirdo",
-			args: []string{"PIZZAs", "^wAT@golf", "^^hecKing", "goose", "bonk", "^^FIERCENESS@-2"},
-			cfg: &argh.ParserConfig{
-				Prog: argh.CommandConfig{
-					Commands: map[string]argh.CommandConfig{
-						"goose": argh.CommandConfig{NValue: 1},
-					},
-					Flags: map[string]argh.FlagConfig{
-						"w":          argh.FlagConfig{},
-						"A":          argh.FlagConfig{},
-						"T":          argh.FlagConfig{NValue: 1},
-						"hecking":    argh.FlagConfig{},
-						"FIERCENESS": argh.FlagConfig{NValue: 1},
-					},
-				},
-				ScannerConfig: &argh.ScannerConfig{
-					AssignmentOperator: '@',
-					FlagPrefix:         '^',
-					MultiValueDelim:    ',',
-				},
-			},
-			expPT: []argh.Node{
-				&argh.Command{
-					Name: "PIZZAs",
-					Nodes: []argh.Node{
-						&argh.ArgDelimiter{},
-						&argh.CompoundShortFlag{
-							Nodes: []argh.Node{
-								&argh.Flag{Name: "w"},
-								&argh.Flag{Name: "A"},
-								&argh.Flag{Name: "T", Values: map[string]string{"0": "golf"}},
-							},
-						},
-						&argh.ArgDelimiter{},
-						&argh.Flag{Name: "hecKing"},
-						&argh.ArgDelimiter{},
-						&argh.Command{Name: "goose", Values: map[string]string{"0": "bonk"}},
-						&argh.ArgDelimiter{},
-						&argh.Flag{Name: "FIERCENESS", Values: map[string]string{"0": "-2"}},
-					},
-				},
-			},
-		},
-		{
-			skip: true,
-
-			name:   "invalid bare assignment",
-			args:   []string{"pizzas", "=", "--wat"},
-			expErr: argh.ErrSyntax,
-			expPT: []argh.Node{
-				&argh.Command{
-					Name: "pizzas",
-					Nodes: []argh.Node{
-						&argh.ArgDelimiter{},
-						&argh.ArgDelimiter{},
-						&argh.Flag{Name: "wat"},
-					},
-				},
-			},
-		},
-	} {
-		if tc.expPT != nil {
-			t.Run(tc.name+" parse tree", func(ct *testing.T) {
-				if tc.skip {
-					ct.SkipNow()
-					return
-				}
-
-				pt, err := argh.ParseArgs2(tc.args, tc.cfg)
-				if err != nil || tc.expErr != nil {
-					assert.ErrorIs(ct, err, tc.expErr)
-					return
-				}
-
-				if !assert.Equal(ct, tc.expPT, pt.Nodes) {
-					spew.Dump(pt)
-				}
-			})
-		}
-
-		if tc.expAST != nil {
-			t.Run(tc.name+" ast", func(ct *testing.T) {
-				if tc.skip {
-					ct.SkipNow()
-					return
-				}
-
-				pt, err := argh.ParseArgs2(tc.args, tc.cfg)
-				if err != nil || tc.expErr != nil {
-					assert.ErrorIs(ct, err, tc.expErr)
-					return
-				}
-
-				ast := argh.NewQuerier(pt.Nodes).AST()
-
-				if !assert.Equal(ct, tc.expAST, ast) {
-					spew.Dump(ast)
-				}
-			})
-		}
-	}
-}

argh/parser_config.go

@@ -7,15 +7,17 @@ const (
 )
 
 var (
-	POSIXyParserConfig = &ParserConfig{
+	POSIXyParserConfig = NewParserConfig(
-		Prog:          CommandConfig{},
+		nil,
-		ScannerConfig: POSIXyScannerConfig,
+		POSIXyScannerConfig,
-	}
+	)
 )
 
 type NValue int
 
 func (nv NValue) Contains(i int) bool {
+	tracef("NValue.Contains(%v)", i)
+
 	if i < int(ZeroValue) {
 		return false
 	}
@@ -33,14 +35,112 @@ type ParserConfig struct {
 	ScannerConfig *ScannerConfig
 }
 
+func NewParserConfig(prog *CommandConfig, sCfg *ScannerConfig) *ParserConfig {
+	if sCfg == nil {
+		sCfg = POSIXyScannerConfig
+	}
+
+	if prog == nil {
+		prog = &CommandConfig{}
+	}
+
+	prog.init()
+
+	pCfg := &ParserConfig{
+		Prog:          *prog,
+		ScannerConfig: sCfg,
+	}
+
+	return pCfg
+}
+
 type CommandConfig struct {
 	NValue     NValue
 	ValueNames []string
-	Flags      map[string]FlagConfig
+	Flags      *Flags
-	Commands   map[string]CommandConfig
+	Commands   *Commands
+}
+
+func (cCfg *CommandConfig) init() {
+	if cCfg.ValueNames == nil {
+		cCfg.ValueNames = []string{}
+	}
+
+	if cCfg.Flags == nil {
+		cCfg.Flags = &Flags{}
+	}
+
+	if cCfg.Commands == nil {
+		cCfg.Commands = &Commands{}
+	}
+}
+
+func (cCfg *CommandConfig) GetCommandConfig(name string) (CommandConfig, bool) {
+	tracef("CommandConfig.GetCommandConfig(%q)", name)
+
+	if cCfg.Commands == nil {
+		cCfg.Commands = &Commands{Map: map[string]CommandConfig{}}
+	}
+
+	return cCfg.Commands.Get(name)
+}
+
+func (cCfg *CommandConfig) GetFlagConfig(name string) (FlagConfig, bool) {
+	tracef("CommandConfig.GetFlagConfig(%q)", name)
+
+	if cCfg.Flags == nil {
+		cCfg.Flags = &Flags{Map: map[string]FlagConfig{}}
+	}
+
+	return cCfg.Flags.Get(name)
 }
 
 type FlagConfig struct {
 	NValue     NValue
+	Persist    bool
 	ValueNames []string
 }
+
+type Flags struct {
+	Parent *Flags
+	Map    map[string]FlagConfig
+
+	Automatic bool
+}
+
+func (fl *Flags) Get(name string) (FlagConfig, bool) {
+	tracef("Flags.Get(%q)", name)
+
+	if fl.Map == nil {
+		fl.Map = map[string]FlagConfig{}
+	}
+
+	flCfg, ok := fl.Map[name]
+	if !ok {
+		if fl.Automatic {
+			return FlagConfig{}, true
+		}
+
+		if fl.Parent != nil {
+			flCfg, ok = fl.Parent.Get(name)
+			return flCfg, ok && flCfg.Persist
+		}
+	}
+
+	return flCfg, ok
+}
+
+type Commands struct {
+	Map map[string]CommandConfig
+}
+
+func (cmd *Commands) Get(name string) (CommandConfig, bool) {
+	tracef("Commands.Get(%q)", name)
+
+	if cmd.Map == nil {
+		cmd.Map = map[string]CommandConfig{}
+	}
+
+	cmdCfg, ok := cmd.Map[name]
+	return cmdCfg, ok
+}

argh/parser_error.go

@@ -0,0 +1,88 @@
+package argh
+
+import (
+	"fmt"
+	"io"
+	"sort"
+)
+
+// ParserError is largely borrowed from go/scanner.Error
+type ParserError struct {
+	Pos Position
+	Msg string
+}
+
+func (e ParserError) Error() string {
+	if e.Pos.IsValid() {
+		return e.Pos.String() + ":" + e.Msg
+	}
+
+	return e.Msg
+}
+
+// ParserErrorList is largely borrowed from go/scanner.ErrorList
+type ParserErrorList []*ParserError
+
+func (el *ParserErrorList) Add(pos Position, msg string) {
+	*el = append(*el, &ParserError{Pos: pos, Msg: msg})
+}
+
+func (el *ParserErrorList) Reset() { *el = (*el)[0:0] }
+
+func (el ParserErrorList) Len() int { return len(el) }
+
+func (el ParserErrorList) Swap(i, j int) { el[i], el[j] = el[j], el[i] }
+
+func (el ParserErrorList) Less(i, j int) bool {
+	e := &el[i].Pos
+	f := &el[j].Pos
+
+	if e.Column != f.Column {
+		return e.Column < f.Column
+	}
+
+	return el[i].Msg < el[j].Msg
+}
+
+func (el ParserErrorList) Sort() {
+	sort.Sort(el)
+}
+
+func (el ParserErrorList) Error() string {
+	switch len(el) {
+	case 0:
+		return "no errors"
+	case 1:
+		return el[0].Error()
+	}
+	return fmt.Sprintf("%s (and %d more errors)", el[0], len(el)-1)
+}
+
+func (el ParserErrorList) Err() error {
+	if len(el) == 0 {
+		return nil
+	}
+	return el
+}
+
+func (el ParserErrorList) Is(other error) bool {
+	if _, ok := other.(ParserErrorList); ok {
+		return el.Error() == other.Error()
+	}
+
+	if v, ok := other.(*ParserErrorList); ok {
+		return el.Error() == (*v).Error()
+	}
+
+	return false
+}
+
+func PrintParserError(w io.Writer, err error) {
+	if list, ok := err.(ParserErrorList); ok {
+		for _, e := range list {
+			fmt.Fprintf(w, "%s\n", e)
+		}
+	} else if err != nil {
+		fmt.Fprintf(w, "%s\n", err)
+	}
+}

argh/querier_test.go

@@ -18,6 +18,21 @@ func TestQuerier_Program(t *testing.T) {
 		{
 			name: "typical",
 			args: []string{"pizzas", "ahoy", "--treatsa", "fun"},
+			cfg: &argh.ParserConfig{
+				Prog: argh.CommandConfig{
+					Commands: &argh.Commands{
+						Map: map[string]argh.CommandConfig{
+							"ahoy": argh.CommandConfig{
+								Flags: &argh.Flags{
+									Map: map[string]argh.FlagConfig{
+										"treatsa": argh.FlagConfig{NValue: 1},
+									},
+								},
+							},
+						},
+					},
+				},
+			},
 			exp:   "pizzas",
 			expOK: true,
 		},
@@ -34,7 +49,7 @@ func TestQuerier_Program(t *testing.T) {
 		},
 	} {
 		t.Run(tc.name, func(ct *testing.T) {
-			pt, err := argh.ParseArgs2(tc.args, tc.cfg)
+			pt, err := argh.ParseArgs(tc.args, tc.cfg)
 			require.Nil(ct, err)
 
 			prog, ok := argh.NewQuerier(pt.Nodes).Program()

argh/scanner_error.go

@@ -1,75 +0,0 @@
-package argh
-
-import (
-	"fmt"
-	"io"
-	"sort"
-)
-
-// ScannerError is largely borrowed from go/scanner.Error
-type ScannerError struct {
-	Pos Position
-	Msg string
-}
-
-func (e ScannerError) Error() string {
-	if e.Pos.IsValid() {
-		return e.Pos.String() + ":" + e.Msg
-	}
-	return e.Msg
-}
-
-// ScannerErrorList is largely borrowed from go/scanner.ErrorList
-type ScannerErrorList []*ScannerError
-
-func (el *ScannerErrorList) Add(pos Position, msg string) {
-	*el = append(*el, &ScannerError{Pos: pos, Msg: msg})
-}
-
-func (el *ScannerErrorList) Reset() { *el = (*el)[0:0] }
-
-func (el ScannerErrorList) Len() int { return len(el) }
-
-func (el ScannerErrorList) Swap(i, j int) { el[i], el[j] = el[j], el[i] }
-
-func (el ScannerErrorList) Less(i, j int) bool {
-	e := &el[i].Pos
-	f := &el[j].Pos
-
-	if e.Column != f.Column {
-		return e.Column < f.Column
-	}
-
-	return el[i].Msg < el[j].Msg
-}
-
-func (el ScannerErrorList) Sort() {
-	sort.Sort(el)
-}
-
-func (el ScannerErrorList) Error() string {
-	switch len(el) {
-	case 0:
-		return "no errors"
-	case 1:
-		return el[0].Error()
-	}
-	return fmt.Sprintf("%s (and %d more errors)", el[0], len(el)-1)
-}
-
-func (el ScannerErrorList) Err() error {
-	if len(el) == 0 {
-		return nil
-	}
-	return el
-}
-
-func PrintScannerError(w io.Writer, err error) {
-	if list, ok := err.(ScannerErrorList); ok {
-		for _, e := range list {
-			fmt.Fprintf(w, "%s\n", e)
-		}
-	} else if err != nil {
-		fmt.Fprintf(w, "%s\n", err)
-	}
-}