[no-relnote] Migrate to urfave v3

Signed-off-by: Carlos Eduardo Arango Gutierrez <eduardoa@nvidia.com>

vendor/github.com/urfave/cli/v3/completion.go

@@ -0,0 +1,100 @@
+package cli
+
+import (
+	"context"
+	"embed"
+	"fmt"
+	"sort"
+	"strings"
+)
+
+const (
+	completionCommandName = "completion"
+
+	// This flag is supposed to only be used by the completion script itself to generate completions on the fly.
+	completionFlag = "--generate-shell-completion"
+)
+
+type renderCompletion func(cmd *Command, appName string) (string, error)
+
+var (
+	//go:embed autocomplete
+	autoCompleteFS embed.FS
+
+	shellCompletions = map[string]renderCompletion{
+		"bash": func(c *Command, appName string) (string, error) {
+			b, err := autoCompleteFS.ReadFile("autocomplete/bash_autocomplete")
+			return fmt.Sprintf(string(b), appName), err
+		},
+		"zsh": func(c *Command, appName string) (string, error) {
+			b, err := autoCompleteFS.ReadFile("autocomplete/zsh_autocomplete")
+			return fmt.Sprintf(string(b), appName), err
+		},
+		"fish": func(c *Command, appName string) (string, error) {
+			return c.Root().ToFishCompletion()
+		},
+		"pwsh": func(c *Command, appName string) (string, error) {
+			b, err := autoCompleteFS.ReadFile("autocomplete/powershell_autocomplete.ps1")
+			return string(b), err
+		},
+	}
+)
+
+const completionDescription = `Output shell completion script for bash, zsh, fish, or Powershell.
+Source the output to enable completion.
+
+# .bashrc
+source <($COMMAND completion bash)
+
+# .zshrc
+source <($COMMAND completion zsh)
+
+# fish
+$COMMAND completion fish > ~/.config/fish/completions/$COMMAND.fish
+
+# Powershell
+Output the script to path/to/autocomplete/$COMMAND.ps1 an run it.
+`
+
+func buildCompletionCommand(appName string) *Command {
+	return &Command{
+		Name:        completionCommandName,
+		Hidden:      true,
+		Usage:       "Output shell completion script for bash, zsh, fish, or Powershell",
+		Description: strings.ReplaceAll(completionDescription, "$COMMAND", appName),
+		Action: func(ctx context.Context, cmd *Command) error {
+			return printShellCompletion(ctx, cmd, appName)
+		},
+	}
+}
+
+func printShellCompletion(_ context.Context, cmd *Command, appName string) error {
+	var shells []string
+	for k := range shellCompletions {
+		shells = append(shells, k)
+	}
+
+	sort.Strings(shells)
+
+	if cmd.Args().Len() == 0 {
+		return Exit(fmt.Sprintf("no shell provided for completion command. available shells are %+v", shells), 1)
+	}
+	s := cmd.Args().First()
+
+	renderCompletion, ok := shellCompletions[s]
+	if !ok {
+		return Exit(fmt.Sprintf("unknown shell %s, available shells are %+v", s, shells), 1)
+	}
+
+	completionScript, err := renderCompletion(cmd, appName)
+	if err != nil {
+		return Exit(err, 1)
+	}
+
+	_, err = cmd.Writer.Write([]byte(completionScript))
+	if err != nil {
+		return Exit(err, 1)
+	}
+
+	return nil
+}