teai/internal/cli/exitcode_test.go

// exitcode_test.go 驗證結束碼映射：用法錯誤 → 2、API 錯誤 → 3、其他 → 1，
// 以及全域選項剖析（README「輸出與結束碼」「全域介面」）。
package cli

import (
	"strings"
	"testing"

	"gitea.alterminal.com/alterminal/teai/internal/gitea"
)

func TestExitCodeMapping(t *testing.T) {
	cases := []struct {
		name string
		err  error
		want ExitCode
	}{
		{"usage error", &ErrUsage{Msg: "bad flag"}, ExitUsage},
		{"api error 401", &gitea.ErrAPI{StatusCode: 401, Op: "GET /api/v1/user"}, ExitAPI},
		{"api error transport", &gitea.ErrAPI{Op: "GET /api/v1/user", Err: errString("dial tcp")}, ExitAPI},
		{"wrapped api error", wrapped(&gitea.ErrAPI{StatusCode: 500}), ExitAPI},
		{"other error", errString("boom"), ExitInternal},
		{"nil maps to OK", nil, ExitOK},
	}
	for _, tc := range cases {
		if got := exitCodeFor(tc.err); got != tc.want {
			t.Errorf("%s: exitCodeFor = %d, want %d", tc.name, got, tc.want)
		}
	}
}

func TestRunExitCodes(t *testing.T) {
	t.Run("unknown command exits 2", func(t *testing.T) {
		_, _, code := run("no-such")
		if code != 2 {
			t.Fatalf("code = %d, want 2", code)
		}
	})
	t.Run("unknown global option exits 2", func(t *testing.T) {
		_, _, code := run("--wat", "version")
		if code != 2 {
			t.Fatalf("code = %d, want 2", code)
		}
	})
	t.Run("missing option value exits 2", func(t *testing.T) {
		_, _, code := run("--output")
		if code != 2 {
			t.Fatalf("code = %d, want 2", code)
		}
	})
	t.Run("invalid output value exits 2", func(t *testing.T) {
		_, _, code := run("--output=yaml", "version")
		if code != 2 {
			t.Fatalf("code = %d, want 2", code)
		}
	})
	t.Run("invalid timeout exits 2", func(t *testing.T) {
		_, _, code := run("--timeout=soon", "version")
		if code != 2 {
			t.Fatalf("code = %d, want 2", code)
		}
	})
	t.Run("version still works with globals", func(t *testing.T) {
		stdout, _, code := run("--output=table", "--timeout=10s", "version")
		if code != 0 || !strings.Contains(stdout, "teai version ") {
			t.Fatalf("code = %d stdout = %q", code, stdout)
		}
	})
}

func TestParseGlobals(t *testing.T) {
	g := defaultGlobals()
	rest, err := parseGlobals(&g, []string{
		"--url", "https://example.com",
		"--token=tok",
		"--config", "/tmp/c.yml",
		"--output", "table",
		"--timeout", "45s",
		"next",
	})
	if err != nil {
		t.Fatal(err)
	}
	if len(rest) != 1 || rest[0] != "next" {
		t.Fatalf("rest = %v, want [next]", rest)
	}
	if g.URL != "https://example.com" || g.Token != "tok" || g.ConfigPath != "/tmp/c.yml" {
		t.Fatalf("globals = %+v", g)
	}
	if g.Output != gitea.FormatTable {
		t.Fatalf("output = %v, want table", g.Output)
	}
	if g.Timeout.String() != "45s" {
		t.Fatalf("timeout = %s", g.Timeout)
	}
}

func TestParseGlobalsStopsAtCommand(t *testing.T) {
	g := defaultGlobals()
	rest, err := parseGlobals(&g, []string{"version", "--output", "table"})
	if err != nil {
		t.Fatal(err)
	}
	// 命令之後的選項屬於命令，不屬於全域。
	if len(rest) != 3 || rest[0] != "version" {
		t.Fatalf("rest = %v", rest)
	}
}

// TestExtractGlobalsReservedFlags 驗證 #18：與全域同名的命令旗標
// （登記於 commandReservedFlags）必須留給命令，其餘全域選項照常抽取。
func TestExtractGlobalsReservedFlags(t *testing.T) {
	g := defaultGlobals()
	rest, err := extractGlobals(&g, []string{
		"add",
		"--url", "https://srv.example.com", // login add 自有旗標：保留
		"--token=tok", // 同上（inline 形式）：保留
		"--name", "test-site",
		"--output", "table", // 非保留：仍是全域
	}, reservedFlags("login"))
	if err != nil {
		t.Fatal(err)
	}
	want := []string{"add", "--url", "https://srv.example.com", "--token=tok", "--name", "test-site"}
	if len(rest) != len(want) {
		t.Fatalf("rest = %v, want %v", rest, want)
	}
	for i := range want {
		if rest[i] != want[i] {
			t.Fatalf("rest = %v, want %v", rest, want)
		}
	}
	if g.Output != gitea.FormatTable {
		t.Fatalf("output = %v, want table", g.Output)
	}
	if g.URL != defaultGlobals().URL || g.Token != "" {
		t.Fatalf("reserved flags must not leak into globals: %+v", g)
	}
}

// TestExtractGlobalsNonReservedCommand 驗證 #13 行為不回歸：未登記保留
// 旗標的命令（如 next/members/pulls），命令後的全域選項照常抽取、
// 命令自己的旗標（--has-work 等）原樣保留。
func TestExtractGlobalsNonReservedCommand(t *testing.T) {
	g := defaultGlobals()
	rest, err := extractGlobals(&g, []string{
		"members", "--has-work", "--output", "table",
	}, reservedFlags("members"))
	if err != nil {
		t.Fatal(err)
	}
	if len(rest) != 2 || rest[0] != "members" || rest[1] != "--has-work" {
		t.Fatalf("rest = %v, want [members --has-work]", rest)
	}
	if g.Output != gitea.FormatTable {
		t.Fatalf("output = %v, want table", g.Output)
	}
}

// errString 把字串轉成 error（測試輔助）。
type errStr string

func (e errStr) Error() string { return string(e) }

func errString(s string) error { return errStr(s) }

// wrapped 包一層 error（測試 errors.As 穿透）。
type wrappedErr struct{ inner error }

func (w wrappedErr) Error() string { return "wrapped: " + w.inner.Error() }
func (w wrappedErr) Unwrap() error { return w.inner }

func wrapped(inner error) error { return wrappedErr{inner} }