Files
MonkeyCode/backend/domain/git.go

230 lines
5.4 KiB
Go
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
package domain
import (
"context"
"io"
"strings"
"github.com/GoYoko/web"
)
// GitClienter Git 平台统一客户端接口
type GitClienter interface {
// 认证
CheckPAT(ctx context.Context, token, repoURL string) (bool, *BindRepository, error)
UserInfo(ctx context.Context, token string) (*PlatformUserInfo, error)
// Repositories 列出可访问的仓库。opts.Page>0 时按平台能力做服务端分页,
// 返回的 RepositoryPage.PageInfo 非 nil;opts.Page==0 时返回全部仓库,PageInfo 为 nil。
Repositories(ctx context.Context, opts *RepositoryOptions) (*RepositoryPage, error)
// 仓库操作
Tree(ctx context.Context, opts *TreeOptions) (*GetRepoTreeResp, error)
Blob(ctx context.Context, opts *BlobOptions) (*GetBlobResp, error)
Logs(ctx context.Context, opts *LogsOptions) (*GetGitLogsResp, error)
Archive(ctx context.Context, opts *ArchiveOptions) (*GetRepoArchiveResp, error)
Branches(ctx context.Context, opts *BranchesOptions) ([]*BranchInfo, error)
// Webhook
DeleteWebhook(ctx context.Context, opts *WebhookOptions) error
CreateWebhook(ctx context.Context, opts *CreateWebhookOptions) error
}
// TreeEntry 文件树节点
type TreeEntry struct {
Mode int
Name string
Path string
Sha string
Size int
LastModifiedAt int64 // GitHub 特有,其他平台为 0
}
// GetRepoTreeResp 获取仓库文件树响应
type GetRepoTreeResp struct {
Entries []*TreeEntry
SHA string
}
// GetBlobResp 获取单文件内容响应
type GetBlobResp struct {
Content []byte
IsBinary bool
Sha string
Size int
}
// GitUser 提交用户信息
type GitUser struct {
Email string
Name string
When int64
}
// GitCommit 提交信息
type GitCommit struct {
Author *GitUser
Committer *GitUser
Message string
ParentShas []string
Sha string
TreeSha string
}
// GitCommitEntry 包装 commit 对象
type GitCommitEntry struct {
Commit *GitCommit
}
// GetGitLogsResp 获取提交历史响应
type GetGitLogsResp struct {
Count int
Entries []*GitCommitEntry
}
// GetRepoArchiveResp 获取仓库压缩包响应
type GetRepoArchiveResp struct {
ContentLength int64
ContentType string
Reader io.ReadCloser
}
// BranchInfo 分支信息
type BranchInfo struct {
Name string
}
// PlatformUserInfo 平台用户信息
type PlatformUserInfo struct {
Name string
}
// BindRepository 绑定仓库信息
type BindRepository struct {
RepoID string
RepoName string
FullName string
RepoURL string
RepoDescription string
IsPrivate bool
Platform string
}
type RepositoryOptions struct {
Token string
InstallID int64 // GitHub App 模式,其他平台忽略
IsOAuth bool // GitLab/Gitea OAuth 模式,其他平台忽略
Flush bool // 强制刷新缓存
// 分页参数:Page>0 时启用服务端分页(目前 GitHub/GitLab 支持,其它平台忽略并返回全量)
Page int
Size int
Keyword string // 按仓库名关键字过滤(目前 GitHub/GitLab 支持)
}
// RepositoryPage 仓库列表(可分页)结果。
// PageInfo 为 nil 表示未分页(返回了全部仓库)。
type RepositoryPage struct {
Repositories []AuthRepository
PageInfo *web.PageInfo
}
// PaginateRepos 在内存中按关键字(仓库名子串,大小写不敏感)过滤后切片,
// 供各平台 client 拿到全量仓库后做服务端分页时复用(GitHub/GitLab 原生分页除外)。
func PaginateRepos(all []AuthRepository, keyword string, page, size int) *RepositoryPage {
if keyword != "" {
kw := strings.ToLower(keyword)
var filtered []AuthRepository
for _, r := range all {
if strings.Contains(strings.ToLower(r.FullName), kw) {
filtered = append(filtered, r)
}
}
all = filtered
}
total := len(all)
start := min(max((page-1)*size, 0), total)
end := min(start+size, total)
return &RepositoryPage{
Repositories: all[start:end],
PageInfo: &web.PageInfo{
TotalCount: int64(total),
HasNextPage: end < total,
},
}
}
// TreeOptions 获取文件树参数
type TreeOptions struct {
Token string
Owner string
Repo string
Ref string
Path string
Recursive bool
InstallID int64 // GitHub App 模式,其他平台忽略
IsOAuth bool // GitLab/Gitea OAuth 模式,其他平台忽略
}
// BlobOptions 获取文件内容参数
type BlobOptions struct {
Token string
Owner string
Repo string
Ref string
Path string
InstallID int64
IsOAuth bool
}
// LogsOptions 获取提交历史参数
type LogsOptions struct {
Token string
Owner string
Repo string
Ref string
Path string
Limit int
Offset int
InstallID int64
IsOAuth bool
}
// ArchiveOptions 获取归档参数
type ArchiveOptions struct {
Token string
Owner string
Repo string
Ref string
InstallID int64
IsOAuth bool
}
// BranchesOptions 列出分支参数
type BranchesOptions struct {
Token string
Owner string
Repo string
Page int
PerPage int
InstallID int64
IsOAuth bool
}
// WebhookOptions Webhook 操作参数
type WebhookOptions struct {
Token string
RepoURL string
WebhookURL string
IsOAuth bool
}
// CreateWebhookOptions 创建 Webhook 参数
type CreateWebhookOptions struct {
Token string
RepoURL string
WebhookURL string
SecretToken string
Events []string
IsOAuth bool
}