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,69 @@
+// Copyright 2026 The Gitea Authors. All rights reserved.
+// SPDX-License-Identifier: MIT
+
+package app
+
+import (
+	"errors"
+	"io"
+	"strconv"
+	"time"
+
+	"gitea.dev/tea/internal/clierr"
+	"github.com/spf13/cobra"
+	"github.com/spf13/cobra/doc"
+)
+
+func (a *application) manCommand() *cobra.Command {
+	var output string
+	command := &cobra.Command{
+		Use: "man [command...]", Short: "Generate the full manual or a command's man page", Hidden: true,
+		Annotations: textOutput("man pages are troff"),
+		RunE: func(cmd *cobra.Command, args []string) error {
+			// Use built-ins only so personal aliases and settings cannot change the manual.
+			root := NewRoot(Dependencies{})
+			target, remaining, err := root.Find(args)
+			if err != nil || len(remaining) != 0 {
+				return clierr.Wrap(clierr.Usage, errors.New("unknown manual command; use tea help to list commands"))
+			}
+			date := ManualDate(a.deps.Getenv)
+			return writeOutput(cmd, output, func(writer io.Writer) error {
+				var render func(*cobra.Command) error
+				render = func(page *cobra.Command) error {
+					if err := cmd.Context().Err(); err != nil {
+						return err
+					}
+					page.DisableAutoGenTag = true
+					// GenMan fills an empty Title from the command path by mutating the header, so each page needs its own.
+					header := &doc.GenManHeader{Section: "1", Date: &date, Source: "Tea", Manual: "Tea Manual"}
+					if err := doc.GenMan(page, header, writer); err != nil {
+						return err
+					}
+					if len(args) == 0 {
+						for _, child := range page.Commands() {
+							if child.Hidden {
+								continue
+							}
+							if err := render(child); err != nil {
+								return err
+							}
+						}
+					}
+					return nil
+				}
+				return render(target)
+			})
+		},
+	}
+	command.Flags().StringVarP(&output, "output-file", "o", "", "Write the man page to a new file (default stdout)")
+	return command
+}
+
+// ManualDate dates man pages from SOURCE_DATE_EPOCH, falling back to a fixed date so the
+// manual stays reproducible when the variable is unset.
+func ManualDate(getenv func(string) string) time.Time {
+	if seconds, err := strconv.ParseInt(getenv("SOURCE_DATE_EPOCH"), 10, 64); err == nil {
+		return time.Unix(seconds, 0).UTC()
+	}
+	return time.Date(2026, time.January, 1, 0, 0, 0, 0, time.UTC)
+}