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 11:01:25 +01:00 · 2026-10-11 17:23:06 +00:00
1 parent 12e415a7a7
commit f02245449b
@@ -0,0 +1,116 @@
+// Copyright 2026 The Gitea Authors. All rights reserved.
+// SPDX-License-Identifier: MIT
+
+package app
+
+import (
+	"errors"
+	"strconv"
+
+	"gitea.dev/tea/internal/clierr"
+	"gitea.dev/tea/internal/services"
+	"gitea.dev/tea/internal/terminal"
+	"github.com/spf13/cobra"
+)
+
+func (a *application) prCommand() *cobra.Command {
+	group := &cobra.Command{Use: "pr", Short: "Work with pull requests"}
+	group.AddCommand(a.pullChecksCommand(), a.pullCheckoutCommand(), a.pullCleanCommand(), a.statusCommand(true))
+	var limit, page int
+	var state string
+	var options services.PullListOptions
+	var labels []string
+	list := &cobra.Command{Use: "list", Short: "List pull requests", Args: argsExact(0), RunE: func(cmd *cobra.Command, _ []string) error {
+		if err := oneOf("state", state, "open", "closed", "all"); err != nil {
+			return err
+		}
+		if options.Milestone < 0 {
+			return clierr.Wrap(clierr.Usage, errors.New("--milestone must be a nonnegative ID"))
+		}
+		if options.Sort != "" {
+			if err := oneOf("sort", options.Sort, "oldest", "recentupdate", "recentclose", "leastupdate", "mostcomment", "leastcomment", "priority"); err != nil {
+				return err
+			}
+		}
+		target, err := a.resolve(cmd.Context(), true)
+		if err != nil {
+			return err
+		}
+		options.State, options.Limit, options.Page = state, limit, page
+		options.Labels, err = (services.Labels{Client: target.client, Repository: target.Repo}).ResolveIssueNames(cmd.Context(), labels)
+		if err != nil {
+			return err
+		}
+		items, more, err := (services.Pulls{Client: target.client, Repository: target.Repo}).List(cmd.Context(), options)
+		if err != nil {
+			return err
+		}
+		if err := writeList(a, cmd, items, pullRow); err != nil {
+			return err
+		}
+		return a.morePagesHint(cmd, more, page)
+	}}
+	list.Flags().StringVar(&state, "state", "open", "Filter state: open, closed, all")
+	pageFlags(list, &limit, &page)
+	list.Flags().StringVar(&options.Author, "author", "", "Filter by author username")
+	list.Flags().StringVar(&options.Base, "base", "", "Filter by target branch")
+	list.Flags().StringVar(&options.Sort, "sort", "", "Order: oldest, recentupdate, recentclose, leastupdate, mostcomment, leastcomment, priority")
+	list.Flags().Int64Var(&options.Milestone, "milestone", 0, "Filter by milestone ID")
+	list.Flags().StringSliceVar(&labels, "label", nil, "Filter by label names (repo: or org: resolves ambiguity)")
+	group.AddCommand(list)
+	var web, comments bool
+	view := &cobra.Command{Use: "view [number]", Short: "View a pull request", Args: usageArgs(cobra.MaximumNArgs(1)), RunE: func(cmd *cobra.Command, args []string) error {
+		target, err := a.resolve(cmd.Context(), true)
+		if err != nil {
+			return err
+		}
+		service := services.Pulls{Client: target.client, Repository: target.Repo}
+		var item services.Pull
+		if len(args) == 1 {
+			n, err := number(args[0])
+			if err != nil {
+				return err
+			}
+			item, err = service.View(cmd.Context(), n)
+			if err != nil {
+				return err
+			}
+		} else {
+			head, err := a.currentBranch(cmd.Context())
+			if err != nil {
+				return clierr.Wrap(clierr.Usage, errors.New("supply a pull number outside a branch checkout"))
+			}
+			item, err = service.FindOpenByHead(cmd.Context(), head)
+			if err != nil {
+				return err
+			}
+		}
+		if web {
+			return a.openBrowser(cmd, item.URL)
+		}
+		if a.options.json != "" {
+			return a.writeJSON(cmd, item)
+		}
+		return a.writeDiscussion(cmd, target, pullView(item), comments)
+	}}
+	view.Flags().BoolVar(&web, "web", false, "Open the pull request in a browser")
+	view.Flags().BoolVarP(&comments, "comments", "c", false, "View pull request comments")
+	group.AddCommand(view)
+	a.addPullMutations(group)
+	group.AddCommand(a.pullEditCommand())
+	group.AddCommand(a.issueAttachmentCommand(), a.commentCommand())
+	return group
+}
+
+func pullRow(item services.Pull) []terminal.Cell {
+	state := pullState(item)
+	return []terminal.Cell{{Text: strconv.FormatInt(item.Number, 10), Link: item.URL}, {Text: item.Title}, {Text: state, Color: stateColors[state]}, {Text: item.Author}}
+}
+
+// pullState reports merged pull requests as merged rather than closed.
+func pullState(item services.Pull) string {
+	if item.Merged {
+		return "merged"
+	}
+	return item.State
+}