Function parseArgs

cli/args.go:180–209

parseArgs parses the given non-flag arguments in the context of the given configuration struct, flags, and commands. The non-flag arguments and flags should be gotten through [getArgs] first. It returns the command specified by the arguments, an ordered map of all of the flag names and their associa

(cfg T, args []string, flags map[string]string, cmds ...*Cmd[T])

// the arguments, an ordered map of all of the flag names and their associated
// field objects, and any error.
func parseArgs[T any](cfg T, args []string, flags map[string]string, cmds ...*Cmd[T]) (cmd string, allFlags *fields, err error) {
	newArgs, newCmd, err := parseArgsImpl(cfg, args, "", cmds...)
	if err != nil {
		return newCmd, allFlags, err
	}

	// if the command is blank, then it is the root command
	if newCmd == "" {
		for _, c := range cmds {
			if c.Root && c.Name != "help" {
				newCmd = c.Name
				break
			}
		}
	}

	allFields := &fields{}
	addMetaConfigFields(allFields)
	addFields(cfg, allFields, newCmd)

	allFlags = &fields{}
	newArgs, err = addFlags(allFields, allFlags, newArgs, flags)
	if err != nil {
		return newCmd, allFields, err
	}
	if len(newArgs) > 0 {
		return newCmd, allFields, fmt.Errorf("got unused arguments: %v", newArgs)
	}
	return newCmd, allFlags, nil
}

// parseArgsImpl is the underlying implementation of [parseArgs] that is called
// recursively and takes most of what [parseArgs] does, plus the current command state,