gitlink-cli/shortcuts/release/release.go

677 lines
19 KiB
Go

package release
import (
"errors"
"fmt"
"io"
"net/http"
"net/url"
"os"
"path/filepath"
"strconv"
"strings"
"github.com/gitlink-org/gitlink-cli/internal/i18n"
"github.com/gitlink-org/gitlink-cli/shortcuts/common"
)
// resolveVersionID maps a user-supplied release reference (tag name, gitea
// release id, or database version_id) to the database version_id that the
// `/releases/:id` show/edit/destroy endpoints expect. The list endpoint is
// the only one exposing both identifiers, so we page through it and match.
func resolveVersionID(ctx *common.RuntimeContext, ref string) (string, error) {
for page := 1; page <= 100; page++ {
q := url.Values{}
q.Set("page", strconv.Itoa(page))
q.Set("limit", "50")
env, err := ctx.CallAPIWithQuery("GET", ctx.RepoPath()+"/releases", q)
if err != nil {
return "", err
}
data, _ := env.Data.(map[string]interface{})
releases, _ := data["releases"].([]interface{})
if len(releases) == 0 {
break
}
for _, r := range releases {
rel, _ := r.(map[string]interface{})
tag, _ := rel["tag_name"].(string)
gid := fmt.Sprintf("%v", rel["id"])
versionID := fmt.Sprintf("%v", rel["version_id"])
if ref == tag || ref == gid || ref == versionID {
return versionID, nil
}
}
}
return "", fmt.Errorf("release %q not found", ref)
}
func Shortcuts(translators ...*i18n.Translator) []*common.Shortcut {
tr := shortcutTranslator(translators...)
return []*common.Shortcut{
{
Name: "list",
Description: tr.T("cmd.release.list.short"),
Flags: []common.Flag{
{Name: "page", Short: "p", Usage: tr.T("flag.page"), Default: "1"},
{Name: "limit", Short: "l", Usage: tr.T("flag.limit"), Default: "20"},
{Name: "all", Usage: tr.T("flag.all"), Bool: true, Default: "false"},
},
Run: func(ctx *common.RuntimeContext) error {
if err := ctx.ResolveOwnerRepo(); err != nil {
return err
}
q := url.Values{}
q.Set("page", ctx.Arg("page"))
q.Set("limit", ctx.Arg("limit"))
if ctx.Arg("all") == "true" {
items, err := ctx.PaginateAllKey(ctx.RepoPath()+"/releases", q, "releases")
if err != nil {
return err
}
return ctx.Output(common.NewListEnvelope("releases", items))
}
env, err := ctx.CallAPIWithQuery("GET", ctx.RepoPath()+"/releases", q)
if err != nil {
return err
}
return ctx.Output(env)
},
},
{
Name: "create",
Description: tr.T("cmd.release.create.short"),
Flags: []common.Flag{
{Name: "tag", Short: "t", Usage: tr.T("flag.release.tag"), Required: true},
{Name: "name", Short: "n", Usage: tr.T("flag.release.name"), Required: true},
{Name: "body", Short: "b", Usage: tr.T("flag.release.body")},
{Name: "target", Usage: tr.T("flag.release.target"), Default: "master"},
{Name: "prerelease", Usage: tr.T("flag.release.prerelease"), Default: "false"},
{Name: "draft", Usage: "Mark as draft (true/false)", Default: "false"},
{Name: "attachment-ids", Usage: "Comma-separated attachment IDs"},
{Name: "attachment-files", Usage: tr.T("flag.release.attachment_files")},
},
Run: func(ctx *common.RuntimeContext) error {
if err := ctx.ResolveOwnerRepo(); err != nil {
return err
}
tag, err := ctx.RequireArg("tag")
if err != nil {
return err
}
name, err := ctx.RequireArg("name")
if err != nil {
return err
}
draft, err := releaseBoolArg(ctx, "draft", false)
if err != nil {
return err
}
prerelease, err := releaseBoolArg(ctx, "prerelease", false)
if err != nil {
return err
}
payload := map[string]interface{}{
"tag_name": tag,
"name": name,
"draft": draft,
"prerelease": prerelease,
}
if b := ctx.Arg("body"); b != "" {
payload["body"] = b
}
if t := ctx.Arg("target"); t != "" {
payload["target_commitish"] = t
}
var ids []string
if attachmentIDs := ctx.Arg("attachment-ids"); attachmentIDs != "" {
ids, err = parseReleaseAttachmentIDs(attachmentIDs)
if err != nil {
return err
}
}
if files := ctx.Arg("attachment-files"); files != "" {
uploaded, err := uploadReleaseAttachments(ctx, files)
if err != nil {
return err
}
ids = append(ids, uploaded...)
}
if len(ids) > 0 {
payload["attachment_ids"] = ids
}
env, err := ctx.CallAPI("POST", ctx.RepoPath()+"/releases", payload)
if err != nil {
return err
}
return ctx.Output(env)
},
},
{
Name: "edit",
Description: "Get release edit data",
Flags: []common.Flag{
{Name: "id", Short: "i", Usage: tr.T("flag.release.id_or_tag"), Required: true},
},
Run: func(ctx *common.RuntimeContext) error {
if err := ctx.ResolveOwnerRepo(); err != nil {
return err
}
id, err := ctx.RequireArg("id")
if err != nil {
return err
}
id, err = resolveVersionID(ctx, id)
if err != nil {
return err
}
env, err := ctx.CallAPI("GET", fmt.Sprintf("%s/releases/%s/edit", ctx.RepoPath(), id), nil)
if err != nil {
return err
}
return ctx.Output(env)
},
},
{
Name: "view",
Description: tr.T("cmd.release.view.short"),
Flags: []common.Flag{
{Name: "id", Short: "i", Usage: tr.T("flag.release.id_or_tag"), Required: true},
},
Run: func(ctx *common.RuntimeContext) error {
if err := ctx.ResolveOwnerRepo(); err != nil {
return err
}
id, err := ctx.RequireArg("id")
if err != nil {
return err
}
versionID, err := resolveVersionID(ctx, id)
if err != nil {
return err
}
env, err := ctx.CallAPI("GET", fmt.Sprintf("%s/releases/%s", ctx.RepoPath(), versionID), nil)
if err != nil {
return err
}
return ctx.Output(env)
},
},
{
Name: "download",
Description: tr.T("cmd.release.download.short"),
Long: tr.T("cmd.release.download.long"),
Flags: []common.Flag{
{Name: "id", Short: "i", Usage: tr.T("flag.release.id_or_tag"), Required: true},
{Name: "output-dir", Short: "o", Usage: tr.T("flag.release.output_dir"), Default: "."},
},
Run: func(ctx *common.RuntimeContext) error {
if err := ctx.ResolveOwnerRepo(); err != nil {
return err
}
id, err := ctx.RequireArg("id")
if err != nil {
return err
}
versionID, err := resolveVersionID(ctx, id)
if err != nil {
return err
}
env, err := ctx.CallAPI("GET", fmt.Sprintf("%s/releases/%s", ctx.RepoPath(), versionID), nil)
if err != nil {
return err
}
data, _ := env.Data.(map[string]interface{})
attachments, _ := data["attachments"].([]interface{})
if len(attachments) == 0 {
return errors.New(tr.T("error.release.no_attachments"))
}
outDir := ctx.Arg("output-dir")
if err := os.MkdirAll(outDir, 0o755); err != nil {
return fmt.Errorf("create output dir %q: %w", outDir, err)
}
var downloaded []map[string]interface{}
for _, a := range attachments {
att, _ := a.(map[string]interface{})
title, _ := att["title"].(string)
attID := fmt.Sprintf("%v", att["id"])
if title == "" || attID == "" || att["id"] == nil {
continue
}
dest := filepath.Join(outDir, filepath.Base(title))
n, err := ctx.Client.DownloadFile("/attachments/"+attID, dest)
if err != nil {
return fmt.Errorf("download %q failed: %w", title, err)
}
downloaded = append(downloaded, map[string]interface{}{
"file": dest,
"bytes": n,
})
}
return ctx.OutputData(map[string]interface{}{
"release": id,
"files": downloaded,
})
},
},
{
Name: "update",
Description: "Update a release while preserving unspecified fields",
Flags: []common.Flag{
{Name: "id", Short: "i", Usage: "Release version ID", Required: true},
{Name: "tag", Short: "t", Usage: "Tag name"},
{Name: "name", Short: "n", Usage: "Release name"},
{Name: "body", Short: "b", Usage: "Release notes"},
{Name: "target", Usage: "Target branch"},
{Name: "prerelease", Usage: "Mark as prerelease (true/false)"},
{Name: "draft", Usage: "Mark as draft (true/false)"},
{Name: "attachment-ids", Usage: "Comma-separated attachment IDs"},
{Name: "dry-run", Usage: "Preview the update request without changing release state", Bool: true, Default: "false"},
},
Run: runUpdate,
},
{
Name: "delete",
Description: tr.T("cmd.release.delete.short"),
Flags: []common.Flag{
{Name: "id", Short: "i", Usage: tr.T("flag.release.id_or_tag"), Required: true},
{Name: "dry-run", Usage: "Preview the delete request without changing release state", Bool: true, Default: "false"},
},
Run: func(ctx *common.RuntimeContext) error {
if err := ctx.ResolveOwnerRepo(); err != nil {
return err
}
id, err := ctx.RequireArg("id")
if err != nil {
return err
}
id, err = resolveVersionID(ctx, id)
if err != nil {
return err
}
path := fmt.Sprintf("%s/releases/%s", ctx.RepoPath(), id)
if ctx.Arg("dry-run") == "true" {
return ctx.OutputData(map[string]interface{}{
"repository": fmt.Sprintf("%s/%s", ctx.Owner, ctx.Repo),
"dry_run": true,
"action": "delete_release",
"method": "DELETE",
"path": path,
})
}
_, delErr := ctx.CallAPI("DELETE", path, nil)
if delErr != nil {
// GitLink API bug: delete succeeds but returns error status.
// Verify by checking if the release still exists.
_, viewErr := ctx.CallAPI("GET", path, nil)
if viewErr != nil {
// Release no longer exists — delete actually succeeded
return ctx.OutputData(map[string]interface{}{
"message": "删除成功",
})
}
// Release still exists — delete truly failed
return delErr
}
return ctx.OutputData(map[string]interface{}{
"message": "删除成功",
})
},
},
{
Name: "download",
Description: "Download release assets",
Flags: []common.Flag{
{Name: "id", Short: "i", Usage: "Release ID", Required: true},
{Name: "output", Short: "o", Usage: "Output directory", Default: "."},
},
Run: func(ctx *common.RuntimeContext) error {
if err := ctx.ResolveOwnerRepo(); err != nil {
return err
}
id, err := ctx.RequireArg("id")
if err != nil {
return err
}
outputDir := ctx.Arg("output")
// Fetch release details to find assets
env, err := ctx.CallAPI("GET", fmt.Sprintf("%s/releases/%s", ctx.RepoPath(), id), nil)
if err != nil {
return err
}
data, ok := env.Data.(map[string]interface{})
if !ok {
return fmt.Errorf("unexpected release response format")
}
assets, _ := data["assets"].([]interface{})
if len(assets) == 0 {
return ctx.OutputData(map[string]interface{}{
"message": "没有可下载的资源",
})
}
if err := os.MkdirAll(outputDir, 0o755); err != nil {
return fmt.Errorf("创建输出目录失败: %w", err)
}
var downloaded []string
for _, a := range assets {
asset, _ := a.(map[string]interface{})
downloadURL, _ := asset["url"].(string)
filename, _ := asset["filename"].(string)
if downloadURL == "" || filename == "" {
continue
}
// Build full URL if relative
if downloadURL[0] == '/' {
downloadURL = ctx.Client.BaseURL + downloadURL
}
resp, err := ctx.Client.HTTP.Get(downloadURL)
if err != nil {
return fmt.Errorf("下载 %s 失败: %w", filename, err)
}
if resp.StatusCode != http.StatusOK {
resp.Body.Close()
return fmt.Errorf("下载 %s 失败: HTTP %d", filename, resp.StatusCode)
}
destPath := filepath.Join(outputDir, filename)
f, err := os.Create(destPath)
if err != nil {
resp.Body.Close()
return fmt.Errorf("创建文件 %s 失败: %w", destPath, err)
}
if _, err := io.Copy(f, resp.Body); err != nil {
f.Close()
resp.Body.Close()
return fmt.Errorf("写入文件 %s 失败: %w", destPath, err)
}
f.Close()
resp.Body.Close()
downloaded = append(downloaded, filename)
}
return ctx.OutputData(map[string]interface{}{
"message": fmt.Sprintf("已下载 %d 个资源", len(downloaded)),
"downloaded": downloaded,
})
},
},
}
}
func shortcutTranslator(translators ...*i18n.Translator) *i18n.Translator {
if len(translators) > 0 && translators[0] != nil {
return translators[0]
}
return i18n.Default()
}
func runUpdate(ctx *common.RuntimeContext) error {
if err := ctx.ResolveOwnerRepo(); err != nil {
return err
}
id, err := ctx.RequireArg("id")
if err != nil {
return err
}
if !hasReleaseUpdateArgs(ctx) {
return fmt.Errorf("at least one of --tag, --name, --body, --target, --draft, --prerelease, or --attachment-ids is required")
}
if err := validateReleaseUpdateArgs(ctx); err != nil {
return err
}
id, err = resolveVersionID(ctx, id)
if err != nil {
return err
}
current, err := fetchReleaseEdit(ctx, id)
if err != nil {
return fmt.Errorf("fetch release edit data: %w", err)
}
payload, err := releaseUpdatePayload(ctx, current)
if err != nil {
return err
}
path := fmt.Sprintf("%s/releases/%s", ctx.RepoPath(), id)
if ctx.Arg("dry-run") == "true" {
return ctx.OutputData(map[string]interface{}{
"repository": fmt.Sprintf("%s/%s", ctx.Owner, ctx.Repo),
"dry_run": true,
"action": "update_release",
"method": "PUT",
"path": path,
"payload": payload,
})
}
env, err := ctx.CallAPI("PUT", path, payload)
if err != nil {
return err
}
return ctx.Output(env)
}
func fetchReleaseEdit(ctx *common.RuntimeContext, id string) (map[string]interface{}, error) {
env, err := ctx.CallAPI("GET", fmt.Sprintf("%s/releases/%s/edit", ctx.RepoPath(), id), nil)
if err != nil {
return nil, err
}
data, ok := env.Data.(map[string]interface{})
if !ok {
return nil, fmt.Errorf("failed to parse release edit data")
}
return data, nil
}
func releaseUpdatePayload(ctx *common.RuntimeContext, current map[string]interface{}) (map[string]interface{}, error) {
name := firstReleaseValue(ctx.Arg("name"), releaseString(current, "name"))
if name == "" {
return nil, fmt.Errorf("required release name is missing; pass --name")
}
tag := firstReleaseValue(ctx.Arg("tag"), releaseString(current, "tag_name"))
if tag == "" {
return nil, fmt.Errorf("required release tag is missing; pass --tag")
}
body := firstReleaseValue(ctx.Arg("body"), releaseString(current, "body"))
target := firstReleaseValue(ctx.Arg("target"), releaseString(current, "target_commitish"))
draft, err := releaseBoolFromArgsOrMap(ctx, "draft", current, false)
if err != nil {
return nil, err
}
prerelease, err := releaseBoolFromArgsOrMap(ctx, "prerelease", current, false)
if err != nil {
return nil, err
}
payload := map[string]interface{}{
"name": name,
"tag_name": tag,
"body": body,
"target_commitish": target,
"draft": draft,
"prerelease": prerelease,
}
if attachmentIDs := ctx.Arg("attachment-ids"); attachmentIDs != "" {
ids, err := parseReleaseAttachmentIDs(attachmentIDs)
if err != nil {
return nil, err
}
payload["attachment_ids"] = ids
} else if ids := releaseAttachmentIDs(current); len(ids) > 0 {
payload["attachment_ids"] = ids
}
return payload, nil
}
func hasReleaseUpdateArgs(ctx *common.RuntimeContext) bool {
for _, name := range []string{"tag", "name", "body", "target", "draft", "prerelease", "attachment-ids"} {
if ctx.Arg(name) != "" {
return true
}
}
return false
}
func validateReleaseUpdateArgs(ctx *common.RuntimeContext) error {
for _, name := range []string{"draft", "prerelease"} {
if ctx.Arg(name) == "" {
continue
}
if _, err := releaseBoolArg(ctx, name, false); err != nil {
return err
}
}
if ctx.Arg("attachment-ids") != "" {
_, err := parseReleaseAttachmentIDs(ctx.Arg("attachment-ids"))
return err
}
return nil
}
func releaseBoolArg(ctx *common.RuntimeContext, name string, defaultValue bool) (bool, error) {
value := strings.TrimSpace(ctx.Arg(name))
if value == "" {
return defaultValue, nil
}
switch strings.ToLower(value) {
case "true":
return true, nil
case "false":
return false, nil
default:
return false, fmt.Errorf("invalid --%s value %q: use true or false", name, value)
}
}
func releaseBoolFromArgsOrMap(ctx *common.RuntimeContext, name string, current map[string]interface{}, defaultValue bool) (bool, error) {
if ctx.Arg(name) != "" {
return releaseBoolArg(ctx, name, defaultValue)
}
if current != nil {
if value, ok := current[name].(bool); ok {
return value, nil
}
}
return defaultValue, nil
}
func parseReleaseAttachmentIDs(value string) ([]string, error) {
parts := strings.Split(value, ",")
ids := make([]string, 0, len(parts))
seen := map[string]bool{}
for _, part := range parts {
id := strings.TrimSpace(part)
if id == "" {
continue
}
if seen[id] {
continue
}
seen[id] = true
ids = append(ids, id)
}
if len(ids) == 0 {
return nil, fmt.Errorf("--attachment-ids must include at least one ID")
}
return ids, nil
}
func releaseAttachmentIDs(current map[string]interface{}) []string {
if current == nil {
return nil
}
attachments, ok := current["attachments"].([]interface{})
if !ok {
return nil
}
ids := make([]string, 0, len(attachments))
for _, attachment := range attachments {
item, ok := attachment.(map[string]interface{})
if !ok {
continue
}
if id := releaseIDString(item["id"]); id != "" {
ids = append(ids, id)
}
}
return ids
}
func releaseIDString(value interface{}) string {
switch id := value.(type) {
case string:
return strings.TrimSpace(id)
case float64:
if id == float64(int64(id)) {
return strconv.FormatInt(int64(id), 10)
}
return fmt.Sprintf("%v", id)
case int:
return strconv.Itoa(id)
default:
return ""
}
}
func releaseString(values map[string]interface{}, key string) string {
if values == nil {
return ""
}
value, _ := values[key].(string)
return strings.TrimSpace(value)
}
func firstReleaseValue(values ...string) string {
for _, value := range values {
if strings.TrimSpace(value) != "" {
return strings.TrimSpace(value)
}
}
return ""
}
// uploadReleaseAttachments uploads local files given as a comma-separated
// list and returns their attachment ids for use in attachment_ids.
func uploadReleaseAttachments(ctx *common.RuntimeContext, files string) ([]string, error) {
var ids []string
for _, part := range strings.Split(files, ",") {
file := strings.TrimSpace(part)
if file == "" {
continue
}
info, err := os.Stat(file)
if err != nil {
return nil, fmt.Errorf("cannot access file %q: %w", file, err)
}
if info.IsDir() {
return nil, fmt.Errorf("%q is a directory, expected a file", file)
}
env, err := ctx.Client.PostMultipartFile("/attachments", file, "file", nil)
if err != nil {
return nil, fmt.Errorf("upload %q failed: %w", file, err)
}
data, _ := env.Data.(map[string]interface{})
id, _ := data["id"].(string)
if id == "" {
if num, ok := data["id"].(float64); ok {
id = strconv.FormatFloat(num, 'f', -1, 64)
}
}
if id == "" {
return nil, fmt.Errorf("upload %q succeeded but no attachment id was returned", file)
}
ids = append(ids, id)
}
if len(ids) == 0 {
return nil, fmt.Errorf("--attachment-files must include at least one file")
}
return ids, nil
}