start using urfave-cli v3

- only used when SRC_INTERNAL_CLIFLAGS_V2 is 1
- add 'old' command, which runs the usual src cli commands until all
  commands are migrated

Author: burmudar

cmd/src/main.go

@@ -1,6 +1,7 @@
 package main
 
 import (
+	"context"
 	"encoding/json"
 	"flag"
 	"io"
@@ -12,6 +13,8 @@ import (
 	"slices"
 	"strings"
 
+	"github.com/urfave/cli/v3"
+
 	"github.com/sourcegraph/sourcegraph/lib/errors"
 
 	"github.com/sourcegraph/src-cli/internal/api"
@@ -85,11 +88,56 @@ var (
 // commands contains all registered subcommands.
 var commands commander
 
+var mainCmd = &cli.Command{
+	Name:      "src",
+	Aliases:   []string{},
+	Usage:     "Sourcegraph CLI tool",
+	ArgsUsage: "command [options]",
+	Version:   "dev",
+	Description: `src is a tool that provides access to Sourcegraph instances.
+For more information, see https://github.com/sourcegraph/src-cli`,
+	DefaultCommand: "old",
+	Category:       "",
+	Commands: []*cli.Command{
+		oldSrcCmd,
+	},
+	Flags:                    []cli.Flag{},
+	InvalidFlagAccessHandler: nil,
+	Hidden:                   false,
+	Authors:                  []any{},
+	Copyright:                "Sourcegraph, Inc.",
+	HideVersion:              false,
+}
+
+// oldSrcCmd is a temporary command that just runs the old cli.
+//
+// Any top level flags like --help / -v will be capture by urfave parser
+var oldSrcCmd = &cli.Command{
+	Name:        "old",
+	Description: "run the old src command line parser",
+	Hidden:      true,
+	HideHelp:    true,
+	Action: func(ctx context.Context, c *cli.Command) error {
+		oldRun()
+		return nil
+	},
+}
+
 func main() {
 	// Configure logging.
 	log.SetFlags(0)
 	log.SetPrefix("")
 
+	if os.Getenv("SRC_INTERNAL_CLIFLAGS_V2") == "1" {
+		if err := mainCmd.Run(context.Background(), os.Args); err != nil {
+			log.Fatal(err)
+		}
+	} else {
+		oldRun()
+	}
+}
+
+func oldRun() {
 	commands.run(flag.CommandLine, "src", usageText, normalizeDashHelp(os.Args[1:]))
 }
 

go.mod

@@ -29,6 +29,7 @@ require (
 	github.com/sourcegraph/scip v0.6.1
 	github.com/sourcegraph/sourcegraph/lib v0.0.0-20240709083501-1af563b61442
 	github.com/stretchr/testify v1.11.1
+	github.com/urfave/cli/v3 v3.6.1
 	golang.org/x/net v0.44.0
 	golang.org/x/sync v0.17.0
 	google.golang.org/api v0.132.0

go.sum

@@ -451,6 +451,8 @@ github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD
 github.com/tetratelabs/wazero v1.3.0 h1:nqw7zCldxE06B8zSZAY0ACrR9OH5QCcPwYmYlwtcwtE=
 github.com/tetratelabs/wazero v1.3.0/go.mod h1:wYx2gNRg8/WihJfSDxA1TIL8H+GkfLYm+bIfbblu9VQ=
 github.com/urfave/cli v1.22.12/go.mod h1:sSBEIC79qR6OvcmsD4U3KABeOTxDqQtdDnaFuUN30b8=
+github.com/urfave/cli/v3 v3.6.1 h1:j8Qq8NyUawj/7rTYdBGrxcH7A/j7/G8Q5LhWEW4G3Mo=
+github.com/urfave/cli/v3 v3.6.1/go.mod h1:ysVLtOEmg2tOy6PknnYVhDoouyC/6N42TMeoMzskhso=
 github.com/vbatts/tar-split v0.11.3 h1:hLFqsOLQ1SsppQNTMpkpPXClLDfC2A3Zgy9OUU+RVck=
 github.com/vbatts/tar-split v0.11.3/go.mod h1:9QlHN18E+fEH7RdG+QAJJcuya3rqT7eXSTY7wGrAokY=
 github.com/x448/float16 v0.8.4 h1:qLwI1I70+NjRFUR3zs1JPUCgaCXSh3SW62uAKT1mSBM=