Method Parse

parse_doc/parse_default.go:120–210

(context parseContext)

}

func (defaultParser) Parse(context parseContext) (res *parseResult, err error) {
	res = &parseResult{}

	flagContext := datastore.FlagContext{
		SubCommand: parseUsageSubCommand(context.args, context.text),
	}

	var completions []datastore.Completion
	var discoveredFlagMap = make(map[string]bool)
	var discoveredFlags []string
	for _, line := range context.text.lines {
		flagsMatch := flagRegexp.FindAllStringSubmatch(line, -1)
		for _, match := range flagsMatch {
			flag := match[1]
			if !discoveredFlagMap[flag] {
				discoveredFlags = append(discoveredFlags, flag)
				discoveredFlagMap[flag] = true
			}
		}
	}

	// Sometimes we find examples of merged single letter options like `-xzf` (== -x -z -f) in help messages.
	// We want to distinguish them from java style-options like `-server`.
	// We want to guess if we are dealing with gnu style or java style.
	isGnuLike := false
	for _, flag := range discoveredFlags {
		if strings.HasPrefix(flag, "--") {
			isGnuLike = true
			break
		}
	}

	for _, flag := range discoveredFlags {
		if isGnuLike && isJavaStyleFlag(flag) {
			continue
		}
		completions = append(completions, datastore.Completion{Flag: flag, Context: flagContext})
	}

	// Now we are going to search for sub-commands.
	// Idea is following
	//   1. We are looking for string that ends with `commands:` (we ignore case)
	//   2. Then we check indentation of the next line
	//   3. First word of the line that has same indentation as first line is sub-command.
	//   4. We skip the line if line indent is bigger than indent of the first line
	//      (most likely this is continuation of help)
	//   5. We stop when we find empty line or line that has indent less than indent of the first line.
	const (
		Outer           = iota
		FirstLineInside = iota
		Inside          = iota
	)
	var state = Outer
	var prevIndent = -1
	var currentParagraphIndent = 0
	for _, line := range context.text.lines {
		var indent = computeIndent(line)
		switch state {