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,90 @@
+// Copyright 2026 The Gitea Authors. All rights reserved.
+// SPDX-License-Identifier: MIT
+
+package app
+
+import (
+	"context"
+	"net/http"
+	"testing"
+	"time"
+
+	"gitea.dev/tea/internal/clierr"
+	"github.com/stretchr/testify/require"
+)
+
+func TestRunTimeBoundsUseOneClockReading(t *testing.T) {
+	now := time.Date(2028, 2, 1, 12, 0, 0, 0, time.UTC)
+	deps, _, _ := testDeps(t)
+	reads := 0
+	deps.Now = func() time.Time { reads++; return now }
+	err := Execute(context.Background(), deps, []string{"run", "list", "--since=1h", "--until=2h"})
+	require.ErrorContains(t, err, "--since must not be later than --until")
+	require.Equal(t, 1, reads)
+}
+
+func TestRunWatchExitAndOutputContracts(t *testing.T) {
+	for _, test := range []struct {
+		name, status, conclusion string
+		code                     int
+	}{
+		{"success", "completed", "success", 0},
+		{"failed run", "completed", "failure", clierr.Failure},
+		{"timeout", "in_progress", "", clierr.Canceled},
+	} {
+		t.Run(test.name, func(t *testing.T) {
+			server := newAuthenticatedServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+				require.Equal(t, "/api/v1/repos/alice/project/actions/runs/7", r.URL.Path)
+				_, _ = w.Write([]byte(`{"id":7,"status":"` + test.status + `","conclusion":"` + test.conclusion + `"}`))
+			}))
+			defer server.Close()
+			deps, out, diagnostics := serverDeps(t, server.URL)
+			err := Execute(context.Background(), deps, []string{"run", "watch", "7", "--repo", "alice/project", "--json=id,status,conclusion", "--interval=1ms", "--timeout=100ms", "--no-input"})
+			require.Equal(t, test.code, clierr.ExitCode(err))
+			if test.code == clierr.Canceled {
+				require.ErrorIs(t, err, context.DeadlineExceeded)
+				require.Empty(t, out.String())
+			} else {
+				require.JSONEq(t, `{"id":7,"status":"completed","conclusion":"`+test.conclusion+`"}`, out.String())
+			}
+			require.Contains(t, diagnostics.String(), "run 7:")
+		})
+	}
+}
+
+func TestWorkflowRunFollowStreamsFirstJobLogs(t *testing.T) {
+	jobPolls := 0
+	server := newAuthenticatedServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		switch {
+		case r.Method == http.MethodPost && r.URL.Path == "/api/v1/repos/owner/repo/actions/workflows/ci.yml/dispatches":
+			require.Equal(t, "true", r.URL.Query().Get("return_run_details"))
+			_, _ = w.Write([]byte(`{"workflow_run_id":11,"html_url":"https://gitea.test/owner/repo/actions/runs/11"}`))
+		case r.URL.Path == "/api/v1/repos/owner/repo/actions/runs/11/jobs":
+			jobPolls++
+			if r.URL.Query().Get("page") != "" && r.URL.Query().Get("page") != "1" {
+				_, _ = w.Write([]byte(`{"jobs":[]}`))
+				return
+			}
+			_, _ = w.Write([]byte(`{"jobs":[{"id":21,"name":"build","status":"completed","conclusion":"success"}]}`))
+		case r.URL.Path == "/api/v1/repos/owner/repo/actions/jobs/21/logs":
+			_, _ = w.Write([]byte("hello from job\n"))
+		case r.URL.Path == "/api/v1/repos/owner/repo/actions/runs/11":
+			_, _ = w.Write([]byte(`{"id":11,"status":"completed","conclusion":"success","display_title":"ci"}`))
+		default:
+			t.Fatalf("unexpected %s %s", r.Method, r.URL.Path)
+		}
+	}))
+	defer server.Close()
+	deps, out, diagnostics := serverDeps(t, server.URL)
+	require.NoError(t, Execute(context.Background(), deps, []string{"workflow", "run", "ci.yml", "-R", "owner/repo", "--ref", "main", "--follow", "--no-input"}))
+	require.Contains(t, out.String(), "11\thttps://gitea.test/owner/repo/actions/runs/11")
+	require.Contains(t, out.String(), "hello from job\n")
+	require.Contains(t, diagnostics.String(), "Waiting for run 11 jobs")
+	require.Contains(t, diagnostics.String(), "Following job 21 (build)")
+	require.GreaterOrEqual(t, jobPolls, 1)
+
+	err := Execute(context.Background(), deps, []string{"workflow", "run", "ci.yml", "-R", "owner/repo", "--ref", "main", "--follow", "--json", "--no-input"})
+	require.Error(t, err)
+	require.Equal(t, clierr.Usage, clierr.ExitCode(err))
+	require.Contains(t, err.Error(), "--follow cannot be combined with --json")
+}