Function cmdFromFunc

cli/cmd.go:50–80

cmdFromFunc returns a new [Cmd] object from the given function and any information specified on it using comment directives, which requires the use of [types].

(fun func(T) error)

// and any information specified on it using comment directives,
// which requires the use of [types].
func cmdFromFunc[T any](fun func(T) error) (*Cmd[T], error) {
	cmd := &Cmd[T]{
		Func: fun,
	}

	fn := types.FuncName(fun)

	// we need to get rid of package name and then convert to kebab
	strs := strings.Split(fn, ".")
	cfn := strs[len(strs)-1] // camel function name
	cmd.Name = strcase.ToKebab(cfn)

	if f := types.FuncByName(fn); f != nil {
		cmd.Doc = f.Doc
		for _, dir := range f.Directives {
			if dir.Tool != "cli" {
				continue
			}
			if dir.Directive != "cmd" {
				return cmd, fmt.Errorf("unrecognized comment directive %q (from comment %q)", dir.Directive, dir.String())
			}
			_, err := SetFromArgs(cmd, dir.Args, ErrNotFound)
			if err != nil {
				return cmd, fmt.Errorf("error setting command from directive arguments (from comment %q): %w", dir.String(), err)
			}
		}
		// we format the doc after the directives so that we have the up-to-date documentation and name
		cmd.Doc = types.FormatDoc(cmd.Doc, cfn, strcase.ToSentence(cmd.Name))
	}
	return cmd, nil
}

// cmdFromCmdOrFunc returns a new [Cmd] object from the given
// [CmdOrFunc] object, using [cmdFromFunc] if it is a function.