feat!: rebuild tea on Cobra with explicit noun/verb commands (#1126)

- **switch tea to the Cobra command tree:** `internal/app` wires the packages from parts 1–4 into explicit noun/verb commands with `--repo`, `--json` / `--jq`, `--sudo` and `--debug`; `main.go` points at it. Build, release and docs tooling (`tools/cli-docs`, Makefile, goreleaser, snap, CI) and README / CONTRIBUTING are updated. - **remove the urfave/cli command tree:** deletes `cmd/`, `modules/`, the old integration tests, contrib completion scripts and the generated `docs/CLI.md`, and drops their dependencies. This commit only deletes. ## Breaking changes This is a breaking release. It requires Gitea 28 or newer; configuration moves to separate `config.yml` and `hosts.yml` files and requires fresh authentication, and command names, aliases, flags and output formats change. `docs/migration-1.0.md` maps every old command, flag and environment variable to its replacement. ## Issues fixes #1118 fixes #1116 fixes #1115 fixes #1094 fixes #1091 fixes #1073 fixes #1052 fixes #1032 fixes #1023 fixes #966 fixes #908 fixes #833 fixes #831 fixes #817 fixes #804 fixes #779 fixes #770 fixes #737 fixes #697 fixes #726 fixes #677 fixes #672 fixes #633 fixes #632 fixes #560 fixes #556 fixes #523 fixes #516 fixes #510 fixes #504 fixes #500 fixes #482 fixes #406 fixes #403 fixes #373 fixes #351 fixes #344 fixes #326 fixes #325 fixes #323 fixes #246 fixes #240 fixes #232 fixes #197 fixes #172 fixes #141 fixes #69 fixes #1110 fixes #569 fixes #480 fixes #666 fixes #670 fixes #457 fixes #643 fixes #498 fixes #490 fixes #1069 fixes #834 fixes #602 fixes #328 fixes #417 fixes #571 fixes #1029 fixes #489 fixes #1050 fixes #162 fixes #430 fixes #1087 fixes #683 Reviewed-on: https://gitea.com/gitea/tea/pulls/1126 Reviewed-by: TheFox0x7 <95654+thefox0x7@noreply.gitea.com>
2026-10-26 19:11:25 +01:00 · 2026-10-11 17:23:06 +00:00
1 parent 12e415a7a7
commit f02245449b
@@ -1,141 +0,0 @@
-// Copyright 2020 The Gitea Authors. All rights reserved.
-// SPDX-License-Identifier: MIT
-
-package times
-
-import (
-	stdctx "context"
-	"fmt"
-	"strings"
-	"time"
-
-	"gitea.dev/sdk"
-
-	"gitea.dev/tea/cmd/flags"
-	"gitea.dev/tea/modules/context"
-	"gitea.dev/tea/modules/print"
-	"gitea.dev/tea/modules/utils"
-	"github.com/araddon/dateparse"
-	"github.com/urfave/cli/v3"
-)
-
-// NOTE: not using NewCsvFlag, as we don't want an alias & default value.
-var timeFieldsFlag = &flags.CsvFlag{
-	AvailableFields: print.TrackedTimeFields,
-	StringFlag: cli.StringFlag{
-		Name: "fields",
-		Usage: fmt.Sprintf(`Comma-separated list of fields to print. Available values:
-	%s
-`, strings.Join(print.TrackedTimeFields, ",")),
-	},
-}
-
-// CmdTrackedTimesList represents a sub command of times to list them
-var CmdTrackedTimesList = cli.Command{
-	Name:    "list",
-	Aliases: []string{"ls"},
-	Action:  RunTimesList,
-	Usage:   "List tracked times on issues & pulls",
-	Description: `List tracked times, across repos, or on a single repo or issue:
- given a username all times on a repo by that user are shown,
- given a issue index with '#' prefix, all times on that issue are listed,
- given --mine, your times are listed across all repositories.
-Depending on your permissions on the repository, only your own tracked times might be listed.`,
-	ArgsUsage: "[username | #issue]",
-
-	Flags: append([]cli.Flag{
-		&cli.StringFlag{
-			Name:    "from",
-			Aliases: []string{"f"},
-			Usage:   "Show only times tracked after this date",
-		},
-		&cli.StringFlag{
-			Name:    "until",
-			Aliases: []string{"u"},
-			Usage:   "Show only times tracked before this date",
-		},
-		&cli.BoolFlag{
-			Name:    "total",
-			Aliases: []string{"t"},
-			Usage:   "Print the total duration at the end",
-		},
-		&cli.BoolFlag{
-			Name:    "mine",
-			Aliases: []string{"m"},
-			Usage:   "Show all times tracked by you across all repositories (overrides command arguments)",
-		},
-		timeFieldsFlag,
-		&flags.PaginationPageFlag,
-		&flags.PaginationLimitFlag,
-	}, flags.AllDefaultFlags...),
-}
-
-// RunTimesList list repositories
-func RunTimesList(requestCtx stdctx.Context, cmd *cli.Command) error {
-	ctx, err := context.InitCommand(cmd)
-	if err != nil {
-		return err
-	}
-	if err := ctx.Ensure(context.CtxRequirement{RemoteRepo: true}); err != nil {
-		return err
-	}
-	client := ctx.Login.Client()
-
-	var times []*gitea.TrackedTime
-	var from, until time.Time
-	var fields []string
-
-	if ctx.IsSet("from") {
-		from, err = dateparse.ParseLocal(ctx.String("from"))
-		if err != nil {
-			return err
-		}
-	}
-	if ctx.IsSet("until") {
-		until, err = dateparse.ParseLocal(ctx.String("until"))
-		if err != nil {
-			return err
-		}
-	}
-
-	opts := gitea.ListTrackedTimesOptions{
-		ListOptions: flags.GetListOptions(cmd),
-		Since:       from,
-		Before:      until,
-	}
-
-	user := ctx.Args().First()
-	if ctx.Bool("mine") {
-		times, _, err = client.Issues.ListMyTrackedTimes(requestCtx, opts)
-		fields = []string{"created", "repo", "issue", "duration"}
-	} else if user == "" {
-		// get all tracked times on the repo
-		times, _, err = client.Issues.ListRepoTrackedTimes(requestCtx, ctx.Owner, ctx.Repo, opts)
-		fields = []string{"created", "issue", "user", "duration"}
-	} else if strings.HasPrefix(user, "#") {
-		// get all tracked times on the specified issue
-		issue, parseErr := utils.ArgToIndex(user)
-		if parseErr != nil {
-			return parseErr
-		}
-		times, _, err = client.Issues.ListIssueTrackedTimes(requestCtx, ctx.Owner, ctx.Repo, issue, opts)
-		fields = []string{"created", "user", "duration"}
-	} else {
-		// get all tracked times by the specified user
-		opts.User = user
-		times, _, err = client.Issues.ListRepoTrackedTimes(requestCtx, ctx.Owner, ctx.Repo, opts)
-		fields = []string{"created", "issue", "duration"}
-	}
-
-	if err != nil {
-		return err
-	}
-
-	if ctx.IsSet("fields") {
-		if fields, err = timeFieldsFlag.GetValues(cmd); err != nil {
-			return err
-		}
-	}
-
-	return print.TrackedTimesList(times, ctx.Output, fields, ctx.Bool("total"))
-}