diff --git a/README.md b/README.md index 17b6049..bb8876b 100644 --- a/README.md +++ b/README.md @@ -908,3 +908,7 @@ See [skills/gitlink-shared/references/api-reference.md](./skills/gitlink-shared/ ## License [MulanPSL-2.0](https://license.coscl.org.cn/MulanPSL2) + +# Low-level git objects: tree entries and blob content by SHA +gitlink-cli repo +git-tree --owner myname --repo myrepo -s master --recursive +gitlink-cli repo +blob --owner myname --repo myrepo -s --decode diff --git a/internal/i18n/locales/en-US.json b/internal/i18n/locales/en-US.json index dc1dc1c..ae73266 100644 --- a/internal/i18n/locales/en-US.json +++ b/internal/i18n/locales/en-US.json @@ -81,9 +81,11 @@ "cmd.release.list.short": "List releases", "cmd.release.short": "Release operations", "cmd.release.view.short": "View release details", + "cmd.repo.blob.short": "Fetch a git blob object by SHA", "cmd.repo.create.short": "Create a new repository", "cmd.repo.delete.short": "Delete a repository", "cmd.repo.fork.short": "Fork a repository", + "cmd.repo.git_tree.short": "List entries of a git tree object by SHA or ref", "cmd.repo.info.short": "Show repository details", "cmd.repo.list.short": "List repositories for a user or organization", "cmd.repo.short": "Repository operations", @@ -210,6 +212,9 @@ "flag.repo": "Repository name (auto-detected from git remote)", "flag.repo.category": "Filter: manage/mirror/sync/fork/all (default: manage)", "flag.repo.description": "Repository description", + "flag.repo.git.decode": "Print decoded blob content instead of the JSON envelope", + "flag.repo.git.recursive": "Recurse into subtrees", + "flag.repo.git.sha": "Object SHA (git-tree also accepts a branch/tag ref)", "flag.repo.name": "Repository name", "flag.repo.private": "Make repository private (true/false)", "flag.repo.tree.path": "Directory path to list (default: repository root)", diff --git a/internal/i18n/locales/zh-CN.json b/internal/i18n/locales/zh-CN.json index c47aa6b..449289c 100644 --- a/internal/i18n/locales/zh-CN.json +++ b/internal/i18n/locales/zh-CN.json @@ -81,9 +81,11 @@ "cmd.release.list.short": "列出发布", "cmd.release.short": "发布操作", "cmd.release.view.short": "查看发布详情", + "cmd.repo.blob.short": "按 SHA 获取 git blob 对象", "cmd.repo.create.short": "创建新仓库", "cmd.repo.delete.short": "删除仓库", "cmd.repo.fork.short": "Fork 仓库", + "cmd.repo.git_tree.short": "按 SHA 或 ref 列出 git tree 对象条目", "cmd.repo.info.short": "显示仓库详情", "cmd.repo.list.short": "列出用户或组织的仓库", "cmd.repo.short": "仓库操作", @@ -210,6 +212,9 @@ "flag.repo": "仓库名称(自动从 git remote 检测)", "flag.repo.category": "筛选:manage/mirror/sync/fork/all(默认:manage)", "flag.repo.description": "仓库描述", + "flag.repo.git.decode": "直接输出解码后的 blob 内容而非 JSON 包裹", + "flag.repo.git.recursive": "递归子目录", + "flag.repo.git.sha": "对象 SHA(git-tree 也接受分支/标签 ref)", "flag.repo.name": "仓库名称", "flag.repo.private": "设为私有仓库(true/false)", "flag.repo.tree.path": "要列出的目录路径(默认:仓库根目录)", diff --git a/shortcuts/repo/repo.go b/shortcuts/repo/repo.go index 06774a6..ecbcfa8 100644 --- a/shortcuts/repo/repo.go +++ b/shortcuts/repo/repo.go @@ -1,6 +1,7 @@ package repo import ( + "encoding/base64" "fmt" "net/url" "strconv" @@ -108,6 +109,72 @@ func Shortcuts(translators ...*i18n.Translator) []*common.Shortcut { return ctx.Output(env) }, }, + { + Name: "git-tree", + Description: tr.T("cmd.repo.git_tree.short"), + Flags: []common.Flag{ + {Name: "sha", Short: "s", Usage: tr.T("flag.repo.git.sha"), Required: true}, + {Name: "recursive", Short: "r", Usage: tr.T("flag.repo.git.recursive"), Bool: true}, + {Name: "page", Short: "p", Usage: tr.T("flag.page"), Default: "1"}, + {Name: "limit", Short: "l", Usage: tr.T("flag.limit"), Default: "20"}, + }, + Run: func(ctx *common.RuntimeContext) error { + if err := ctx.ResolveOwnerRepo(); err != nil { + return err + } + sha, err := ctx.RequireArg("sha") + if err != nil { + return err + } + q := url.Values{} + q.Set("page", ctx.Arg("page")) + q.Set("limit", ctx.Arg("limit")) + if ctx.Arg("recursive") == "true" { + q.Set("recursive", "true") + } + env, err := ctx.CallAPIWithQuery("GET", fmt.Sprintf("/v1%s/git/trees/%s", ctx.RepoPath(), url.PathEscape(sha)), q) + if err != nil { + return err + } + return ctx.Output(env) + }, + }, + { + Name: "blob", + Description: tr.T("cmd.repo.blob.short"), + Flags: []common.Flag{ + {Name: "sha", Short: "s", Usage: tr.T("flag.repo.git.sha"), Required: true}, + {Name: "decode", Short: "d", Usage: tr.T("flag.repo.git.decode"), Bool: true}, + }, + Run: func(ctx *common.RuntimeContext) error { + if err := ctx.ResolveOwnerRepo(); err != nil { + return err + } + sha, err := ctx.RequireArg("sha") + if err != nil { + return err + } + env, err := ctx.CallAPI("GET", fmt.Sprintf("/v1%s/git/blobs/%s", ctx.RepoPath(), url.PathEscape(sha)), nil) + if err != nil { + return err + } + if ctx.Arg("decode") == "true" { + if data, ok := env.Data.(map[string]interface{}); ok { + if enc, _ := data["encoding"].(string); enc == "base64" { + if content, _ := data["content"].(string); content != "" { + decoded, err := base64.StdEncoding.DecodeString(content) + if err != nil { + return fmt.Errorf("decode blob content: %w", err) + } + fmt.Print(string(decoded)) + return nil + } + } + } + } + return ctx.Output(env) + }, + }, { Name: "languages", Description: "Show repository language statistics", diff --git a/shortcuts/repo/repo_test.go b/shortcuts/repo/repo_test.go index 5c5f34b..4aa29c2 100644 --- a/shortcuts/repo/repo_test.go +++ b/shortcuts/repo/repo_test.go @@ -1,10 +1,12 @@ package repo import ( + "encoding/base64" "encoding/json" "fmt" "net/http" "net/http/httptest" + "strings" "testing" "github.com/gitlink-org/gitlink-cli/internal/client" @@ -634,3 +636,42 @@ func assertEqual(t *testing.T, got interface{}, want interface{}) { t.Fatalf("got %v (%T), want %v (%T)", got, got, want, want) } } + +func TestRepoGitTreeBuildsPathAndRecursive(t *testing.T) { + var query string + server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + if r.Method != "GET" || r.URL.Path != "/v1/owner/repo/git/trees/master.json" { + t.Fatalf("unexpected request: %s %s", r.Method, r.URL.Path) + } + query = r.URL.RawQuery + writeJSON(t, w, map[string]interface{}{"total_count": float64(2), "entries": []interface{}{}}) + })) + defer server.Close() + + if err := runShortcut(t, server, "git-tree", map[string]string{"sha": "master", "recursive": "true", "page": "1", "limit": "20"}); err != nil { + t.Fatalf("git-tree failed: %v", err) + } + if !strings.Contains(query, "recursive=true") { + t.Fatalf("expected recursive=true in query, got %q", query) + } +} + +func TestRepoBlobDecode(t *testing.T) { + server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + if r.Method != "GET" || r.URL.Path != "/v1/owner/repo/git/blobs/abc123.json" { + t.Fatalf("unexpected request: %s %s", r.Method, r.URL.Path) + } + writeJSON(t, w, map[string]interface{}{ + "sha": "abc123", "encoding": "base64", + "content": base64.StdEncoding.EncodeToString([]byte("hello blob")), + }) + })) + defer server.Close() + + if err := runShortcut(t, server, "blob", map[string]string{"sha": "abc123", "decode": "true"}); err != nil { + t.Fatalf("blob failed: %v", err) + } + if err := runShortcut(t, server, "blob", map[string]string{"sha": "abc123"}); err != nil { + t.Fatalf("blob without decode failed: %v", err) + } +}