Gitea 2 Gitea migration (#12657)
* first draft
* update gitea sdk to 9e280adb4da
* adapt feat of updated sdk
* releases now works
* break the Reactions loop
* use convertGiteaLabel
* fix endless loop because paggination is not supported there !!!
* rename gitea local uploader files
* pagination can bite you in the ass
* Version Checks
* lint
* docs
* rename gitea sdk import to miss future conficts
* go-swagger: dont scan the sdk structs
* make sure gitea can shutdown gracefully
* make GetPullRequests and GetIssues similar
* rm useles
* Add Test: started ...
* ... add tests ...
* Add tests and Fixing things
* Workaround missing SHA
* Adapt: Ensure that all migration requests are cancellable
(714ab71ddc)
* LINT: fix misspells in test set
* adapt ListMergeRequestAwardEmoji
* update sdk
* Return error when creating giteadownloader failed
* update sdk
* adapt new sdk
* adopt new features
* check version before err
* adapt: 'migrate service type switch page'
* optimize
* Fix DefaultBranch
* impruve
* handle subPath
* fix test
* Fix ReviewCommentPosition
* test GetReviews
* add DefaultBranch int test set
* rm unused
* Update SDK to v0.13.0
* addopt sdk changes
* found better link
* format template
* Update Docs
* Update Gitea SDK (v0.13.1)
tokarchuk/v1.17
6543
4 years ago
committed by
GitHub
parent
dfa7291f8f
commit
49b1948cb1
@ -0,0 +1,671 @@ |
|||||||
|
// Copyright 2020 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package migrations |
||||||
|
|
||||||
|
import ( |
||||||
|
"context" |
||||||
|
"errors" |
||||||
|
"fmt" |
||||||
|
"io" |
||||||
|
"net/http" |
||||||
|
"net/url" |
||||||
|
"strings" |
||||||
|
"time" |
||||||
|
|
||||||
|
"code.gitea.io/gitea/modules/log" |
||||||
|
"code.gitea.io/gitea/modules/migrations/base" |
||||||
|
"code.gitea.io/gitea/modules/structs" |
||||||
|
|
||||||
|
gitea_sdk "code.gitea.io/sdk/gitea" |
||||||
|
) |
||||||
|
|
||||||
|
var ( |
||||||
|
_ base.Downloader = &GiteaDownloader{} |
||||||
|
_ base.DownloaderFactory = &GiteaDownloaderFactory{} |
||||||
|
) |
||||||
|
|
||||||
|
func init() { |
||||||
|
RegisterDownloaderFactory(&GiteaDownloaderFactory{}) |
||||||
|
} |
||||||
|
|
||||||
|
// GiteaDownloaderFactory defines a gitea downloader factory
|
||||||
|
type GiteaDownloaderFactory struct { |
||||||
|
} |
||||||
|
|
||||||
|
// New returns a Downloader related to this factory according MigrateOptions
|
||||||
|
func (f *GiteaDownloaderFactory) New(ctx context.Context, opts base.MigrateOptions) (base.Downloader, error) { |
||||||
|
u, err := url.Parse(opts.CloneAddr) |
||||||
|
if err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
|
||||||
|
baseURL := u.Scheme + "://" + u.Host |
||||||
|
repoNameSpace := strings.TrimPrefix(u.Path, "/") |
||||||
|
repoNameSpace = strings.TrimSuffix(repoNameSpace, ".git") |
||||||
|
|
||||||
|
path := strings.Split(repoNameSpace, "/") |
||||||
|
if len(path) < 2 { |
||||||
|
return nil, fmt.Errorf("invalid path") |
||||||
|
} |
||||||
|
|
||||||
|
repoPath := strings.Join(path[len(path)-2:], "/") |
||||||
|
if len(path) > 2 { |
||||||
|
subPath := strings.Join(path[:len(path)-2], "/") |
||||||
|
baseURL += "/" + subPath |
||||||
|
} |
||||||
|
|
||||||
|
log.Trace("Create gitea downloader. BaseURL: %s RepoName: %s", baseURL, repoNameSpace) |
||||||
|
|
||||||
|
return NewGiteaDownloader(ctx, baseURL, repoPath, opts.AuthUsername, opts.AuthPassword, opts.AuthToken) |
||||||
|
} |
||||||
|
|
||||||
|
// GitServiceType returns the type of git service
|
||||||
|
func (f *GiteaDownloaderFactory) GitServiceType() structs.GitServiceType { |
||||||
|
return structs.GiteaService |
||||||
|
} |
||||||
|
|
||||||
|
// GiteaDownloader implements a Downloader interface to get repository information's
|
||||||
|
type GiteaDownloader struct { |
||||||
|
ctx context.Context |
||||||
|
client *gitea_sdk.Client |
||||||
|
repoOwner string |
||||||
|
repoName string |
||||||
|
pagination bool |
||||||
|
maxPerPage int |
||||||
|
} |
||||||
|
|
||||||
|
// NewGiteaDownloader creates a gitea Downloader via gitea API
|
||||||
|
// Use either a username/password or personal token. token is preferred
|
||||||
|
// Note: Public access only allows very basic access
|
||||||
|
func NewGiteaDownloader(ctx context.Context, baseURL, repoPath, username, password, token string) (*GiteaDownloader, error) { |
||||||
|
giteaClient, err := gitea_sdk.NewClient( |
||||||
|
baseURL, |
||||||
|
gitea_sdk.SetToken(token), |
||||||
|
gitea_sdk.SetBasicAuth(username, password), |
||||||
|
gitea_sdk.SetContext(ctx), |
||||||
|
) |
||||||
|
if err != nil { |
||||||
|
log.Error(fmt.Sprintf("NewGiteaDownloader: %s", err.Error())) |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
|
||||||
|
path := strings.Split(repoPath, "/") |
||||||
|
|
||||||
|
paginationSupport := true |
||||||
|
if err := giteaClient.CheckServerVersionConstraint(">=1.12"); err != nil { |
||||||
|
paginationSupport = false |
||||||
|
} |
||||||
|
|
||||||
|
// set small maxPerPage since we can only guess
|
||||||
|
// (default would be 50 but this can differ)
|
||||||
|
maxPerPage := 10 |
||||||
|
// new gitea instances can tell us what maximum they have
|
||||||
|
if giteaClient.CheckServerVersionConstraint(">=1.13.0") == nil { |
||||||
|
apiConf, _, err := giteaClient.GetGlobalAPISettings() |
||||||
|
if err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
maxPerPage = apiConf.MaxResponseItems |
||||||
|
} |
||||||
|
|
||||||
|
return &GiteaDownloader{ |
||||||
|
ctx: ctx, |
||||||
|
client: giteaClient, |
||||||
|
repoOwner: path[0], |
||||||
|
repoName: path[1], |
||||||
|
pagination: paginationSupport, |
||||||
|
maxPerPage: maxPerPage, |
||||||
|
}, nil |
||||||
|
} |
||||||
|
|
||||||
|
// SetContext set context
|
||||||
|
func (g *GiteaDownloader) SetContext(ctx context.Context) { |
||||||
|
g.ctx = ctx |
||||||
|
} |
||||||
|
|
||||||
|
// GetRepoInfo returns a repository information
|
||||||
|
func (g *GiteaDownloader) GetRepoInfo() (*base.Repository, error) { |
||||||
|
if g == nil { |
||||||
|
return nil, errors.New("error: GiteaDownloader is nil") |
||||||
|
} |
||||||
|
|
||||||
|
repo, _, err := g.client.GetRepo(g.repoOwner, g.repoName) |
||||||
|
if err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
|
||||||
|
return &base.Repository{ |
||||||
|
Name: repo.Name, |
||||||
|
Owner: repo.Owner.UserName, |
||||||
|
IsPrivate: repo.Private, |
||||||
|
Description: repo.Description, |
||||||
|
CloneURL: repo.CloneURL, |
||||||
|
OriginalURL: repo.HTMLURL, |
||||||
|
DefaultBranch: repo.DefaultBranch, |
||||||
|
}, nil |
||||||
|
} |
||||||
|
|
||||||
|
// GetTopics return gitea topics
|
||||||
|
func (g *GiteaDownloader) GetTopics() ([]string, error) { |
||||||
|
topics, _, err := g.client.ListRepoTopics(g.repoOwner, g.repoName, gitea_sdk.ListRepoTopicsOptions{}) |
||||||
|
return topics, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetMilestones returns milestones
|
||||||
|
func (g *GiteaDownloader) GetMilestones() ([]*base.Milestone, error) { |
||||||
|
var milestones = make([]*base.Milestone, 0, g.maxPerPage) |
||||||
|
|
||||||
|
for i := 1; ; i++ { |
||||||
|
// make sure gitea can shutdown gracefully
|
||||||
|
select { |
||||||
|
case <-g.ctx.Done(): |
||||||
|
return nil, nil |
||||||
|
default: |
||||||
|
} |
||||||
|
|
||||||
|
ms, _, err := g.client.ListRepoMilestones(g.repoOwner, g.repoName, gitea_sdk.ListMilestoneOption{ |
||||||
|
ListOptions: gitea_sdk.ListOptions{ |
||||||
|
PageSize: g.maxPerPage, |
||||||
|
Page: i, |
||||||
|
}, |
||||||
|
State: gitea_sdk.StateAll, |
||||||
|
}) |
||||||
|
if err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
|
||||||
|
for i := range ms { |
||||||
|
// old gitea instances dont have this information
|
||||||
|
createdAT := time.Now() |
||||||
|
var updatedAT *time.Time |
||||||
|
if ms[i].Closed != nil { |
||||||
|
createdAT = *ms[i].Closed |
||||||
|
updatedAT = ms[i].Closed |
||||||
|
} |
||||||
|
|
||||||
|
// new gitea instances (>=1.13) do
|
||||||
|
if !ms[i].Created.IsZero() { |
||||||
|
createdAT = ms[i].Created |
||||||
|
} |
||||||
|
if ms[i].Updated != nil && !ms[i].Updated.IsZero() { |
||||||
|
updatedAT = ms[i].Updated |
||||||
|
} |
||||||
|
|
||||||
|
milestones = append(milestones, &base.Milestone{ |
||||||
|
Title: ms[i].Title, |
||||||
|
Description: ms[i].Description, |
||||||
|
Deadline: ms[i].Deadline, |
||||||
|
Created: createdAT, |
||||||
|
Updated: updatedAT, |
||||||
|
Closed: ms[i].Closed, |
||||||
|
State: string(ms[i].State), |
||||||
|
}) |
||||||
|
} |
||||||
|
if !g.pagination || len(ms) < g.maxPerPage { |
||||||
|
break |
||||||
|
} |
||||||
|
} |
||||||
|
return milestones, nil |
||||||
|
} |
||||||
|
|
||||||
|
func (g *GiteaDownloader) convertGiteaLabel(label *gitea_sdk.Label) *base.Label { |
||||||
|
return &base.Label{ |
||||||
|
Name: label.Name, |
||||||
|
Color: label.Color, |
||||||
|
Description: label.Description, |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
// GetLabels returns labels
|
||||||
|
func (g *GiteaDownloader) GetLabels() ([]*base.Label, error) { |
||||||
|
var labels = make([]*base.Label, 0, g.maxPerPage) |
||||||
|
|
||||||
|
for i := 1; ; i++ { |
||||||
|
// make sure gitea can shutdown gracefully
|
||||||
|
select { |
||||||
|
case <-g.ctx.Done(): |
||||||
|
return nil, nil |
||||||
|
default: |
||||||
|
} |
||||||
|
|
||||||
|
ls, _, err := g.client.ListRepoLabels(g.repoOwner, g.repoName, gitea_sdk.ListLabelsOptions{ListOptions: gitea_sdk.ListOptions{ |
||||||
|
PageSize: g.maxPerPage, |
||||||
|
Page: i, |
||||||
|
}}) |
||||||
|
if err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
|
||||||
|
for i := range ls { |
||||||
|
labels = append(labels, g.convertGiteaLabel(ls[i])) |
||||||
|
} |
||||||
|
if !g.pagination || len(ls) < g.maxPerPage { |
||||||
|
break |
||||||
|
} |
||||||
|
} |
||||||
|
return labels, nil |
||||||
|
} |
||||||
|
|
||||||
|
func (g *GiteaDownloader) convertGiteaRelease(rel *gitea_sdk.Release) *base.Release { |
||||||
|
r := &base.Release{ |
||||||
|
TagName: rel.TagName, |
||||||
|
TargetCommitish: rel.Target, |
||||||
|
Name: rel.Title, |
||||||
|
Body: rel.Note, |
||||||
|
Draft: rel.IsDraft, |
||||||
|
Prerelease: rel.IsPrerelease, |
||||||
|
PublisherID: rel.Publisher.ID, |
||||||
|
PublisherName: rel.Publisher.UserName, |
||||||
|
PublisherEmail: rel.Publisher.Email, |
||||||
|
Published: rel.PublishedAt, |
||||||
|
Created: rel.CreatedAt, |
||||||
|
} |
||||||
|
|
||||||
|
for _, asset := range rel.Attachments { |
||||||
|
size := int(asset.Size) |
||||||
|
dlCount := int(asset.DownloadCount) |
||||||
|
r.Assets = append(r.Assets, base.ReleaseAsset{ |
||||||
|
ID: asset.ID, |
||||||
|
Name: asset.Name, |
||||||
|
Size: &size, |
||||||
|
DownloadCount: &dlCount, |
||||||
|
Created: asset.Created, |
||||||
|
DownloadURL: &asset.DownloadURL, |
||||||
|
}) |
||||||
|
} |
||||||
|
return r |
||||||
|
} |
||||||
|
|
||||||
|
// GetReleases returns releases
|
||||||
|
func (g *GiteaDownloader) GetReleases() ([]*base.Release, error) { |
||||||
|
var releases = make([]*base.Release, 0, g.maxPerPage) |
||||||
|
|
||||||
|
for i := 1; ; i++ { |
||||||
|
// make sure gitea can shutdown gracefully
|
||||||
|
select { |
||||||
|
case <-g.ctx.Done(): |
||||||
|
return nil, nil |
||||||
|
default: |
||||||
|
} |
||||||
|
|
||||||
|
rl, _, err := g.client.ListReleases(g.repoOwner, g.repoName, gitea_sdk.ListReleasesOptions{ListOptions: gitea_sdk.ListOptions{ |
||||||
|
PageSize: g.maxPerPage, |
||||||
|
Page: i, |
||||||
|
}}) |
||||||
|
if err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
|
||||||
|
for i := range rl { |
||||||
|
releases = append(releases, g.convertGiteaRelease(rl[i])) |
||||||
|
} |
||||||
|
if !g.pagination || len(rl) < g.maxPerPage { |
||||||
|
break |
||||||
|
} |
||||||
|
} |
||||||
|
return releases, nil |
||||||
|
} |
||||||
|
|
||||||
|
// GetAsset returns an asset
|
||||||
|
func (g *GiteaDownloader) GetAsset(_ string, relID, id int64) (io.ReadCloser, error) { |
||||||
|
asset, _, err := g.client.GetReleaseAttachment(g.repoOwner, g.repoName, relID, id) |
||||||
|
if err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
resp, err := http.Get(asset.DownloadURL) |
||||||
|
if err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
|
||||||
|
// resp.Body is closed by the uploader
|
||||||
|
return resp.Body, nil |
||||||
|
} |
||||||
|
|
||||||
|
func (g *GiteaDownloader) getIssueReactions(index int64) ([]*base.Reaction, error) { |
||||||
|
var reactions []*base.Reaction |
||||||
|
if err := g.client.CheckServerVersionConstraint(">=1.11"); err != nil { |
||||||
|
log.Info("GiteaDownloader: instance to old, skip getIssueReactions") |
||||||
|
return reactions, nil |
||||||
|
} |
||||||
|
rl, _, err := g.client.GetIssueReactions(g.repoOwner, g.repoName, index) |
||||||
|
if err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
|
||||||
|
for _, reaction := range rl { |
||||||
|
reactions = append(reactions, &base.Reaction{ |
||||||
|
UserID: reaction.User.ID, |
||||||
|
UserName: reaction.User.UserName, |
||||||
|
Content: reaction.Reaction, |
||||||
|
}) |
||||||
|
} |
||||||
|
return reactions, nil |
||||||
|
} |
||||||
|
|
||||||
|
func (g *GiteaDownloader) getCommentReactions(commentID int64) ([]*base.Reaction, error) { |
||||||
|
var reactions []*base.Reaction |
||||||
|
if err := g.client.CheckServerVersionConstraint(">=1.11"); err != nil { |
||||||
|
log.Info("GiteaDownloader: instance to old, skip getCommentReactions") |
||||||
|
return reactions, nil |
||||||
|
} |
||||||
|
rl, _, err := g.client.GetIssueCommentReactions(g.repoOwner, g.repoName, commentID) |
||||||
|
if err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
|
||||||
|
for i := range rl { |
||||||
|
reactions = append(reactions, &base.Reaction{ |
||||||
|
UserID: rl[i].User.ID, |
||||||
|
UserName: rl[i].User.UserName, |
||||||
|
Content: rl[i].Reaction, |
||||||
|
}) |
||||||
|
} |
||||||
|
return reactions, nil |
||||||
|
} |
||||||
|
|
||||||
|
// GetIssues returns issues according start and limit
|
||||||
|
func (g *GiteaDownloader) GetIssues(page, perPage int) ([]*base.Issue, bool, error) { |
||||||
|
if perPage > g.maxPerPage { |
||||||
|
perPage = g.maxPerPage |
||||||
|
} |
||||||
|
var allIssues = make([]*base.Issue, 0, perPage) |
||||||
|
|
||||||
|
issues, _, err := g.client.ListRepoIssues(g.repoOwner, g.repoName, gitea_sdk.ListIssueOption{ |
||||||
|
ListOptions: gitea_sdk.ListOptions{Page: page, PageSize: perPage}, |
||||||
|
State: gitea_sdk.StateAll, |
||||||
|
Type: gitea_sdk.IssueTypeIssue, |
||||||
|
}) |
||||||
|
if err != nil { |
||||||
|
return nil, false, fmt.Errorf("error while listing issues: %v", err) |
||||||
|
} |
||||||
|
for _, issue := range issues { |
||||||
|
|
||||||
|
var labels = make([]*base.Label, 0, len(issue.Labels)) |
||||||
|
for i := range issue.Labels { |
||||||
|
labels = append(labels, g.convertGiteaLabel(issue.Labels[i])) |
||||||
|
} |
||||||
|
|
||||||
|
var milestone string |
||||||
|
if issue.Milestone != nil { |
||||||
|
milestone = issue.Milestone.Title |
||||||
|
} |
||||||
|
|
||||||
|
reactions, err := g.getIssueReactions(issue.Index) |
||||||
|
if err != nil { |
||||||
|
return nil, false, fmt.Errorf("error while loading reactions: %v", err) |
||||||
|
} |
||||||
|
|
||||||
|
var assignees []string |
||||||
|
for i := range issue.Assignees { |
||||||
|
assignees = append(assignees, issue.Assignees[i].UserName) |
||||||
|
} |
||||||
|
|
||||||
|
allIssues = append(allIssues, &base.Issue{ |
||||||
|
Title: issue.Title, |
||||||
|
Number: issue.Index, |
||||||
|
PosterID: issue.Poster.ID, |
||||||
|
PosterName: issue.Poster.UserName, |
||||||
|
PosterEmail: issue.Poster.Email, |
||||||
|
Content: issue.Body, |
||||||
|
Milestone: milestone, |
||||||
|
State: string(issue.State), |
||||||
|
Created: issue.Created, |
||||||
|
Updated: issue.Updated, |
||||||
|
Closed: issue.Closed, |
||||||
|
Reactions: reactions, |
||||||
|
Labels: labels, |
||||||
|
Assignees: assignees, |
||||||
|
IsLocked: issue.IsLocked, |
||||||
|
}) |
||||||
|
} |
||||||
|
|
||||||
|
isEnd := len(issues) < perPage |
||||||
|
if !g.pagination { |
||||||
|
isEnd = len(issues) == 0 |
||||||
|
} |
||||||
|
return allIssues, isEnd, nil |
||||||
|
} |
||||||
|
|
||||||
|
// GetComments returns comments according issueNumber
|
||||||
|
func (g *GiteaDownloader) GetComments(index int64) ([]*base.Comment, error) { |
||||||
|
var allComments = make([]*base.Comment, 0, g.maxPerPage) |
||||||
|
|
||||||
|
// for i := 1; ; i++ {
|
||||||
|
// make sure gitea can shutdown gracefully
|
||||||
|
select { |
||||||
|
case <-g.ctx.Done(): |
||||||
|
return nil, nil |
||||||
|
default: |
||||||
|
} |
||||||
|
|
||||||
|
comments, _, err := g.client.ListIssueComments(g.repoOwner, g.repoName, index, gitea_sdk.ListIssueCommentOptions{ListOptions: gitea_sdk.ListOptions{ |
||||||
|
// PageSize: g.maxPerPage,
|
||||||
|
// Page: i,
|
||||||
|
}}) |
||||||
|
if err != nil { |
||||||
|
return nil, fmt.Errorf("error while listing comments: %v", err) |
||||||
|
} |
||||||
|
|
||||||
|
for _, comment := range comments { |
||||||
|
reactions, err := g.getCommentReactions(comment.ID) |
||||||
|
if err != nil { |
||||||
|
return nil, fmt.Errorf("error while listing comment creactions: %v", err) |
||||||
|
} |
||||||
|
|
||||||
|
allComments = append(allComments, &base.Comment{ |
||||||
|
IssueIndex: index, |
||||||
|
PosterID: comment.Poster.ID, |
||||||
|
PosterName: comment.Poster.UserName, |
||||||
|
PosterEmail: comment.Poster.Email, |
||||||
|
Content: comment.Body, |
||||||
|
Created: comment.Created, |
||||||
|
Updated: comment.Updated, |
||||||
|
Reactions: reactions, |
||||||
|
}) |
||||||
|
} |
||||||
|
|
||||||
|
// TODO enable pagination vor (gitea >= 1.14) when it got implemented
|
||||||
|
// if !g.pagination || len(comments) < g.maxPerPage {
|
||||||
|
// break
|
||||||
|
// }
|
||||||
|
//}
|
||||||
|
return allComments, nil |
||||||
|
} |
||||||
|
|
||||||
|
// GetPullRequests returns pull requests according page and perPage
|
||||||
|
func (g *GiteaDownloader) GetPullRequests(page, perPage int) ([]*base.PullRequest, bool, error) { |
||||||
|
if perPage > g.maxPerPage { |
||||||
|
perPage = g.maxPerPage |
||||||
|
} |
||||||
|
var allPRs = make([]*base.PullRequest, 0, perPage) |
||||||
|
|
||||||
|
prs, _, err := g.client.ListRepoPullRequests(g.repoOwner, g.repoName, gitea_sdk.ListPullRequestsOptions{ |
||||||
|
ListOptions: gitea_sdk.ListOptions{ |
||||||
|
Page: page, |
||||||
|
PageSize: perPage, |
||||||
|
}, |
||||||
|
State: gitea_sdk.StateAll, |
||||||
|
}) |
||||||
|
if err != nil { |
||||||
|
return nil, false, fmt.Errorf("error while listing repos: %v", err) |
||||||
|
} |
||||||
|
for _, pr := range prs { |
||||||
|
var milestone string |
||||||
|
if pr.Milestone != nil { |
||||||
|
milestone = pr.Milestone.Title |
||||||
|
} |
||||||
|
|
||||||
|
var labels = make([]*base.Label, 0, len(pr.Labels)) |
||||||
|
for i := range pr.Labels { |
||||||
|
labels = append(labels, g.convertGiteaLabel(pr.Labels[i])) |
||||||
|
} |
||||||
|
|
||||||
|
var ( |
||||||
|
headUserName string |
||||||
|
headRepoName string |
||||||
|
headCloneURL string |
||||||
|
headRef string |
||||||
|
headSHA string |
||||||
|
) |
||||||
|
if pr.Head != nil { |
||||||
|
if pr.Head.Repository != nil { |
||||||
|
headUserName = pr.Head.Repository.Owner.UserName |
||||||
|
headRepoName = pr.Head.Repository.Name |
||||||
|
headCloneURL = pr.Head.Repository.CloneURL |
||||||
|
} |
||||||
|
headSHA = pr.Head.Sha |
||||||
|
headRef = pr.Head.Ref |
||||||
|
if headSHA == "" { |
||||||
|
headCommit, _, err := g.client.GetSingleCommit(g.repoOwner, g.repoName, url.PathEscape(pr.Head.Ref)) |
||||||
|
if err != nil { |
||||||
|
return nil, false, fmt.Errorf("error while resolving git ref: %v", err) |
||||||
|
} |
||||||
|
headSHA = headCommit.SHA |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
var mergeCommitSHA string |
||||||
|
if pr.MergedCommitID != nil { |
||||||
|
mergeCommitSHA = *pr.MergedCommitID |
||||||
|
} |
||||||
|
|
||||||
|
reactions, err := g.getIssueReactions(pr.Index) |
||||||
|
if err != nil { |
||||||
|
return nil, false, fmt.Errorf("error while loading reactions: %v", err) |
||||||
|
} |
||||||
|
|
||||||
|
var assignees []string |
||||||
|
for i := range pr.Assignees { |
||||||
|
assignees = append(assignees, pr.Assignees[i].UserName) |
||||||
|
} |
||||||
|
|
||||||
|
createdAt := time.Now() |
||||||
|
if pr.Created != nil { |
||||||
|
createdAt = *pr.Created |
||||||
|
} |
||||||
|
updatedAt := time.Now() |
||||||
|
if pr.Created != nil { |
||||||
|
updatedAt = *pr.Updated |
||||||
|
} |
||||||
|
|
||||||
|
closedAt := pr.Closed |
||||||
|
if pr.Merged != nil && closedAt == nil { |
||||||
|
closedAt = pr.Merged |
||||||
|
} |
||||||
|
|
||||||
|
allPRs = append(allPRs, &base.PullRequest{ |
||||||
|
Title: pr.Title, |
||||||
|
Number: pr.Index, |
||||||
|
PosterID: pr.Poster.ID, |
||||||
|
PosterName: pr.Poster.UserName, |
||||||
|
PosterEmail: pr.Poster.Email, |
||||||
|
Content: pr.Body, |
||||||
|
State: string(pr.State), |
||||||
|
Created: createdAt, |
||||||
|
Updated: updatedAt, |
||||||
|
Closed: closedAt, |
||||||
|
Labels: labels, |
||||||
|
Milestone: milestone, |
||||||
|
Reactions: reactions, |
||||||
|
Assignees: assignees, |
||||||
|
Merged: pr.HasMerged, |
||||||
|
MergedTime: pr.Merged, |
||||||
|
MergeCommitSHA: mergeCommitSHA, |
||||||
|
IsLocked: pr.IsLocked, |
||||||
|
PatchURL: pr.PatchURL, |
||||||
|
Head: base.PullRequestBranch{ |
||||||
|
Ref: headRef, |
||||||
|
SHA: headSHA, |
||||||
|
RepoName: headRepoName, |
||||||
|
OwnerName: headUserName, |
||||||
|
CloneURL: headCloneURL, |
||||||
|
}, |
||||||
|
Base: base.PullRequestBranch{ |
||||||
|
Ref: pr.Base.Ref, |
||||||
|
SHA: pr.Base.Sha, |
||||||
|
RepoName: g.repoName, |
||||||
|
OwnerName: g.repoOwner, |
||||||
|
}, |
||||||
|
}) |
||||||
|
} |
||||||
|
|
||||||
|
isEnd := len(prs) < perPage |
||||||
|
if !g.pagination { |
||||||
|
isEnd = len(prs) == 0 |
||||||
|
} |
||||||
|
return allPRs, isEnd, nil |
||||||
|
} |
||||||
|
|
||||||
|
// GetReviews returns pull requests review
|
||||||
|
func (g *GiteaDownloader) GetReviews(index int64) ([]*base.Review, error) { |
||||||
|
if err := g.client.CheckServerVersionConstraint(">=1.12"); err != nil { |
||||||
|
log.Info("GiteaDownloader: instance to old, skip GetReviews") |
||||||
|
return nil, nil |
||||||
|
} |
||||||
|
|
||||||
|
var allReviews = make([]*base.Review, 0, g.maxPerPage) |
||||||
|
|
||||||
|
for i := 1; ; i++ { |
||||||
|
// make sure gitea can shutdown gracefully
|
||||||
|
select { |
||||||
|
case <-g.ctx.Done(): |
||||||
|
return nil, nil |
||||||
|
default: |
||||||
|
} |
||||||
|
|
||||||
|
prl, _, err := g.client.ListPullReviews(g.repoOwner, g.repoName, index, gitea_sdk.ListPullReviewsOptions{ListOptions: gitea_sdk.ListOptions{ |
||||||
|
Page: i, |
||||||
|
PageSize: g.maxPerPage, |
||||||
|
}}) |
||||||
|
if err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
|
||||||
|
for _, pr := range prl { |
||||||
|
|
||||||
|
rcl, _, err := g.client.ListPullReviewComments(g.repoOwner, g.repoName, index, pr.ID) |
||||||
|
if err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
var reviewComments []*base.ReviewComment |
||||||
|
for i := range rcl { |
||||||
|
line := int(rcl[i].LineNum) |
||||||
|
if rcl[i].OldLineNum > 0 { |
||||||
|
line = int(rcl[i].OldLineNum) * -1 |
||||||
|
} |
||||||
|
|
||||||
|
reviewComments = append(reviewComments, &base.ReviewComment{ |
||||||
|
ID: rcl[i].ID, |
||||||
|
Content: rcl[i].Body, |
||||||
|
TreePath: rcl[i].Path, |
||||||
|
DiffHunk: rcl[i].DiffHunk, |
||||||
|
Line: line, |
||||||
|
CommitID: rcl[i].CommitID, |
||||||
|
PosterID: rcl[i].Reviewer.ID, |
||||||
|
CreatedAt: rcl[i].Created, |
||||||
|
UpdatedAt: rcl[i].Updated, |
||||||
|
}) |
||||||
|
} |
||||||
|
|
||||||
|
allReviews = append(allReviews, &base.Review{ |
||||||
|
ID: pr.ID, |
||||||
|
IssueIndex: index, |
||||||
|
ReviewerID: pr.Reviewer.ID, |
||||||
|
ReviewerName: pr.Reviewer.UserName, |
||||||
|
Official: pr.Official, |
||||||
|
CommitID: pr.CommitID, |
||||||
|
Content: pr.Body, |
||||||
|
CreatedAt: pr.Submitted, |
||||||
|
State: string(pr.State), |
||||||
|
Comments: reviewComments, |
||||||
|
}) |
||||||
|
} |
||||||
|
|
||||||
|
if len(prl) < g.maxPerPage { |
||||||
|
break |
||||||
|
} |
||||||
|
} |
||||||
|
return allReviews, nil |
||||||
|
} |
||||||
@ -0,0 +1,365 @@ |
|||||||
|
// Copyright 2020 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package migrations |
||||||
|
|
||||||
|
import ( |
||||||
|
"context" |
||||||
|
"fmt" |
||||||
|
"net/http" |
||||||
|
"os" |
||||||
|
"sort" |
||||||
|
"testing" |
||||||
|
"time" |
||||||
|
|
||||||
|
"code.gitea.io/gitea/modules/migrations/base" |
||||||
|
|
||||||
|
"github.com/stretchr/testify/assert" |
||||||
|
) |
||||||
|
|
||||||
|
func assertEqualIssue(t *testing.T, issueExp, issueGet *base.Issue) { |
||||||
|
assert.EqualValues(t, issueExp.Number, issueGet.Number) |
||||||
|
assert.EqualValues(t, issueExp.Title, issueGet.Title) |
||||||
|
assert.EqualValues(t, issueExp.Content, issueGet.Content) |
||||||
|
assert.EqualValues(t, issueExp.Milestone, issueGet.Milestone) |
||||||
|
assert.EqualValues(t, issueExp.PosterID, issueGet.PosterID) |
||||||
|
assert.EqualValues(t, issueExp.PosterName, issueGet.PosterName) |
||||||
|
assert.EqualValues(t, issueExp.PosterEmail, issueGet.PosterEmail) |
||||||
|
assert.EqualValues(t, issueExp.IsLocked, issueGet.IsLocked) |
||||||
|
assert.EqualValues(t, issueExp.Created.Unix(), issueGet.Created.Unix()) |
||||||
|
assert.EqualValues(t, issueExp.Updated.Unix(), issueGet.Updated.Unix()) |
||||||
|
if issueExp.Closed != nil { |
||||||
|
assert.EqualValues(t, issueExp.Closed.Unix(), issueGet.Closed.Unix()) |
||||||
|
} else { |
||||||
|
assert.True(t, issueGet.Closed == nil) |
||||||
|
} |
||||||
|
sort.Strings(issueExp.Assignees) |
||||||
|
sort.Strings(issueGet.Assignees) |
||||||
|
assert.EqualValues(t, issueExp.Assignees, issueGet.Assignees) |
||||||
|
assert.EqualValues(t, issueExp.Labels, issueGet.Labels) |
||||||
|
assert.EqualValues(t, issueExp.Reactions, issueGet.Reactions) |
||||||
|
} |
||||||
|
|
||||||
|
func TestGiteaDownloadRepo(t *testing.T) { |
||||||
|
// Skip tests if Gitea token is not found
|
||||||
|
giteaToken := os.Getenv("GITEA_TOKEN") |
||||||
|
if giteaToken == "" { |
||||||
|
t.Skip("skipped test because GITEA_TOKEN was not in the environment") |
||||||
|
} |
||||||
|
|
||||||
|
resp, err := http.Get("https://gitea.com/gitea") |
||||||
|
if err != nil || resp.StatusCode != 200 { |
||||||
|
t.Skipf("Can't reach https://gitea.com, skipping %s", t.Name()) |
||||||
|
} |
||||||
|
|
||||||
|
downloader, err := NewGiteaDownloader(context.Background(), "https://gitea.com", "gitea/test_repo", "", "", giteaToken) |
||||||
|
if downloader == nil { |
||||||
|
t.Fatal("NewGitlabDownloader is nil") |
||||||
|
} |
||||||
|
if !assert.NoError(t, err) { |
||||||
|
t.Fatal("NewGitlabDownloader error occur") |
||||||
|
} |
||||||
|
|
||||||
|
repo, err := downloader.GetRepoInfo() |
||||||
|
assert.NoError(t, err) |
||||||
|
assert.EqualValues(t, &base.Repository{ |
||||||
|
Name: "test_repo", |
||||||
|
Owner: "gitea", |
||||||
|
IsPrivate: false, |
||||||
|
Description: "Test repository for testing migration from gitea to gitea", |
||||||
|
CloneURL: "https://gitea.com/gitea/test_repo.git", |
||||||
|
OriginalURL: "https://gitea.com/gitea/test_repo", |
||||||
|
DefaultBranch: "master", |
||||||
|
}, repo) |
||||||
|
|
||||||
|
topics, err := downloader.GetTopics() |
||||||
|
assert.NoError(t, err) |
||||||
|
sort.Strings(topics) |
||||||
|
assert.EqualValues(t, []string{"ci", "gitea", "migration", "test"}, topics) |
||||||
|
|
||||||
|
labels, err := downloader.GetLabels() |
||||||
|
assert.NoError(t, err) |
||||||
|
assert.Len(t, labels, 6) |
||||||
|
for _, l := range labels { |
||||||
|
switch l.Name { |
||||||
|
case "Bug": |
||||||
|
assertLabelEqual(t, "Bug", "e11d21", "", l) |
||||||
|
case "documentation": |
||||||
|
assertLabelEqual(t, "Enhancement", "207de5", "", l) |
||||||
|
case "confirmed": |
||||||
|
assertLabelEqual(t, "Feature", "0052cc", "a feature request", l) |
||||||
|
case "enhancement": |
||||||
|
assertLabelEqual(t, "Invalid", "d4c5f9", "", l) |
||||||
|
case "critical": |
||||||
|
assertLabelEqual(t, "Question", "fbca04", "", l) |
||||||
|
case "discussion": |
||||||
|
assertLabelEqual(t, "Valid", "53e917", "", l) |
||||||
|
default: |
||||||
|
assert.Error(t, fmt.Errorf("unexpected label: %s", l.Name)) |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
milestones, err := downloader.GetMilestones() |
||||||
|
assert.NoError(t, err) |
||||||
|
assert.Len(t, milestones, 2) |
||||||
|
|
||||||
|
for _, milestone := range milestones { |
||||||
|
switch milestone.Title { |
||||||
|
case "V1": |
||||||
|
assert.EqualValues(t, "Generate Content", milestone.Description) |
||||||
|
// assert.EqualValues(t, "ToDo", milestone.Created)
|
||||||
|
// assert.EqualValues(t, "ToDo", milestone.Updated)
|
||||||
|
assert.EqualValues(t, 1598985406, milestone.Closed.Unix()) |
||||||
|
assert.True(t, milestone.Deadline == nil) |
||||||
|
assert.EqualValues(t, "closed", milestone.State) |
||||||
|
case "V2 Finalize": |
||||||
|
assert.EqualValues(t, "", milestone.Description) |
||||||
|
// assert.EqualValues(t, "ToDo", milestone.Created)
|
||||||
|
// assert.EqualValues(t, "ToDo", milestone.Updated)
|
||||||
|
assert.True(t, milestone.Closed == nil) |
||||||
|
assert.EqualValues(t, 1599263999, milestone.Deadline.Unix()) |
||||||
|
assert.EqualValues(t, "open", milestone.State) |
||||||
|
default: |
||||||
|
assert.Error(t, fmt.Errorf("unexpected milestone: %s", milestone.Title)) |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
releases, err := downloader.GetReleases() |
||||||
|
assert.NoError(t, err) |
||||||
|
assert.EqualValues(t, []*base.Release{ |
||||||
|
{ |
||||||
|
Name: "Second Release", |
||||||
|
TagName: "v2-rc1", |
||||||
|
TargetCommitish: "master", |
||||||
|
Body: "this repo has:\r\n* reactions\r\n* wiki\r\n* issues (open/closed)\r\n* pulls (open/closed/merged) (external/internal)\r\n* pull reviews\r\n* projects\r\n* milestones\r\n* labels\r\n* releases\r\n\r\nto test migration against", |
||||||
|
Draft: false, |
||||||
|
Prerelease: true, |
||||||
|
Created: time.Date(2020, 9, 1, 18, 2, 43, 0, time.UTC), |
||||||
|
Published: time.Date(2020, 9, 1, 18, 2, 43, 0, time.UTC), |
||||||
|
PublisherID: 689, |
||||||
|
PublisherName: "6543", |
||||||
|
PublisherEmail: "6543@noreply.gitea.io", |
||||||
|
}, |
||||||
|
{ |
||||||
|
Name: "First Release", |
||||||
|
TagName: "V1", |
||||||
|
TargetCommitish: "master", |
||||||
|
Body: "as title", |
||||||
|
Draft: false, |
||||||
|
Prerelease: false, |
||||||
|
Created: time.Date(2020, 9, 1, 17, 30, 32, 0, time.UTC), |
||||||
|
Published: time.Date(2020, 9, 1, 17, 30, 32, 0, time.UTC), |
||||||
|
PublisherID: 689, |
||||||
|
PublisherName: "6543", |
||||||
|
PublisherEmail: "6543@noreply.gitea.io", |
||||||
|
}, |
||||||
|
}, releases) |
||||||
|
|
||||||
|
issues, isEnd, err := downloader.GetIssues(1, 50) |
||||||
|
assert.NoError(t, err) |
||||||
|
assert.EqualValues(t, 7, len(issues)) |
||||||
|
assert.True(t, isEnd) |
||||||
|
assert.EqualValues(t, "open", issues[0].State) |
||||||
|
|
||||||
|
issues, isEnd, err = downloader.GetIssues(3, 2) |
||||||
|
assert.NoError(t, err) |
||||||
|
assert.EqualValues(t, 2, len(issues)) |
||||||
|
assert.False(t, isEnd) |
||||||
|
|
||||||
|
var ( |
||||||
|
closed4 = time.Date(2020, 9, 1, 15, 49, 34, 0, time.UTC) |
||||||
|
closed2 = time.Unix(1598969497, 0) |
||||||
|
) |
||||||
|
|
||||||
|
assertEqualIssue(t, &base.Issue{ |
||||||
|
Number: 4, |
||||||
|
Title: "what is this repo about?", |
||||||
|
Content: "", |
||||||
|
Milestone: "V1", |
||||||
|
PosterID: -1, |
||||||
|
PosterName: "Ghost", |
||||||
|
PosterEmail: "", |
||||||
|
State: "closed", |
||||||
|
IsLocked: true, |
||||||
|
Created: time.Unix(1598975321, 0), |
||||||
|
Updated: time.Unix(1598975400, 0), |
||||||
|
Labels: []*base.Label{{ |
||||||
|
Name: "Question", |
||||||
|
Color: "fbca04", |
||||||
|
Description: "", |
||||||
|
}}, |
||||||
|
Reactions: []*base.Reaction{ |
||||||
|
{ |
||||||
|
UserID: 689, |
||||||
|
UserName: "6543", |
||||||
|
Content: "gitea", |
||||||
|
}, |
||||||
|
{ |
||||||
|
UserID: 689, |
||||||
|
UserName: "6543", |
||||||
|
Content: "laugh", |
||||||
|
}, |
||||||
|
}, |
||||||
|
Closed: &closed4, |
||||||
|
}, issues[0]) |
||||||
|
assertEqualIssue(t, &base.Issue{ |
||||||
|
Number: 2, |
||||||
|
Title: "Spam", |
||||||
|
Content: ":(", |
||||||
|
Milestone: "", |
||||||
|
PosterID: 689, |
||||||
|
PosterName: "6543", |
||||||
|
PosterEmail: "6543@noreply.gitea.io", |
||||||
|
State: "closed", |
||||||
|
IsLocked: false, |
||||||
|
Created: time.Unix(1598919780, 0), |
||||||
|
Updated: closed2, |
||||||
|
Labels: []*base.Label{{ |
||||||
|
Name: "Invalid", |
||||||
|
Color: "d4c5f9", |
||||||
|
Description: "", |
||||||
|
}}, |
||||||
|
Reactions: nil, |
||||||
|
Closed: &closed2, |
||||||
|
}, issues[1]) |
||||||
|
|
||||||
|
comments, err := downloader.GetComments(4) |
||||||
|
assert.NoError(t, err) |
||||||
|
assert.Len(t, comments, 2) |
||||||
|
assert.EqualValues(t, 1598975370, comments[0].Created.Unix()) |
||||||
|
assert.EqualValues(t, 1599070865, comments[0].Updated.Unix()) |
||||||
|
assert.EqualValues(t, 1598975393, comments[1].Created.Unix()) |
||||||
|
assert.EqualValues(t, 1598975393, comments[1].Updated.Unix()) |
||||||
|
assert.EqualValues(t, []*base.Comment{ |
||||||
|
{ |
||||||
|
IssueIndex: 4, |
||||||
|
PosterID: 689, |
||||||
|
PosterName: "6543", |
||||||
|
PosterEmail: "6543@noreply.gitea.io", |
||||||
|
Created: comments[0].Created, |
||||||
|
Updated: comments[0].Updated, |
||||||
|
Content: "a really good question!\n\nIt is the used as TESTSET for gitea2gitea repo migration function", |
||||||
|
}, |
||||||
|
{ |
||||||
|
IssueIndex: 4, |
||||||
|
PosterID: -1, |
||||||
|
PosterName: "Ghost", |
||||||
|
PosterEmail: "", |
||||||
|
Created: comments[1].Created, |
||||||
|
Updated: comments[1].Updated, |
||||||
|
Content: "Oh!", |
||||||
|
}, |
||||||
|
}, comments) |
||||||
|
|
||||||
|
prs, isEnd, err := downloader.GetPullRequests(1, 50) |
||||||
|
assert.NoError(t, err) |
||||||
|
assert.True(t, isEnd) |
||||||
|
assert.Len(t, prs, 6) |
||||||
|
prs, isEnd, err = downloader.GetPullRequests(1, 3) |
||||||
|
assert.NoError(t, err) |
||||||
|
assert.False(t, isEnd) |
||||||
|
assert.Len(t, prs, 3) |
||||||
|
merged12 := time.Unix(1598982934, 0) |
||||||
|
assertEqualPulls(t, &base.PullRequest{ |
||||||
|
Number: 12, |
||||||
|
PosterID: 689, |
||||||
|
PosterName: "6543", |
||||||
|
PosterEmail: "6543@noreply.gitea.io", |
||||||
|
Title: "Dont Touch", |
||||||
|
Content: "\r\nadd dont touch note", |
||||||
|
Milestone: "V2 Finalize", |
||||||
|
State: "closed", |
||||||
|
IsLocked: false, |
||||||
|
Created: time.Unix(1598982759, 0), |
||||||
|
Updated: time.Unix(1599023425, 0), |
||||||
|
Closed: &merged12, |
||||||
|
Assignees: []string{"techknowlogick"}, |
||||||
|
Labels: []*base.Label{}, |
||||||
|
|
||||||
|
Base: base.PullRequestBranch{ |
||||||
|
CloneURL: "", |
||||||
|
Ref: "master", |
||||||
|
SHA: "827aa28a907853e5ddfa40c8f9bc52471a2685fd", |
||||||
|
RepoName: "test_repo", |
||||||
|
OwnerName: "gitea", |
||||||
|
}, |
||||||
|
Head: base.PullRequestBranch{ |
||||||
|
CloneURL: "https://gitea.com/6543-forks/test_repo.git", |
||||||
|
Ref: "refs/pull/12/head", |
||||||
|
SHA: "b6ab5d9ae000b579a5fff03f92c486da4ddf48b6", |
||||||
|
RepoName: "test_repo", |
||||||
|
OwnerName: "6543-forks", |
||||||
|
}, |
||||||
|
Merged: true, |
||||||
|
MergedTime: &merged12, |
||||||
|
MergeCommitSHA: "827aa28a907853e5ddfa40c8f9bc52471a2685fd", |
||||||
|
PatchURL: "https://gitea.com/gitea/test_repo/pulls/12.patch", |
||||||
|
}, prs[1]) |
||||||
|
|
||||||
|
reviews, err := downloader.GetReviews(7) |
||||||
|
assert.NoError(t, err) |
||||||
|
if assert.Len(t, reviews, 3) { |
||||||
|
assert.EqualValues(t, 689, reviews[0].ReviewerID) |
||||||
|
assert.EqualValues(t, "6543", reviews[0].ReviewerName) |
||||||
|
assert.EqualValues(t, "techknowlogick", reviews[1].ReviewerName) |
||||||
|
assert.EqualValues(t, "techknowlogick", reviews[2].ReviewerName) |
||||||
|
assert.False(t, reviews[1].Official) |
||||||
|
assert.EqualValues(t, "I think this needs some changes", reviews[1].Content) |
||||||
|
assert.EqualValues(t, "REQUEST_CHANGES", reviews[1].State) |
||||||
|
assert.True(t, reviews[2].Official) |
||||||
|
assert.EqualValues(t, "looks good", reviews[2].Content) |
||||||
|
assert.EqualValues(t, "APPROVED", reviews[2].State) |
||||||
|
|
||||||
|
// TODO: https://github.com/go-gitea/gitea/issues/12846
|
||||||
|
// assert.EqualValues(t, 9, reviews[1].ReviewerID)
|
||||||
|
// assert.EqualValues(t, 9, reviews[2].ReviewerID)
|
||||||
|
|
||||||
|
assert.Len(t, reviews[0].Comments, 1) |
||||||
|
assert.EqualValues(t, &base.ReviewComment{ |
||||||
|
ID: 116561, |
||||||
|
InReplyTo: 0, |
||||||
|
Content: "is one `\\newline` to less?", |
||||||
|
TreePath: "README.md", |
||||||
|
DiffHunk: "@@ -2,3 +2,3 @@\n \n-Test repository for testing migration from gitea 2 gitea\n\\ No newline at end of file\n+Test repository for testing migration from gitea 2 gitea", |
||||||
|
Position: 0, |
||||||
|
Line: 4, |
||||||
|
CommitID: "187ece0cb6631e2858a6872e5733433bb3ca3b03", |
||||||
|
PosterID: 689, |
||||||
|
Reactions: nil, |
||||||
|
CreatedAt: time.Date(2020, 9, 1, 16, 12, 58, 0, time.UTC), |
||||||
|
UpdatedAt: time.Date(2020, 9, 1, 16, 12, 58, 0, time.UTC), |
||||||
|
}, reviews[0].Comments[0]) |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
func assertEqualPulls(t *testing.T, pullExp, pullGet *base.PullRequest) { |
||||||
|
assertEqualIssue(t, pull2issue(pullExp), pull2issue(pullGet)) |
||||||
|
assert.EqualValues(t, 0, pullGet.OriginalNumber) |
||||||
|
assert.EqualValues(t, pullExp.PatchURL, pullGet.PatchURL) |
||||||
|
assert.EqualValues(t, pullExp.Merged, pullGet.Merged) |
||||||
|
assert.EqualValues(t, pullExp.MergedTime.Unix(), pullGet.MergedTime.Unix()) |
||||||
|
assert.EqualValues(t, pullExp.MergeCommitSHA, pullGet.MergeCommitSHA) |
||||||
|
assert.EqualValues(t, pullExp.Base, pullGet.Base) |
||||||
|
assert.EqualValues(t, pullExp.Head, pullGet.Head) |
||||||
|
} |
||||||
|
|
||||||
|
func pull2issue(pull *base.PullRequest) *base.Issue { |
||||||
|
return &base.Issue{ |
||||||
|
Number: pull.Number, |
||||||
|
PosterID: pull.PosterID, |
||||||
|
PosterName: pull.PosterName, |
||||||
|
PosterEmail: pull.PosterEmail, |
||||||
|
Title: pull.Title, |
||||||
|
Content: pull.Content, |
||||||
|
Milestone: pull.Milestone, |
||||||
|
State: pull.State, |
||||||
|
IsLocked: pull.IsLocked, |
||||||
|
Created: pull.Created, |
||||||
|
Updated: pull.Updated, |
||||||
|
Closed: pull.Closed, |
||||||
|
Labels: pull.Labels, |
||||||
|
Reactions: pull.Reactions, |
||||||
|
Assignees: pull.Assignees, |
||||||
|
} |
||||||
|
} |
||||||
|
After Width: | Height: | Size: 1.6 KiB |
@ -0,0 +1,137 @@ |
|||||||
|
{{template "base/head" .}} |
||||||
|
<div class="repository new migrate"> |
||||||
|
<div class="ui middle very relaxed page grid"> |
||||||
|
<div class="column"> |
||||||
|
<form class="ui form" action="{{.Link}}" method="post"> |
||||||
|
{{.CsrfTokenHtml}} |
||||||
|
<h3 class="ui top attached header"> |
||||||
|
{{.i18n.Tr "repo.migrate.migrate" .service.Title}} |
||||||
|
<input id="service_type" type="hidden" name="service" value="{{.service}}"> |
||||||
|
</h3> |
||||||
|
<div class="ui attached segment"> |
||||||
|
{{template "base/alert" .}} |
||||||
|
<div class="inline required field {{if .Err_CloneAddr}}error{{end}}"> |
||||||
|
<label for="clone_addr">{{.i18n.Tr "repo.migrate.clone_address"}}</label> |
||||||
|
<input id="clone_addr" name="clone_addr" value="{{.clone_addr}}" autofocus required> |
||||||
|
<span class="help"> |
||||||
|
{{.i18n.Tr "repo.migrate.clone_address_desc"}}{{if .ContextUser.CanImportLocal}} {{.i18n.Tr "repo.migrate.clone_local_path"}}{{end}} |
||||||
|
{{if .LFSActive}}<br />{{.i18n.Tr "repo.migrate.lfs_mirror_unsupported"}}{{end}} |
||||||
|
</span> |
||||||
|
</div> |
||||||
|
|
||||||
|
<div class="inline field {{if .Err_Auth}}error{{end}}"> |
||||||
|
<label for="auth_token">{{.i18n.Tr "access_token"}}</label> |
||||||
|
<input id="auth_token" name="auth_token" value="{{.auth_token}}" {{if not .auth_token}} data-need-clear="true" {{end}}> |
||||||
|
<a target=”_blank” href="https://docs.gitea.io/en-us/api-usage">{{svg "octicon-question"}}</a> |
||||||
|
</div> |
||||||
|
|
||||||
|
<div class="inline field"> |
||||||
|
<label>{{.i18n.Tr "repo.migrate_options"}}</label> |
||||||
|
<div class="ui checkbox"> |
||||||
|
{{if .DisableMirrors}} |
||||||
|
<input id="mirror" name="mirror" type="checkbox" readonly> |
||||||
|
<label>{{.i18n.Tr "repo.migrate_options_mirror_disabled"}}</label> |
||||||
|
{{else}} |
||||||
|
<input id="mirror" name="mirror" type="checkbox" {{if .mirror}} checked{{end}}> |
||||||
|
<label>{{.i18n.Tr "repo.migrate_options_mirror_helper" | Safe}}</label> |
||||||
|
{{end}} |
||||||
|
</div> |
||||||
|
</div> |
||||||
|
|
||||||
|
<span class="help">{{.i18n.Tr "repo.migrate.migrate_items_options"}}</span> |
||||||
|
<div id="migrate_items"> |
||||||
|
<div class="inline field"> |
||||||
|
<label>{{.i18n.Tr "repo.migrate_items"}}</label> |
||||||
|
<div class="ui checkbox"> |
||||||
|
<input name="wiki" type="checkbox" {{if .wiki}} checked{{end}}> |
||||||
|
<label>{{.i18n.Tr "repo.migrate_items_wiki" | Safe}}</label> |
||||||
|
</div> |
||||||
|
<div class="ui checkbox"> |
||||||
|
<input name="milestones" type="checkbox" {{if .milestones}} checked{{end}}> |
||||||
|
<label>{{.i18n.Tr "repo.migrate_items_milestones" | Safe}}</label> |
||||||
|
</div> |
||||||
|
</div> |
||||||
|
<div class="inline field"> |
||||||
|
<label></label> |
||||||
|
<div class="ui checkbox"> |
||||||
|
<input name="labels" type="checkbox" {{if .labels}} checked{{end}}> |
||||||
|
<label>{{.i18n.Tr "repo.migrate_items_labels" | Safe}}</label> |
||||||
|
</div> |
||||||
|
<div class="ui checkbox"> |
||||||
|
<input name="issues" type="checkbox" {{if .issues}} checked{{end}}> |
||||||
|
<label>{{.i18n.Tr "repo.migrate_items_issues" | Safe}}</label> |
||||||
|
</div> |
||||||
|
</div> |
||||||
|
<div class="inline field"> |
||||||
|
<label></label> |
||||||
|
<div class="ui checkbox"> |
||||||
|
<input name="pull_requests" type="checkbox" {{if .pull_requests}} checked{{end}}> |
||||||
|
<label>{{.i18n.Tr "repo.migrate_items_merge_requests" | Safe}}</label> |
||||||
|
</div> |
||||||
|
<div class="ui checkbox"> |
||||||
|
<input name="releases" type="checkbox" {{if .releases}} checked{{end}}> |
||||||
|
<label>{{.i18n.Tr "repo.migrate_items_releases" | Safe}}</label> |
||||||
|
</div> |
||||||
|
</div> |
||||||
|
</div> |
||||||
|
|
||||||
|
<div class="ui divider"></div> |
||||||
|
|
||||||
|
<div class="inline required field {{if .Err_Owner}}error{{end}}"> |
||||||
|
<label>{{.i18n.Tr "repo.owner"}}</label> |
||||||
|
<div class="ui selection owner dropdown"> |
||||||
|
<input type="hidden" id="uid" name="uid" value="{{.ContextUser.ID}}" required> |
||||||
|
<span class="text" title="{{.ContextUser.Name}}"> |
||||||
|
<img class="ui mini image" src="{{.ContextUser.RelAvatarLink}}"> |
||||||
|
{{.ContextUser.ShortName 20}} |
||||||
|
</span> |
||||||
|
<i class="dropdown icon"></i> |
||||||
|
<div class="menu" title="{{.SignedUser.Name}}"> |
||||||
|
<div class="item" data-value="{{.SignedUser.ID}}"> |
||||||
|
<img class="ui mini image" src="{{.SignedUser.RelAvatarLink}}"> |
||||||
|
{{.SignedUser.ShortName 20}} |
||||||
|
</div> |
||||||
|
{{range .Orgs}} |
||||||
|
<div class="item" data-value="{{.ID}}" title="{{.Name}}"> |
||||||
|
<img class="ui mini image" src="{{.RelAvatarLink}}"> |
||||||
|
{{.ShortName 20}} |
||||||
|
</div> |
||||||
|
{{end}} |
||||||
|
</div> |
||||||
|
</div> |
||||||
|
</div> |
||||||
|
|
||||||
|
<div class="inline required field {{if .Err_RepoName}}error{{end}}"> |
||||||
|
<label for="repo_name">{{.i18n.Tr "repo.repo_name"}}</label> |
||||||
|
<input id="repo_name" name="repo_name" value="{{.repo_name}}" required> |
||||||
|
</div> |
||||||
|
<div class="inline field"> |
||||||
|
<label>{{.i18n.Tr "repo.visibility"}}</label> |
||||||
|
<div class="ui checkbox"> |
||||||
|
{{if .IsForcedPrivate}} |
||||||
|
<input name="private" type="checkbox" checked readonly> |
||||||
|
<label>{{.i18n.Tr "repo.visibility_helper_forced" | Safe}}</label> |
||||||
|
{{else}} |
||||||
|
<input name="private" type="checkbox" {{if .private}} checked{{end}}> |
||||||
|
<label>{{.i18n.Tr "repo.visibility_helper" | Safe}}</label> |
||||||
|
{{end}} |
||||||
|
</div> |
||||||
|
</div> |
||||||
|
<div class="inline field {{if .Err_Description}}error{{end}}"> |
||||||
|
<label for="description">{{.i18n.Tr "repo.repo_desc"}}</label> |
||||||
|
<textarea id="description" name="description">{{.description}}</textarea> |
||||||
|
</div> |
||||||
|
|
||||||
|
<div class="inline field"> |
||||||
|
<label></label> |
||||||
|
<button class="ui green button"> |
||||||
|
{{.i18n.Tr "repo.migrate_repo"}} |
||||||
|
</button> |
||||||
|
<a class="ui button" href="{{AppSubUrl}}/">{{.i18n.Tr "cancel"}}</a> |
||||||
|
</div> |
||||||
|
</div> |
||||||
|
</form> |
||||||
|
</div> |
||||||
|
</div> |
||||||
|
</div> |
||||||
|
{{template "base/footer" .}} |
||||||
@ -0,0 +1,20 @@ |
|||||||
|
Copyright (c) 2016 The Gitea Authors |
||||||
|
Copyright (c) 2014 The Gogs Authors |
||||||
|
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining a copy |
||||||
|
of this software and associated documentation files (the "Software"), to deal |
||||||
|
in the Software without restriction, including without limitation the rights |
||||||
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell |
||||||
|
copies of the Software, and to permit persons to whom the Software is |
||||||
|
furnished to do so, subject to the following conditions: |
||||||
|
|
||||||
|
The above copyright notice and this permission notice shall be included in |
||||||
|
all copies or substantial portions of the Software. |
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||||
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||||
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE |
||||||
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||||
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, |
||||||
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN |
||||||
|
THE SOFTWARE. |
||||||
@ -0,0 +1,44 @@ |
|||||||
|
// Copyright 2020 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"fmt" |
||||||
|
"time" |
||||||
|
) |
||||||
|
|
||||||
|
// CronTask represents a Cron task
|
||||||
|
type CronTask struct { |
||||||
|
Name string `json:"name"` |
||||||
|
Schedule string `json:"schedule"` |
||||||
|
Next time.Time `json:"next"` |
||||||
|
Prev time.Time `json:"prev"` |
||||||
|
ExecTimes int64 `json:"exec_times"` |
||||||
|
} |
||||||
|
|
||||||
|
// ListCronTaskOptions list options for ListCronTasks
|
||||||
|
type ListCronTaskOptions struct { |
||||||
|
ListOptions |
||||||
|
} |
||||||
|
|
||||||
|
// ListCronTasks list available cron tasks
|
||||||
|
func (c *Client) ListCronTasks(opt ListCronTaskOptions) ([]*CronTask, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.13.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
opt.setDefaults() |
||||||
|
ct := make([]*CronTask, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/admin/cron?%s", opt.getURLQuery().Encode()), jsonHeader, nil, &ct) |
||||||
|
return ct, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// RunCronTasks run a cron task
|
||||||
|
func (c *Client) RunCronTasks(task string) (*Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.13.0"); err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
_, resp, err := c.getResponse("POST", fmt.Sprintf("/admin/cron/%s", task), jsonHeader, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
@ -0,0 +1,36 @@ |
|||||||
|
// Copyright 2015 The Gogs Authors. All rights reserved.
|
||||||
|
// Copyright 2019 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
) |
||||||
|
|
||||||
|
// AdminListOrgsOptions options for listing admin's organizations
|
||||||
|
type AdminListOrgsOptions struct { |
||||||
|
ListOptions |
||||||
|
} |
||||||
|
|
||||||
|
// AdminListOrgs lists all orgs
|
||||||
|
func (c *Client) AdminListOrgs(opt AdminListOrgsOptions) ([]*Organization, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
orgs := make([]*Organization, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/admin/orgs?%s", opt.getURLQuery().Encode()), nil, nil, &orgs) |
||||||
|
return orgs, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// AdminCreateOrg create an organization
|
||||||
|
func (c *Client) AdminCreateOrg(user string, opt CreateOrgOption) (*Organization, *Response, error) { |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
org := new(Organization) |
||||||
|
resp, err := c.getParsedResponse("POST", fmt.Sprintf("/admin/users/%s/orgs", user), jsonHeader, bytes.NewReader(body), org) |
||||||
|
return org, resp, err |
||||||
|
} |
||||||
@ -0,0 +1,22 @@ |
|||||||
|
// Copyright 2015 The Gogs Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
) |
||||||
|
|
||||||
|
// AdminCreateRepo create a repo
|
||||||
|
func (c *Client) AdminCreateRepo(user string, opt CreateRepoOption) (*Repository, *Response, error) { |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
repo := new(Repository) |
||||||
|
resp, err := c.getParsedResponse("POST", fmt.Sprintf("/admin/users/%s/repos", user), jsonHeader, bytes.NewReader(body), repo) |
||||||
|
return repo, resp, err |
||||||
|
} |
||||||
@ -0,0 +1,114 @@ |
|||||||
|
// Copyright 2015 The Gogs Authors. All rights reserved.
|
||||||
|
// Copyright 2019 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
) |
||||||
|
|
||||||
|
// AdminListUsersOptions options for listing admin users
|
||||||
|
type AdminListUsersOptions struct { |
||||||
|
ListOptions |
||||||
|
} |
||||||
|
|
||||||
|
// AdminListUsers lists all users
|
||||||
|
func (c *Client) AdminListUsers(opt AdminListUsersOptions) ([]*User, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
users := make([]*User, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/admin/users?%s", opt.getURLQuery().Encode()), nil, nil, &users) |
||||||
|
return users, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// CreateUserOption create user options
|
||||||
|
type CreateUserOption struct { |
||||||
|
SourceID int64 `json:"source_id"` |
||||||
|
LoginName string `json:"login_name"` |
||||||
|
Username string `json:"username"` |
||||||
|
FullName string `json:"full_name"` |
||||||
|
Email string `json:"email"` |
||||||
|
Password string `json:"password"` |
||||||
|
MustChangePassword *bool `json:"must_change_password"` |
||||||
|
SendNotify bool `json:"send_notify"` |
||||||
|
} |
||||||
|
|
||||||
|
// Validate the CreateUserOption struct
|
||||||
|
func (opt CreateUserOption) Validate() error { |
||||||
|
if len(opt.Email) == 0 { |
||||||
|
return fmt.Errorf("email is empty") |
||||||
|
} |
||||||
|
if len(opt.Username) == 0 { |
||||||
|
return fmt.Errorf("username is empty") |
||||||
|
} |
||||||
|
return nil |
||||||
|
} |
||||||
|
|
||||||
|
// AdminCreateUser create a user
|
||||||
|
func (c *Client) AdminCreateUser(opt CreateUserOption) (*User, *Response, error) { |
||||||
|
if err := opt.Validate(); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
user := new(User) |
||||||
|
resp, err := c.getParsedResponse("POST", "/admin/users", jsonHeader, bytes.NewReader(body), user) |
||||||
|
return user, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// EditUserOption edit user options
|
||||||
|
type EditUserOption struct { |
||||||
|
SourceID int64 `json:"source_id"` |
||||||
|
LoginName string `json:"login_name"` |
||||||
|
FullName string `json:"full_name"` |
||||||
|
Email string `json:"email"` |
||||||
|
Password string `json:"password"` |
||||||
|
MustChangePassword *bool `json:"must_change_password"` |
||||||
|
Website string `json:"website"` |
||||||
|
Location string `json:"location"` |
||||||
|
Active *bool `json:"active"` |
||||||
|
Admin *bool `json:"admin"` |
||||||
|
AllowGitHook *bool `json:"allow_git_hook"` |
||||||
|
AllowImportLocal *bool `json:"allow_import_local"` |
||||||
|
MaxRepoCreation *int `json:"max_repo_creation"` |
||||||
|
ProhibitLogin *bool `json:"prohibit_login"` |
||||||
|
AllowCreateOrganization *bool `json:"allow_create_organization"` |
||||||
|
} |
||||||
|
|
||||||
|
// AdminEditUser modify user informations
|
||||||
|
func (c *Client) AdminEditUser(user string, opt EditUserOption) (*Response, error) { |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
_, resp, err := c.getResponse("PATCH", fmt.Sprintf("/admin/users/%s", user), jsonHeader, bytes.NewReader(body)) |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// AdminDeleteUser delete one user according name
|
||||||
|
func (c *Client) AdminDeleteUser(user string) (*Response, error) { |
||||||
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/admin/users/%s", user), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// AdminCreateUserPublicKey adds a public key for the user
|
||||||
|
func (c *Client) AdminCreateUserPublicKey(user string, opt CreateKeyOption) (*PublicKey, *Response, error) { |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
key := new(PublicKey) |
||||||
|
resp, err := c.getParsedResponse("POST", fmt.Sprintf("/admin/users/%s/keys", user), jsonHeader, bytes.NewReader(body), key) |
||||||
|
return key, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// AdminDeleteUserPublicKey deletes a user's public key
|
||||||
|
func (c *Client) AdminDeleteUserPublicKey(user string, keyID int) (*Response, error) { |
||||||
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/admin/users/%s/keys/%d", user, keyID), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
@ -0,0 +1,96 @@ |
|||||||
|
// Copyright 2017 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea // import "code.gitea.io/sdk/gitea"
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
"io" |
||||||
|
"mime/multipart" |
||||||
|
"net/http" |
||||||
|
"time" |
||||||
|
) |
||||||
|
|
||||||
|
// Attachment a generic attachment
|
||||||
|
type Attachment struct { |
||||||
|
ID int64 `json:"id"` |
||||||
|
Name string `json:"name"` |
||||||
|
Size int64 `json:"size"` |
||||||
|
DownloadCount int64 `json:"download_count"` |
||||||
|
Created time.Time `json:"created_at"` |
||||||
|
UUID string `json:"uuid"` |
||||||
|
DownloadURL string `json:"browser_download_url"` |
||||||
|
} |
||||||
|
|
||||||
|
// ListReleaseAttachmentsOptions options for listing release's attachments
|
||||||
|
type ListReleaseAttachmentsOptions struct { |
||||||
|
ListOptions |
||||||
|
} |
||||||
|
|
||||||
|
// ListReleaseAttachments list release's attachments
|
||||||
|
func (c *Client) ListReleaseAttachments(user, repo string, release int64, opt ListReleaseAttachmentsOptions) ([]*Attachment, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
attachments := make([]*Attachment, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", |
||||||
|
fmt.Sprintf("/repos/%s/%s/releases/%d/assets?%s", user, repo, release, opt.getURLQuery().Encode()), |
||||||
|
nil, nil, &attachments) |
||||||
|
return attachments, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetReleaseAttachment returns the requested attachment
|
||||||
|
func (c *Client) GetReleaseAttachment(user, repo string, release int64, id int64) (*Attachment, *Response, error) { |
||||||
|
a := new(Attachment) |
||||||
|
resp, err := c.getParsedResponse("GET", |
||||||
|
fmt.Sprintf("/repos/%s/%s/releases/%d/assets/%d", user, repo, release, id), |
||||||
|
nil, nil, &a) |
||||||
|
return a, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// CreateReleaseAttachment creates an attachment for the given release
|
||||||
|
func (c *Client) CreateReleaseAttachment(user, repo string, release int64, file io.Reader, filename string) (*Attachment, *Response, error) { |
||||||
|
// Write file to body
|
||||||
|
body := new(bytes.Buffer) |
||||||
|
writer := multipart.NewWriter(body) |
||||||
|
part, err := writer.CreateFormFile("attachment", filename) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
|
||||||
|
if _, err = io.Copy(part, file); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
if err = writer.Close(); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
|
||||||
|
// Send request
|
||||||
|
attachment := new(Attachment) |
||||||
|
resp, err := c.getParsedResponse("POST", |
||||||
|
fmt.Sprintf("/repos/%s/%s/releases/%d/assets", user, repo, release), |
||||||
|
http.Header{"Content-Type": {writer.FormDataContentType()}}, body, &attachment) |
||||||
|
return attachment, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// EditAttachmentOptions options for editing attachments
|
||||||
|
type EditAttachmentOptions struct { |
||||||
|
Name string `json:"name"` |
||||||
|
} |
||||||
|
|
||||||
|
// EditReleaseAttachment updates the given attachment with the given options
|
||||||
|
func (c *Client) EditReleaseAttachment(user, repo string, release int64, attachment int64, form EditAttachmentOptions) (*Attachment, *Response, error) { |
||||||
|
body, err := json.Marshal(&form) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
attach := new(Attachment) |
||||||
|
resp, err := c.getParsedResponse("PATCH", fmt.Sprintf("/repos/%s/%s/releases/%d/assets/%d", user, repo, release, attachment), jsonHeader, bytes.NewReader(body), attach) |
||||||
|
return attach, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// DeleteReleaseAttachment deletes the given attachment including the uploaded file
|
||||||
|
func (c *Client) DeleteReleaseAttachment(user, repo string, release int64, id int64) (*Response, error) { |
||||||
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/repos/%s/%s/releases/%d/assets/%d", user, repo, release, id), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
@ -0,0 +1,253 @@ |
|||||||
|
// Copyright 2014 The Gogs Authors. All rights reserved.
|
||||||
|
// Copyright 2020 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"context" |
||||||
|
"encoding/json" |
||||||
|
"errors" |
||||||
|
"fmt" |
||||||
|
"io" |
||||||
|
"io/ioutil" |
||||||
|
"net/http" |
||||||
|
"strings" |
||||||
|
"sync" |
||||||
|
|
||||||
|
"github.com/hashicorp/go-version" |
||||||
|
) |
||||||
|
|
||||||
|
var jsonHeader = http.Header{"content-type": []string{"application/json"}} |
||||||
|
|
||||||
|
// Version return the library version
|
||||||
|
func Version() string { |
||||||
|
return "0.13.0" |
||||||
|
} |
||||||
|
|
||||||
|
// Client represents a Gitea API client.
|
||||||
|
type Client struct { |
||||||
|
url string |
||||||
|
accessToken string |
||||||
|
username string |
||||||
|
password string |
||||||
|
otp string |
||||||
|
sudo string |
||||||
|
debug bool |
||||||
|
client *http.Client |
||||||
|
ctx context.Context |
||||||
|
serverVersion *version.Version |
||||||
|
versionLock sync.RWMutex |
||||||
|
} |
||||||
|
|
||||||
|
// Response represents the gitea response
|
||||||
|
type Response struct { |
||||||
|
*http.Response |
||||||
|
} |
||||||
|
|
||||||
|
// NewClient initializes and returns a API client.
|
||||||
|
func NewClient(url string, options ...func(*Client)) (*Client, error) { |
||||||
|
client := &Client{ |
||||||
|
url: strings.TrimSuffix(url, "/"), |
||||||
|
client: &http.Client{}, |
||||||
|
ctx: context.Background(), |
||||||
|
} |
||||||
|
for _, opt := range options { |
||||||
|
opt(client) |
||||||
|
} |
||||||
|
if err := client.CheckServerVersionConstraint(">=1.10"); err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
return client, nil |
||||||
|
} |
||||||
|
|
||||||
|
// NewClientWithHTTP creates an API client with a custom http client
|
||||||
|
// Deprecated use SetHTTPClient option
|
||||||
|
func NewClientWithHTTP(url string, httpClient *http.Client) *Client { |
||||||
|
client, _ := NewClient(url, SetHTTPClient(httpClient)) |
||||||
|
return client |
||||||
|
} |
||||||
|
|
||||||
|
// SetHTTPClient is an option for NewClient to set custom http client
|
||||||
|
func SetHTTPClient(httpClient *http.Client) func(client *Client) { |
||||||
|
return func(client *Client) { |
||||||
|
client.client = httpClient |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
// SetToken is an option for NewClient to set token
|
||||||
|
func SetToken(token string) func(client *Client) { |
||||||
|
return func(client *Client) { |
||||||
|
client.accessToken = token |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
// SetBasicAuth is an option for NewClient to set username and password
|
||||||
|
func SetBasicAuth(username, password string) func(client *Client) { |
||||||
|
return func(client *Client) { |
||||||
|
client.SetBasicAuth(username, password) |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
// SetBasicAuth sets username and password
|
||||||
|
func (c *Client) SetBasicAuth(username, password string) { |
||||||
|
c.username, c.password = username, password |
||||||
|
} |
||||||
|
|
||||||
|
// SetOTP is an option for NewClient to set OTP for 2FA
|
||||||
|
func SetOTP(otp string) func(client *Client) { |
||||||
|
return func(client *Client) { |
||||||
|
client.SetOTP(otp) |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
// SetOTP sets OTP for 2FA
|
||||||
|
func (c *Client) SetOTP(otp string) { |
||||||
|
c.otp = otp |
||||||
|
} |
||||||
|
|
||||||
|
// SetContext is an option for NewClient to set context
|
||||||
|
func SetContext(ctx context.Context) func(client *Client) { |
||||||
|
return func(client *Client) { |
||||||
|
client.SetContext(ctx) |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
// SetContext set context witch is used for http requests
|
||||||
|
func (c *Client) SetContext(ctx context.Context) { |
||||||
|
c.ctx = ctx |
||||||
|
} |
||||||
|
|
||||||
|
// SetHTTPClient replaces default http.Client with user given one.
|
||||||
|
func (c *Client) SetHTTPClient(client *http.Client) { |
||||||
|
c.client = client |
||||||
|
} |
||||||
|
|
||||||
|
// SetSudo is an option for NewClient to set sudo header
|
||||||
|
func SetSudo(sudo string) func(client *Client) { |
||||||
|
return func(client *Client) { |
||||||
|
client.SetSudo(sudo) |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
// SetSudo sets username to impersonate.
|
||||||
|
func (c *Client) SetSudo(sudo string) { |
||||||
|
c.sudo = sudo |
||||||
|
} |
||||||
|
|
||||||
|
// SetDebugMode is an option for NewClient to enable debug mode
|
||||||
|
func SetDebugMode() func(client *Client) { |
||||||
|
return func(client *Client) { |
||||||
|
client.debug = true |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
func (c *Client) getWebResponse(method, path string, body io.Reader) ([]byte, *Response, error) { |
||||||
|
if c.debug { |
||||||
|
fmt.Printf("%s: %s\nBody: %v\n", method, c.url+path, body) |
||||||
|
} |
||||||
|
req, err := http.NewRequestWithContext(c.ctx, method, c.url+path, body) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
resp, err := c.client.Do(req) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
|
||||||
|
defer resp.Body.Close() |
||||||
|
data, err := ioutil.ReadAll(resp.Body) |
||||||
|
if c.debug { |
||||||
|
fmt.Printf("Response: %v\n\n", resp) |
||||||
|
} |
||||||
|
return data, &Response{resp}, nil |
||||||
|
} |
||||||
|
|
||||||
|
func (c *Client) doRequest(method, path string, header http.Header, body io.Reader) (*Response, error) { |
||||||
|
if c.debug { |
||||||
|
fmt.Printf("%s: %s\nHeader: %v\nBody: %s\n", method, c.url+"/api/v1"+path, header, body) |
||||||
|
} |
||||||
|
req, err := http.NewRequestWithContext(c.ctx, method, c.url+"/api/v1"+path, body) |
||||||
|
if err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
if len(c.accessToken) != 0 { |
||||||
|
req.Header.Set("Authorization", "token "+c.accessToken) |
||||||
|
} |
||||||
|
if len(c.otp) != 0 { |
||||||
|
req.Header.Set("X-GITEA-OTP", c.otp) |
||||||
|
} |
||||||
|
if len(c.username) != 0 { |
||||||
|
req.SetBasicAuth(c.username, c.password) |
||||||
|
} |
||||||
|
if len(c.sudo) != 0 { |
||||||
|
req.Header.Set("Sudo", c.sudo) |
||||||
|
} |
||||||
|
for k, v := range header { |
||||||
|
req.Header[k] = v |
||||||
|
} |
||||||
|
|
||||||
|
resp, err := c.client.Do(req) |
||||||
|
if err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
if c.debug { |
||||||
|
fmt.Printf("Response: %v\n\n", resp) |
||||||
|
} |
||||||
|
return &Response{resp}, nil |
||||||
|
} |
||||||
|
|
||||||
|
func (c *Client) getResponse(method, path string, header http.Header, body io.Reader) ([]byte, *Response, error) { |
||||||
|
resp, err := c.doRequest(method, path, header, body) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
defer resp.Body.Close() |
||||||
|
|
||||||
|
data, err := ioutil.ReadAll(resp.Body) |
||||||
|
if err != nil { |
||||||
|
return nil, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
switch resp.StatusCode { |
||||||
|
case 403: |
||||||
|
return data, resp, errors.New("403 Forbidden") |
||||||
|
case 404: |
||||||
|
return data, resp, errors.New("404 Not Found") |
||||||
|
case 409: |
||||||
|
return data, resp, errors.New("409 Conflict") |
||||||
|
case 422: |
||||||
|
return data, resp, fmt.Errorf("422 Unprocessable Entity: %s", string(data)) |
||||||
|
} |
||||||
|
|
||||||
|
if resp.StatusCode/100 != 2 { |
||||||
|
errMap := make(map[string]interface{}) |
||||||
|
if err = json.Unmarshal(data, &errMap); err != nil { |
||||||
|
// when the JSON can't be parsed, data was probably empty or a plain string,
|
||||||
|
// so we try to return a helpful error anyway
|
||||||
|
return data, resp, fmt.Errorf("Unknown API Error: %d\nRequest: '%s' with '%s' method '%s' header and '%s' body", resp.StatusCode, path, method, header, string(data)) |
||||||
|
} |
||||||
|
return data, resp, errors.New(errMap["message"].(string)) |
||||||
|
} |
||||||
|
|
||||||
|
return data, resp, nil |
||||||
|
} |
||||||
|
|
||||||
|
func (c *Client) getParsedResponse(method, path string, header http.Header, body io.Reader, obj interface{}) (*Response, error) { |
||||||
|
data, resp, err := c.getResponse(method, path, header, body) |
||||||
|
if err != nil { |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
return resp, json.Unmarshal(data, obj) |
||||||
|
} |
||||||
|
|
||||||
|
func (c *Client) getStatusCode(method, path string, header http.Header, body io.Reader) (int, *Response, error) { |
||||||
|
resp, err := c.doRequest(method, path, header, body) |
||||||
|
if err != nil { |
||||||
|
return -1, resp, err |
||||||
|
} |
||||||
|
defer resp.Body.Close() |
||||||
|
|
||||||
|
return resp.StatusCode, resp, nil |
||||||
|
} |
||||||
@ -0,0 +1,5 @@ |
|||||||
|
// Copyright 2016 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea // import "code.gitea.io/sdk/gitea"
|
||||||
@ -0,0 +1,43 @@ |
|||||||
|
// Copyright 2016 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
) |
||||||
|
|
||||||
|
// ListForksOptions options for listing repository's forks
|
||||||
|
type ListForksOptions struct { |
||||||
|
ListOptions |
||||||
|
} |
||||||
|
|
||||||
|
// ListForks list a repository's forks
|
||||||
|
func (c *Client) ListForks(user string, repo string, opt ListForksOptions) ([]*Repository, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
forks := make([]*Repository, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", |
||||||
|
fmt.Sprintf("/repos/%s/%s/forks?%s", user, repo, opt.getURLQuery().Encode()), |
||||||
|
nil, nil, &forks) |
||||||
|
return forks, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// CreateForkOption options for creating a fork
|
||||||
|
type CreateForkOption struct { |
||||||
|
// organization name, if forking into an organization
|
||||||
|
Organization *string `json:"organization"` |
||||||
|
} |
||||||
|
|
||||||
|
// CreateFork create a fork of a repository
|
||||||
|
func (c *Client) CreateFork(user, repo string, form CreateForkOption) (*Repository, *Response, error) { |
||||||
|
body, err := json.Marshal(form) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
fork := new(Repository) |
||||||
|
resp, err := c.getParsedResponse("POST", fmt.Sprintf("/repos/%s/%s/forks", user, repo), jsonHeader, bytes.NewReader(body), &fork) |
||||||
|
return fork, resp, err |
||||||
|
} |
||||||
@ -0,0 +1,25 @@ |
|||||||
|
// Copyright 2020 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"fmt" |
||||||
|
) |
||||||
|
|
||||||
|
// GitBlobResponse represents a git blob
|
||||||
|
type GitBlobResponse struct { |
||||||
|
Content string `json:"content"` |
||||||
|
Encoding string `json:"encoding"` |
||||||
|
URL string `json:"url"` |
||||||
|
SHA string `json:"sha"` |
||||||
|
Size int64 `json:"size"` |
||||||
|
} |
||||||
|
|
||||||
|
// GetBlob get the blob of a repository file
|
||||||
|
func (c *Client) GetBlob(user, repo, sha string) (*GitBlobResponse, *Response, error) { |
||||||
|
blob := new(GitBlobResponse) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/git/blobs/%s", user, repo, sha), nil, nil, blob) |
||||||
|
return blob, resp, err |
||||||
|
} |
||||||
@ -0,0 +1,59 @@ |
|||||||
|
// Copyright 2019 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
) |
||||||
|
|
||||||
|
// GitHook represents a Git repository hook
|
||||||
|
type GitHook struct { |
||||||
|
Name string `json:"name"` |
||||||
|
IsActive bool `json:"is_active"` |
||||||
|
Content string `json:"content,omitempty"` |
||||||
|
} |
||||||
|
|
||||||
|
// ListRepoGitHooksOptions options for listing repository's githooks
|
||||||
|
type ListRepoGitHooksOptions struct { |
||||||
|
ListOptions |
||||||
|
} |
||||||
|
|
||||||
|
// ListRepoGitHooks list all the Git hooks of one repository
|
||||||
|
func (c *Client) ListRepoGitHooks(user, repo string, opt ListRepoGitHooksOptions) ([]*GitHook, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
hooks := make([]*GitHook, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/hooks/git?%s", user, repo, opt.getURLQuery().Encode()), nil, nil, &hooks) |
||||||
|
return hooks, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetRepoGitHook get a Git hook of a repository
|
||||||
|
func (c *Client) GetRepoGitHook(user, repo, id string) (*GitHook, *Response, error) { |
||||||
|
h := new(GitHook) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/hooks/git/%s", user, repo, id), nil, nil, h) |
||||||
|
return h, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// EditGitHookOption options when modifying one Git hook
|
||||||
|
type EditGitHookOption struct { |
||||||
|
Content string `json:"content"` |
||||||
|
} |
||||||
|
|
||||||
|
// EditRepoGitHook modify one Git hook of a repository
|
||||||
|
func (c *Client) EditRepoGitHook(user, repo, id string, opt EditGitHookOption) (*Response, error) { |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
_, resp, err := c.getResponse("PATCH", fmt.Sprintf("/repos/%s/%s/hooks/git/%s", user, repo, id), jsonHeader, bytes.NewReader(body)) |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// DeleteRepoGitHook delete one Git hook from a repository
|
||||||
|
func (c *Client) DeleteRepoGitHook(user, repo, id string) (*Response, error) { |
||||||
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/repos/%s/%s/hooks/git/%s", user, repo, id), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
@ -0,0 +1,8 @@ |
|||||||
|
module code.gitea.io/sdk/gitea |
||||||
|
|
||||||
|
go 1.12 |
||||||
|
|
||||||
|
require ( |
||||||
|
github.com/hashicorp/go-version v1.2.0 |
||||||
|
github.com/stretchr/testify v1.4.0 |
||||||
|
) |
||||||
@ -0,0 +1,13 @@ |
|||||||
|
github.com/davecgh/go-spew v1.1.0 h1:ZDRjVQ15GmhC3fiQ8ni8+OwkZQO4DARzQgrnXU1Liz8= |
||||||
|
github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= |
||||||
|
github.com/hashicorp/go-version v1.2.0 h1:3vNe/fWF5CBgRIguda1meWhsZHy3m8gCJ5wx+dIzX/E= |
||||||
|
github.com/hashicorp/go-version v1.2.0/go.mod h1:fltr4n8CU8Ke44wwGCBoEymUuxUHl09ZGVZPK5anwXA= |
||||||
|
github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= |
||||||
|
github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= |
||||||
|
github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME= |
||||||
|
github.com/stretchr/testify v1.4.0 h1:2E4SXV/wtOkTonXsotYi4li6zVWxYlZuYNCXe9XRJyk= |
||||||
|
github.com/stretchr/testify v1.4.0/go.mod h1:j7eGeouHqKxXV5pUuKE4zz7dFj8WfuZ+81PSLYec5m4= |
||||||
|
gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405 h1:yhCVgyC4o1eVCa2tZl7eS0r+SDo693bJlVdllGtEeKM= |
||||||
|
gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= |
||||||
|
gopkg.in/yaml.v2 v2.2.2 h1:ZCJp+EgiOT7lHqUV2J862kp8Qj64Jo6az82+3Td9dZw= |
||||||
|
gopkg.in/yaml.v2 v2.2.2/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI= |
||||||
@ -0,0 +1,142 @@ |
|||||||
|
// Copyright 2014 The Gogs Authors. All rights reserved.
|
||||||
|
// Copyright 2017 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
"time" |
||||||
|
) |
||||||
|
|
||||||
|
// Hook a hook is a web hook when one repository changed
|
||||||
|
type Hook struct { |
||||||
|
ID int64 `json:"id"` |
||||||
|
Type string `json:"type"` |
||||||
|
URL string `json:"-"` |
||||||
|
Config map[string]string `json:"config"` |
||||||
|
Events []string `json:"events"` |
||||||
|
Active bool `json:"active"` |
||||||
|
Updated time.Time `json:"updated_at"` |
||||||
|
Created time.Time `json:"created_at"` |
||||||
|
} |
||||||
|
|
||||||
|
// ListHooksOptions options for listing hooks
|
||||||
|
type ListHooksOptions struct { |
||||||
|
ListOptions |
||||||
|
} |
||||||
|
|
||||||
|
// ListOrgHooks list all the hooks of one organization
|
||||||
|
func (c *Client) ListOrgHooks(org string, opt ListHooksOptions) ([]*Hook, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
hooks := make([]*Hook, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/orgs/%s/hooks?%s", org, opt.getURLQuery().Encode()), nil, nil, &hooks) |
||||||
|
return hooks, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// ListRepoHooks list all the hooks of one repository
|
||||||
|
func (c *Client) ListRepoHooks(user, repo string, opt ListHooksOptions) ([]*Hook, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
hooks := make([]*Hook, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/hooks?%s", user, repo, opt.getURLQuery().Encode()), nil, nil, &hooks) |
||||||
|
return hooks, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetOrgHook get a hook of an organization
|
||||||
|
func (c *Client) GetOrgHook(org string, id int64) (*Hook, *Response, error) { |
||||||
|
h := new(Hook) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/orgs/%s/hooks/%d", org, id), nil, nil, h) |
||||||
|
return h, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetRepoHook get a hook of a repository
|
||||||
|
func (c *Client) GetRepoHook(user, repo string, id int64) (*Hook, *Response, error) { |
||||||
|
h := new(Hook) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/hooks/%d", user, repo, id), nil, nil, h) |
||||||
|
return h, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// CreateHookOption options when create a hook
|
||||||
|
type CreateHookOption struct { |
||||||
|
Type string `json:"type"` |
||||||
|
Config map[string]string `json:"config"` |
||||||
|
Events []string `json:"events"` |
||||||
|
BranchFilter string `json:"branch_filter"` |
||||||
|
Active bool `json:"active"` |
||||||
|
} |
||||||
|
|
||||||
|
// Validate the CreateHookOption struct
|
||||||
|
func (opt CreateHookOption) Validate() error { |
||||||
|
if len(opt.Type) == 0 { |
||||||
|
return fmt.Errorf("hook type needed") |
||||||
|
} |
||||||
|
return nil |
||||||
|
} |
||||||
|
|
||||||
|
// CreateOrgHook create one hook for an organization, with options
|
||||||
|
func (c *Client) CreateOrgHook(org string, opt CreateHookOption) (*Hook, *Response, error) { |
||||||
|
if err := opt.Validate(); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
h := new(Hook) |
||||||
|
resp, err := c.getParsedResponse("POST", fmt.Sprintf("/orgs/%s/hooks", org), jsonHeader, bytes.NewReader(body), h) |
||||||
|
return h, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// CreateRepoHook create one hook for a repository, with options
|
||||||
|
func (c *Client) CreateRepoHook(user, repo string, opt CreateHookOption) (*Hook, *Response, error) { |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
h := new(Hook) |
||||||
|
resp, err := c.getParsedResponse("POST", fmt.Sprintf("/repos/%s/%s/hooks", user, repo), jsonHeader, bytes.NewReader(body), h) |
||||||
|
return h, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// EditHookOption options when modify one hook
|
||||||
|
type EditHookOption struct { |
||||||
|
Config map[string]string `json:"config"` |
||||||
|
Events []string `json:"events"` |
||||||
|
BranchFilter string `json:"branch_filter"` |
||||||
|
Active *bool `json:"active"` |
||||||
|
} |
||||||
|
|
||||||
|
// EditOrgHook modify one hook of an organization, with hook id and options
|
||||||
|
func (c *Client) EditOrgHook(org string, id int64, opt EditHookOption) (*Response, error) { |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
_, resp, err := c.getResponse("PATCH", fmt.Sprintf("/orgs/%s/hooks/%d", org, id), jsonHeader, bytes.NewReader(body)) |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// EditRepoHook modify one hook of a repository, with hook id and options
|
||||||
|
func (c *Client) EditRepoHook(user, repo string, id int64, opt EditHookOption) (*Response, error) { |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
_, resp, err := c.getResponse("PATCH", fmt.Sprintf("/repos/%s/%s/hooks/%d", user, repo, id), jsonHeader, bytes.NewReader(body)) |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// DeleteOrgHook delete one hook from an organization, with hook id
|
||||||
|
func (c *Client) DeleteOrgHook(org string, id int64) (*Response, error) { |
||||||
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/orgs/%s/hooks/%d", org, id), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// DeleteRepoHook delete one hook from a repository, with hook id
|
||||||
|
func (c *Client) DeleteRepoHook(user, repo string, id int64) (*Response, error) { |
||||||
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/repos/%s/%s/hooks/%d", user, repo, id), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
@ -0,0 +1,233 @@ |
|||||||
|
// Copyright 2016 The Gogs Authors. All rights reserved.
|
||||||
|
// Copyright 2019 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
"net/url" |
||||||
|
"strings" |
||||||
|
"time" |
||||||
|
) |
||||||
|
|
||||||
|
// PullRequestMeta PR info if an issue is a PR
|
||||||
|
type PullRequestMeta struct { |
||||||
|
HasMerged bool `json:"merged"` |
||||||
|
Merged *time.Time `json:"merged_at"` |
||||||
|
} |
||||||
|
|
||||||
|
// RepositoryMeta basic repository information
|
||||||
|
type RepositoryMeta struct { |
||||||
|
ID int64 `json:"id"` |
||||||
|
Name string `json:"name"` |
||||||
|
Owner string `json:"owner"` |
||||||
|
FullName string `json:"full_name"` |
||||||
|
} |
||||||
|
|
||||||
|
// Issue represents an issue in a repository
|
||||||
|
type Issue struct { |
||||||
|
ID int64 `json:"id"` |
||||||
|
URL string `json:"url"` |
||||||
|
Index int64 `json:"number"` |
||||||
|
Poster *User `json:"user"` |
||||||
|
OriginalAuthor string `json:"original_author"` |
||||||
|
OriginalAuthorID int64 `json:"original_author_id"` |
||||||
|
Title string `json:"title"` |
||||||
|
Body string `json:"body"` |
||||||
|
Labels []*Label `json:"labels"` |
||||||
|
Milestone *Milestone `json:"milestone"` |
||||||
|
Assignee *User `json:"assignee"` |
||||||
|
Assignees []*User `json:"assignees"` |
||||||
|
// Whether the issue is open or closed
|
||||||
|
State StateType `json:"state"` |
||||||
|
IsLocked bool `json:"is_locked"` |
||||||
|
Comments int `json:"comments"` |
||||||
|
Created time.Time `json:"created_at"` |
||||||
|
Updated time.Time `json:"updated_at"` |
||||||
|
Closed *time.Time `json:"closed_at"` |
||||||
|
Deadline *time.Time `json:"due_date"` |
||||||
|
PullRequest *PullRequestMeta `json:"pull_request"` |
||||||
|
Repository *RepositoryMeta `json:"repository"` |
||||||
|
} |
||||||
|
|
||||||
|
// ListIssueOption list issue options
|
||||||
|
type ListIssueOption struct { |
||||||
|
ListOptions |
||||||
|
State StateType |
||||||
|
Type IssueType |
||||||
|
Labels []string |
||||||
|
Milestones []string |
||||||
|
KeyWord string |
||||||
|
} |
||||||
|
|
||||||
|
// StateType issue state type
|
||||||
|
type StateType string |
||||||
|
|
||||||
|
const ( |
||||||
|
// StateOpen pr/issue is opend
|
||||||
|
StateOpen StateType = "open" |
||||||
|
// StateClosed pr/issue is closed
|
||||||
|
StateClosed StateType = "closed" |
||||||
|
// StateAll is all
|
||||||
|
StateAll StateType = "all" |
||||||
|
) |
||||||
|
|
||||||
|
// IssueType is issue a pull or only an issue
|
||||||
|
type IssueType string |
||||||
|
|
||||||
|
const ( |
||||||
|
// IssueTypeAll pr and issue
|
||||||
|
IssueTypeAll IssueType = "" |
||||||
|
// IssueTypeIssue only issues
|
||||||
|
IssueTypeIssue IssueType = "issues" |
||||||
|
// IssueTypePull only pulls
|
||||||
|
IssueTypePull IssueType = "pulls" |
||||||
|
) |
||||||
|
|
||||||
|
// QueryEncode turns options into querystring argument
|
||||||
|
func (opt *ListIssueOption) QueryEncode() string { |
||||||
|
query := opt.getURLQuery() |
||||||
|
|
||||||
|
if len(opt.State) > 0 { |
||||||
|
query.Add("state", string(opt.State)) |
||||||
|
} |
||||||
|
|
||||||
|
if len(opt.Labels) > 0 { |
||||||
|
query.Add("labels", strings.Join(opt.Labels, ",")) |
||||||
|
} |
||||||
|
|
||||||
|
if len(opt.KeyWord) > 0 { |
||||||
|
query.Add("q", opt.KeyWord) |
||||||
|
} |
||||||
|
|
||||||
|
query.Add("type", string(opt.Type)) |
||||||
|
|
||||||
|
if len(opt.Milestones) > 0 { |
||||||
|
query.Add("milestones", strings.Join(opt.Milestones, ",")) |
||||||
|
} |
||||||
|
|
||||||
|
return query.Encode() |
||||||
|
} |
||||||
|
|
||||||
|
// ListIssues returns all issues assigned the authenticated user
|
||||||
|
func (c *Client) ListIssues(opt ListIssueOption) ([]*Issue, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
issues := make([]*Issue, 0, opt.PageSize) |
||||||
|
|
||||||
|
link, _ := url.Parse("/repos/issues/search") |
||||||
|
link.RawQuery = opt.QueryEncode() |
||||||
|
resp, err := c.getParsedResponse("GET", link.String(), jsonHeader, nil, &issues) |
||||||
|
if e := c.CheckServerVersionConstraint(">=1.12.0"); e != nil { |
||||||
|
for i := 0; i < len(issues); i++ { |
||||||
|
if issues[i].Repository != nil { |
||||||
|
issues[i].Repository.Owner = strings.Split(issues[i].Repository.FullName, "/")[0] |
||||||
|
} |
||||||
|
} |
||||||
|
} |
||||||
|
return issues, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// ListRepoIssues returns all issues for a given repository
|
||||||
|
func (c *Client) ListRepoIssues(owner, repo string, opt ListIssueOption) ([]*Issue, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
issues := make([]*Issue, 0, opt.PageSize) |
||||||
|
|
||||||
|
link, _ := url.Parse(fmt.Sprintf("/repos/%s/%s/issues", owner, repo)) |
||||||
|
link.RawQuery = opt.QueryEncode() |
||||||
|
resp, err := c.getParsedResponse("GET", link.String(), jsonHeader, nil, &issues) |
||||||
|
if e := c.CheckServerVersionConstraint(">=1.12.0"); e != nil { |
||||||
|
for i := 0; i < len(issues); i++ { |
||||||
|
if issues[i].Repository != nil { |
||||||
|
issues[i].Repository.Owner = strings.Split(issues[i].Repository.FullName, "/")[0] |
||||||
|
} |
||||||
|
} |
||||||
|
} |
||||||
|
return issues, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetIssue returns a single issue for a given repository
|
||||||
|
func (c *Client) GetIssue(owner, repo string, index int64) (*Issue, *Response, error) { |
||||||
|
issue := new(Issue) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/issues/%d", owner, repo, index), nil, nil, issue) |
||||||
|
if e := c.CheckServerVersionConstraint(">=1.12.0"); e != nil && issue.Repository != nil { |
||||||
|
issue.Repository.Owner = strings.Split(issue.Repository.FullName, "/")[0] |
||||||
|
} |
||||||
|
return issue, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// CreateIssueOption options to create one issue
|
||||||
|
type CreateIssueOption struct { |
||||||
|
Title string `json:"title"` |
||||||
|
Body string `json:"body"` |
||||||
|
// username of assignee
|
||||||
|
Assignee string `json:"assignee"` |
||||||
|
Assignees []string `json:"assignees"` |
||||||
|
Deadline *time.Time `json:"due_date"` |
||||||
|
// milestone id
|
||||||
|
Milestone int64 `json:"milestone"` |
||||||
|
// list of label ids
|
||||||
|
Labels []int64 `json:"labels"` |
||||||
|
Closed bool `json:"closed"` |
||||||
|
} |
||||||
|
|
||||||
|
// Validate the CreateIssueOption struct
|
||||||
|
func (opt CreateIssueOption) Validate() error { |
||||||
|
if len(strings.TrimSpace(opt.Title)) == 0 { |
||||||
|
return fmt.Errorf("title is empty") |
||||||
|
} |
||||||
|
return nil |
||||||
|
} |
||||||
|
|
||||||
|
// CreateIssue create a new issue for a given repository
|
||||||
|
func (c *Client) CreateIssue(owner, repo string, opt CreateIssueOption) (*Issue, *Response, error) { |
||||||
|
if err := opt.Validate(); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
issue := new(Issue) |
||||||
|
resp, err := c.getParsedResponse("POST", fmt.Sprintf("/repos/%s/%s/issues", owner, repo), |
||||||
|
jsonHeader, bytes.NewReader(body), issue) |
||||||
|
return issue, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// EditIssueOption options for editing an issue
|
||||||
|
type EditIssueOption struct { |
||||||
|
Title string `json:"title"` |
||||||
|
Body *string `json:"body"` |
||||||
|
Assignee *string `json:"assignee"` |
||||||
|
Assignees []string `json:"assignees"` |
||||||
|
Milestone *int64 `json:"milestone"` |
||||||
|
State *StateType `json:"state"` |
||||||
|
Deadline *time.Time `json:"due_date"` |
||||||
|
} |
||||||
|
|
||||||
|
// Validate the EditIssueOption struct
|
||||||
|
func (opt EditIssueOption) Validate() error { |
||||||
|
if len(opt.Title) != 0 && len(strings.TrimSpace(opt.Title)) == 0 { |
||||||
|
return fmt.Errorf("title is empty") |
||||||
|
} |
||||||
|
return nil |
||||||
|
} |
||||||
|
|
||||||
|
// EditIssue modify an existing issue for a given repository
|
||||||
|
func (c *Client) EditIssue(owner, repo string, index int64, opt EditIssueOption) (*Issue, *Response, error) { |
||||||
|
if err := opt.Validate(); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
issue := new(Issue) |
||||||
|
resp, err := c.getParsedResponse("PATCH", |
||||||
|
fmt.Sprintf("/repos/%s/%s/issues/%d", owner, repo, index), |
||||||
|
jsonHeader, bytes.NewReader(body), issue) |
||||||
|
return issue, resp, err |
||||||
|
} |
||||||
@ -0,0 +1,136 @@ |
|||||||
|
// Copyright 2016 The Gogs Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
"net/url" |
||||||
|
"time" |
||||||
|
) |
||||||
|
|
||||||
|
// Comment represents a comment on a commit or issue
|
||||||
|
type Comment struct { |
||||||
|
ID int64 `json:"id"` |
||||||
|
HTMLURL string `json:"html_url"` |
||||||
|
PRURL string `json:"pull_request_url"` |
||||||
|
IssueURL string `json:"issue_url"` |
||||||
|
Poster *User `json:"user"` |
||||||
|
OriginalAuthor string `json:"original_author"` |
||||||
|
OriginalAuthorID int64 `json:"original_author_id"` |
||||||
|
Body string `json:"body"` |
||||||
|
Created time.Time `json:"created_at"` |
||||||
|
Updated time.Time `json:"updated_at"` |
||||||
|
} |
||||||
|
|
||||||
|
// ListIssueCommentOptions list comment options
|
||||||
|
type ListIssueCommentOptions struct { |
||||||
|
ListOptions |
||||||
|
Since time.Time |
||||||
|
Before time.Time |
||||||
|
} |
||||||
|
|
||||||
|
// QueryEncode turns options into querystring argument
|
||||||
|
func (opt *ListIssueCommentOptions) QueryEncode() string { |
||||||
|
query := opt.getURLQuery() |
||||||
|
if !opt.Since.IsZero() { |
||||||
|
query.Add("since", opt.Since.Format(time.RFC3339)) |
||||||
|
} |
||||||
|
if !opt.Before.IsZero() { |
||||||
|
query.Add("before", opt.Before.Format(time.RFC3339)) |
||||||
|
} |
||||||
|
return query.Encode() |
||||||
|
} |
||||||
|
|
||||||
|
// ListIssueComments list comments on an issue.
|
||||||
|
func (c *Client) ListIssueComments(owner, repo string, index int64, opt ListIssueCommentOptions) ([]*Comment, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
link, _ := url.Parse(fmt.Sprintf("/repos/%s/%s/issues/%d/comments", owner, repo, index)) |
||||||
|
link.RawQuery = opt.QueryEncode() |
||||||
|
comments := make([]*Comment, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", link.String(), nil, nil, &comments) |
||||||
|
return comments, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// ListRepoIssueComments list comments for a given repo.
|
||||||
|
func (c *Client) ListRepoIssueComments(owner, repo string, opt ListIssueCommentOptions) ([]*Comment, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
link, _ := url.Parse(fmt.Sprintf("/repos/%s/%s/issues/comments", owner, repo)) |
||||||
|
link.RawQuery = opt.QueryEncode() |
||||||
|
comments := make([]*Comment, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", link.String(), nil, nil, &comments) |
||||||
|
return comments, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetIssueComment get a comment for a given repo by id.
|
||||||
|
func (c *Client) GetIssueComment(owner, repo string, id int64) (*Comment, *Response, error) { |
||||||
|
comment := new(Comment) |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil { |
||||||
|
return comment, nil, err |
||||||
|
} |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/issues/comments/%d", owner, repo, id), nil, nil, &comment) |
||||||
|
return comment, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// CreateIssueCommentOption options for creating a comment on an issue
|
||||||
|
type CreateIssueCommentOption struct { |
||||||
|
Body string `json:"body"` |
||||||
|
} |
||||||
|
|
||||||
|
// Validate the CreateIssueCommentOption struct
|
||||||
|
func (opt CreateIssueCommentOption) Validate() error { |
||||||
|
if len(opt.Body) == 0 { |
||||||
|
return fmt.Errorf("body is empty") |
||||||
|
} |
||||||
|
return nil |
||||||
|
} |
||||||
|
|
||||||
|
// CreateIssueComment create comment on an issue.
|
||||||
|
func (c *Client) CreateIssueComment(owner, repo string, index int64, opt CreateIssueCommentOption) (*Comment, *Response, error) { |
||||||
|
if err := opt.Validate(); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
comment := new(Comment) |
||||||
|
resp, err := c.getParsedResponse("POST", fmt.Sprintf("/repos/%s/%s/issues/%d/comments", owner, repo, index), jsonHeader, bytes.NewReader(body), comment) |
||||||
|
return comment, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// EditIssueCommentOption options for editing a comment
|
||||||
|
type EditIssueCommentOption struct { |
||||||
|
Body string `json:"body"` |
||||||
|
} |
||||||
|
|
||||||
|
// Validate the EditIssueCommentOption struct
|
||||||
|
func (opt EditIssueCommentOption) Validate() error { |
||||||
|
if len(opt.Body) == 0 { |
||||||
|
return fmt.Errorf("body is empty") |
||||||
|
} |
||||||
|
return nil |
||||||
|
} |
||||||
|
|
||||||
|
// EditIssueComment edits an issue comment.
|
||||||
|
func (c *Client) EditIssueComment(owner, repo string, commentID int64, opt EditIssueCommentOption) (*Comment, *Response, error) { |
||||||
|
if err := opt.Validate(); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
comment := new(Comment) |
||||||
|
resp, err := c.getParsedResponse("PATCH", fmt.Sprintf("/repos/%s/%s/issues/comments/%d", owner, repo, commentID), jsonHeader, bytes.NewReader(body), comment) |
||||||
|
return comment, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// DeleteIssueComment deletes an issue comment.
|
||||||
|
func (c *Client) DeleteIssueComment(owner, repo string, commentID int64) (*Response, error) { |
||||||
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/repos/%s/%s/issues/comments/%d", owner, repo, commentID), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
@ -0,0 +1,181 @@ |
|||||||
|
// Copyright 2016 The Gogs Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
"regexp" |
||||||
|
"strings" |
||||||
|
) |
||||||
|
|
||||||
|
// Label a label to an issue or a pr
|
||||||
|
type Label struct { |
||||||
|
ID int64 `json:"id"` |
||||||
|
Name string `json:"name"` |
||||||
|
// example: 00aabb
|
||||||
|
Color string `json:"color"` |
||||||
|
Description string `json:"description"` |
||||||
|
URL string `json:"url"` |
||||||
|
} |
||||||
|
|
||||||
|
// ListLabelsOptions options for listing repository's labels
|
||||||
|
type ListLabelsOptions struct { |
||||||
|
ListOptions |
||||||
|
} |
||||||
|
|
||||||
|
// ListRepoLabels list labels of one repository
|
||||||
|
func (c *Client) ListRepoLabels(owner, repo string, opt ListLabelsOptions) ([]*Label, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
labels := make([]*Label, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/labels?%s", owner, repo, opt.getURLQuery().Encode()), nil, nil, &labels) |
||||||
|
return labels, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetRepoLabel get one label of repository by repo it
|
||||||
|
func (c *Client) GetRepoLabel(owner, repo string, id int64) (*Label, *Response, error) { |
||||||
|
label := new(Label) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/labels/%d", owner, repo, id), nil, nil, label) |
||||||
|
return label, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// CreateLabelOption options for creating a label
|
||||||
|
type CreateLabelOption struct { |
||||||
|
Name string `json:"name"` |
||||||
|
// example: #00aabb
|
||||||
|
Color string `json:"color"` |
||||||
|
Description string `json:"description"` |
||||||
|
} |
||||||
|
|
||||||
|
// Validate the CreateLabelOption struct
|
||||||
|
func (opt CreateLabelOption) Validate() error { |
||||||
|
aw, err := regexp.MatchString("^#?[0-9,a-f,A-F]{6}$", opt.Color) |
||||||
|
if err != nil { |
||||||
|
return err |
||||||
|
} |
||||||
|
if !aw { |
||||||
|
return fmt.Errorf("invalid color format") |
||||||
|
} |
||||||
|
if len(strings.TrimSpace(opt.Name)) == 0 { |
||||||
|
return fmt.Errorf("empty name not allowed") |
||||||
|
} |
||||||
|
return nil |
||||||
|
} |
||||||
|
|
||||||
|
// CreateLabel create one label of repository
|
||||||
|
func (c *Client) CreateLabel(owner, repo string, opt CreateLabelOption) (*Label, *Response, error) { |
||||||
|
if err := opt.Validate(); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
if len(opt.Color) == 6 { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil { |
||||||
|
opt.Color = "#" + opt.Color |
||||||
|
} |
||||||
|
} |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
label := new(Label) |
||||||
|
resp, err := c.getParsedResponse("POST", |
||||||
|
fmt.Sprintf("/repos/%s/%s/labels", owner, repo), |
||||||
|
jsonHeader, bytes.NewReader(body), label) |
||||||
|
return label, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// EditLabelOption options for editing a label
|
||||||
|
type EditLabelOption struct { |
||||||
|
Name *string `json:"name"` |
||||||
|
Color *string `json:"color"` |
||||||
|
Description *string `json:"description"` |
||||||
|
} |
||||||
|
|
||||||
|
// Validate the EditLabelOption struct
|
||||||
|
func (opt EditLabelOption) Validate() error { |
||||||
|
if opt.Color != nil { |
||||||
|
aw, err := regexp.MatchString("^#?[0-9,a-f,A-F]{6}$", *opt.Color) |
||||||
|
if err != nil { |
||||||
|
return err |
||||||
|
} |
||||||
|
if !aw { |
||||||
|
return fmt.Errorf("invalid color format") |
||||||
|
} |
||||||
|
} |
||||||
|
if opt.Name != nil { |
||||||
|
if len(strings.TrimSpace(*opt.Name)) == 0 { |
||||||
|
return fmt.Errorf("empty name not allowed") |
||||||
|
} |
||||||
|
} |
||||||
|
return nil |
||||||
|
} |
||||||
|
|
||||||
|
// EditLabel modify one label with options
|
||||||
|
func (c *Client) EditLabel(owner, repo string, id int64, opt EditLabelOption) (*Label, *Response, error) { |
||||||
|
if err := opt.Validate(); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
label := new(Label) |
||||||
|
resp, err := c.getParsedResponse("PATCH", fmt.Sprintf("/repos/%s/%s/labels/%d", owner, repo, id), jsonHeader, bytes.NewReader(body), label) |
||||||
|
return label, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// DeleteLabel delete one label of repository by id
|
||||||
|
func (c *Client) DeleteLabel(owner, repo string, id int64) (*Response, error) { |
||||||
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/repos/%s/%s/labels/%d", owner, repo, id), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetIssueLabels get labels of one issue via issue id
|
||||||
|
func (c *Client) GetIssueLabels(owner, repo string, index int64, opts ListLabelsOptions) ([]*Label, *Response, error) { |
||||||
|
labels := make([]*Label, 0, 5) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/issues/%d/labels?%s", owner, repo, index, opts.getURLQuery().Encode()), nil, nil, &labels) |
||||||
|
return labels, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// IssueLabelsOption a collection of labels
|
||||||
|
type IssueLabelsOption struct { |
||||||
|
// list of label IDs
|
||||||
|
Labels []int64 `json:"labels"` |
||||||
|
} |
||||||
|
|
||||||
|
// AddIssueLabels add one or more labels to one issue
|
||||||
|
func (c *Client) AddIssueLabels(owner, repo string, index int64, opt IssueLabelsOption) ([]*Label, *Response, error) { |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
var labels []*Label |
||||||
|
resp, err := c.getParsedResponse("POST", fmt.Sprintf("/repos/%s/%s/issues/%d/labels", owner, repo, index), jsonHeader, bytes.NewReader(body), &labels) |
||||||
|
return labels, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// ReplaceIssueLabels replace old labels of issue with new labels
|
||||||
|
func (c *Client) ReplaceIssueLabels(owner, repo string, index int64, opt IssueLabelsOption) ([]*Label, *Response, error) { |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
var labels []*Label |
||||||
|
resp, err := c.getParsedResponse("PUT", fmt.Sprintf("/repos/%s/%s/issues/%d/labels", owner, repo, index), jsonHeader, bytes.NewReader(body), &labels) |
||||||
|
return labels, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// DeleteIssueLabel delete one label of one issue by issue id and label id
|
||||||
|
// TODO: maybe we need delete by label name and issue id
|
||||||
|
func (c *Client) DeleteIssueLabel(owner, repo string, index, label int64) (*Response, error) { |
||||||
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/repos/%s/%s/issues/%d/labels/%d", owner, repo, index, label), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// ClearIssueLabels delete all the labels of one issue.
|
||||||
|
func (c *Client) ClearIssueLabels(owner, repo string, index int64) (*Response, error) { |
||||||
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/repos/%s/%s/issues/%d/labels", owner, repo, index), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
@ -0,0 +1,213 @@ |
|||||||
|
// Copyright 2016 The Gogs Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
"net/url" |
||||||
|
"strings" |
||||||
|
"time" |
||||||
|
) |
||||||
|
|
||||||
|
// Milestone milestone is a collection of issues on one repository
|
||||||
|
type Milestone struct { |
||||||
|
ID int64 `json:"id"` |
||||||
|
Title string `json:"title"` |
||||||
|
Description string `json:"description"` |
||||||
|
State StateType `json:"state"` |
||||||
|
OpenIssues int `json:"open_issues"` |
||||||
|
ClosedIssues int `json:"closed_issues"` |
||||||
|
Created time.Time `json:"created_at"` |
||||||
|
Updated *time.Time `json:"updated_at"` |
||||||
|
Closed *time.Time `json:"closed_at"` |
||||||
|
Deadline *time.Time `json:"due_on"` |
||||||
|
} |
||||||
|
|
||||||
|
// ListMilestoneOption list milestone options
|
||||||
|
type ListMilestoneOption struct { |
||||||
|
ListOptions |
||||||
|
// open, closed, all
|
||||||
|
State StateType |
||||||
|
Name string |
||||||
|
} |
||||||
|
|
||||||
|
// QueryEncode turns options into querystring argument
|
||||||
|
func (opt *ListMilestoneOption) QueryEncode() string { |
||||||
|
query := opt.getURLQuery() |
||||||
|
if opt.State != "" { |
||||||
|
query.Add("state", string(opt.State)) |
||||||
|
} |
||||||
|
if len(opt.Name) != 0 { |
||||||
|
query.Add("name", opt.Name) |
||||||
|
} |
||||||
|
return query.Encode() |
||||||
|
} |
||||||
|
|
||||||
|
// ListRepoMilestones list all the milestones of one repository
|
||||||
|
func (c *Client) ListRepoMilestones(owner, repo string, opt ListMilestoneOption) ([]*Milestone, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
milestones := make([]*Milestone, 0, opt.PageSize) |
||||||
|
|
||||||
|
link, _ := url.Parse(fmt.Sprintf("/repos/%s/%s/milestones", owner, repo)) |
||||||
|
link.RawQuery = opt.QueryEncode() |
||||||
|
resp, err := c.getParsedResponse("GET", link.String(), nil, nil, &milestones) |
||||||
|
return milestones, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetMilestone get one milestone by repo name and milestone id
|
||||||
|
func (c *Client) GetMilestone(owner, repo string, id int64) (*Milestone, *Response, error) { |
||||||
|
milestone := new(Milestone) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/milestones/%d", owner, repo, id), nil, nil, milestone) |
||||||
|
return milestone, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetMilestoneByName get one milestone by repo and milestone name
|
||||||
|
func (c *Client) GetMilestoneByName(owner, repo string, name string) (*Milestone, *Response, error) { |
||||||
|
if c.CheckServerVersionConstraint(">=1.13") != nil { |
||||||
|
// backwards compatibility mode
|
||||||
|
m, resp, err := c.resolveMilestoneByName(owner, repo, name) |
||||||
|
return m, resp, err |
||||||
|
} |
||||||
|
milestone := new(Milestone) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/milestones/%s", owner, repo, name), nil, nil, milestone) |
||||||
|
return milestone, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// CreateMilestoneOption options for creating a milestone
|
||||||
|
type CreateMilestoneOption struct { |
||||||
|
Title string `json:"title"` |
||||||
|
Description string `json:"description"` |
||||||
|
State StateType `json:"state"` |
||||||
|
Deadline *time.Time `json:"due_on"` |
||||||
|
} |
||||||
|
|
||||||
|
// Validate the CreateMilestoneOption struct
|
||||||
|
func (opt CreateMilestoneOption) Validate() error { |
||||||
|
if len(strings.TrimSpace(opt.Title)) == 0 { |
||||||
|
return fmt.Errorf("title is empty") |
||||||
|
} |
||||||
|
return nil |
||||||
|
} |
||||||
|
|
||||||
|
// CreateMilestone create one milestone with options
|
||||||
|
func (c *Client) CreateMilestone(owner, repo string, opt CreateMilestoneOption) (*Milestone, *Response, error) { |
||||||
|
if err := opt.Validate(); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
milestone := new(Milestone) |
||||||
|
resp, err := c.getParsedResponse("POST", fmt.Sprintf("/repos/%s/%s/milestones", owner, repo), jsonHeader, bytes.NewReader(body), milestone) |
||||||
|
|
||||||
|
// make creating closed milestones need gitea >= v1.13.0
|
||||||
|
// this make it backwards compatible
|
||||||
|
if err == nil && opt.State == StateClosed && milestone.State != StateClosed { |
||||||
|
closed := StateClosed |
||||||
|
return c.EditMilestone(owner, repo, milestone.ID, EditMilestoneOption{ |
||||||
|
State: &closed, |
||||||
|
}) |
||||||
|
} |
||||||
|
|
||||||
|
return milestone, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// EditMilestoneOption options for editing a milestone
|
||||||
|
type EditMilestoneOption struct { |
||||||
|
Title string `json:"title"` |
||||||
|
Description *string `json:"description"` |
||||||
|
State *StateType `json:"state"` |
||||||
|
Deadline *time.Time `json:"due_on"` |
||||||
|
} |
||||||
|
|
||||||
|
// Validate the EditMilestoneOption struct
|
||||||
|
func (opt EditMilestoneOption) Validate() error { |
||||||
|
if len(opt.Title) != 0 && len(strings.TrimSpace(opt.Title)) == 0 { |
||||||
|
return fmt.Errorf("title is empty") |
||||||
|
} |
||||||
|
return nil |
||||||
|
} |
||||||
|
|
||||||
|
// EditMilestone modify milestone with options
|
||||||
|
func (c *Client) EditMilestone(owner, repo string, id int64, opt EditMilestoneOption) (*Milestone, *Response, error) { |
||||||
|
if err := opt.Validate(); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
milestone := new(Milestone) |
||||||
|
resp, err := c.getParsedResponse("PATCH", fmt.Sprintf("/repos/%s/%s/milestones/%d", owner, repo, id), jsonHeader, bytes.NewReader(body), milestone) |
||||||
|
return milestone, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// EditMilestoneByName modify milestone with options
|
||||||
|
func (c *Client) EditMilestoneByName(owner, repo string, name string, opt EditMilestoneOption) (*Milestone, *Response, error) { |
||||||
|
if c.CheckServerVersionConstraint(">=1.13") != nil { |
||||||
|
// backwards compatibility mode
|
||||||
|
m, _, err := c.resolveMilestoneByName(owner, repo, name) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
return c.EditMilestone(owner, repo, m.ID, opt) |
||||||
|
} |
||||||
|
if err := opt.Validate(); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
milestone := new(Milestone) |
||||||
|
resp, err := c.getParsedResponse("PATCH", fmt.Sprintf("/repos/%s/%s/milestones/%s", owner, repo, name), jsonHeader, bytes.NewReader(body), milestone) |
||||||
|
return milestone, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// DeleteMilestone delete one milestone by id
|
||||||
|
func (c *Client) DeleteMilestone(owner, repo string, id int64) (*Response, error) { |
||||||
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/repos/%s/%s/milestones/%d", owner, repo, id), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// DeleteMilestoneByName delete one milestone by name
|
||||||
|
func (c *Client) DeleteMilestoneByName(owner, repo string, name string) (*Response, error) { |
||||||
|
if c.CheckServerVersionConstraint(">=1.13") != nil { |
||||||
|
// backwards compatibility mode
|
||||||
|
m, _, err := c.resolveMilestoneByName(owner, repo, name) |
||||||
|
if err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
return c.DeleteMilestone(owner, repo, m.ID) |
||||||
|
} |
||||||
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/repos/%s/%s/milestones/%s", owner, repo, name), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// resolveMilestoneByName is a fallback method to find milestone id by name
|
||||||
|
func (c *Client) resolveMilestoneByName(owner, repo, name string) (*Milestone, *Response, error) { |
||||||
|
for i := 1; ; i++ { |
||||||
|
miles, resp, err := c.ListRepoMilestones(owner, repo, ListMilestoneOption{ |
||||||
|
ListOptions: ListOptions{ |
||||||
|
Page: i, |
||||||
|
}, |
||||||
|
State: "all", |
||||||
|
}) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
if len(miles) == 0 { |
||||||
|
return nil, nil, fmt.Errorf("milestone '%s' do not exist", name) |
||||||
|
} |
||||||
|
for _, m := range miles { |
||||||
|
if strings.ToLower(strings.TrimSpace(m.Title)) == strings.ToLower(strings.TrimSpace(name)) { |
||||||
|
return m, resp, nil |
||||||
|
} |
||||||
|
} |
||||||
|
} |
||||||
|
} |
||||||
@ -0,0 +1,104 @@ |
|||||||
|
// Copyright 2020 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
"time" |
||||||
|
) |
||||||
|
|
||||||
|
// Reaction contain one reaction
|
||||||
|
type Reaction struct { |
||||||
|
User *User `json:"user"` |
||||||
|
Reaction string `json:"content"` |
||||||
|
Created time.Time `json:"created_at"` |
||||||
|
} |
||||||
|
|
||||||
|
// GetIssueReactions get a list reactions of an issue
|
||||||
|
func (c *Client) GetIssueReactions(owner, repo string, index int64) ([]*Reaction, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.11.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
reactions := make([]*Reaction, 0, 10) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/issues/%d/reactions", owner, repo, index), nil, nil, &reactions) |
||||||
|
return reactions, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetIssueCommentReactions get a list of reactions from a comment of an issue
|
||||||
|
func (c *Client) GetIssueCommentReactions(owner, repo string, commentID int64) ([]*Reaction, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.11.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
reactions := make([]*Reaction, 0, 10) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/issues/comments/%d/reactions", owner, repo, commentID), nil, nil, &reactions) |
||||||
|
return reactions, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// editReactionOption contain the reaction type
|
||||||
|
type editReactionOption struct { |
||||||
|
Reaction string `json:"content"` |
||||||
|
} |
||||||
|
|
||||||
|
// PostIssueReaction add a reaction to an issue
|
||||||
|
func (c *Client) PostIssueReaction(owner, repo string, index int64, reaction string) (*Reaction, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.11.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
reactionResponse := new(Reaction) |
||||||
|
body, err := json.Marshal(&editReactionOption{Reaction: reaction}) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
resp, err := c.getParsedResponse("POST", |
||||||
|
fmt.Sprintf("/repos/%s/%s/issues/%d/reactions", owner, repo, index), |
||||||
|
jsonHeader, bytes.NewReader(body), reactionResponse) |
||||||
|
return reactionResponse, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// DeleteIssueReaction remove a reaction from an issue
|
||||||
|
func (c *Client) DeleteIssueReaction(owner, repo string, index int64, reaction string) (*Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.11.0"); err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
body, err := json.Marshal(&editReactionOption{Reaction: reaction}) |
||||||
|
if err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/repos/%s/%s/issues/%d/reactions", owner, repo, index), jsonHeader, bytes.NewReader(body)) |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// PostIssueCommentReaction add a reaction to a comment of an issue
|
||||||
|
func (c *Client) PostIssueCommentReaction(owner, repo string, commentID int64, reaction string) (*Reaction, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.11.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
reactionResponse := new(Reaction) |
||||||
|
body, err := json.Marshal(&editReactionOption{Reaction: reaction}) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
resp, err := c.getParsedResponse("POST", |
||||||
|
fmt.Sprintf("/repos/%s/%s/issues/comments/%d/reactions", owner, repo, commentID), |
||||||
|
jsonHeader, bytes.NewReader(body), reactionResponse) |
||||||
|
return reactionResponse, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// DeleteIssueCommentReaction remove a reaction from a comment of an issue
|
||||||
|
func (c *Client) DeleteIssueCommentReaction(owner, repo string, commentID int64, reaction string) (*Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.11.0"); err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
body, err := json.Marshal(&editReactionOption{Reaction: reaction}) |
||||||
|
if err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
_, resp, err := c.getResponse("DELETE", |
||||||
|
fmt.Sprintf("/repos/%s/%s/issues/comments/%d/reactions", owner, repo, commentID), |
||||||
|
jsonHeader, bytes.NewReader(body)) |
||||||
|
return resp, err |
||||||
|
} |
||||||
@ -0,0 +1,43 @@ |
|||||||
|
// Copyright 2020 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"fmt" |
||||||
|
"time" |
||||||
|
) |
||||||
|
|
||||||
|
// StopWatch represents a running stopwatch of an issue / pr
|
||||||
|
type StopWatch struct { |
||||||
|
Created time.Time `json:"created"` |
||||||
|
IssueIndex int64 `json:"issue_index"` |
||||||
|
} |
||||||
|
|
||||||
|
// GetMyStopwatches list all stopwatches
|
||||||
|
func (c *Client) GetMyStopwatches() ([]*StopWatch, *Response, error) { |
||||||
|
stopwatches := make([]*StopWatch, 0, 1) |
||||||
|
resp, err := c.getParsedResponse("GET", "/user/stopwatches", nil, nil, &stopwatches) |
||||||
|
return stopwatches, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// DeleteIssueStopwatch delete / cancel a specific stopwatch
|
||||||
|
func (c *Client) DeleteIssueStopwatch(owner, repo string, index int64) (*Response, error) { |
||||||
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/repos/%s/%s/issues/%d/stopwatch/delete", owner, repo, index), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// StartIssueStopWatch starts a stopwatch for an existing issue for a given
|
||||||
|
// repository
|
||||||
|
func (c *Client) StartIssueStopWatch(owner, repo string, index int64) (*Response, error) { |
||||||
|
_, resp, err := c.getResponse("POST", fmt.Sprintf("/repos/%s/%s/issues/%d/stopwatch/start", owner, repo, index), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// StopIssueStopWatch stops an existing stopwatch for an issue in a given
|
||||||
|
// repository
|
||||||
|
func (c *Client) StopIssueStopWatch(owner, repo string, index int64) (*Response, error) { |
||||||
|
_, resp, err := c.getResponse("POST", fmt.Sprintf("/repos/%s/%s/issues/%d/stopwatch/stop", owner, repo, index), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
@ -0,0 +1,84 @@ |
|||||||
|
// Copyright 2020 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"fmt" |
||||||
|
"net/http" |
||||||
|
) |
||||||
|
|
||||||
|
// GetIssueSubscribers get list of users who subscribed on an issue
|
||||||
|
func (c *Client) GetIssueSubscribers(owner, repo string, index int64) ([]*User, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.11.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
subscribers := make([]*User, 0, 10) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/issues/%d/subscriptions", owner, repo, index), nil, nil, &subscribers) |
||||||
|
return subscribers, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// AddIssueSubscription Subscribe user to issue
|
||||||
|
func (c *Client) AddIssueSubscription(owner, repo string, index int64, user string) (*Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.11.0"); err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
status, resp, err := c.getStatusCode("PUT", fmt.Sprintf("/repos/%s/%s/issues/%d/subscriptions/%s", owner, repo, index, user), nil, nil) |
||||||
|
if err != nil { |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
if status == http.StatusCreated { |
||||||
|
return resp, nil |
||||||
|
} |
||||||
|
if status == http.StatusOK { |
||||||
|
return resp, fmt.Errorf("already subscribed") |
||||||
|
} |
||||||
|
return resp, fmt.Errorf("unexpected Status: %d", status) |
||||||
|
} |
||||||
|
|
||||||
|
// DeleteIssueSubscription unsubscribe user from issue
|
||||||
|
func (c *Client) DeleteIssueSubscription(owner, repo string, index int64, user string) (*Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.11.0"); err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
status, resp, err := c.getStatusCode("DELETE", fmt.Sprintf("/repos/%s/%s/issues/%d/subscriptions/%s", owner, repo, index, user), nil, nil) |
||||||
|
if err != nil { |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
if status == http.StatusCreated { |
||||||
|
return resp, nil |
||||||
|
} |
||||||
|
if status == http.StatusOK { |
||||||
|
return resp, fmt.Errorf("already unsubscribed") |
||||||
|
} |
||||||
|
return resp, fmt.Errorf("unexpected Status: %d", status) |
||||||
|
} |
||||||
|
|
||||||
|
// CheckIssueSubscription check if current user is subscribed to an issue
|
||||||
|
func (c *Client) CheckIssueSubscription(owner, repo string, index int64) (*WatchInfo, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
wi := new(WatchInfo) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/issues/%d/subscriptions/check", owner, repo, index), nil, nil, wi) |
||||||
|
return wi, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// IssueSubscribe subscribe current user to an issue
|
||||||
|
func (c *Client) IssueSubscribe(owner, repo string, index int64) (*Response, error) { |
||||||
|
u, _, err := c.GetMyUserInfo() |
||||||
|
if err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
return c.AddIssueSubscription(owner, repo, index, u.UserName) |
||||||
|
} |
||||||
|
|
||||||
|
// IssueUnSubscribe unsubscribe current user from an issue
|
||||||
|
func (c *Client) IssueUnSubscribe(owner, repo string, index int64) (*Response, error) { |
||||||
|
u, _, err := c.GetMyUserInfo() |
||||||
|
if err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
return c.DeleteIssueSubscription(owner, repo, index, u.UserName) |
||||||
|
} |
||||||
@ -0,0 +1,127 @@ |
|||||||
|
// Copyright 2017 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
"time" |
||||||
|
) |
||||||
|
|
||||||
|
// TrackedTime worked time for an issue / pr
|
||||||
|
type TrackedTime struct { |
||||||
|
ID int64 `json:"id"` |
||||||
|
Created time.Time `json:"created"` |
||||||
|
// Time in seconds
|
||||||
|
Time int64 `json:"time"` |
||||||
|
// deprecated (only for backwards compatibility)
|
||||||
|
UserID int64 `json:"user_id"` |
||||||
|
UserName string `json:"user_name"` |
||||||
|
// deprecated (only for backwards compatibility)
|
||||||
|
IssueID int64 `json:"issue_id"` |
||||||
|
Issue *Issue `json:"issue"` |
||||||
|
} |
||||||
|
|
||||||
|
// GetUserTrackedTimes list tracked times of a user
|
||||||
|
func (c *Client) GetUserTrackedTimes(owner, repo, user string) ([]*TrackedTime, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.11.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
times := make([]*TrackedTime, 0, 10) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/times/%s", owner, repo, user), nil, nil, ×) |
||||||
|
return times, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetRepoTrackedTimes list tracked times of a repository
|
||||||
|
func (c *Client) GetRepoTrackedTimes(owner, repo string) ([]*TrackedTime, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.11.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
times := make([]*TrackedTime, 0, 10) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/times", owner, repo), nil, nil, ×) |
||||||
|
return times, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetMyTrackedTimes list tracked times of the current user
|
||||||
|
func (c *Client) GetMyTrackedTimes() ([]*TrackedTime, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.11.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
times := make([]*TrackedTime, 0, 10) |
||||||
|
resp, err := c.getParsedResponse("GET", "/user/times", nil, nil, ×) |
||||||
|
return times, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// AddTimeOption options for adding time to an issue
|
||||||
|
type AddTimeOption struct { |
||||||
|
// time in seconds
|
||||||
|
Time int64 `json:"time"` |
||||||
|
// optional
|
||||||
|
Created time.Time `json:"created"` |
||||||
|
// optional
|
||||||
|
User string `json:"user_name"` |
||||||
|
} |
||||||
|
|
||||||
|
// Validate the AddTimeOption struct
|
||||||
|
func (opt AddTimeOption) Validate() error { |
||||||
|
if opt.Time == 0 { |
||||||
|
return fmt.Errorf("no time to add") |
||||||
|
} |
||||||
|
return nil |
||||||
|
} |
||||||
|
|
||||||
|
// AddTime adds time to issue with the given index
|
||||||
|
func (c *Client) AddTime(owner, repo string, index int64, opt AddTimeOption) (*TrackedTime, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.11.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
if err := opt.Validate(); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
t := new(TrackedTime) |
||||||
|
resp, err := c.getParsedResponse("POST", |
||||||
|
fmt.Sprintf("/repos/%s/%s/issues/%d/times", owner, repo, index), |
||||||
|
jsonHeader, bytes.NewReader(body), t) |
||||||
|
return t, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// ListTrackedTimesOptions options for listing repository's tracked times
|
||||||
|
type ListTrackedTimesOptions struct { |
||||||
|
ListOptions |
||||||
|
} |
||||||
|
|
||||||
|
// ListTrackedTimes list tracked times of a single issue for a given repository
|
||||||
|
func (c *Client) ListTrackedTimes(owner, repo string, index int64, opt ListTrackedTimesOptions) ([]*TrackedTime, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.11.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
opt.setDefaults() |
||||||
|
times := make([]*TrackedTime, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/issues/%d/times?%s", owner, repo, index, opt.getURLQuery().Encode()), nil, nil, ×) |
||||||
|
return times, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// ResetIssueTime reset tracked time of a single issue for a given repository
|
||||||
|
func (c *Client) ResetIssueTime(owner, repo string, index int64) (*Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.11.0"); err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/repos/%s/%s/issues/%d/times", owner, repo, index), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// DeleteTime delete a specific tracked time by id of a single issue for a given repository
|
||||||
|
func (c *Client) DeleteTime(owner, repo string, index, timeID int64) (*Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.11.0"); err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/repos/%s/%s/issues/%d/times/%d", owner, repo, index, timeID), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
@ -0,0 +1,37 @@ |
|||||||
|
// Copyright 2020 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"fmt" |
||||||
|
"net/url" |
||||||
|
) |
||||||
|
|
||||||
|
const defaultPageSize = 10 |
||||||
|
const maxPageSize = 50 |
||||||
|
|
||||||
|
// ListOptions options for using Gitea's API pagination
|
||||||
|
type ListOptions struct { |
||||||
|
Page int |
||||||
|
PageSize int |
||||||
|
} |
||||||
|
|
||||||
|
func (o ListOptions) getURLQuery() url.Values { |
||||||
|
query := make(url.Values) |
||||||
|
query.Add("page", fmt.Sprintf("%d", o.Page)) |
||||||
|
query.Add("limit", fmt.Sprintf("%d", o.PageSize)) |
||||||
|
|
||||||
|
return query |
||||||
|
} |
||||||
|
|
||||||
|
func (o ListOptions) setDefaults() { |
||||||
|
if o.Page < 1 { |
||||||
|
o.Page = 1 |
||||||
|
} |
||||||
|
|
||||||
|
if o.PageSize < 0 || o.PageSize > maxPageSize { |
||||||
|
o.PageSize = defaultPageSize |
||||||
|
} |
||||||
|
} |
||||||
@ -0,0 +1,199 @@ |
|||||||
|
// Copyright 2020 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"fmt" |
||||||
|
"net/url" |
||||||
|
"time" |
||||||
|
) |
||||||
|
|
||||||
|
// NotificationThread expose Notification on API
|
||||||
|
type NotificationThread struct { |
||||||
|
ID int64 `json:"id"` |
||||||
|
Repository *Repository `json:"repository"` |
||||||
|
Subject *NotificationSubject `json:"subject"` |
||||||
|
Unread bool `json:"unread"` |
||||||
|
Pinned bool `json:"pinned"` |
||||||
|
UpdatedAt time.Time `json:"updated_at"` |
||||||
|
URL string `json:"url"` |
||||||
|
} |
||||||
|
|
||||||
|
// NotificationSubject contains the notification subject (Issue/Pull/Commit)
|
||||||
|
type NotificationSubject struct { |
||||||
|
Title string `json:"title"` |
||||||
|
URL string `json:"url"` |
||||||
|
LatestCommentURL string `json:"latest_comment_url"` |
||||||
|
Type string `json:"type"` |
||||||
|
State StateType `json:"state"` |
||||||
|
} |
||||||
|
|
||||||
|
// NotifyStatus notification status type
|
||||||
|
type NotifyStatus string |
||||||
|
|
||||||
|
const ( |
||||||
|
// NotifyStatusUnread was not read
|
||||||
|
NotifyStatusUnread NotifyStatus = "unread" |
||||||
|
// NotifyStatusRead was already read by user
|
||||||
|
NotifyStatusRead NotifyStatus = "read" |
||||||
|
// NotifyStatusPinned notification is pinned by user
|
||||||
|
NotifyStatusPinned NotifyStatus = "pinned" |
||||||
|
) |
||||||
|
|
||||||
|
// ListNotificationOptions represents the filter options
|
||||||
|
type ListNotificationOptions struct { |
||||||
|
ListOptions |
||||||
|
Since time.Time |
||||||
|
Before time.Time |
||||||
|
Status []NotifyStatus |
||||||
|
} |
||||||
|
|
||||||
|
// MarkNotificationOptions represents the filter & modify options
|
||||||
|
type MarkNotificationOptions struct { |
||||||
|
LastReadAt time.Time |
||||||
|
Status []NotifyStatus |
||||||
|
ToStatus NotifyStatus |
||||||
|
} |
||||||
|
|
||||||
|
// QueryEncode encode options to url query
|
||||||
|
func (opt *ListNotificationOptions) QueryEncode() string { |
||||||
|
query := opt.getURLQuery() |
||||||
|
if !opt.Since.IsZero() { |
||||||
|
query.Add("since", opt.Since.Format(time.RFC3339)) |
||||||
|
} |
||||||
|
if !opt.Before.IsZero() { |
||||||
|
query.Add("before", opt.Before.Format(time.RFC3339)) |
||||||
|
} |
||||||
|
for _, s := range opt.Status { |
||||||
|
query.Add("status-types", string(s)) |
||||||
|
} |
||||||
|
return query.Encode() |
||||||
|
} |
||||||
|
|
||||||
|
// Validate the CreateUserOption struct
|
||||||
|
func (opt ListNotificationOptions) Validate(c *Client) error { |
||||||
|
if len(opt.Status) != 0 { |
||||||
|
return c.CheckServerVersionConstraint(">=1.12.3") |
||||||
|
} |
||||||
|
return nil |
||||||
|
} |
||||||
|
|
||||||
|
// QueryEncode encode options to url query
|
||||||
|
func (opt *MarkNotificationOptions) QueryEncode() string { |
||||||
|
query := make(url.Values) |
||||||
|
if !opt.LastReadAt.IsZero() { |
||||||
|
query.Add("last_read_at", opt.LastReadAt.Format(time.RFC3339)) |
||||||
|
} |
||||||
|
for _, s := range opt.Status { |
||||||
|
query.Add("status-types", string(s)) |
||||||
|
} |
||||||
|
if len(opt.ToStatus) != 0 { |
||||||
|
query.Add("to-status", string(opt.ToStatus)) |
||||||
|
} |
||||||
|
return query.Encode() |
||||||
|
} |
||||||
|
|
||||||
|
// Validate the CreateUserOption struct
|
||||||
|
func (opt MarkNotificationOptions) Validate(c *Client) error { |
||||||
|
if len(opt.Status) != 0 || len(opt.ToStatus) != 0 { |
||||||
|
return c.CheckServerVersionConstraint(">=1.12.3") |
||||||
|
} |
||||||
|
return nil |
||||||
|
} |
||||||
|
|
||||||
|
// CheckNotifications list users's notification threads
|
||||||
|
func (c *Client) CheckNotifications() (int64, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil { |
||||||
|
return 0, nil, err |
||||||
|
} |
||||||
|
new := struct { |
||||||
|
New int64 `json:"new"` |
||||||
|
}{} |
||||||
|
|
||||||
|
resp, err := c.getParsedResponse("GET", "/notifications/new", jsonHeader, nil, &new) |
||||||
|
return new.New, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetNotification get notification thread by ID
|
||||||
|
func (c *Client) GetNotification(id int64) (*NotificationThread, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
thread := new(NotificationThread) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/notifications/threads/%d", id), nil, nil, thread) |
||||||
|
return thread, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// ReadNotification mark notification thread as read by ID
|
||||||
|
// It optionally takes a second argument if status has to be set other than 'read'
|
||||||
|
func (c *Client) ReadNotification(id int64, status ...NotifyStatus) (*Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
link := fmt.Sprintf("/notifications/threads/%d", id) |
||||||
|
if len(status) != 0 { |
||||||
|
link += fmt.Sprintf("?to-status=%s", status[0]) |
||||||
|
} |
||||||
|
_, resp, err := c.getResponse("PATCH", link, nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// ListNotifications list users's notification threads
|
||||||
|
func (c *Client) ListNotifications(opt ListNotificationOptions) ([]*NotificationThread, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
if err := opt.Validate(c); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
link, _ := url.Parse("/notifications") |
||||||
|
link.RawQuery = opt.QueryEncode() |
||||||
|
threads := make([]*NotificationThread, 0, 10) |
||||||
|
resp, err := c.getParsedResponse("GET", link.String(), nil, nil, &threads) |
||||||
|
return threads, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// ReadNotifications mark notification threads as read
|
||||||
|
func (c *Client) ReadNotifications(opt MarkNotificationOptions) (*Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
if err := opt.Validate(c); err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
link, _ := url.Parse("/notifications") |
||||||
|
link.RawQuery = opt.QueryEncode() |
||||||
|
_, resp, err := c.getResponse("PUT", link.String(), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// ListRepoNotifications list users's notification threads on a specific repo
|
||||||
|
func (c *Client) ListRepoNotifications(owner, reponame string, opt ListNotificationOptions) ([]*NotificationThread, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
if err := opt.Validate(c); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
link, _ := url.Parse(fmt.Sprintf("/repos/%s/%s/notifications", owner, reponame)) |
||||||
|
link.RawQuery = opt.QueryEncode() |
||||||
|
threads := make([]*NotificationThread, 0, 10) |
||||||
|
resp, err := c.getParsedResponse("GET", link.String(), nil, nil, &threads) |
||||||
|
return threads, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// ReadRepoNotifications mark notification threads as read on a specific repo
|
||||||
|
func (c *Client) ReadRepoNotifications(owner, reponame string, opt MarkNotificationOptions) (*Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
if err := opt.Validate(c); err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
link, _ := url.Parse(fmt.Sprintf("/repos/%s/%s/notifications", owner, reponame)) |
||||||
|
link.RawQuery = opt.QueryEncode() |
||||||
|
_, resp, err := c.getResponse("PUT", link.String(), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
@ -0,0 +1,91 @@ |
|||||||
|
// Copyright 2020 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
"time" |
||||||
|
) |
||||||
|
|
||||||
|
// Oauth2 represents an Oauth2 Application
|
||||||
|
type Oauth2 struct { |
||||||
|
ID int64 `json:"id"` |
||||||
|
Name string `json:"name"` |
||||||
|
ClientID string `json:"client_id"` |
||||||
|
ClientSecret string `json:"client_secret"` |
||||||
|
RedirectURIs []string `json:"redirect_uris"` |
||||||
|
Created time.Time `json:"created"` |
||||||
|
} |
||||||
|
|
||||||
|
// ListOauth2Option for listing Oauth2 Applications
|
||||||
|
type ListOauth2Option struct { |
||||||
|
ListOptions |
||||||
|
} |
||||||
|
|
||||||
|
// CreateOauth2Option required options for creating an Application
|
||||||
|
type CreateOauth2Option struct { |
||||||
|
Name string `json:"name"` |
||||||
|
RedirectURIs []string `json:"redirect_uris"` |
||||||
|
} |
||||||
|
|
||||||
|
// CreateOauth2 create an Oauth2 Application and returns a completed Oauth2 object.
|
||||||
|
func (c *Client) CreateOauth2(opt CreateOauth2Option) (*Oauth2, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
oauth := new(Oauth2) |
||||||
|
resp, err := c.getParsedResponse("POST", "/user/applications/oauth2", jsonHeader, bytes.NewReader(body), oauth) |
||||||
|
return oauth, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// UpdateOauth2 a specific Oauth2 Application by ID and return a completed Oauth2 object.
|
||||||
|
func (c *Client) UpdateOauth2(oauth2id int64, opt CreateOauth2Option) (*Oauth2, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
oauth := new(Oauth2) |
||||||
|
resp, err := c.getParsedResponse("PATCH", fmt.Sprintf("/user/applications/oauth2/%d", oauth2id), jsonHeader, bytes.NewReader(body), oauth) |
||||||
|
return oauth, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetOauth2 a specific Oauth2 Application by ID.
|
||||||
|
func (c *Client) GetOauth2(oauth2id int64) (*Oauth2, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
oauth2s := &Oauth2{} |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/user/applications/oauth2/%d", oauth2id), nil, nil, &oauth2s) |
||||||
|
return oauth2s, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// ListOauth2 all of your Oauth2 Applications.
|
||||||
|
func (c *Client) ListOauth2(opt ListOauth2Option) ([]*Oauth2, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
opt.setDefaults() |
||||||
|
oauth2s := make([]*Oauth2, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/user/applications/oauth2?%s", opt.getURLQuery().Encode()), nil, nil, &oauth2s) |
||||||
|
return oauth2s, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// DeleteOauth2 delete an Oauth2 application by ID
|
||||||
|
func (c *Client) DeleteOauth2(oauth2id int64) (*Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/user/applications/oauth2/%d", oauth2id), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
@ -0,0 +1,142 @@ |
|||||||
|
// Copyright 2015 The Gogs Authors. All rights reserved.
|
||||||
|
// Copyright 2019 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
) |
||||||
|
|
||||||
|
// Organization represents an organization
|
||||||
|
type Organization struct { |
||||||
|
ID int64 `json:"id"` |
||||||
|
UserName string `json:"username"` |
||||||
|
FullName string `json:"full_name"` |
||||||
|
AvatarURL string `json:"avatar_url"` |
||||||
|
Description string `json:"description"` |
||||||
|
Website string `json:"website"` |
||||||
|
Location string `json:"location"` |
||||||
|
Visibility string `json:"visibility"` |
||||||
|
} |
||||||
|
|
||||||
|
// VisibleType defines the visibility
|
||||||
|
type VisibleType string |
||||||
|
|
||||||
|
const ( |
||||||
|
// VisibleTypePublic Visible for everyone
|
||||||
|
VisibleTypePublic VisibleType = "public" |
||||||
|
|
||||||
|
// VisibleTypeLimited Visible for every connected user
|
||||||
|
VisibleTypeLimited VisibleType = "limited" |
||||||
|
|
||||||
|
// VisibleTypePrivate Visible only for organization's members
|
||||||
|
VisibleTypePrivate VisibleType = "private" |
||||||
|
) |
||||||
|
|
||||||
|
// ListOrgsOptions options for listing organizations
|
||||||
|
type ListOrgsOptions struct { |
||||||
|
ListOptions |
||||||
|
} |
||||||
|
|
||||||
|
// ListMyOrgs list all of current user's organizations
|
||||||
|
func (c *Client) ListMyOrgs(opt ListOrgsOptions) ([]*Organization, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
orgs := make([]*Organization, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/user/orgs?%s", opt.getURLQuery().Encode()), nil, nil, &orgs) |
||||||
|
return orgs, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// ListUserOrgs list all of some user's organizations
|
||||||
|
func (c *Client) ListUserOrgs(user string, opt ListOrgsOptions) ([]*Organization, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
orgs := make([]*Organization, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/users/%s/orgs?%s", user, opt.getURLQuery().Encode()), nil, nil, &orgs) |
||||||
|
return orgs, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetOrg get one organization by name
|
||||||
|
func (c *Client) GetOrg(orgname string) (*Organization, *Response, error) { |
||||||
|
org := new(Organization) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/orgs/%s", orgname), nil, nil, org) |
||||||
|
return org, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// CreateOrgOption options for creating an organization
|
||||||
|
type CreateOrgOption struct { |
||||||
|
Name string `json:"username"` |
||||||
|
FullName string `json:"full_name"` |
||||||
|
Description string `json:"description"` |
||||||
|
Website string `json:"website"` |
||||||
|
Location string `json:"location"` |
||||||
|
Visibility VisibleType `json:"visibility"` |
||||||
|
} |
||||||
|
|
||||||
|
// checkVisibilityOpt check if mode exist
|
||||||
|
func checkVisibilityOpt(v VisibleType) bool { |
||||||
|
return v == VisibleTypePublic || v == VisibleTypeLimited || v == VisibleTypePrivate |
||||||
|
} |
||||||
|
|
||||||
|
// Validate the CreateOrgOption struct
|
||||||
|
func (opt CreateOrgOption) Validate() error { |
||||||
|
if len(opt.Name) == 0 { |
||||||
|
return fmt.Errorf("empty org name") |
||||||
|
} |
||||||
|
if len(opt.Visibility) != 0 && !checkVisibilityOpt(opt.Visibility) { |
||||||
|
return fmt.Errorf("infalid bisibility option") |
||||||
|
} |
||||||
|
return nil |
||||||
|
} |
||||||
|
|
||||||
|
// CreateOrg creates an organization
|
||||||
|
func (c *Client) CreateOrg(opt CreateOrgOption) (*Organization, *Response, error) { |
||||||
|
if err := opt.Validate(); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
org := new(Organization) |
||||||
|
resp, err := c.getParsedResponse("POST", "/orgs", jsonHeader, bytes.NewReader(body), org) |
||||||
|
return org, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// EditOrgOption options for editing an organization
|
||||||
|
type EditOrgOption struct { |
||||||
|
FullName string `json:"full_name"` |
||||||
|
Description string `json:"description"` |
||||||
|
Website string `json:"website"` |
||||||
|
Location string `json:"location"` |
||||||
|
Visibility VisibleType `json:"visibility"` |
||||||
|
} |
||||||
|
|
||||||
|
// Validate the EditOrgOption struct
|
||||||
|
func (opt EditOrgOption) Validate() error { |
||||||
|
if len(opt.Visibility) != 0 && !checkVisibilityOpt(opt.Visibility) { |
||||||
|
return fmt.Errorf("infalid bisibility option") |
||||||
|
} |
||||||
|
return nil |
||||||
|
} |
||||||
|
|
||||||
|
// EditOrg modify one organization via options
|
||||||
|
func (c *Client) EditOrg(orgname string, opt EditOrgOption) (*Response, error) { |
||||||
|
if err := opt.Validate(); err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
_, resp, err := c.getResponse("PATCH", fmt.Sprintf("/orgs/%s", orgname), jsonHeader, bytes.NewReader(body)) |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// DeleteOrg deletes an organization
|
||||||
|
func (c *Client) DeleteOrg(orgname string) (*Response, error) { |
||||||
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/orgs/%s", orgname), jsonHeader, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
@ -0,0 +1,101 @@ |
|||||||
|
// Copyright 2020 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"fmt" |
||||||
|
"net/http" |
||||||
|
"net/url" |
||||||
|
) |
||||||
|
|
||||||
|
// DeleteOrgMembership remove a member from an organization
|
||||||
|
func (c *Client) DeleteOrgMembership(org, user string) (*Response, error) { |
||||||
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/orgs/%s/members/%s", url.PathEscape(org), url.PathEscape(user)), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// ListOrgMembershipOption list OrgMembership options
|
||||||
|
type ListOrgMembershipOption struct { |
||||||
|
ListOptions |
||||||
|
} |
||||||
|
|
||||||
|
// ListOrgMembership list an organization's members
|
||||||
|
func (c *Client) ListOrgMembership(org string, opt ListOrgMembershipOption) ([]*User, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
users := make([]*User, 0, opt.PageSize) |
||||||
|
|
||||||
|
link, _ := url.Parse(fmt.Sprintf("/orgs/%s/members", url.PathEscape(org))) |
||||||
|
link.RawQuery = opt.getURLQuery().Encode() |
||||||
|
resp, err := c.getParsedResponse("GET", link.String(), jsonHeader, nil, &users) |
||||||
|
return users, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// ListPublicOrgMembership list an organization's members
|
||||||
|
func (c *Client) ListPublicOrgMembership(org string, opt ListOrgMembershipOption) ([]*User, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
users := make([]*User, 0, opt.PageSize) |
||||||
|
|
||||||
|
link, _ := url.Parse(fmt.Sprintf("/orgs/%s/public_members", url.PathEscape(org))) |
||||||
|
link.RawQuery = opt.getURLQuery().Encode() |
||||||
|
resp, err := c.getParsedResponse("GET", link.String(), jsonHeader, nil, &users) |
||||||
|
return users, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// CheckOrgMembership Check if a user is a member of an organization
|
||||||
|
func (c *Client) CheckOrgMembership(org, user string) (bool, *Response, error) { |
||||||
|
status, resp, err := c.getStatusCode("GET", fmt.Sprintf("/orgs/%s/members/%s", url.PathEscape(org), url.PathEscape(user)), nil, nil) |
||||||
|
if err != nil { |
||||||
|
return false, resp, err |
||||||
|
} |
||||||
|
switch status { |
||||||
|
case http.StatusNoContent: |
||||||
|
return true, resp, nil |
||||||
|
case http.StatusNotFound: |
||||||
|
return false, resp, nil |
||||||
|
default: |
||||||
|
return false, resp, fmt.Errorf("unexpected Status: %d", status) |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
// CheckPublicOrgMembership Check if a user is a member of an organization
|
||||||
|
func (c *Client) CheckPublicOrgMembership(org, user string) (bool, *Response, error) { |
||||||
|
status, resp, err := c.getStatusCode("GET", fmt.Sprintf("/orgs/%s/public_members/%s", url.PathEscape(org), url.PathEscape(user)), nil, nil) |
||||||
|
if err != nil { |
||||||
|
return false, resp, err |
||||||
|
} |
||||||
|
switch status { |
||||||
|
case http.StatusNoContent: |
||||||
|
return true, resp, nil |
||||||
|
case http.StatusNotFound: |
||||||
|
return false, resp, nil |
||||||
|
default: |
||||||
|
return false, resp, fmt.Errorf("unexpected Status: %d", status) |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
// SetPublicOrgMembership publicize/conceal a user's membership
|
||||||
|
func (c *Client) SetPublicOrgMembership(org, user string, visible bool) (*Response, error) { |
||||||
|
var ( |
||||||
|
status int |
||||||
|
err error |
||||||
|
resp *Response |
||||||
|
) |
||||||
|
if visible { |
||||||
|
status, resp, err = c.getStatusCode("PUT", fmt.Sprintf("/orgs/%s/public_members/%s", url.PathEscape(org), url.PathEscape(user)), nil, nil) |
||||||
|
} else { |
||||||
|
status, resp, err = c.getStatusCode("DELETE", fmt.Sprintf("/orgs/%s/public_members/%s", url.PathEscape(org), url.PathEscape(user)), nil, nil) |
||||||
|
} |
||||||
|
if err != nil { |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
switch status { |
||||||
|
case http.StatusNoContent: |
||||||
|
return resp, nil |
||||||
|
case http.StatusNotFound: |
||||||
|
return resp, fmt.Errorf("forbidden") |
||||||
|
default: |
||||||
|
return resp, fmt.Errorf("unexpected Status: %d", status) |
||||||
|
} |
||||||
|
} |
||||||
@ -0,0 +1,202 @@ |
|||||||
|
// Copyright 2019 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
) |
||||||
|
|
||||||
|
// Team represents a team in an organization
|
||||||
|
type Team struct { |
||||||
|
ID int64 `json:"id"` |
||||||
|
Name string `json:"name"` |
||||||
|
Description string `json:"description"` |
||||||
|
Organization *Organization `json:"organization"` |
||||||
|
Permission AccessMode `json:"permission"` |
||||||
|
CanCreateOrgRepo bool `json:"can_create_org_repo"` |
||||||
|
IncludesAllRepositories bool `json:"includes_all_repositories"` |
||||||
|
// example: ["repo.code","repo.issues","repo.ext_issues","repo.wiki","repo.pulls","repo.releases","repo.ext_wiki"]
|
||||||
|
Units []string `json:"units"` |
||||||
|
} |
||||||
|
|
||||||
|
// ListTeamsOptions options for listing teams
|
||||||
|
type ListTeamsOptions struct { |
||||||
|
ListOptions |
||||||
|
} |
||||||
|
|
||||||
|
// ListOrgTeams lists all teams of an organization
|
||||||
|
func (c *Client) ListOrgTeams(org string, opt ListTeamsOptions) ([]*Team, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
teams := make([]*Team, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/orgs/%s/teams?%s", org, opt.getURLQuery().Encode()), nil, nil, &teams) |
||||||
|
return teams, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// ListMyTeams lists all the teams of the current user
|
||||||
|
func (c *Client) ListMyTeams(opt *ListTeamsOptions) ([]*Team, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
teams := make([]*Team, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/user/teams?%s", opt.getURLQuery().Encode()), nil, nil, &teams) |
||||||
|
return teams, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetTeam gets a team by ID
|
||||||
|
func (c *Client) GetTeam(id int64) (*Team, *Response, error) { |
||||||
|
t := new(Team) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/teams/%d", id), nil, nil, t) |
||||||
|
return t, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// CreateTeamOption options for creating a team
|
||||||
|
type CreateTeamOption struct { |
||||||
|
Name string `json:"name"` |
||||||
|
Description string `json:"description"` |
||||||
|
Permission AccessMode `json:"permission"` |
||||||
|
CanCreateOrgRepo bool `json:"can_create_org_repo"` |
||||||
|
IncludesAllRepositories bool `json:"includes_all_repositories"` |
||||||
|
// example: ["repo.code","repo.issues","repo.ext_issues","repo.wiki","repo.pulls","repo.releases","repo.ext_wiki"]
|
||||||
|
Units []string `json:"units"` |
||||||
|
} |
||||||
|
|
||||||
|
// Validate the CreateTeamOption struct
|
||||||
|
func (opt CreateTeamOption) Validate() error { |
||||||
|
if opt.Permission == AccessModeOwner { |
||||||
|
opt.Permission = AccessModeAdmin |
||||||
|
} else if opt.Permission != AccessModeRead && opt.Permission != AccessModeWrite && opt.Permission != AccessModeAdmin { |
||||||
|
return fmt.Errorf("permission mode invalid") |
||||||
|
} |
||||||
|
if len(opt.Name) == 0 { |
||||||
|
return fmt.Errorf("name required") |
||||||
|
} |
||||||
|
if len(opt.Name) > 30 { |
||||||
|
return fmt.Errorf("name to long") |
||||||
|
} |
||||||
|
if len(opt.Description) > 255 { |
||||||
|
return fmt.Errorf("description to long") |
||||||
|
} |
||||||
|
return nil |
||||||
|
} |
||||||
|
|
||||||
|
// CreateTeam creates a team for an organization
|
||||||
|
func (c *Client) CreateTeam(org string, opt CreateTeamOption) (*Team, *Response, error) { |
||||||
|
if err := opt.Validate(); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
t := new(Team) |
||||||
|
resp, err := c.getParsedResponse("POST", fmt.Sprintf("/orgs/%s/teams", org), jsonHeader, bytes.NewReader(body), t) |
||||||
|
return t, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// EditTeamOption options for editing a team
|
||||||
|
type EditTeamOption struct { |
||||||
|
Name string `json:"name"` |
||||||
|
Description *string `json:"description"` |
||||||
|
Permission AccessMode `json:"permission"` |
||||||
|
CanCreateOrgRepo *bool `json:"can_create_org_repo"` |
||||||
|
IncludesAllRepositories *bool `json:"includes_all_repositories"` |
||||||
|
// example: ["repo.code","repo.issues","repo.ext_issues","repo.wiki","repo.pulls","repo.releases","repo.ext_wiki"]
|
||||||
|
Units []string `json:"units"` |
||||||
|
} |
||||||
|
|
||||||
|
// Validate the EditTeamOption struct
|
||||||
|
func (opt EditTeamOption) Validate() error { |
||||||
|
if opt.Permission == AccessModeOwner { |
||||||
|
opt.Permission = AccessModeAdmin |
||||||
|
} else if opt.Permission != AccessModeRead && opt.Permission != AccessModeWrite && opt.Permission != AccessModeAdmin { |
||||||
|
return fmt.Errorf("permission mode invalid") |
||||||
|
} |
||||||
|
if len(opt.Name) == 0 { |
||||||
|
return fmt.Errorf("name required") |
||||||
|
} |
||||||
|
if len(opt.Name) > 30 { |
||||||
|
return fmt.Errorf("name to long") |
||||||
|
} |
||||||
|
if opt.Description != nil && len(*opt.Description) > 255 { |
||||||
|
return fmt.Errorf("description to long") |
||||||
|
} |
||||||
|
return nil |
||||||
|
} |
||||||
|
|
||||||
|
// EditTeam edits a team of an organization
|
||||||
|
func (c *Client) EditTeam(id int64, opt EditTeamOption) (*Response, error) { |
||||||
|
if err := opt.Validate(); err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
_, resp, err := c.getResponse("PATCH", fmt.Sprintf("/teams/%d", id), jsonHeader, bytes.NewReader(body)) |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// DeleteTeam deletes a team of an organization
|
||||||
|
func (c *Client) DeleteTeam(id int64) (*Response, error) { |
||||||
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/teams/%d", id), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// ListTeamMembersOptions options for listing team's members
|
||||||
|
type ListTeamMembersOptions struct { |
||||||
|
ListOptions |
||||||
|
} |
||||||
|
|
||||||
|
// ListTeamMembers lists all members of a team
|
||||||
|
func (c *Client) ListTeamMembers(id int64, opt ListTeamMembersOptions) ([]*User, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
members := make([]*User, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/teams/%d/members?%s", id, opt.getURLQuery().Encode()), nil, nil, &members) |
||||||
|
return members, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetTeamMember gets a member of a team
|
||||||
|
func (c *Client) GetTeamMember(id int64, user string) (*User, *Response, error) { |
||||||
|
m := new(User) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/teams/%d/members/%s", id, user), nil, nil, m) |
||||||
|
return m, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// AddTeamMember adds a member to a team
|
||||||
|
func (c *Client) AddTeamMember(id int64, user string) (*Response, error) { |
||||||
|
_, resp, err := c.getResponse("PUT", fmt.Sprintf("/teams/%d/members/%s", id, user), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// RemoveTeamMember removes a member from a team
|
||||||
|
func (c *Client) RemoveTeamMember(id int64, user string) (*Response, error) { |
||||||
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/teams/%d/members/%s", id, user), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// ListTeamRepositoriesOptions options for listing team's repositories
|
||||||
|
type ListTeamRepositoriesOptions struct { |
||||||
|
ListOptions |
||||||
|
} |
||||||
|
|
||||||
|
// ListTeamRepositories lists all repositories of a team
|
||||||
|
func (c *Client) ListTeamRepositories(id int64, opt ListTeamRepositoriesOptions) ([]*Repository, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
repos := make([]*Repository, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/teams/%d/repos?%s", id, opt.getURLQuery().Encode()), nil, nil, &repos) |
||||||
|
return repos, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// AddTeamRepository adds a repository to a team
|
||||||
|
func (c *Client) AddTeamRepository(id int64, org, repo string) (*Response, error) { |
||||||
|
_, resp, err := c.getResponse("PUT", fmt.Sprintf("/teams/%d/repos/%s/%s", id, org, repo), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// RemoveTeamRepository removes a repository from a team
|
||||||
|
func (c *Client) RemoveTeamRepository(id int64, org, repo string) (*Response, error) { |
||||||
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/teams/%d/repos/%s/%s", id, org, repo), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
@ -0,0 +1,253 @@ |
|||||||
|
// Copyright 2016 The Gogs Authors. All rights reserved.
|
||||||
|
// Copyright 2019 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
"net/url" |
||||||
|
"strings" |
||||||
|
"time" |
||||||
|
) |
||||||
|
|
||||||
|
// PRBranchInfo information about a branch
|
||||||
|
type PRBranchInfo struct { |
||||||
|
Name string `json:"label"` |
||||||
|
Ref string `json:"ref"` |
||||||
|
Sha string `json:"sha"` |
||||||
|
RepoID int64 `json:"repo_id"` |
||||||
|
Repository *Repository `json:"repo"` |
||||||
|
} |
||||||
|
|
||||||
|
// PullRequest represents a pull request
|
||||||
|
type PullRequest struct { |
||||||
|
ID int64 `json:"id"` |
||||||
|
URL string `json:"url"` |
||||||
|
Index int64 `json:"number"` |
||||||
|
Poster *User `json:"user"` |
||||||
|
Title string `json:"title"` |
||||||
|
Body string `json:"body"` |
||||||
|
Labels []*Label `json:"labels"` |
||||||
|
Milestone *Milestone `json:"milestone"` |
||||||
|
Assignee *User `json:"assignee"` |
||||||
|
Assignees []*User `json:"assignees"` |
||||||
|
State StateType `json:"state"` |
||||||
|
IsLocked bool `json:"is_locked"` |
||||||
|
Comments int `json:"comments"` |
||||||
|
|
||||||
|
HTMLURL string `json:"html_url"` |
||||||
|
DiffURL string `json:"diff_url"` |
||||||
|
PatchURL string `json:"patch_url"` |
||||||
|
|
||||||
|
Mergeable bool `json:"mergeable"` |
||||||
|
HasMerged bool `json:"merged"` |
||||||
|
Merged *time.Time `json:"merged_at"` |
||||||
|
MergedCommitID *string `json:"merge_commit_sha"` |
||||||
|
MergedBy *User `json:"merged_by"` |
||||||
|
|
||||||
|
Base *PRBranchInfo `json:"base"` |
||||||
|
Head *PRBranchInfo `json:"head"` |
||||||
|
MergeBase string `json:"merge_base"` |
||||||
|
|
||||||
|
Deadline *time.Time `json:"due_date"` |
||||||
|
Created *time.Time `json:"created_at"` |
||||||
|
Updated *time.Time `json:"updated_at"` |
||||||
|
Closed *time.Time `json:"closed_at"` |
||||||
|
} |
||||||
|
|
||||||
|
// ListPullRequestsOptions options for listing pull requests
|
||||||
|
type ListPullRequestsOptions struct { |
||||||
|
ListOptions |
||||||
|
State StateType `json:"state"` |
||||||
|
// oldest, recentupdate, leastupdate, mostcomment, leastcomment, priority
|
||||||
|
Sort string |
||||||
|
Milestone int64 |
||||||
|
} |
||||||
|
|
||||||
|
// MergeStyle is used specify how a pull is merged
|
||||||
|
type MergeStyle string |
||||||
|
|
||||||
|
const ( |
||||||
|
// MergeStyleMerge merge pull as usual
|
||||||
|
MergeStyleMerge MergeStyle = "merge" |
||||||
|
// MergeStyleRebase rebase pull
|
||||||
|
MergeStyleRebase MergeStyle = "rebase" |
||||||
|
// MergeStyleRebaseMerge rebase and merge pull
|
||||||
|
MergeStyleRebaseMerge MergeStyle = "rebase-merge" |
||||||
|
// MergeStyleSquash squash and merge pull
|
||||||
|
MergeStyleSquash MergeStyle = "squash" |
||||||
|
) |
||||||
|
|
||||||
|
// QueryEncode turns options into querystring argument
|
||||||
|
func (opt *ListPullRequestsOptions) QueryEncode() string { |
||||||
|
query := opt.getURLQuery() |
||||||
|
if len(opt.State) > 0 { |
||||||
|
query.Add("state", string(opt.State)) |
||||||
|
} |
||||||
|
if len(opt.Sort) > 0 { |
||||||
|
query.Add("sort", opt.Sort) |
||||||
|
} |
||||||
|
if opt.Milestone > 0 { |
||||||
|
query.Add("milestone", fmt.Sprintf("%d", opt.Milestone)) |
||||||
|
} |
||||||
|
return query.Encode() |
||||||
|
} |
||||||
|
|
||||||
|
// ListRepoPullRequests list PRs of one repository
|
||||||
|
func (c *Client) ListRepoPullRequests(owner, repo string, opt ListPullRequestsOptions) ([]*PullRequest, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
prs := make([]*PullRequest, 0, opt.PageSize) |
||||||
|
|
||||||
|
link, _ := url.Parse(fmt.Sprintf("/repos/%s/%s/pulls", owner, repo)) |
||||||
|
link.RawQuery = opt.QueryEncode() |
||||||
|
resp, err := c.getParsedResponse("GET", link.String(), jsonHeader, nil, &prs) |
||||||
|
return prs, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetPullRequest get information of one PR
|
||||||
|
func (c *Client) GetPullRequest(owner, repo string, index int64) (*PullRequest, *Response, error) { |
||||||
|
pr := new(PullRequest) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/pulls/%d", owner, repo, index), nil, nil, pr) |
||||||
|
return pr, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// CreatePullRequestOption options when creating a pull request
|
||||||
|
type CreatePullRequestOption struct { |
||||||
|
Head string `json:"head"` |
||||||
|
Base string `json:"base"` |
||||||
|
Title string `json:"title"` |
||||||
|
Body string `json:"body"` |
||||||
|
Assignee string `json:"assignee"` |
||||||
|
Assignees []string `json:"assignees"` |
||||||
|
Milestone int64 `json:"milestone"` |
||||||
|
Labels []int64 `json:"labels"` |
||||||
|
Deadline *time.Time `json:"due_date"` |
||||||
|
} |
||||||
|
|
||||||
|
// CreatePullRequest create pull request with options
|
||||||
|
func (c *Client) CreatePullRequest(owner, repo string, opt CreatePullRequestOption) (*PullRequest, *Response, error) { |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
pr := new(PullRequest) |
||||||
|
resp, err := c.getParsedResponse("POST", |
||||||
|
fmt.Sprintf("/repos/%s/%s/pulls", owner, repo), |
||||||
|
jsonHeader, bytes.NewReader(body), pr) |
||||||
|
return pr, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// EditPullRequestOption options when modify pull request
|
||||||
|
type EditPullRequestOption struct { |
||||||
|
Title string `json:"title"` |
||||||
|
Body string `json:"body"` |
||||||
|
Base string `json:"base"` |
||||||
|
Assignee string `json:"assignee"` |
||||||
|
Assignees []string `json:"assignees"` |
||||||
|
Milestone int64 `json:"milestone"` |
||||||
|
Labels []int64 `json:"labels"` |
||||||
|
State *StateType `json:"state"` |
||||||
|
Deadline *time.Time `json:"due_date"` |
||||||
|
} |
||||||
|
|
||||||
|
// Validate the EditPullRequestOption struct
|
||||||
|
func (opt EditPullRequestOption) Validate(c *Client) error { |
||||||
|
if len(opt.Title) != 0 && len(strings.TrimSpace(opt.Title)) == 0 { |
||||||
|
return fmt.Errorf("title is empty") |
||||||
|
} |
||||||
|
if len(opt.Base) != 0 { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil { |
||||||
|
return fmt.Errorf("can not change base gitea to old") |
||||||
|
} |
||||||
|
} |
||||||
|
return nil |
||||||
|
} |
||||||
|
|
||||||
|
// EditPullRequest modify pull request with PR id and options
|
||||||
|
func (c *Client) EditPullRequest(owner, repo string, index int64, opt EditPullRequestOption) (*PullRequest, *Response, error) { |
||||||
|
if err := opt.Validate(c); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
pr := new(PullRequest) |
||||||
|
resp, err := c.getParsedResponse("PATCH", |
||||||
|
fmt.Sprintf("/repos/%s/%s/pulls/%d", owner, repo, index), |
||||||
|
jsonHeader, bytes.NewReader(body), pr) |
||||||
|
return pr, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// MergePullRequestOption options when merging a pull request
|
||||||
|
type MergePullRequestOption struct { |
||||||
|
Style MergeStyle `json:"Do"` |
||||||
|
Title string `json:"MergeTitleField"` |
||||||
|
Message string `json:"MergeMessageField"` |
||||||
|
} |
||||||
|
|
||||||
|
// Validate the MergePullRequestOption struct
|
||||||
|
func (opt MergePullRequestOption) Validate(c *Client) error { |
||||||
|
if opt.Style == MergeStyleSquash { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.11.5"); err != nil { |
||||||
|
return err |
||||||
|
} |
||||||
|
} |
||||||
|
return nil |
||||||
|
} |
||||||
|
|
||||||
|
// MergePullRequest merge a PR to repository by PR id
|
||||||
|
func (c *Client) MergePullRequest(owner, repo string, index int64, opt MergePullRequestOption) (bool, *Response, error) { |
||||||
|
if err := opt.Validate(c); err != nil { |
||||||
|
return false, nil, err |
||||||
|
} |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return false, nil, err |
||||||
|
} |
||||||
|
status, resp, err := c.getStatusCode("POST", fmt.Sprintf("/repos/%s/%s/pulls/%d/merge", owner, repo, index), jsonHeader, bytes.NewReader(body)) |
||||||
|
if err != nil { |
||||||
|
return false, resp, err |
||||||
|
} |
||||||
|
return status == 200, resp, nil |
||||||
|
} |
||||||
|
|
||||||
|
// IsPullRequestMerged test if one PR is merged to one repository
|
||||||
|
func (c *Client) IsPullRequestMerged(owner, repo string, index int64) (bool, *Response, error) { |
||||||
|
status, resp, err := c.getStatusCode("GET", fmt.Sprintf("/repos/%s/%s/pulls/%d/merge", owner, repo, index), nil, nil) |
||||||
|
|
||||||
|
if err != nil { |
||||||
|
return false, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
return status == 204, resp, nil |
||||||
|
} |
||||||
|
|
||||||
|
// getPullRequestDiffOrPatch gets the patch or diff file as bytes for a PR
|
||||||
|
func (c *Client) getPullRequestDiffOrPatch(owner, repo, kind string, index int64) ([]byte, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.13.0"); err != nil { |
||||||
|
r, _, err2 := c.GetRepo(owner, repo) |
||||||
|
if err2 != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
if r.Private { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
return c.getWebResponse("GET", fmt.Sprintf("/%s/%s/pulls/%d.%s", owner, repo, index, kind), nil) |
||||||
|
} |
||||||
|
return c.getResponse("GET", fmt.Sprintf("/repos/%s/%s/pulls/%d.%s", owner, repo, index, kind), nil, nil) |
||||||
|
} |
||||||
|
|
||||||
|
// GetPullRequestPatch gets the .patch file as bytes for a PR
|
||||||
|
func (c *Client) GetPullRequestPatch(owner, repo string, index int64) ([]byte, *Response, error) { |
||||||
|
return c.getPullRequestDiffOrPatch(owner, repo, "patch", index) |
||||||
|
} |
||||||
|
|
||||||
|
// GetPullRequestDiff gets the .diff file as bytes for a PR
|
||||||
|
func (c *Client) GetPullRequestDiff(owner, repo string, index int64) ([]byte, *Response, error) { |
||||||
|
return c.getPullRequestDiffOrPatch(owner, repo, "diff", index) |
||||||
|
} |
||||||
@ -0,0 +1,219 @@ |
|||||||
|
// Copyright 2020 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
"net/url" |
||||||
|
"strings" |
||||||
|
"time" |
||||||
|
) |
||||||
|
|
||||||
|
// ReviewStateType review state type
|
||||||
|
type ReviewStateType string |
||||||
|
|
||||||
|
const ( |
||||||
|
// ReviewStateApproved pr is approved
|
||||||
|
ReviewStateApproved ReviewStateType = "APPROVED" |
||||||
|
// ReviewStatePending pr state is pending
|
||||||
|
ReviewStatePending ReviewStateType = "PENDING" |
||||||
|
// ReviewStateComment is a comment review
|
||||||
|
ReviewStateComment ReviewStateType = "COMMENT" |
||||||
|
// ReviewStateRequestChanges changes for pr are requested
|
||||||
|
ReviewStateRequestChanges ReviewStateType = "REQUEST_CHANGES" |
||||||
|
// ReviewStateRequestReview review is requested from user
|
||||||
|
ReviewStateRequestReview ReviewStateType = "REQUEST_REVIEW" |
||||||
|
// ReviewStateUnknown state of pr is unknown
|
||||||
|
ReviewStateUnknown ReviewStateType = "" |
||||||
|
) |
||||||
|
|
||||||
|
// PullReview represents a pull request review
|
||||||
|
type PullReview struct { |
||||||
|
ID int64 `json:"id"` |
||||||
|
Reviewer *User `json:"user"` |
||||||
|
State ReviewStateType `json:"state"` |
||||||
|
Body string `json:"body"` |
||||||
|
CommitID string `json:"commit_id"` |
||||||
|
Stale bool `json:"stale"` |
||||||
|
Official bool `json:"official"` |
||||||
|
CodeCommentsCount int `json:"comments_count"` |
||||||
|
Submitted time.Time `json:"submitted_at"` |
||||||
|
|
||||||
|
HTMLURL string `json:"html_url"` |
||||||
|
HTMLPullURL string `json:"pull_request_url"` |
||||||
|
} |
||||||
|
|
||||||
|
// PullReviewComment represents a comment on a pull request review
|
||||||
|
type PullReviewComment struct { |
||||||
|
ID int64 `json:"id"` |
||||||
|
Body string `json:"body"` |
||||||
|
Reviewer *User `json:"user"` |
||||||
|
ReviewID int64 `json:"pull_request_review_id"` |
||||||
|
|
||||||
|
Created time.Time `json:"created_at"` |
||||||
|
Updated time.Time `json:"updated_at"` |
||||||
|
|
||||||
|
Path string `json:"path"` |
||||||
|
CommitID string `json:"commit_id"` |
||||||
|
OrigCommitID string `json:"original_commit_id"` |
||||||
|
DiffHunk string `json:"diff_hunk"` |
||||||
|
LineNum uint64 `json:"position"` |
||||||
|
OldLineNum uint64 `json:"original_position"` |
||||||
|
|
||||||
|
HTMLURL string `json:"html_url"` |
||||||
|
HTMLPullURL string `json:"pull_request_url"` |
||||||
|
} |
||||||
|
|
||||||
|
// CreatePullReviewOptions are options to create a pull review
|
||||||
|
type CreatePullReviewOptions struct { |
||||||
|
State ReviewStateType `json:"event"` |
||||||
|
Body string `json:"body"` |
||||||
|
CommitID string `json:"commit_id"` |
||||||
|
Comments []CreatePullReviewComment `json:"comments"` |
||||||
|
} |
||||||
|
|
||||||
|
// CreatePullReviewComment represent a review comment for creation api
|
||||||
|
type CreatePullReviewComment struct { |
||||||
|
// the tree path
|
||||||
|
Path string `json:"path"` |
||||||
|
Body string `json:"body"` |
||||||
|
// if comment to old file line or 0
|
||||||
|
OldLineNum int64 `json:"old_position"` |
||||||
|
// if comment to new file line or 0
|
||||||
|
NewLineNum int64 `json:"new_position"` |
||||||
|
} |
||||||
|
|
||||||
|
// SubmitPullReviewOptions are options to submit a pending pull review
|
||||||
|
type SubmitPullReviewOptions struct { |
||||||
|
State ReviewStateType `json:"event"` |
||||||
|
Body string `json:"body"` |
||||||
|
} |
||||||
|
|
||||||
|
// ListPullReviewsOptions options for listing PullReviews
|
||||||
|
type ListPullReviewsOptions struct { |
||||||
|
ListOptions |
||||||
|
} |
||||||
|
|
||||||
|
// Validate the CreatePullReviewOptions struct
|
||||||
|
func (opt CreatePullReviewOptions) Validate() error { |
||||||
|
if opt.State != ReviewStateApproved && len(strings.TrimSpace(opt.Body)) == 0 { |
||||||
|
return fmt.Errorf("body is empty") |
||||||
|
} |
||||||
|
for i := range opt.Comments { |
||||||
|
if err := opt.Comments[i].Validate(); err != nil { |
||||||
|
return err |
||||||
|
} |
||||||
|
} |
||||||
|
return nil |
||||||
|
} |
||||||
|
|
||||||
|
// Validate the SubmitPullReviewOptions struct
|
||||||
|
func (opt SubmitPullReviewOptions) Validate() error { |
||||||
|
if opt.State != ReviewStateApproved && len(strings.TrimSpace(opt.Body)) == 0 { |
||||||
|
return fmt.Errorf("body is empty") |
||||||
|
} |
||||||
|
return nil |
||||||
|
} |
||||||
|
|
||||||
|
// Validate the CreatePullReviewComment struct
|
||||||
|
func (opt CreatePullReviewComment) Validate() error { |
||||||
|
if len(strings.TrimSpace(opt.Body)) == 0 { |
||||||
|
return fmt.Errorf("body is empty") |
||||||
|
} |
||||||
|
if opt.NewLineNum != 0 && opt.OldLineNum != 0 { |
||||||
|
return fmt.Errorf("old and new line num are set, cant identify the code comment position") |
||||||
|
} |
||||||
|
return nil |
||||||
|
} |
||||||
|
|
||||||
|
// ListPullReviews lists all reviews of a pull request
|
||||||
|
func (c *Client) ListPullReviews(owner, repo string, index int64, opt ListPullReviewsOptions) ([]*PullReview, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
opt.setDefaults() |
||||||
|
rs := make([]*PullReview, 0, opt.PageSize) |
||||||
|
|
||||||
|
link, _ := url.Parse(fmt.Sprintf("/repos/%s/%s/pulls/%d/reviews", owner, repo, index)) |
||||||
|
link.RawQuery = opt.ListOptions.getURLQuery().Encode() |
||||||
|
|
||||||
|
resp, err := c.getParsedResponse("GET", link.String(), jsonHeader, nil, &rs) |
||||||
|
return rs, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetPullReview gets a specific review of a pull request
|
||||||
|
func (c *Client) GetPullReview(owner, repo string, index, id int64) (*PullReview, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
|
||||||
|
r := new(PullReview) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/pulls/%d/reviews/%d", owner, repo, index, id), jsonHeader, nil, &r) |
||||||
|
return r, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// ListPullReviewComments lists all comments of a pull request review
|
||||||
|
func (c *Client) ListPullReviewComments(owner, repo string, index, id int64) ([]*PullReviewComment, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
rcl := make([]*PullReviewComment, 0, 4) |
||||||
|
link, _ := url.Parse(fmt.Sprintf("/repos/%s/%s/pulls/%d/reviews/%d/comments", owner, repo, index, id)) |
||||||
|
|
||||||
|
resp, err := c.getParsedResponse("GET", link.String(), jsonHeader, nil, &rcl) |
||||||
|
return rcl, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// DeletePullReview delete a specific review from a pull request
|
||||||
|
func (c *Client) DeletePullReview(owner, repo string, index, id int64) (*Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
|
||||||
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/repos/%s/%s/pulls/%d/reviews/%d", owner, repo, index, id), jsonHeader, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// CreatePullReview create a review to an pull request
|
||||||
|
func (c *Client) CreatePullReview(owner, repo string, index int64, opt CreatePullReviewOptions) (*PullReview, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
if err := opt.Validate(); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
|
||||||
|
r := new(PullReview) |
||||||
|
resp, err := c.getParsedResponse("POST", |
||||||
|
fmt.Sprintf("/repos/%s/%s/pulls/%d/reviews", owner, repo, index), |
||||||
|
jsonHeader, bytes.NewReader(body), r) |
||||||
|
return r, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// SubmitPullReview submit a pending review to an pull request
|
||||||
|
func (c *Client) SubmitPullReview(owner, repo string, index, id int64, opt SubmitPullReviewOptions) (*PullReview, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
if err := opt.Validate(); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
|
||||||
|
r := new(PullReview) |
||||||
|
resp, err := c.getParsedResponse("POST", |
||||||
|
fmt.Sprintf("/repos/%s/%s/pulls/%d/reviews/%d", owner, repo, index, id), |
||||||
|
jsonHeader, bytes.NewReader(body), r) |
||||||
|
return r, resp, err |
||||||
|
} |
||||||
@ -0,0 +1,153 @@ |
|||||||
|
// Copyright 2016 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
"net/http" |
||||||
|
"strings" |
||||||
|
"time" |
||||||
|
) |
||||||
|
|
||||||
|
// Release represents a repository release
|
||||||
|
type Release struct { |
||||||
|
ID int64 `json:"id"` |
||||||
|
TagName string `json:"tag_name"` |
||||||
|
Target string `json:"target_commitish"` |
||||||
|
Title string `json:"name"` |
||||||
|
Note string `json:"body"` |
||||||
|
URL string `json:"url"` |
||||||
|
TarURL string `json:"tarball_url"` |
||||||
|
ZipURL string `json:"zipball_url"` |
||||||
|
IsDraft bool `json:"draft"` |
||||||
|
IsPrerelease bool `json:"prerelease"` |
||||||
|
CreatedAt time.Time `json:"created_at"` |
||||||
|
PublishedAt time.Time `json:"published_at"` |
||||||
|
Publisher *User `json:"author"` |
||||||
|
Attachments []*Attachment `json:"assets"` |
||||||
|
} |
||||||
|
|
||||||
|
// ListReleasesOptions options for listing repository's releases
|
||||||
|
type ListReleasesOptions struct { |
||||||
|
ListOptions |
||||||
|
} |
||||||
|
|
||||||
|
// ListReleases list releases of a repository
|
||||||
|
func (c *Client) ListReleases(user, repo string, opt ListReleasesOptions) ([]*Release, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
releases := make([]*Release, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", |
||||||
|
fmt.Sprintf("/repos/%s/%s/releases?%s", user, repo, opt.getURLQuery().Encode()), |
||||||
|
nil, nil, &releases) |
||||||
|
return releases, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetRelease get a release of a repository by id
|
||||||
|
func (c *Client) GetRelease(user, repo string, id int64) (*Release, *Response, error) { |
||||||
|
r := new(Release) |
||||||
|
resp, err := c.getParsedResponse("GET", |
||||||
|
fmt.Sprintf("/repos/%s/%s/releases/%d", user, repo, id), |
||||||
|
jsonHeader, nil, &r) |
||||||
|
return r, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetReleaseByTag get a release of a repository by tag
|
||||||
|
func (c *Client) GetReleaseByTag(user, repo string, tag string) (*Release, *Response, error) { |
||||||
|
if c.CheckServerVersionConstraint(">=1.13.0") != nil { |
||||||
|
return c.fallbackGetReleaseByTag(user, repo, tag) |
||||||
|
} |
||||||
|
r := new(Release) |
||||||
|
resp, err := c.getParsedResponse("GET", |
||||||
|
fmt.Sprintf("/repos/%s/%s/releases/tags/%s", user, repo, tag), |
||||||
|
nil, nil, &r) |
||||||
|
return r, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// CreateReleaseOption options when creating a release
|
||||||
|
type CreateReleaseOption struct { |
||||||
|
TagName string `json:"tag_name"` |
||||||
|
Target string `json:"target_commitish"` |
||||||
|
Title string `json:"name"` |
||||||
|
Note string `json:"body"` |
||||||
|
IsDraft bool `json:"draft"` |
||||||
|
IsPrerelease bool `json:"prerelease"` |
||||||
|
} |
||||||
|
|
||||||
|
// Validate the CreateReleaseOption struct
|
||||||
|
func (opt CreateReleaseOption) Validate() error { |
||||||
|
if len(strings.TrimSpace(opt.Title)) == 0 { |
||||||
|
return fmt.Errorf("title is empty") |
||||||
|
} |
||||||
|
return nil |
||||||
|
} |
||||||
|
|
||||||
|
// CreateRelease create a release
|
||||||
|
func (c *Client) CreateRelease(user, repo string, opt CreateReleaseOption) (*Release, *Response, error) { |
||||||
|
if err := opt.Validate(); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
body, err := json.Marshal(opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
r := new(Release) |
||||||
|
resp, err := c.getParsedResponse("POST", |
||||||
|
fmt.Sprintf("/repos/%s/%s/releases", user, repo), |
||||||
|
jsonHeader, bytes.NewReader(body), r) |
||||||
|
return r, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// EditReleaseOption options when editing a release
|
||||||
|
type EditReleaseOption struct { |
||||||
|
TagName string `json:"tag_name"` |
||||||
|
Target string `json:"target_commitish"` |
||||||
|
Title string `json:"name"` |
||||||
|
Note string `json:"body"` |
||||||
|
IsDraft *bool `json:"draft"` |
||||||
|
IsPrerelease *bool `json:"prerelease"` |
||||||
|
} |
||||||
|
|
||||||
|
// EditRelease edit a release
|
||||||
|
func (c *Client) EditRelease(user, repo string, id int64, form EditReleaseOption) (*Release, *Response, error) { |
||||||
|
body, err := json.Marshal(form) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
r := new(Release) |
||||||
|
resp, err := c.getParsedResponse("PATCH", |
||||||
|
fmt.Sprintf("/repos/%s/%s/releases/%d", user, repo, id), |
||||||
|
jsonHeader, bytes.NewReader(body), r) |
||||||
|
return r, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// DeleteRelease delete a release from a repository
|
||||||
|
func (c *Client) DeleteRelease(user, repo string, id int64) (*Response, error) { |
||||||
|
_, resp, err := c.getResponse("DELETE", |
||||||
|
fmt.Sprintf("/repos/%s/%s/releases/%d", user, repo, id), |
||||||
|
nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// fallbackGetReleaseByTag is fallback for old gitea installations ( < 1.13.0 )
|
||||||
|
func (c *Client) fallbackGetReleaseByTag(user, repo string, tag string) (*Release, *Response, error) { |
||||||
|
for i := 1; ; i++ { |
||||||
|
rl, resp, err := c.ListReleases(user, repo, ListReleasesOptions{ListOptions{Page: i}}) |
||||||
|
if err != nil { |
||||||
|
return nil, resp, err |
||||||
|
} |
||||||
|
if len(rl) == 0 { |
||||||
|
return nil, |
||||||
|
&Response{&http.Response{StatusCode: 404}}, |
||||||
|
fmt.Errorf("release with tag '%s' not found", tag) |
||||||
|
} |
||||||
|
for _, r := range rl { |
||||||
|
if r.TagName == tag { |
||||||
|
return r, resp, nil |
||||||
|
} |
||||||
|
} |
||||||
|
} |
||||||
|
} |
||||||
@ -0,0 +1,390 @@ |
|||||||
|
// Copyright 2014 The Gogs Authors. All rights reserved.
|
||||||
|
// Copyright 2020 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
"net/url" |
||||||
|
"strings" |
||||||
|
"time" |
||||||
|
) |
||||||
|
|
||||||
|
// Permission represents a set of permissions
|
||||||
|
type Permission struct { |
||||||
|
Admin bool `json:"admin"` |
||||||
|
Push bool `json:"push"` |
||||||
|
Pull bool `json:"pull"` |
||||||
|
} |
||||||
|
|
||||||
|
// Repository represents a repository
|
||||||
|
type Repository struct { |
||||||
|
ID int64 `json:"id"` |
||||||
|
Owner *User `json:"owner"` |
||||||
|
Name string `json:"name"` |
||||||
|
FullName string `json:"full_name"` |
||||||
|
Description string `json:"description"` |
||||||
|
Empty bool `json:"empty"` |
||||||
|
Private bool `json:"private"` |
||||||
|
Fork bool `json:"fork"` |
||||||
|
Parent *Repository `json:"parent"` |
||||||
|
Mirror bool `json:"mirror"` |
||||||
|
Size int `json:"size"` |
||||||
|
HTMLURL string `json:"html_url"` |
||||||
|
SSHURL string `json:"ssh_url"` |
||||||
|
CloneURL string `json:"clone_url"` |
||||||
|
OriginalURL string `json:"original_url"` |
||||||
|
Website string `json:"website"` |
||||||
|
Stars int `json:"stars_count"` |
||||||
|
Forks int `json:"forks_count"` |
||||||
|
Watchers int `json:"watchers_count"` |
||||||
|
OpenIssues int `json:"open_issues_count"` |
||||||
|
DefaultBranch string `json:"default_branch"` |
||||||
|
Archived bool `json:"archived"` |
||||||
|
Created time.Time `json:"created_at"` |
||||||
|
Updated time.Time `json:"updated_at"` |
||||||
|
Permissions *Permission `json:"permissions,omitempty"` |
||||||
|
HasIssues bool `json:"has_issues"` |
||||||
|
HasWiki bool `json:"has_wiki"` |
||||||
|
HasPullRequests bool `json:"has_pull_requests"` |
||||||
|
IgnoreWhitespaceConflicts bool `json:"ignore_whitespace_conflicts"` |
||||||
|
AllowMerge bool `json:"allow_merge_commits"` |
||||||
|
AllowRebase bool `json:"allow_rebase"` |
||||||
|
AllowRebaseMerge bool `json:"allow_rebase_explicit"` |
||||||
|
AllowSquash bool `json:"allow_squash_merge"` |
||||||
|
AvatarURL string `json:"avatar_url"` |
||||||
|
} |
||||||
|
|
||||||
|
// RepoType represent repo type
|
||||||
|
type RepoType string |
||||||
|
|
||||||
|
const ( |
||||||
|
// RepoTypeNone dont specify a type
|
||||||
|
RepoTypeNone RepoType = "" |
||||||
|
// RepoTypeSource is the default repo type
|
||||||
|
RepoTypeSource RepoType = "source" |
||||||
|
// RepoTypeFork is a repo witch was forked from an other one
|
||||||
|
RepoTypeFork RepoType = "fork" |
||||||
|
// RepoTypeMirror represents an mirror repo
|
||||||
|
RepoTypeMirror RepoType = "mirror" |
||||||
|
) |
||||||
|
|
||||||
|
// ListReposOptions options for listing repositories
|
||||||
|
type ListReposOptions struct { |
||||||
|
ListOptions |
||||||
|
} |
||||||
|
|
||||||
|
// ListMyRepos lists all repositories for the authenticated user that has access to.
|
||||||
|
func (c *Client) ListMyRepos(opt ListReposOptions) ([]*Repository, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
repos := make([]*Repository, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/user/repos?%s", opt.getURLQuery().Encode()), nil, nil, &repos) |
||||||
|
return repos, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// ListUserRepos list all repositories of one user by user's name
|
||||||
|
func (c *Client) ListUserRepos(user string, opt ListReposOptions) ([]*Repository, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
repos := make([]*Repository, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/users/%s/repos?%s", user, opt.getURLQuery().Encode()), nil, nil, &repos) |
||||||
|
return repos, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// ListOrgReposOptions options for a organization's repositories
|
||||||
|
type ListOrgReposOptions struct { |
||||||
|
ListOptions |
||||||
|
} |
||||||
|
|
||||||
|
// ListOrgRepos list all repositories of one organization by organization's name
|
||||||
|
func (c *Client) ListOrgRepos(org string, opt ListOrgReposOptions) ([]*Repository, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
repos := make([]*Repository, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/orgs/%s/repos?%s", org, opt.getURLQuery().Encode()), nil, nil, &repos) |
||||||
|
return repos, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// SearchRepoOptions options for searching repositories
|
||||||
|
type SearchRepoOptions struct { |
||||||
|
ListOptions |
||||||
|
|
||||||
|
// The keyword to query
|
||||||
|
Keyword string |
||||||
|
// Limit search to repositories with keyword as topic
|
||||||
|
KeywordIsTopic bool |
||||||
|
// Include search of keyword within repository description
|
||||||
|
KeywordInDescription bool |
||||||
|
|
||||||
|
/* |
||||||
|
User Filter |
||||||
|
*/ |
||||||
|
|
||||||
|
// Repo Owner
|
||||||
|
OwnerID int64 |
||||||
|
// Stared By UserID
|
||||||
|
StarredByUserID int64 |
||||||
|
|
||||||
|
/* |
||||||
|
Repo Attributes |
||||||
|
*/ |
||||||
|
|
||||||
|
// pubic, private or all repositories (defaults to all)
|
||||||
|
IsPrivate *bool |
||||||
|
// archived, non-archived or all repositories (defaults to all)
|
||||||
|
IsArchived *bool |
||||||
|
// Exclude template repos from search
|
||||||
|
ExcludeTemplate bool |
||||||
|
// Filter by "fork", "source", "mirror"
|
||||||
|
Type RepoType |
||||||
|
|
||||||
|
/* |
||||||
|
Sort Filters |
||||||
|
*/ |
||||||
|
|
||||||
|
// sort repos by attribute. Supported values are "alpha", "created", "updated", "size", and "id". Default is "alpha"
|
||||||
|
Sort string |
||||||
|
// sort order, either "asc" (ascending) or "desc" (descending). Default is "asc", ignored if "sort" is not specified.
|
||||||
|
Order string |
||||||
|
// Repo owner to prioritize in the results
|
||||||
|
PrioritizedByOwnerID int64 |
||||||
|
|
||||||
|
/* |
||||||
|
Cover EdgeCases |
||||||
|
*/ |
||||||
|
// if set all other options are ignored and this string is used as query
|
||||||
|
RawQuery string |
||||||
|
} |
||||||
|
|
||||||
|
// QueryEncode turns options into querystring argument
|
||||||
|
func (opt *SearchRepoOptions) QueryEncode() string { |
||||||
|
query := opt.getURLQuery() |
||||||
|
if opt.Keyword != "" { |
||||||
|
query.Add("q", opt.Keyword) |
||||||
|
} |
||||||
|
if opt.KeywordIsTopic { |
||||||
|
query.Add("topic", "true") |
||||||
|
} |
||||||
|
if opt.KeywordInDescription { |
||||||
|
query.Add("includeDesc", "true") |
||||||
|
} |
||||||
|
|
||||||
|
// User Filter
|
||||||
|
if opt.OwnerID > 0 { |
||||||
|
query.Add("uid", fmt.Sprintf("%d", opt.OwnerID)) |
||||||
|
query.Add("exclusive", "true") |
||||||
|
} |
||||||
|
if opt.StarredByUserID > 0 { |
||||||
|
query.Add("starredBy", fmt.Sprintf("%d", opt.StarredByUserID)) |
||||||
|
} |
||||||
|
|
||||||
|
// Repo Attributes
|
||||||
|
if opt.IsPrivate != nil { |
||||||
|
query.Add("is_private", fmt.Sprintf("%v", opt.IsPrivate)) |
||||||
|
} |
||||||
|
if opt.IsArchived != nil { |
||||||
|
query.Add("archived", fmt.Sprintf("%v", opt.IsArchived)) |
||||||
|
} |
||||||
|
if opt.ExcludeTemplate { |
||||||
|
query.Add("template", "false") |
||||||
|
} |
||||||
|
if len(opt.Type) != 0 { |
||||||
|
query.Add("mode", string(opt.Type)) |
||||||
|
} |
||||||
|
|
||||||
|
// Sort Filters
|
||||||
|
if opt.Sort != "" { |
||||||
|
query.Add("sort", opt.Sort) |
||||||
|
} |
||||||
|
if opt.PrioritizedByOwnerID > 0 { |
||||||
|
query.Add("priority_owner_id", fmt.Sprintf("%d", opt.PrioritizedByOwnerID)) |
||||||
|
} |
||||||
|
if opt.Order != "" { |
||||||
|
query.Add("order", opt.Order) |
||||||
|
} |
||||||
|
|
||||||
|
return query.Encode() |
||||||
|
} |
||||||
|
|
||||||
|
type searchRepoResponse struct { |
||||||
|
Repos []*Repository `json:"data"` |
||||||
|
} |
||||||
|
|
||||||
|
// SearchRepos searches for repositories matching the given filters
|
||||||
|
func (c *Client) SearchRepos(opt SearchRepoOptions) ([]*Repository, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
repos := new(searchRepoResponse) |
||||||
|
|
||||||
|
link, _ := url.Parse("/repos/search") |
||||||
|
|
||||||
|
if len(opt.RawQuery) != 0 { |
||||||
|
link.RawQuery = opt.RawQuery |
||||||
|
} else { |
||||||
|
link.RawQuery = opt.QueryEncode() |
||||||
|
// IsPrivate only works on gitea >= 1.12.0
|
||||||
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil && opt.IsPrivate != nil { |
||||||
|
if *opt.IsPrivate { |
||||||
|
// private repos only not supported on gitea <= 1.11.x
|
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
link.Query().Add("private", "false") |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
resp, err := c.getParsedResponse("GET", link.String(), nil, nil, &repos) |
||||||
|
return repos.Repos, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// CreateRepoOption options when creating repository
|
||||||
|
type CreateRepoOption struct { |
||||||
|
// Name of the repository to create
|
||||||
|
Name string `json:"name"` |
||||||
|
// Description of the repository to create
|
||||||
|
Description string `json:"description"` |
||||||
|
// Whether the repository is private
|
||||||
|
Private bool `json:"private"` |
||||||
|
// Issue Label set to use
|
||||||
|
IssueLabels string `json:"issue_labels"` |
||||||
|
// Whether the repository should be auto-intialized?
|
||||||
|
AutoInit bool `json:"auto_init"` |
||||||
|
// Gitignores to use
|
||||||
|
Gitignores string `json:"gitignores"` |
||||||
|
// License to use
|
||||||
|
License string `json:"license"` |
||||||
|
// Readme of the repository to create
|
||||||
|
Readme string `json:"readme"` |
||||||
|
// DefaultBranch of the repository (used when initializes and in template)
|
||||||
|
DefaultBranch string `json:"default_branch"` |
||||||
|
} |
||||||
|
|
||||||
|
// Validate the CreateRepoOption struct
|
||||||
|
func (opt CreateRepoOption) Validate() error { |
||||||
|
if len(strings.TrimSpace(opt.Name)) == 0 { |
||||||
|
return fmt.Errorf("name is empty") |
||||||
|
} |
||||||
|
return nil |
||||||
|
} |
||||||
|
|
||||||
|
// CreateRepo creates a repository for authenticated user.
|
||||||
|
func (c *Client) CreateRepo(opt CreateRepoOption) (*Repository, *Response, error) { |
||||||
|
if err := opt.Validate(); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
repo := new(Repository) |
||||||
|
resp, err := c.getParsedResponse("POST", "/user/repos", jsonHeader, bytes.NewReader(body), repo) |
||||||
|
return repo, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// CreateOrgRepo creates an organization repository for authenticated user.
|
||||||
|
func (c *Client) CreateOrgRepo(org string, opt CreateRepoOption) (*Repository, *Response, error) { |
||||||
|
if err := opt.Validate(); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
repo := new(Repository) |
||||||
|
resp, err := c.getParsedResponse("POST", fmt.Sprintf("/org/%s/repos", org), jsonHeader, bytes.NewReader(body), repo) |
||||||
|
return repo, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetRepo returns information of a repository of given owner.
|
||||||
|
func (c *Client) GetRepo(owner, reponame string) (*Repository, *Response, error) { |
||||||
|
repo := new(Repository) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s", owner, reponame), nil, nil, repo) |
||||||
|
return repo, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// EditRepoOption options when editing a repository's properties
|
||||||
|
type EditRepoOption struct { |
||||||
|
// name of the repository
|
||||||
|
Name *string `json:"name,omitempty"` |
||||||
|
// a short description of the repository.
|
||||||
|
Description *string `json:"description,omitempty"` |
||||||
|
// a URL with more information about the repository.
|
||||||
|
Website *string `json:"website,omitempty"` |
||||||
|
// either `true` to make the repository private or `false` to make it public.
|
||||||
|
// Note: you will get a 422 error if the organization restricts changing repository visibility to organization
|
||||||
|
// owners and a non-owner tries to change the value of private.
|
||||||
|
Private *bool `json:"private,omitempty"` |
||||||
|
// either `true` to enable issues for this repository or `false` to disable them.
|
||||||
|
HasIssues *bool `json:"has_issues,omitempty"` |
||||||
|
// either `true` to enable the wiki for this repository or `false` to disable it.
|
||||||
|
HasWiki *bool `json:"has_wiki,omitempty"` |
||||||
|
// sets the default branch for this repository.
|
||||||
|
DefaultBranch *string `json:"default_branch,omitempty"` |
||||||
|
// either `true` to allow pull requests, or `false` to prevent pull request.
|
||||||
|
HasPullRequests *bool `json:"has_pull_requests,omitempty"` |
||||||
|
// either `true` to ignore whitespace for conflicts, or `false` to not ignore whitespace. `has_pull_requests` must be `true`.
|
||||||
|
IgnoreWhitespaceConflicts *bool `json:"ignore_whitespace_conflicts,omitempty"` |
||||||
|
// either `true` to allow merging pull requests with a merge commit, or `false` to prevent merging pull requests with merge commits. `has_pull_requests` must be `true`.
|
||||||
|
AllowMerge *bool `json:"allow_merge_commits,omitempty"` |
||||||
|
// either `true` to allow rebase-merging pull requests, or `false` to prevent rebase-merging. `has_pull_requests` must be `true`.
|
||||||
|
AllowRebase *bool `json:"allow_rebase,omitempty"` |
||||||
|
// either `true` to allow rebase with explicit merge commits (--no-ff), or `false` to prevent rebase with explicit merge commits. `has_pull_requests` must be `true`.
|
||||||
|
AllowRebaseMerge *bool `json:"allow_rebase_explicit,omitempty"` |
||||||
|
// either `true` to allow squash-merging pull requests, or `false` to prevent squash-merging. `has_pull_requests` must be `true`.
|
||||||
|
AllowSquash *bool `json:"allow_squash_merge,omitempty"` |
||||||
|
// set to `true` to archive this repository.
|
||||||
|
Archived *bool `json:"archived,omitempty"` |
||||||
|
} |
||||||
|
|
||||||
|
// EditRepo edit the properties of a repository
|
||||||
|
func (c *Client) EditRepo(owner, reponame string, opt EditRepoOption) (*Repository, *Response, error) { |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
repo := new(Repository) |
||||||
|
resp, err := c.getParsedResponse("PATCH", fmt.Sprintf("/repos/%s/%s", owner, reponame), jsonHeader, bytes.NewReader(body), repo) |
||||||
|
return repo, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// DeleteRepo deletes a repository of user or organization.
|
||||||
|
func (c *Client) DeleteRepo(owner, repo string) (*Response, error) { |
||||||
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/repos/%s/%s", owner, repo), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// MirrorSync adds a mirrored repository to the mirror sync queue.
|
||||||
|
func (c *Client) MirrorSync(owner, repo string) (*Response, error) { |
||||||
|
_, resp, err := c.getResponse("POST", fmt.Sprintf("/repos/%s/%s/mirror-sync", owner, repo), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetRepoLanguages return language stats of a repo
|
||||||
|
func (c *Client) GetRepoLanguages(owner, repo string) (map[string]int64, *Response, error) { |
||||||
|
langMap := make(map[string]int64) |
||||||
|
|
||||||
|
data, resp, err := c.getResponse("GET", fmt.Sprintf("/repos/%s/%s/languages", owner, repo), jsonHeader, nil) |
||||||
|
if err != nil { |
||||||
|
return nil, resp, err |
||||||
|
} |
||||||
|
if err = json.Unmarshal(data, &langMap); err != nil { |
||||||
|
return nil, resp, err |
||||||
|
} |
||||||
|
return langMap, resp, nil |
||||||
|
} |
||||||
|
|
||||||
|
// ArchiveType represent supported archive formats by gitea
|
||||||
|
type ArchiveType string |
||||||
|
|
||||||
|
const ( |
||||||
|
// ZipArchive represent zip format
|
||||||
|
ZipArchive ArchiveType = ".zip" |
||||||
|
// TarGZArchive represent tar.gz format
|
||||||
|
TarGZArchive ArchiveType = ".tar.gz" |
||||||
|
) |
||||||
|
|
||||||
|
// GetArchive get an archive of a repository by git reference
|
||||||
|
// e.g.: ref -> master, 70b7c74b33, v1.2.1, ...
|
||||||
|
func (c *Client) GetArchive(owner, repo, ref string, ext ArchiveType) ([]byte, *Response, error) { |
||||||
|
return c.getResponse("GET", fmt.Sprintf("/repos/%s/%s/archive/%s%s", owner, repo, url.PathEscape(ref), ext), nil, nil) |
||||||
|
} |
||||||
@ -0,0 +1,134 @@ |
|||||||
|
// Copyright 2016 The Gogs Authors. All rights reserved.
|
||||||
|
// Copyright 2020 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
"time" |
||||||
|
) |
||||||
|
|
||||||
|
// PayloadUser represents the author or committer of a commit
|
||||||
|
type PayloadUser struct { |
||||||
|
// Full name of the commit author
|
||||||
|
Name string `json:"name"` |
||||||
|
Email string `json:"email"` |
||||||
|
UserName string `json:"username"` |
||||||
|
} |
||||||
|
|
||||||
|
// FIXME: consider using same format as API when commits API are added.
|
||||||
|
// applies to PayloadCommit and PayloadCommitVerification
|
||||||
|
|
||||||
|
// PayloadCommit represents a commit
|
||||||
|
type PayloadCommit struct { |
||||||
|
// sha1 hash of the commit
|
||||||
|
ID string `json:"id"` |
||||||
|
Message string `json:"message"` |
||||||
|
URL string `json:"url"` |
||||||
|
Author *PayloadUser `json:"author"` |
||||||
|
Committer *PayloadUser `json:"committer"` |
||||||
|
Verification *PayloadCommitVerification `json:"verification"` |
||||||
|
Timestamp time.Time `json:"timestamp"` |
||||||
|
Added []string `json:"added"` |
||||||
|
Removed []string `json:"removed"` |
||||||
|
Modified []string `json:"modified"` |
||||||
|
} |
||||||
|
|
||||||
|
// PayloadCommitVerification represents the GPG verification of a commit
|
||||||
|
type PayloadCommitVerification struct { |
||||||
|
Verified bool `json:"verified"` |
||||||
|
Reason string `json:"reason"` |
||||||
|
Signature string `json:"signature"` |
||||||
|
Payload string `json:"payload"` |
||||||
|
} |
||||||
|
|
||||||
|
// Branch represents a repository branch
|
||||||
|
type Branch struct { |
||||||
|
Name string `json:"name"` |
||||||
|
Commit *PayloadCommit `json:"commit"` |
||||||
|
Protected bool `json:"protected"` |
||||||
|
RequiredApprovals int64 `json:"required_approvals"` |
||||||
|
EnableStatusCheck bool `json:"enable_status_check"` |
||||||
|
StatusCheckContexts []string `json:"status_check_contexts"` |
||||||
|
UserCanPush bool `json:"user_can_push"` |
||||||
|
UserCanMerge bool `json:"user_can_merge"` |
||||||
|
EffectiveBranchProtectionName string `json:"effective_branch_protection_name"` |
||||||
|
} |
||||||
|
|
||||||
|
// ListRepoBranchesOptions options for listing a repository's branches
|
||||||
|
type ListRepoBranchesOptions struct { |
||||||
|
ListOptions |
||||||
|
} |
||||||
|
|
||||||
|
// ListRepoBranches list all the branches of one repository
|
||||||
|
func (c *Client) ListRepoBranches(user, repo string, opt ListRepoBranchesOptions) ([]*Branch, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
branches := make([]*Branch, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/branches?%s", user, repo, opt.getURLQuery().Encode()), nil, nil, &branches) |
||||||
|
return branches, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetRepoBranch get one branch's information of one repository
|
||||||
|
func (c *Client) GetRepoBranch(user, repo, branch string) (*Branch, *Response, error) { |
||||||
|
b := new(Branch) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/branches/%s", user, repo, branch), nil, nil, &b) |
||||||
|
if err != nil { |
||||||
|
return nil, resp, err |
||||||
|
} |
||||||
|
return b, resp, nil |
||||||
|
} |
||||||
|
|
||||||
|
// DeleteRepoBranch delete a branch in a repository
|
||||||
|
func (c *Client) DeleteRepoBranch(user, repo, branch string) (bool, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil { |
||||||
|
return false, nil, err |
||||||
|
} |
||||||
|
status, resp, err := c.getStatusCode("DELETE", fmt.Sprintf("/repos/%s/%s/branches/%s", user, repo, branch), nil, nil) |
||||||
|
if err != nil { |
||||||
|
return false, resp, err |
||||||
|
} |
||||||
|
return status == 204, resp, nil |
||||||
|
} |
||||||
|
|
||||||
|
// CreateBranchOption options when creating a branch in a repository
|
||||||
|
type CreateBranchOption struct { |
||||||
|
// Name of the branch to create
|
||||||
|
BranchName string `json:"new_branch_name"` |
||||||
|
// Name of the old branch to create from (optional)
|
||||||
|
OldBranchName string `json:"old_branch_name"` |
||||||
|
} |
||||||
|
|
||||||
|
// Validate the CreateBranchOption struct
|
||||||
|
func (opt CreateBranchOption) Validate() error { |
||||||
|
if len(opt.BranchName) == 0 { |
||||||
|
return fmt.Errorf("BranchName is empty") |
||||||
|
} |
||||||
|
if len(opt.BranchName) > 100 { |
||||||
|
return fmt.Errorf("BranchName to long") |
||||||
|
} |
||||||
|
if len(opt.OldBranchName) > 100 { |
||||||
|
return fmt.Errorf("OldBranchName to long") |
||||||
|
} |
||||||
|
return nil |
||||||
|
} |
||||||
|
|
||||||
|
// CreateBranch creates a branch for a user's repository
|
||||||
|
func (c *Client) CreateBranch(owner, repo string, opt CreateBranchOption) (*Branch, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.13.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
if err := opt.Validate(); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
branch := new(Branch) |
||||||
|
resp, err := c.getParsedResponse("POST", fmt.Sprintf("/repos/%s/%s/branches", owner, repo), jsonHeader, bytes.NewReader(body), branch) |
||||||
|
return branch, resp, err |
||||||
|
} |
||||||
@ -0,0 +1,150 @@ |
|||||||
|
// Copyright 2020 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
"net/url" |
||||||
|
"time" |
||||||
|
) |
||||||
|
|
||||||
|
// BranchProtection represents a branch protection for a repository
|
||||||
|
type BranchProtection struct { |
||||||
|
BranchName string `json:"branch_name"` |
||||||
|
EnablePush bool `json:"enable_push"` |
||||||
|
EnablePushWhitelist bool `json:"enable_push_whitelist"` |
||||||
|
PushWhitelistUsernames []string `json:"push_whitelist_usernames"` |
||||||
|
PushWhitelistTeams []string `json:"push_whitelist_teams"` |
||||||
|
PushWhitelistDeployKeys bool `json:"push_whitelist_deploy_keys"` |
||||||
|
EnableMergeWhitelist bool `json:"enable_merge_whitelist"` |
||||||
|
MergeWhitelistUsernames []string `json:"merge_whitelist_usernames"` |
||||||
|
MergeWhitelistTeams []string `json:"merge_whitelist_teams"` |
||||||
|
EnableStatusCheck bool `json:"enable_status_check"` |
||||||
|
StatusCheckContexts []string `json:"status_check_contexts"` |
||||||
|
RequiredApprovals int64 `json:"required_approvals"` |
||||||
|
EnableApprovalsWhitelist bool `json:"enable_approvals_whitelist"` |
||||||
|
ApprovalsWhitelistUsernames []string `json:"approvals_whitelist_username"` |
||||||
|
ApprovalsWhitelistTeams []string `json:"approvals_whitelist_teams"` |
||||||
|
BlockOnRejectedReviews bool `json:"block_on_rejected_reviews"` |
||||||
|
BlockOnOutdatedBranch bool `json:"block_on_outdated_branch"` |
||||||
|
DismissStaleApprovals bool `json:"dismiss_stale_approvals"` |
||||||
|
RequireSignedCommits bool `json:"require_signed_commits"` |
||||||
|
ProtectedFilePatterns string `json:"protected_file_patterns"` |
||||||
|
Created time.Time `json:"created_at"` |
||||||
|
Updated time.Time `json:"updated_at"` |
||||||
|
} |
||||||
|
|
||||||
|
// CreateBranchProtectionOption options for creating a branch protection
|
||||||
|
type CreateBranchProtectionOption struct { |
||||||
|
BranchName string `json:"branch_name"` |
||||||
|
EnablePush bool `json:"enable_push"` |
||||||
|
EnablePushWhitelist bool `json:"enable_push_whitelist"` |
||||||
|
PushWhitelistUsernames []string `json:"push_whitelist_usernames"` |
||||||
|
PushWhitelistTeams []string `json:"push_whitelist_teams"` |
||||||
|
PushWhitelistDeployKeys bool `json:"push_whitelist_deploy_keys"` |
||||||
|
EnableMergeWhitelist bool `json:"enable_merge_whitelist"` |
||||||
|
MergeWhitelistUsernames []string `json:"merge_whitelist_usernames"` |
||||||
|
MergeWhitelistTeams []string `json:"merge_whitelist_teams"` |
||||||
|
EnableStatusCheck bool `json:"enable_status_check"` |
||||||
|
StatusCheckContexts []string `json:"status_check_contexts"` |
||||||
|
RequiredApprovals int64 `json:"required_approvals"` |
||||||
|
EnableApprovalsWhitelist bool `json:"enable_approvals_whitelist"` |
||||||
|
ApprovalsWhitelistUsernames []string `json:"approvals_whitelist_username"` |
||||||
|
ApprovalsWhitelistTeams []string `json:"approvals_whitelist_teams"` |
||||||
|
BlockOnRejectedReviews bool `json:"block_on_rejected_reviews"` |
||||||
|
BlockOnOutdatedBranch bool `json:"block_on_outdated_branch"` |
||||||
|
DismissStaleApprovals bool `json:"dismiss_stale_approvals"` |
||||||
|
RequireSignedCommits bool `json:"require_signed_commits"` |
||||||
|
ProtectedFilePatterns string `json:"protected_file_patterns"` |
||||||
|
} |
||||||
|
|
||||||
|
// EditBranchProtectionOption options for editing a branch protection
|
||||||
|
type EditBranchProtectionOption struct { |
||||||
|
EnablePush *bool `json:"enable_push"` |
||||||
|
EnablePushWhitelist *bool `json:"enable_push_whitelist"` |
||||||
|
PushWhitelistUsernames []string `json:"push_whitelist_usernames"` |
||||||
|
PushWhitelistTeams []string `json:"push_whitelist_teams"` |
||||||
|
PushWhitelistDeployKeys *bool `json:"push_whitelist_deploy_keys"` |
||||||
|
EnableMergeWhitelist *bool `json:"enable_merge_whitelist"` |
||||||
|
MergeWhitelistUsernames []string `json:"merge_whitelist_usernames"` |
||||||
|
MergeWhitelistTeams []string `json:"merge_whitelist_teams"` |
||||||
|
EnableStatusCheck *bool `json:"enable_status_check"` |
||||||
|
StatusCheckContexts []string `json:"status_check_contexts"` |
||||||
|
RequiredApprovals *int64 `json:"required_approvals"` |
||||||
|
EnableApprovalsWhitelist *bool `json:"enable_approvals_whitelist"` |
||||||
|
ApprovalsWhitelistUsernames []string `json:"approvals_whitelist_username"` |
||||||
|
ApprovalsWhitelistTeams []string `json:"approvals_whitelist_teams"` |
||||||
|
BlockOnRejectedReviews *bool `json:"block_on_rejected_reviews"` |
||||||
|
BlockOnOutdatedBranch *bool `json:"block_on_outdated_branch"` |
||||||
|
DismissStaleApprovals *bool `json:"dismiss_stale_approvals"` |
||||||
|
RequireSignedCommits *bool `json:"require_signed_commits"` |
||||||
|
ProtectedFilePatterns *string `json:"protected_file_patterns"` |
||||||
|
} |
||||||
|
|
||||||
|
// ListBranchProtectionsOptions list branch protection options
|
||||||
|
type ListBranchProtectionsOptions struct { |
||||||
|
ListOptions |
||||||
|
} |
||||||
|
|
||||||
|
// ListBranchProtections list branch protections for a repo
|
||||||
|
func (c *Client) ListBranchProtections(owner, repo string, opt ListBranchProtectionsOptions) ([]*BranchProtection, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
bps := make([]*BranchProtection, 0, opt.PageSize) |
||||||
|
link, _ := url.Parse(fmt.Sprintf("/repos/%s/%s/branch_protections", owner, repo)) |
||||||
|
link.RawQuery = opt.getURLQuery().Encode() |
||||||
|
resp, err := c.getParsedResponse("GET", link.String(), jsonHeader, nil, &bps) |
||||||
|
return bps, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetBranchProtection gets a branch protection
|
||||||
|
func (c *Client) GetBranchProtection(owner, repo, name string) (*BranchProtection, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
bp := new(BranchProtection) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/branch_protections/%s", owner, repo, name), jsonHeader, nil, bp) |
||||||
|
return bp, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// CreateBranchProtection creates a branch protection for a repo
|
||||||
|
func (c *Client) CreateBranchProtection(owner, repo string, opt CreateBranchProtectionOption) (*BranchProtection, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
bp := new(BranchProtection) |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
resp, err := c.getParsedResponse("POST", fmt.Sprintf("/repos/%s/%s/branch_protections", owner, repo), jsonHeader, bytes.NewReader(body), bp) |
||||||
|
return bp, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// EditBranchProtection edits a branch protection for a repo
|
||||||
|
func (c *Client) EditBranchProtection(owner, repo, name string, opt EditBranchProtectionOption) (*BranchProtection, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
bp := new(BranchProtection) |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
resp, err := c.getParsedResponse("PATCH", fmt.Sprintf("/repos/%s/%s/branch_protections/%s", owner, repo, name), jsonHeader, bytes.NewReader(body), bp) |
||||||
|
return bp, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// DeleteBranchProtection deletes a branch protection for a repo
|
||||||
|
func (c *Client) DeleteBranchProtection(owner, repo, name string) (*Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/repos/%s/%s/branch_protections/%s", owner, repo, name), jsonHeader, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
@ -0,0 +1,97 @@ |
|||||||
|
// Copyright 2016 The Gogs Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
) |
||||||
|
|
||||||
|
// ListCollaboratorsOptions options for listing a repository's collaborators
|
||||||
|
type ListCollaboratorsOptions struct { |
||||||
|
ListOptions |
||||||
|
} |
||||||
|
|
||||||
|
// ListCollaborators list a repository's collaborators
|
||||||
|
func (c *Client) ListCollaborators(user, repo string, opt ListCollaboratorsOptions) ([]*User, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
collaborators := make([]*User, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", |
||||||
|
fmt.Sprintf("/repos/%s/%s/collaborators?%s", user, repo, opt.getURLQuery().Encode()), |
||||||
|
nil, nil, &collaborators) |
||||||
|
return collaborators, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// IsCollaborator check if a user is a collaborator of a repository
|
||||||
|
func (c *Client) IsCollaborator(user, repo, collaborator string) (bool, *Response, error) { |
||||||
|
status, resp, err := c.getStatusCode("GET", fmt.Sprintf("/repos/%s/%s/collaborators/%s", user, repo, collaborator), nil, nil) |
||||||
|
if err != nil { |
||||||
|
return false, resp, err |
||||||
|
} |
||||||
|
if status == 204 { |
||||||
|
return true, resp, nil |
||||||
|
} |
||||||
|
return false, resp, nil |
||||||
|
} |
||||||
|
|
||||||
|
// AddCollaboratorOption options when adding a user as a collaborator of a repository
|
||||||
|
type AddCollaboratorOption struct { |
||||||
|
Permission *AccessMode `json:"permission"` |
||||||
|
} |
||||||
|
|
||||||
|
// AccessMode represent the grade of access you have to something
|
||||||
|
type AccessMode string |
||||||
|
|
||||||
|
const ( |
||||||
|
// AccessModeNone no access
|
||||||
|
AccessModeNone AccessMode = "none" |
||||||
|
// AccessModeRead read access
|
||||||
|
AccessModeRead AccessMode = "read" |
||||||
|
// AccessModeWrite write access
|
||||||
|
AccessModeWrite AccessMode = "write" |
||||||
|
// AccessModeAdmin admin access
|
||||||
|
AccessModeAdmin AccessMode = "admin" |
||||||
|
// AccessModeOwner owner
|
||||||
|
AccessModeOwner AccessMode = "owner" |
||||||
|
) |
||||||
|
|
||||||
|
// Validate the AddCollaboratorOption struct
|
||||||
|
func (opt AddCollaboratorOption) Validate() error { |
||||||
|
if opt.Permission != nil { |
||||||
|
if *opt.Permission == AccessModeOwner { |
||||||
|
*opt.Permission = AccessModeAdmin |
||||||
|
return nil |
||||||
|
} |
||||||
|
if *opt.Permission == AccessModeNone { |
||||||
|
opt.Permission = nil |
||||||
|
return nil |
||||||
|
} |
||||||
|
if *opt.Permission != AccessModeRead && *opt.Permission != AccessModeWrite && *opt.Permission != AccessModeAdmin { |
||||||
|
return fmt.Errorf("permission mode invalid") |
||||||
|
} |
||||||
|
} |
||||||
|
return nil |
||||||
|
} |
||||||
|
|
||||||
|
// AddCollaborator add some user as a collaborator of a repository
|
||||||
|
func (c *Client) AddCollaborator(user, repo, collaborator string, opt AddCollaboratorOption) (*Response, error) { |
||||||
|
if err := opt.Validate(); err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
_, resp, err := c.getResponse("PUT", fmt.Sprintf("/repos/%s/%s/collaborators/%s", user, repo, collaborator), jsonHeader, bytes.NewReader(body)) |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// DeleteCollaborator remove a collaborator from a repository
|
||||||
|
func (c *Client) DeleteCollaborator(user, repo, collaborator string) (*Response, error) { |
||||||
|
_, resp, err := c.getResponse("DELETE", |
||||||
|
fmt.Sprintf("/repos/%s/%s/collaborators/%s", user, repo, collaborator), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
@ -0,0 +1,88 @@ |
|||||||
|
// Copyright 2018 The Gogs Authors. All rights reserved.
|
||||||
|
// Copyright 2019 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"fmt" |
||||||
|
"net/url" |
||||||
|
"time" |
||||||
|
) |
||||||
|
|
||||||
|
// Identity for a person's identity like an author or committer
|
||||||
|
type Identity struct { |
||||||
|
Name string `json:"name"` |
||||||
|
Email string `json:"email"` |
||||||
|
} |
||||||
|
|
||||||
|
// CommitMeta contains meta information of a commit in terms of API.
|
||||||
|
type CommitMeta struct { |
||||||
|
URL string `json:"url"` |
||||||
|
SHA string `json:"sha"` |
||||||
|
} |
||||||
|
|
||||||
|
// CommitUser contains information of a user in the context of a commit.
|
||||||
|
type CommitUser struct { |
||||||
|
Identity |
||||||
|
Date string `json:"date"` |
||||||
|
} |
||||||
|
|
||||||
|
// RepoCommit contains information of a commit in the context of a repository.
|
||||||
|
type RepoCommit struct { |
||||||
|
URL string `json:"url"` |
||||||
|
Author *CommitUser `json:"author"` |
||||||
|
Committer *CommitUser `json:"committer"` |
||||||
|
Message string `json:"message"` |
||||||
|
Tree *CommitMeta `json:"tree"` |
||||||
|
} |
||||||
|
|
||||||
|
// Commit contains information generated from a Git commit.
|
||||||
|
type Commit struct { |
||||||
|
*CommitMeta |
||||||
|
HTMLURL string `json:"html_url"` |
||||||
|
RepoCommit *RepoCommit `json:"commit"` |
||||||
|
Author *User `json:"author"` |
||||||
|
Committer *User `json:"committer"` |
||||||
|
Parents []*CommitMeta `json:"parents"` |
||||||
|
} |
||||||
|
|
||||||
|
// CommitDateOptions store dates for GIT_AUTHOR_DATE and GIT_COMMITTER_DATE
|
||||||
|
type CommitDateOptions struct { |
||||||
|
Author time.Time `json:"author"` |
||||||
|
Committer time.Time `json:"committer"` |
||||||
|
} |
||||||
|
|
||||||
|
// GetSingleCommit returns a single commit
|
||||||
|
func (c *Client) GetSingleCommit(user, repo, commitID string) (*Commit, *Response, error) { |
||||||
|
commit := new(Commit) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/git/commits/%s", user, repo, commitID), nil, nil, &commit) |
||||||
|
return commit, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// ListCommitOptions list commit options
|
||||||
|
type ListCommitOptions struct { |
||||||
|
ListOptions |
||||||
|
//SHA or branch to start listing commits from (usually 'master')
|
||||||
|
SHA string |
||||||
|
} |
||||||
|
|
||||||
|
// QueryEncode turns options into querystring argument
|
||||||
|
func (opt *ListCommitOptions) QueryEncode() string { |
||||||
|
query := opt.ListOptions.getURLQuery() |
||||||
|
if opt.SHA != "" { |
||||||
|
query.Add("sha", opt.SHA) |
||||||
|
} |
||||||
|
return query.Encode() |
||||||
|
} |
||||||
|
|
||||||
|
// ListRepoCommits return list of commits from a repo
|
||||||
|
func (c *Client) ListRepoCommits(user, repo string, opt ListCommitOptions) ([]*Commit, *Response, error) { |
||||||
|
link, _ := url.Parse(fmt.Sprintf("/repos/%s/%s/commits", user, repo)) |
||||||
|
opt.setDefaults() |
||||||
|
commits := make([]*Commit, 0, opt.PageSize) |
||||||
|
link.RawQuery = opt.QueryEncode() |
||||||
|
resp, err := c.getParsedResponse("GET", link.String(), nil, nil, &commits) |
||||||
|
return commits, resp, err |
||||||
|
} |
||||||
@ -0,0 +1,194 @@ |
|||||||
|
// Copyright 2014 The Gogs Authors. All rights reserved.
|
||||||
|
// Copyright 2019 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
) |
||||||
|
|
||||||
|
// FileOptions options for all file APIs
|
||||||
|
type FileOptions struct { |
||||||
|
// message (optional) for the commit of this file. if not supplied, a default message will be used
|
||||||
|
Message string `json:"message"` |
||||||
|
// branch (optional) to base this file from. if not given, the default branch is used
|
||||||
|
BranchName string `json:"branch"` |
||||||
|
// new_branch (optional) will make a new branch from `branch` before creating the file
|
||||||
|
NewBranchName string `json:"new_branch"` |
||||||
|
// `author` and `committer` are optional (if only one is given, it will be used for the other, otherwise the authenticated user will be used)
|
||||||
|
Author Identity `json:"author"` |
||||||
|
Committer Identity `json:"committer"` |
||||||
|
Dates CommitDateOptions `json:"dates"` |
||||||
|
} |
||||||
|
|
||||||
|
// CreateFileOptions options for creating files
|
||||||
|
// Note: `author` and `committer` are optional (if only one is given, it will be used for the other, otherwise the authenticated user will be used)
|
||||||
|
type CreateFileOptions struct { |
||||||
|
FileOptions |
||||||
|
// content must be base64 encoded
|
||||||
|
// required: true
|
||||||
|
Content string `json:"content"` |
||||||
|
} |
||||||
|
|
||||||
|
// DeleteFileOptions options for deleting files (used for other File structs below)
|
||||||
|
// Note: `author` and `committer` are optional (if only one is given, it will be used for the other, otherwise the authenticated user will be used)
|
||||||
|
type DeleteFileOptions struct { |
||||||
|
FileOptions |
||||||
|
// sha is the SHA for the file that already exists
|
||||||
|
// required: true
|
||||||
|
SHA string `json:"sha"` |
||||||
|
} |
||||||
|
|
||||||
|
// UpdateFileOptions options for updating files
|
||||||
|
// Note: `author` and `committer` are optional (if only one is given, it will be used for the other, otherwise the authenticated user will be used)
|
||||||
|
type UpdateFileOptions struct { |
||||||
|
FileOptions |
||||||
|
// sha is the SHA for the file that already exists
|
||||||
|
// required: true
|
||||||
|
SHA string `json:"sha"` |
||||||
|
// content must be base64 encoded
|
||||||
|
// required: true
|
||||||
|
Content string `json:"content"` |
||||||
|
// from_path (optional) is the path of the original file which will be moved/renamed to the path in the URL
|
||||||
|
FromPath string `json:"from_path"` |
||||||
|
} |
||||||
|
|
||||||
|
// FileLinksResponse contains the links for a repo's file
|
||||||
|
type FileLinksResponse struct { |
||||||
|
Self *string `json:"self"` |
||||||
|
GitURL *string `json:"git"` |
||||||
|
HTMLURL *string `json:"html"` |
||||||
|
} |
||||||
|
|
||||||
|
// ContentsResponse contains information about a repo's entry's (dir, file, symlink, submodule) metadata and content
|
||||||
|
type ContentsResponse struct { |
||||||
|
Name string `json:"name"` |
||||||
|
Path string `json:"path"` |
||||||
|
SHA string `json:"sha"` |
||||||
|
// `type` will be `file`, `dir`, `symlink`, or `submodule`
|
||||||
|
Type string `json:"type"` |
||||||
|
Size int64 `json:"size"` |
||||||
|
// `encoding` is populated when `type` is `file`, otherwise null
|
||||||
|
Encoding *string `json:"encoding"` |
||||||
|
// `content` is populated when `type` is `file`, otherwise null
|
||||||
|
Content *string `json:"content"` |
||||||
|
// `target` is populated when `type` is `symlink`, otherwise null
|
||||||
|
Target *string `json:"target"` |
||||||
|
URL *string `json:"url"` |
||||||
|
HTMLURL *string `json:"html_url"` |
||||||
|
GitURL *string `json:"git_url"` |
||||||
|
DownloadURL *string `json:"download_url"` |
||||||
|
// `submodule_git_url` is populated when `type` is `submodule`, otherwise null
|
||||||
|
SubmoduleGitURL *string `json:"submodule_git_url"` |
||||||
|
Links *FileLinksResponse `json:"_links"` |
||||||
|
} |
||||||
|
|
||||||
|
// FileCommitResponse contains information generated from a Git commit for a repo's file.
|
||||||
|
type FileCommitResponse struct { |
||||||
|
CommitMeta |
||||||
|
HTMLURL string `json:"html_url"` |
||||||
|
Author *CommitUser `json:"author"` |
||||||
|
Committer *CommitUser `json:"committer"` |
||||||
|
Parents []*CommitMeta `json:"parents"` |
||||||
|
Message string `json:"message"` |
||||||
|
Tree *CommitMeta `json:"tree"` |
||||||
|
} |
||||||
|
|
||||||
|
// FileResponse contains information about a repo's file
|
||||||
|
type FileResponse struct { |
||||||
|
Content *ContentsResponse `json:"content"` |
||||||
|
Commit *FileCommitResponse `json:"commit"` |
||||||
|
Verification *PayloadCommitVerification `json:"verification"` |
||||||
|
} |
||||||
|
|
||||||
|
// FileDeleteResponse contains information about a repo's file that was deleted
|
||||||
|
type FileDeleteResponse struct { |
||||||
|
Content interface{} `json:"content"` // to be set to nil
|
||||||
|
Commit *FileCommitResponse `json:"commit"` |
||||||
|
Verification *PayloadCommitVerification `json:"verification"` |
||||||
|
} |
||||||
|
|
||||||
|
// GetFile downloads a file of repository, ref can be branch/tag/commit.
|
||||||
|
// e.g.: ref -> master, tree -> macaron.go(no leading slash)
|
||||||
|
func (c *Client) GetFile(user, repo, ref, tree string) ([]byte, *Response, error) { |
||||||
|
return c.getResponse("GET", fmt.Sprintf("/repos/%s/%s/raw/%s/%s", user, repo, ref, tree), nil, nil) |
||||||
|
} |
||||||
|
|
||||||
|
// GetContents get the metadata and contents (if a file) of an entry in a repository, or a list of entries if a dir
|
||||||
|
// ref is optional
|
||||||
|
func (c *Client) GetContents(owner, repo, ref, filepath string) (*ContentsResponse, *Response, error) { |
||||||
|
cr := new(ContentsResponse) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/contents/%s?ref=%s", owner, repo, filepath, ref), jsonHeader, nil, cr) |
||||||
|
return cr, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// CreateFile create a file in a repository
|
||||||
|
func (c *Client) CreateFile(owner, repo, filepath string, opt CreateFileOptions) (*FileResponse, *Response, error) { |
||||||
|
var err error |
||||||
|
if opt.BranchName, err = c.setDefaultBranchForOldVersions(owner, repo, opt.BranchName); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
|
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
fr := new(FileResponse) |
||||||
|
resp, err := c.getParsedResponse("POST", fmt.Sprintf("/repos/%s/%s/contents/%s", owner, repo, filepath), jsonHeader, bytes.NewReader(body), fr) |
||||||
|
return fr, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// UpdateFile update a file in a repository
|
||||||
|
func (c *Client) UpdateFile(owner, repo, filepath string, opt UpdateFileOptions) (*FileResponse, *Response, error) { |
||||||
|
var err error |
||||||
|
if opt.BranchName, err = c.setDefaultBranchForOldVersions(owner, repo, opt.BranchName); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
|
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
fr := new(FileResponse) |
||||||
|
resp, err := c.getParsedResponse("PUT", fmt.Sprintf("/repos/%s/%s/contents/%s", owner, repo, filepath), jsonHeader, bytes.NewReader(body), fr) |
||||||
|
return fr, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// DeleteFile delete a file from repository
|
||||||
|
func (c *Client) DeleteFile(owner, repo, filepath string, opt DeleteFileOptions) (*Response, error) { |
||||||
|
var err error |
||||||
|
if opt.BranchName, err = c.setDefaultBranchForOldVersions(owner, repo, opt.BranchName); err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
|
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
status, resp, err := c.getStatusCode("DELETE", fmt.Sprintf("/repos/%s/%s/contents/%s", owner, repo, filepath), jsonHeader, bytes.NewReader(body)) |
||||||
|
if err != nil { |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
if status != 200 && status != 204 { |
||||||
|
return resp, fmt.Errorf("unexpected Status: %d", status) |
||||||
|
} |
||||||
|
return resp, nil |
||||||
|
} |
||||||
|
|
||||||
|
func (c *Client) setDefaultBranchForOldVersions(owner, repo, branch string) (string, error) { |
||||||
|
if len(branch) == 0 { |
||||||
|
// Gitea >= 1.12.0 Use DefaultBranch on "", mimic this for older versions
|
||||||
|
if c.CheckServerVersionConstraint(">=1.12.0") != nil { |
||||||
|
r, _, err := c.GetRepo(owner, repo) |
||||||
|
if err != nil { |
||||||
|
return "", err |
||||||
|
} |
||||||
|
return r.DefaultBranch, nil |
||||||
|
} |
||||||
|
} |
||||||
|
return branch, nil |
||||||
|
} |
||||||
@ -0,0 +1,79 @@ |
|||||||
|
// Copyright 2015 The Gogs Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
"net/url" |
||||||
|
"time" |
||||||
|
) |
||||||
|
|
||||||
|
// DeployKey a deploy key
|
||||||
|
type DeployKey struct { |
||||||
|
ID int64 `json:"id"` |
||||||
|
KeyID int64 `json:"key_id"` |
||||||
|
Key string `json:"key"` |
||||||
|
URL string `json:"url"` |
||||||
|
Title string `json:"title"` |
||||||
|
Fingerprint string `json:"fingerprint"` |
||||||
|
Created time.Time `json:"created_at"` |
||||||
|
ReadOnly bool `json:"read_only"` |
||||||
|
Repository *Repository `json:"repository,omitempty"` |
||||||
|
} |
||||||
|
|
||||||
|
// ListDeployKeysOptions options for listing a repository's deploy keys
|
||||||
|
type ListDeployKeysOptions struct { |
||||||
|
ListOptions |
||||||
|
KeyID int64 |
||||||
|
Fingerprint string |
||||||
|
} |
||||||
|
|
||||||
|
// QueryEncode turns options into querystring argument
|
||||||
|
func (opt *ListDeployKeysOptions) QueryEncode() string { |
||||||
|
query := opt.getURLQuery() |
||||||
|
if opt.KeyID > 0 { |
||||||
|
query.Add("key_id", fmt.Sprintf("%d", opt.KeyID)) |
||||||
|
} |
||||||
|
if len(opt.Fingerprint) > 0 { |
||||||
|
query.Add("fingerprint", opt.Fingerprint) |
||||||
|
} |
||||||
|
return query.Encode() |
||||||
|
} |
||||||
|
|
||||||
|
// ListDeployKeys list all the deploy keys of one repository
|
||||||
|
func (c *Client) ListDeployKeys(user, repo string, opt ListDeployKeysOptions) ([]*DeployKey, *Response, error) { |
||||||
|
link, _ := url.Parse(fmt.Sprintf("/repos/%s/%s/keys", user, repo)) |
||||||
|
opt.setDefaults() |
||||||
|
link.RawQuery = opt.QueryEncode() |
||||||
|
keys := make([]*DeployKey, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", link.String(), nil, nil, &keys) |
||||||
|
return keys, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetDeployKey get one deploy key with key id
|
||||||
|
func (c *Client) GetDeployKey(user, repo string, keyID int64) (*DeployKey, *Response, error) { |
||||||
|
key := new(DeployKey) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/keys/%d", user, repo, keyID), nil, nil, &key) |
||||||
|
return key, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// CreateDeployKey options when create one deploy key
|
||||||
|
func (c *Client) CreateDeployKey(user, repo string, opt CreateKeyOption) (*DeployKey, *Response, error) { |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
key := new(DeployKey) |
||||||
|
resp, err := c.getParsedResponse("POST", fmt.Sprintf("/repos/%s/%s/keys", user, repo), jsonHeader, bytes.NewReader(body), key) |
||||||
|
return key, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// DeleteDeployKey delete deploy key with key id
|
||||||
|
func (c *Client) DeleteDeployKey(owner, repo string, keyID int64) (*Response, error) { |
||||||
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/repos/%s/%s/keys/%d", owner, repo, keyID), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
@ -0,0 +1,115 @@ |
|||||||
|
// Copyright 2020 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
) |
||||||
|
|
||||||
|
// GitServiceType represents a git service
|
||||||
|
type GitServiceType string |
||||||
|
|
||||||
|
const ( |
||||||
|
// GitServicePlain represents a plain git service
|
||||||
|
GitServicePlain GitServiceType = "git" |
||||||
|
//GitServiceGithub represents github.com
|
||||||
|
GitServiceGithub GitServiceType = "github" |
||||||
|
// GitServiceGitlab represents a gitlab service
|
||||||
|
GitServiceGitlab GitServiceType = "gitlab" |
||||||
|
|
||||||
|
// Not supported jet
|
||||||
|
// // GitServiceGitea represents a gitea service
|
||||||
|
// GitServiceGitea GitServiceType = "gitea"
|
||||||
|
// // GitServiceGogs represents a gogs service
|
||||||
|
// GitServiceGogs GitServiceType = "gogs"
|
||||||
|
) |
||||||
|
|
||||||
|
// MigrateRepoOption options for migrating a repository from an external service
|
||||||
|
type MigrateRepoOption struct { |
||||||
|
RepoName string `json:"repo_name"` |
||||||
|
RepoOwner string `json:"repo_owner"` |
||||||
|
// deprecated use RepoOwner
|
||||||
|
RepoOwnerID int64 `json:"uid"` |
||||||
|
CloneAddr string `json:"clone_addr"` |
||||||
|
Service GitServiceType `json:"service"` |
||||||
|
AuthUsername string `json:"auth_username"` |
||||||
|
AuthPassword string `json:"auth_password"` |
||||||
|
AuthToken string `json:"auth_token"` |
||||||
|
Mirror bool `json:"mirror"` |
||||||
|
Private bool `json:"private"` |
||||||
|
Description string `json:"description"` |
||||||
|
Wiki bool `json:"wiki"` |
||||||
|
Milestones bool `json:"milestones"` |
||||||
|
Labels bool `json:"labels"` |
||||||
|
Issues bool `json:"issues"` |
||||||
|
PullRequests bool `json:"pull_requests"` |
||||||
|
Releases bool `json:"releases"` |
||||||
|
} |
||||||
|
|
||||||
|
// Validate the MigrateRepoOption struct
|
||||||
|
func (opt *MigrateRepoOption) Validate() error { |
||||||
|
// check user options
|
||||||
|
if len(opt.CloneAddr) == 0 { |
||||||
|
return fmt.Errorf("CloneAddr required") |
||||||
|
} |
||||||
|
if len(opt.RepoName) == 0 { |
||||||
|
return fmt.Errorf("RepoName required") |
||||||
|
} else if len(opt.RepoName) > 100 { |
||||||
|
return fmt.Errorf("RepoName to long") |
||||||
|
} |
||||||
|
if len(opt.Description) > 255 { |
||||||
|
return fmt.Errorf("Description to long") |
||||||
|
} |
||||||
|
switch opt.Service { |
||||||
|
case GitServiceGithub: |
||||||
|
if len(opt.AuthToken) == 0 { |
||||||
|
return fmt.Errorf("github require token authentication") |
||||||
|
} |
||||||
|
} |
||||||
|
return nil |
||||||
|
} |
||||||
|
|
||||||
|
// MigrateRepo migrates a repository from other Git hosting sources for the authenticated user.
|
||||||
|
//
|
||||||
|
// To migrate a repository for a organization, the authenticated user must be a
|
||||||
|
// owner of the specified organization.
|
||||||
|
func (c *Client) MigrateRepo(opt MigrateRepoOption) (*Repository, *Response, error) { |
||||||
|
if err := opt.Validate(); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
|
||||||
|
if err := c.CheckServerVersionConstraint(">=1.13.0"); err != nil { |
||||||
|
if len(opt.AuthToken) != 0 { |
||||||
|
// gitea <= 1.12 dont understand AuthToken
|
||||||
|
opt.AuthUsername = opt.AuthToken |
||||||
|
opt.AuthPassword, opt.AuthToken = "", "" |
||||||
|
} |
||||||
|
if len(opt.RepoOwner) != 0 { |
||||||
|
// gitea <= 1.12 dont understand RepoOwner
|
||||||
|
u, _, err := c.GetUserInfo(opt.RepoOwner) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
opt.RepoOwnerID = u.ID |
||||||
|
} else if opt.RepoOwnerID == 0 { |
||||||
|
// gitea <= 1.12 require RepoOwnerID
|
||||||
|
u, _, err := c.GetMyUserInfo() |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
opt.RepoOwnerID = u.ID |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
repo := new(Repository) |
||||||
|
resp, err := c.getParsedResponse("POST", "/repos/migrate", jsonHeader, bytes.NewReader(body), repo) |
||||||
|
return repo, resp, err |
||||||
|
} |
||||||
@ -0,0 +1,69 @@ |
|||||||
|
// Copyright 2018 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"encoding/json" |
||||||
|
"errors" |
||||||
|
"fmt" |
||||||
|
"strings" |
||||||
|
) |
||||||
|
|
||||||
|
// Reference represents a Git reference.
|
||||||
|
type Reference struct { |
||||||
|
Ref string `json:"ref"` |
||||||
|
URL string `json:"url"` |
||||||
|
Object *GitObject `json:"object"` |
||||||
|
} |
||||||
|
|
||||||
|
// GitObject represents a Git object.
|
||||||
|
type GitObject struct { |
||||||
|
Type string `json:"type"` |
||||||
|
SHA string `json:"sha"` |
||||||
|
URL string `json:"url"` |
||||||
|
} |
||||||
|
|
||||||
|
// GetRepoRef get one ref's information of one repository
|
||||||
|
func (c *Client) GetRepoRef(user, repo, ref string) (*Reference, *Response, error) { |
||||||
|
ref = strings.TrimPrefix(ref, "refs/") |
||||||
|
r := new(Reference) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/git/refs/%s", user, repo, ref), nil, nil, &r) |
||||||
|
if _, ok := err.(*json.UnmarshalTypeError); ok { |
||||||
|
// Multiple refs
|
||||||
|
return nil, resp, errors.New("no exact match found for this ref") |
||||||
|
} else if err != nil { |
||||||
|
return nil, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
return r, resp, nil |
||||||
|
} |
||||||
|
|
||||||
|
// GetRepoRefs get list of ref's information of one repository
|
||||||
|
func (c *Client) GetRepoRefs(user, repo, ref string) ([]*Reference, *Response, error) { |
||||||
|
ref = strings.TrimPrefix(ref, "refs/") |
||||||
|
data, resp, err := c.getResponse("GET", fmt.Sprintf("/repos/%s/%s/git/refs/%s", user, repo, ref), nil, nil) |
||||||
|
if err != nil { |
||||||
|
return nil, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// Attempt to unmarshal single returned ref.
|
||||||
|
r := new(Reference) |
||||||
|
refErr := json.Unmarshal(data, r) |
||||||
|
if refErr == nil { |
||||||
|
return []*Reference{r}, resp, nil |
||||||
|
} |
||||||
|
|
||||||
|
// Attempt to unmarshal multiple refs.
|
||||||
|
var rs []*Reference |
||||||
|
refsErr := json.Unmarshal(data, &rs) |
||||||
|
if refsErr == nil { |
||||||
|
if len(rs) == 0 { |
||||||
|
return nil, resp, errors.New("unexpected response: an array of refs with length 0") |
||||||
|
} |
||||||
|
return rs, resp, nil |
||||||
|
} |
||||||
|
|
||||||
|
return nil, resp, fmt.Errorf("unmarshalling failed for both single and multiple refs: %s and %s", refErr, refsErr) |
||||||
|
} |
||||||
@ -0,0 +1,31 @@ |
|||||||
|
// Copyright 2019 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"fmt" |
||||||
|
) |
||||||
|
|
||||||
|
// Tag represents a repository tag
|
||||||
|
type Tag struct { |
||||||
|
Name string `json:"name"` |
||||||
|
ID string `json:"id"` |
||||||
|
Commit *CommitMeta `json:"commit"` |
||||||
|
ZipballURL string `json:"zipball_url"` |
||||||
|
TarballURL string `json:"tarball_url"` |
||||||
|
} |
||||||
|
|
||||||
|
// ListRepoTagsOptions options for listing a repository's tags
|
||||||
|
type ListRepoTagsOptions struct { |
||||||
|
ListOptions |
||||||
|
} |
||||||
|
|
||||||
|
// ListRepoTags list all the branches of one repository
|
||||||
|
func (c *Client) ListRepoTags(user, repo string, opt ListRepoTagsOptions) ([]*Tag, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
tags := make([]*Tag, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/tags?%s", user, repo, opt.getURLQuery().Encode()), nil, nil, &tags) |
||||||
|
return tags, resp, err |
||||||
|
} |
||||||
@ -0,0 +1,58 @@ |
|||||||
|
// Copyright 2019 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
) |
||||||
|
|
||||||
|
// ListRepoTopicsOptions options for listing repo's topics
|
||||||
|
type ListRepoTopicsOptions struct { |
||||||
|
ListOptions |
||||||
|
} |
||||||
|
|
||||||
|
// topicsList represents a list of repo's topics
|
||||||
|
type topicsList struct { |
||||||
|
Topics []string `json:"topics"` |
||||||
|
} |
||||||
|
|
||||||
|
// ListRepoTopics list all repository's topics
|
||||||
|
func (c *Client) ListRepoTopics(user, repo string, opt ListRepoTopicsOptions) ([]string, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
|
||||||
|
list := new(topicsList) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/topics?%s", user, repo, opt.getURLQuery().Encode()), nil, nil, list) |
||||||
|
if err != nil { |
||||||
|
return nil, resp, err |
||||||
|
} |
||||||
|
return list.Topics, resp, nil |
||||||
|
} |
||||||
|
|
||||||
|
// SetRepoTopics replaces the list of repo's topics
|
||||||
|
func (c *Client) SetRepoTopics(user, repo string, list []string) (*Response, error) { |
||||||
|
|
||||||
|
l := topicsList{Topics: list} |
||||||
|
|
||||||
|
body, err := json.Marshal(&l) |
||||||
|
if err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
_, resp, err := c.getResponse("PUT", fmt.Sprintf("/repos/%s/%s/topics", user, repo), jsonHeader, bytes.NewReader(body)) |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// AddRepoTopic adds a topic to a repo's topics list
|
||||||
|
func (c *Client) AddRepoTopic(user, repo, topic string) (*Response, error) { |
||||||
|
_, resp, err := c.getResponse("PUT", fmt.Sprintf("/repos/%s/%s/topics/%s", user, repo, topic), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// DeleteRepoTopic deletes a topic from repo's topics list
|
||||||
|
func (c *Client) DeleteRepoTopic(user, repo, topic string) (*Response, error) { |
||||||
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/repos/%s/%s/topics/%s", user, repo, topic), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
@ -0,0 +1,33 @@ |
|||||||
|
// Copyright 2020 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
) |
||||||
|
|
||||||
|
// TransferRepoOption options when transfer a repository's ownership
|
||||||
|
type TransferRepoOption struct { |
||||||
|
// required: true
|
||||||
|
NewOwner string `json:"new_owner"` |
||||||
|
// ID of the team or teams to add to the repository. Teams can only be added to organization-owned repositories.
|
||||||
|
TeamIDs *[]int64 `json:"team_ids"` |
||||||
|
} |
||||||
|
|
||||||
|
// TransferRepo transfers the ownership of a repository
|
||||||
|
func (c *Client) TransferRepo(owner, reponame string, opt TransferRepoOption) (*Repository, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.12.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
repo := new(Repository) |
||||||
|
resp, err := c.getParsedResponse("POST", fmt.Sprintf("/repos/%s/%s/transfer", owner, reponame), jsonHeader, bytes.NewReader(body), repo) |
||||||
|
return repo, resp, err |
||||||
|
} |
||||||
@ -0,0 +1,41 @@ |
|||||||
|
// Copyright 2018 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"fmt" |
||||||
|
) |
||||||
|
|
||||||
|
// GitEntry represents a git tree
|
||||||
|
type GitEntry struct { |
||||||
|
Path string `json:"path"` |
||||||
|
Mode string `json:"mode"` |
||||||
|
Type string `json:"type"` |
||||||
|
Size int64 `json:"size"` |
||||||
|
SHA string `json:"sha"` |
||||||
|
URL string `json:"url"` |
||||||
|
} |
||||||
|
|
||||||
|
// GitTreeResponse returns a git tree
|
||||||
|
type GitTreeResponse struct { |
||||||
|
SHA string `json:"sha"` |
||||||
|
URL string `json:"url"` |
||||||
|
Entries []GitEntry `json:"tree"` |
||||||
|
Truncated bool `json:"truncated"` |
||||||
|
Page int `json:"page"` |
||||||
|
TotalCount int `json:"total_count"` |
||||||
|
} |
||||||
|
|
||||||
|
// GetTrees downloads a file of repository, ref can be branch/tag/commit.
|
||||||
|
// e.g.: ref -> master, tree -> macaron.go(no leading slash)
|
||||||
|
func (c *Client) GetTrees(user, repo, ref string, recursive bool) (*GitTreeResponse, *Response, error) { |
||||||
|
trees := new(GitTreeResponse) |
||||||
|
var path = fmt.Sprintf("/repos/%s/%s/git/trees/%s", user, repo, ref) |
||||||
|
if recursive { |
||||||
|
path += "?recursive=1" |
||||||
|
} |
||||||
|
resp, err := c.getParsedResponse("GET", path, nil, nil, trees) |
||||||
|
return trees, resp, err |
||||||
|
} |
||||||
@ -0,0 +1,75 @@ |
|||||||
|
// Copyright 2017 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"fmt" |
||||||
|
"net/http" |
||||||
|
"time" |
||||||
|
) |
||||||
|
|
||||||
|
// WatchInfo represents an API watch status of one repository
|
||||||
|
type WatchInfo struct { |
||||||
|
Subscribed bool `json:"subscribed"` |
||||||
|
Ignored bool `json:"ignored"` |
||||||
|
Reason interface{} `json:"reason"` |
||||||
|
CreatedAt time.Time `json:"created_at"` |
||||||
|
URL string `json:"url"` |
||||||
|
RepositoryURL string `json:"repository_url"` |
||||||
|
} |
||||||
|
|
||||||
|
// GetWatchedRepos list all the watched repos of user
|
||||||
|
func (c *Client) GetWatchedRepos(user string) ([]*Repository, *Response, error) { |
||||||
|
repos := make([]*Repository, 0, 10) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/users/%s/subscriptions", user), nil, nil, &repos) |
||||||
|
return repos, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetMyWatchedRepos list repositories watched by the authenticated user
|
||||||
|
func (c *Client) GetMyWatchedRepos() ([]*Repository, *Response, error) { |
||||||
|
repos := make([]*Repository, 0, 10) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/user/subscriptions"), nil, nil, &repos) |
||||||
|
return repos, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// CheckRepoWatch check if the current user is watching a repo
|
||||||
|
func (c *Client) CheckRepoWatch(repoUser, repoName string) (bool, *Response, error) { |
||||||
|
status, resp, err := c.getStatusCode("GET", fmt.Sprintf("/repos/%s/%s/subscription", repoUser, repoName), nil, nil) |
||||||
|
if err != nil { |
||||||
|
return false, resp, err |
||||||
|
} |
||||||
|
switch status { |
||||||
|
case http.StatusNotFound: |
||||||
|
return false, resp, nil |
||||||
|
case http.StatusOK: |
||||||
|
return true, resp, nil |
||||||
|
default: |
||||||
|
return false, resp, fmt.Errorf("unexpected Status: %d", status) |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
// WatchRepo start to watch a repository
|
||||||
|
func (c *Client) WatchRepo(repoUser, repoName string) (*Response, error) { |
||||||
|
status, resp, err := c.getStatusCode("PUT", fmt.Sprintf("/repos/%s/%s/subscription", repoUser, repoName), nil, nil) |
||||||
|
if err != nil { |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
if status == http.StatusOK { |
||||||
|
return resp, nil |
||||||
|
} |
||||||
|
return resp, fmt.Errorf("unexpected Status: %d", status) |
||||||
|
} |
||||||
|
|
||||||
|
// UnWatchRepo stop to watch a repository
|
||||||
|
func (c *Client) UnWatchRepo(repoUser, repoName string) (*Response, error) { |
||||||
|
status, resp, err := c.getStatusCode("DELETE", fmt.Sprintf("/repos/%s/%s/subscription", repoUser, repoName), nil, nil) |
||||||
|
if err != nil { |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
if status == http.StatusNoContent { |
||||||
|
return resp, nil |
||||||
|
} |
||||||
|
return resp, fmt.Errorf("unexpected Status: %d", status) |
||||||
|
} |
||||||
@ -0,0 +1,72 @@ |
|||||||
|
// Copyright 2020 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
// GlobalUISettings represent the global ui settings of a gitea instance witch is exposed by API
|
||||||
|
type GlobalUISettings struct { |
||||||
|
AllowedReactions []string `json:"allowed_reactions"` |
||||||
|
} |
||||||
|
|
||||||
|
// GlobalRepoSettings represent the global repository settings of a gitea instance witch is exposed by API
|
||||||
|
type GlobalRepoSettings struct { |
||||||
|
MirrorsDisabled bool `json:"mirrors_disabled"` |
||||||
|
HTTPGitDisabled bool `json:"http_git_disabled"` |
||||||
|
} |
||||||
|
|
||||||
|
// GlobalAPISettings contains global api settings exposed by it
|
||||||
|
type GlobalAPISettings struct { |
||||||
|
MaxResponseItems int `json:"max_response_items"` |
||||||
|
DefaultPagingNum int `json:"default_paging_num"` |
||||||
|
DefaultGitTreesPerPage int `json:"default_git_trees_per_page"` |
||||||
|
DefaultMaxBlobSize int64 `json:"default_max_blob_size"` |
||||||
|
} |
||||||
|
|
||||||
|
// GlobalAttachmentSettings contains global Attachment settings exposed by API
|
||||||
|
type GlobalAttachmentSettings struct { |
||||||
|
Enabled bool `json:"enabled"` |
||||||
|
AllowedTypes string `json:"allowed_types"` |
||||||
|
MaxSize int64 `json:"max_size"` |
||||||
|
MaxFiles int `json:"max_files"` |
||||||
|
} |
||||||
|
|
||||||
|
// GetGlobalUISettings get global ui settings witch are exposed by API
|
||||||
|
func (c *Client) GetGlobalUISettings() (*GlobalUISettings, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.13.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
conf := new(GlobalUISettings) |
||||||
|
resp, err := c.getParsedResponse("GET", "/settings/ui", jsonHeader, nil, &conf) |
||||||
|
return conf, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetGlobalRepoSettings get global repository settings witch are exposed by API
|
||||||
|
func (c *Client) GetGlobalRepoSettings() (*GlobalRepoSettings, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.13.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
conf := new(GlobalRepoSettings) |
||||||
|
resp, err := c.getParsedResponse("GET", "/settings/repository", jsonHeader, nil, &conf) |
||||||
|
return conf, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetGlobalAPISettings get global api settings witch are exposed by it
|
||||||
|
func (c *Client) GetGlobalAPISettings() (*GlobalAPISettings, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.13.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
conf := new(GlobalAPISettings) |
||||||
|
resp, err := c.getParsedResponse("GET", "/settings/api", jsonHeader, nil, &conf) |
||||||
|
return conf, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetGlobalAttachmentSettings get global repository settings witch are exposed by API
|
||||||
|
func (c *Client) GetGlobalAttachmentSettings() (*GlobalAttachmentSettings, *Response, error) { |
||||||
|
if err := c.CheckServerVersionConstraint(">=1.13.0"); err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
conf := new(GlobalAttachmentSettings) |
||||||
|
resp, err := c.getParsedResponse("GET", "/settings/attachment", jsonHeader, nil, &conf) |
||||||
|
return conf, resp, err |
||||||
|
} |
||||||
@ -0,0 +1,92 @@ |
|||||||
|
// Copyright 2017 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
"time" |
||||||
|
) |
||||||
|
|
||||||
|
// StatusState holds the state of a Status
|
||||||
|
// It can be "pending", "success", "error", "failure", and "warning"
|
||||||
|
type StatusState string |
||||||
|
|
||||||
|
const ( |
||||||
|
// StatusPending is for when the Status is Pending
|
||||||
|
StatusPending StatusState = "pending" |
||||||
|
// StatusSuccess is for when the Status is Success
|
||||||
|
StatusSuccess StatusState = "success" |
||||||
|
// StatusError is for when the Status is Error
|
||||||
|
StatusError StatusState = "error" |
||||||
|
// StatusFailure is for when the Status is Failure
|
||||||
|
StatusFailure StatusState = "failure" |
||||||
|
// StatusWarning is for when the Status is Warning
|
||||||
|
StatusWarning StatusState = "warning" |
||||||
|
) |
||||||
|
|
||||||
|
// Status holds a single Status of a single Commit
|
||||||
|
type Status struct { |
||||||
|
ID int64 `json:"id"` |
||||||
|
State StatusState `json:"status"` |
||||||
|
TargetURL string `json:"target_url"` |
||||||
|
Description string `json:"description"` |
||||||
|
URL string `json:"url"` |
||||||
|
Context string `json:"context"` |
||||||
|
Creator *User `json:"creator"` |
||||||
|
Created time.Time `json:"created_at"` |
||||||
|
Updated time.Time `json:"updated_at"` |
||||||
|
} |
||||||
|
|
||||||
|
// CreateStatusOption holds the information needed to create a new Status for a Commit
|
||||||
|
type CreateStatusOption struct { |
||||||
|
State StatusState `json:"state"` |
||||||
|
TargetURL string `json:"target_url"` |
||||||
|
Description string `json:"description"` |
||||||
|
Context string `json:"context"` |
||||||
|
} |
||||||
|
|
||||||
|
// CreateStatus creates a new Status for a given Commit
|
||||||
|
func (c *Client) CreateStatus(owner, repo, sha string, opts CreateStatusOption) (*Status, *Response, error) { |
||||||
|
body, err := json.Marshal(&opts) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
status := new(Status) |
||||||
|
resp, err := c.getParsedResponse("POST", fmt.Sprintf("/repos/%s/%s/statuses/%s", owner, repo, sha), jsonHeader, bytes.NewReader(body), status) |
||||||
|
return status, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// ListStatusesOption options for listing a repository's commit's statuses
|
||||||
|
type ListStatusesOption struct { |
||||||
|
ListOptions |
||||||
|
} |
||||||
|
|
||||||
|
// ListStatuses returns all statuses for a given Commit
|
||||||
|
func (c *Client) ListStatuses(owner, repo, sha string, opt ListStatusesOption) ([]*Status, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
statuses := make([]*Status, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/commits/%s/statuses?%s", owner, repo, sha, opt.getURLQuery().Encode()), nil, nil, &statuses) |
||||||
|
return statuses, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// CombinedStatus holds the combined state of several statuses for a single commit
|
||||||
|
type CombinedStatus struct { |
||||||
|
State StatusState `json:"state"` |
||||||
|
SHA string `json:"sha"` |
||||||
|
TotalCount int `json:"total_count"` |
||||||
|
Statuses []*Status `json:"statuses"` |
||||||
|
Repository *Repository `json:"repository"` |
||||||
|
CommitURL string `json:"commit_url"` |
||||||
|
URL string `json:"url"` |
||||||
|
} |
||||||
|
|
||||||
|
// GetCombinedStatus returns the CombinedStatus for a given Commit
|
||||||
|
func (c *Client) GetCombinedStatus(owner, repo, sha string) (*CombinedStatus, *Response, error) { |
||||||
|
status := new(CombinedStatus) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/repos/%s/%s/commits/%s/status", owner, repo, sha), nil, nil, status) |
||||||
|
return status, resp, err |
||||||
|
} |
||||||
@ -0,0 +1,43 @@ |
|||||||
|
// Copyright 2014 The Gogs Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"fmt" |
||||||
|
"time" |
||||||
|
) |
||||||
|
|
||||||
|
// User represents a user
|
||||||
|
type User struct { |
||||||
|
// the user's id
|
||||||
|
ID int64 `json:"id"` |
||||||
|
// the user's username
|
||||||
|
UserName string `json:"login"` |
||||||
|
// the user's full name
|
||||||
|
FullName string `json:"full_name"` |
||||||
|
Email string `json:"email"` |
||||||
|
// URL to the user's avatar
|
||||||
|
AvatarURL string `json:"avatar_url"` |
||||||
|
// User locale
|
||||||
|
Language string `json:"language"` |
||||||
|
// Is the user an administrator
|
||||||
|
IsAdmin bool `json:"is_admin"` |
||||||
|
LastLogin time.Time `json:"last_login,omitempty"` |
||||||
|
Created time.Time `json:"created,omitempty"` |
||||||
|
} |
||||||
|
|
||||||
|
// GetUserInfo get user info by user's name
|
||||||
|
func (c *Client) GetUserInfo(user string) (*User, *Response, error) { |
||||||
|
u := new(User) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/users/%s", user), nil, nil, u) |
||||||
|
return u, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetMyUserInfo get user info of current user
|
||||||
|
func (c *Client) GetMyUserInfo() (*User, *Response, error) { |
||||||
|
u := new(User) |
||||||
|
resp, err := c.getParsedResponse("GET", "/user", nil, nil, u) |
||||||
|
return u, resp, err |
||||||
|
} |
||||||
@ -0,0 +1,80 @@ |
|||||||
|
// Copyright 2014 The Gogs Authors. All rights reserved.
|
||||||
|
// Copyright 2019 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
"reflect" |
||||||
|
) |
||||||
|
|
||||||
|
// AccessToken represents an API access token.
|
||||||
|
type AccessToken struct { |
||||||
|
ID int64 `json:"id"` |
||||||
|
Name string `json:"name"` |
||||||
|
Token string `json:"sha1"` |
||||||
|
TokenLastEight string `json:"token_last_eight"` |
||||||
|
} |
||||||
|
|
||||||
|
// ListAccessTokensOptions options for listing a users's access tokens
|
||||||
|
type ListAccessTokensOptions struct { |
||||||
|
ListOptions |
||||||
|
} |
||||||
|
|
||||||
|
// ListAccessTokens lists all the access tokens of user
|
||||||
|
func (c *Client) ListAccessTokens(opts ListAccessTokensOptions) ([]*AccessToken, *Response, error) { |
||||||
|
if len(c.username) == 0 { |
||||||
|
return nil, nil, fmt.Errorf("\"username\" not set: only BasicAuth allowed") |
||||||
|
} |
||||||
|
opts.setDefaults() |
||||||
|
tokens := make([]*AccessToken, 0, opts.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/users/%s/tokens?%s", c.username, opts.getURLQuery().Encode()), jsonHeader, nil, &tokens) |
||||||
|
return tokens, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// CreateAccessTokenOption options when create access token
|
||||||
|
type CreateAccessTokenOption struct { |
||||||
|
Name string `json:"name"` |
||||||
|
} |
||||||
|
|
||||||
|
// CreateAccessToken create one access token with options
|
||||||
|
func (c *Client) CreateAccessToken(opt CreateAccessTokenOption) (*AccessToken, *Response, error) { |
||||||
|
if len(c.username) == 0 { |
||||||
|
return nil, nil, fmt.Errorf("\"username\" not set: only BasicAuth allowed") |
||||||
|
} |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
t := new(AccessToken) |
||||||
|
resp, err := c.getParsedResponse("POST", fmt.Sprintf("/users/%s/tokens", c.username), jsonHeader, bytes.NewReader(body), t) |
||||||
|
return t, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// DeleteAccessToken delete token, identified by ID and if not available by name
|
||||||
|
func (c *Client) DeleteAccessToken(value interface{}) (*Response, error) { |
||||||
|
if len(c.username) == 0 { |
||||||
|
return nil, fmt.Errorf("\"username\" not set: only BasicAuth allowed") |
||||||
|
} |
||||||
|
|
||||||
|
var token = "" |
||||||
|
|
||||||
|
switch reflect.ValueOf(value).Kind() { |
||||||
|
case reflect.Int64: |
||||||
|
token = fmt.Sprintf("%d", value.(int64)) |
||||||
|
case reflect.String: |
||||||
|
if err := c.CheckServerVersionConstraint(">= 1.13.0"); err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
token = value.(string) |
||||||
|
default: |
||||||
|
return nil, fmt.Errorf("only string and int64 supported") |
||||||
|
} |
||||||
|
|
||||||
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/users/%s/tokens/%s", c.username, token), jsonHeader, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
@ -0,0 +1,64 @@ |
|||||||
|
// Copyright 2015 The Gogs Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
) |
||||||
|
|
||||||
|
// Email an email address belonging to a user
|
||||||
|
type Email struct { |
||||||
|
Email string `json:"email"` |
||||||
|
Verified bool `json:"verified"` |
||||||
|
Primary bool `json:"primary"` |
||||||
|
} |
||||||
|
|
||||||
|
// ListEmailsOptions options for listing current's user emails
|
||||||
|
type ListEmailsOptions struct { |
||||||
|
ListOptions |
||||||
|
} |
||||||
|
|
||||||
|
// ListEmails all the email addresses of user
|
||||||
|
func (c *Client) ListEmails(opt ListEmailsOptions) ([]*Email, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
emails := make([]*Email, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/user/emails?%s", opt.getURLQuery().Encode()), nil, nil, &emails) |
||||||
|
return emails, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// CreateEmailOption options when creating email addresses
|
||||||
|
type CreateEmailOption struct { |
||||||
|
// email addresses to add
|
||||||
|
Emails []string `json:"emails"` |
||||||
|
} |
||||||
|
|
||||||
|
// AddEmail add one email to current user with options
|
||||||
|
func (c *Client) AddEmail(opt CreateEmailOption) ([]*Email, *Response, error) { |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
emails := make([]*Email, 0, 3) |
||||||
|
resp, err := c.getParsedResponse("POST", "/user/emails", jsonHeader, bytes.NewReader(body), &emails) |
||||||
|
return emails, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// DeleteEmailOption options when deleting email addresses
|
||||||
|
type DeleteEmailOption struct { |
||||||
|
// email addresses to delete
|
||||||
|
Emails []string `json:"emails"` |
||||||
|
} |
||||||
|
|
||||||
|
// DeleteEmail delete one email of current users'
|
||||||
|
func (c *Client) DeleteEmail(opt DeleteEmailOption) (*Response, error) { |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, err |
||||||
|
} |
||||||
|
_, resp, err := c.getResponse("DELETE", "/user/emails", jsonHeader, bytes.NewReader(body)) |
||||||
|
return resp, err |
||||||
|
} |
||||||
@ -0,0 +1,73 @@ |
|||||||
|
// Copyright 2015 The Gogs Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import "fmt" |
||||||
|
|
||||||
|
// ListFollowersOptions options for listing followers
|
||||||
|
type ListFollowersOptions struct { |
||||||
|
ListOptions |
||||||
|
} |
||||||
|
|
||||||
|
// ListMyFollowers list all the followers of current user
|
||||||
|
func (c *Client) ListMyFollowers(opt ListFollowersOptions) ([]*User, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
users := make([]*User, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/user/followers?%s", opt.getURLQuery().Encode()), nil, nil, &users) |
||||||
|
return users, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// ListFollowers list all the followers of one user
|
||||||
|
func (c *Client) ListFollowers(user string, opt ListFollowersOptions) ([]*User, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
users := make([]*User, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/users/%s/followers?%s", user, opt.getURLQuery().Encode()), nil, nil, &users) |
||||||
|
return users, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// ListFollowingOptions options for listing a user's users being followed
|
||||||
|
type ListFollowingOptions struct { |
||||||
|
ListOptions |
||||||
|
} |
||||||
|
|
||||||
|
// ListMyFollowing list all the users current user followed
|
||||||
|
func (c *Client) ListMyFollowing(opt ListFollowingOptions) ([]*User, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
users := make([]*User, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/user/following?%s", opt.getURLQuery().Encode()), nil, nil, &users) |
||||||
|
return users, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// ListFollowing list all the users the user followed
|
||||||
|
func (c *Client) ListFollowing(user string, opt ListFollowingOptions) ([]*User, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
users := make([]*User, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/users/%s/following?%s", user, opt.getURLQuery().Encode()), nil, nil, &users) |
||||||
|
return users, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// IsFollowing if current user followed the target
|
||||||
|
func (c *Client) IsFollowing(target string) (bool, *Response) { |
||||||
|
_, resp, err := c.getResponse("GET", fmt.Sprintf("/user/following/%s", target), nil, nil) |
||||||
|
return err == nil, resp |
||||||
|
} |
||||||
|
|
||||||
|
// IsUserFollowing if the user followed the target
|
||||||
|
func (c *Client) IsUserFollowing(user, target string) (bool, *Response) { |
||||||
|
_, resp, err := c.getResponse("GET", fmt.Sprintf("/users/%s/following/%s", user, target), nil, nil) |
||||||
|
return err == nil, resp |
||||||
|
} |
||||||
|
|
||||||
|
// Follow set current user follow the target
|
||||||
|
func (c *Client) Follow(target string) (*Response, error) { |
||||||
|
_, resp, err := c.getResponse("PUT", fmt.Sprintf("/user/following/%s", target), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// Unfollow set current user unfollow the target
|
||||||
|
func (c *Client) Unfollow(target string) (*Response, error) { |
||||||
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/user/following/%s", target), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
@ -0,0 +1,86 @@ |
|||||||
|
// Copyright 2017 Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
"time" |
||||||
|
) |
||||||
|
|
||||||
|
// GPGKey a user GPG key to sign commit and tag in repository
|
||||||
|
type GPGKey struct { |
||||||
|
ID int64 `json:"id"` |
||||||
|
PrimaryKeyID string `json:"primary_key_id"` |
||||||
|
KeyID string `json:"key_id"` |
||||||
|
PublicKey string `json:"public_key"` |
||||||
|
Emails []*GPGKeyEmail `json:"emails"` |
||||||
|
SubsKey []*GPGKey `json:"subkeys"` |
||||||
|
CanSign bool `json:"can_sign"` |
||||||
|
CanEncryptComms bool `json:"can_encrypt_comms"` |
||||||
|
CanEncryptStorage bool `json:"can_encrypt_storage"` |
||||||
|
CanCertify bool `json:"can_certify"` |
||||||
|
Created time.Time `json:"created_at,omitempty"` |
||||||
|
Expires time.Time `json:"expires_at,omitempty"` |
||||||
|
} |
||||||
|
|
||||||
|
// GPGKeyEmail an email attached to a GPGKey
|
||||||
|
type GPGKeyEmail struct { |
||||||
|
Email string `json:"email"` |
||||||
|
Verified bool `json:"verified"` |
||||||
|
} |
||||||
|
|
||||||
|
// ListGPGKeysOptions options for listing a user's GPGKeys
|
||||||
|
type ListGPGKeysOptions struct { |
||||||
|
ListOptions |
||||||
|
} |
||||||
|
|
||||||
|
// ListGPGKeys list all the GPG keys of the user
|
||||||
|
func (c *Client) ListGPGKeys(user string, opt ListGPGKeysOptions) ([]*GPGKey, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
keys := make([]*GPGKey, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/users/%s/gpg_keys?%s", user, opt.getURLQuery().Encode()), nil, nil, &keys) |
||||||
|
return keys, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// ListMyGPGKeys list all the GPG keys of current user
|
||||||
|
func (c *Client) ListMyGPGKeys(opt *ListGPGKeysOptions) ([]*GPGKey, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
keys := make([]*GPGKey, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/user/gpg_keys?%s", opt.getURLQuery().Encode()), nil, nil, &keys) |
||||||
|
return keys, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetGPGKey get current user's GPG key by key id
|
||||||
|
func (c *Client) GetGPGKey(keyID int64) (*GPGKey, *Response, error) { |
||||||
|
key := new(GPGKey) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/user/gpg_keys/%d", keyID), nil, nil, &key) |
||||||
|
return key, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// CreateGPGKeyOption options create user GPG key
|
||||||
|
type CreateGPGKeyOption struct { |
||||||
|
// An armored GPG key to add
|
||||||
|
//
|
||||||
|
ArmoredKey string `json:"armored_public_key"` |
||||||
|
} |
||||||
|
|
||||||
|
// CreateGPGKey create GPG key with options
|
||||||
|
func (c *Client) CreateGPGKey(opt CreateGPGKeyOption) (*GPGKey, *Response, error) { |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
key := new(GPGKey) |
||||||
|
resp, err := c.getParsedResponse("POST", "/user/gpg_keys", jsonHeader, bytes.NewReader(body), key) |
||||||
|
return key, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// DeleteGPGKey delete GPG key with key id
|
||||||
|
func (c *Client) DeleteGPGKey(keyID int64) (*Response, error) { |
||||||
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/user/gpg_keys/%d", keyID), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
@ -0,0 +1,80 @@ |
|||||||
|
// Copyright 2015 The Gogs Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"bytes" |
||||||
|
"encoding/json" |
||||||
|
"fmt" |
||||||
|
"time" |
||||||
|
) |
||||||
|
|
||||||
|
// PublicKey publickey is a user key to push code to repository
|
||||||
|
type PublicKey struct { |
||||||
|
ID int64 `json:"id"` |
||||||
|
Key string `json:"key"` |
||||||
|
URL string `json:"url,omitempty"` |
||||||
|
Title string `json:"title,omitempty"` |
||||||
|
Fingerprint string `json:"fingerprint,omitempty"` |
||||||
|
Created time.Time `json:"created_at,omitempty"` |
||||||
|
Owner *User `json:"user,omitempty"` |
||||||
|
ReadOnly bool `json:"read_only,omitempty"` |
||||||
|
KeyType string `json:"key_type,omitempty"` |
||||||
|
} |
||||||
|
|
||||||
|
// ListPublicKeysOptions options for listing a user's PublicKeys
|
||||||
|
type ListPublicKeysOptions struct { |
||||||
|
ListOptions |
||||||
|
} |
||||||
|
|
||||||
|
// ListPublicKeys list all the public keys of the user
|
||||||
|
func (c *Client) ListPublicKeys(user string, opt ListPublicKeysOptions) ([]*PublicKey, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
keys := make([]*PublicKey, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/users/%s/keys?%s", user, opt.getURLQuery().Encode()), nil, nil, &keys) |
||||||
|
return keys, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// ListMyPublicKeys list all the public keys of current user
|
||||||
|
func (c *Client) ListMyPublicKeys(opt ListPublicKeysOptions) ([]*PublicKey, *Response, error) { |
||||||
|
opt.setDefaults() |
||||||
|
keys := make([]*PublicKey, 0, opt.PageSize) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/user/keys?%s", opt.getURLQuery().Encode()), nil, nil, &keys) |
||||||
|
return keys, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// GetPublicKey get current user's public key by key id
|
||||||
|
func (c *Client) GetPublicKey(keyID int64) (*PublicKey, *Response, error) { |
||||||
|
key := new(PublicKey) |
||||||
|
resp, err := c.getParsedResponse("GET", fmt.Sprintf("/user/keys/%d", keyID), nil, nil, &key) |
||||||
|
return key, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// CreateKeyOption options when creating a key
|
||||||
|
type CreateKeyOption struct { |
||||||
|
// Title of the key to add
|
||||||
|
Title string `json:"title"` |
||||||
|
// An armored SSH key to add
|
||||||
|
Key string `json:"key"` |
||||||
|
// Describe if the key has only read access or read/write
|
||||||
|
ReadOnly bool `json:"read_only"` |
||||||
|
} |
||||||
|
|
||||||
|
// CreatePublicKey create public key with options
|
||||||
|
func (c *Client) CreatePublicKey(opt CreateKeyOption) (*PublicKey, *Response, error) { |
||||||
|
body, err := json.Marshal(&opt) |
||||||
|
if err != nil { |
||||||
|
return nil, nil, err |
||||||
|
} |
||||||
|
key := new(PublicKey) |
||||||
|
resp, err := c.getParsedResponse("POST", "/user/keys", jsonHeader, bytes.NewReader(body), key) |
||||||
|
return key, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// DeletePublicKey delete public key with key id
|
||||||
|
func (c *Client) DeletePublicKey(keyID int64) (*Response, error) { |
||||||
|
_, resp, err := c.getResponse("DELETE", fmt.Sprintf("/user/keys/%d", keyID), nil, nil) |
||||||
|
return resp, err |
||||||
|
} |
||||||
@ -0,0 +1,44 @@ |
|||||||
|
// Copyright 2020 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"fmt" |
||||||
|
"net/url" |
||||||
|
) |
||||||
|
|
||||||
|
type searchUsersResponse struct { |
||||||
|
Users []*User `json:"data"` |
||||||
|
} |
||||||
|
|
||||||
|
// SearchUsersOption options for SearchUsers
|
||||||
|
type SearchUsersOption struct { |
||||||
|
ListOptions |
||||||
|
KeyWord string |
||||||
|
} |
||||||
|
|
||||||
|
// QueryEncode turns options into querystring argument
|
||||||
|
func (opt *SearchUsersOption) QueryEncode() string { |
||||||
|
query := make(url.Values) |
||||||
|
if opt.Page > 0 { |
||||||
|
query.Add("page", fmt.Sprintf("%d", opt.Page)) |
||||||
|
} |
||||||
|
if opt.PageSize > 0 { |
||||||
|
query.Add("limit", fmt.Sprintf("%d", opt.PageSize)) |
||||||
|
} |
||||||
|
if len(opt.KeyWord) > 0 { |
||||||
|
query.Add("q", opt.KeyWord) |
||||||
|
} |
||||||
|
return query.Encode() |
||||||
|
} |
||||||
|
|
||||||
|
// SearchUsers finds users by query
|
||||||
|
func (c *Client) SearchUsers(opt SearchUsersOption) ([]*User, *Response, error) { |
||||||
|
link, _ := url.Parse("/users/search") |
||||||
|
link.RawQuery = opt.QueryEncode() |
||||||
|
userResp := new(searchUsersResponse) |
||||||
|
resp, err := c.getParsedResponse("GET", link.String(), nil, nil, &userResp) |
||||||
|
return userResp.Users, resp, err |
||||||
|
} |
||||||
@ -0,0 +1,58 @@ |
|||||||
|
// Copyright 2020 The Gitea Authors. All rights reserved.
|
||||||
|
// Use of this source code is governed by a MIT-style
|
||||||
|
// license that can be found in the LICENSE file.
|
||||||
|
|
||||||
|
package gitea |
||||||
|
|
||||||
|
import ( |
||||||
|
"fmt" |
||||||
|
|
||||||
|
"github.com/hashicorp/go-version" |
||||||
|
) |
||||||
|
|
||||||
|
// ServerVersion returns the version of the server
|
||||||
|
func (c *Client) ServerVersion() (string, *Response, error) { |
||||||
|
var v = struct { |
||||||
|
Version string `json:"version"` |
||||||
|
}{} |
||||||
|
resp, err := c.getParsedResponse("GET", "/version", nil, nil, &v) |
||||||
|
return v.Version, resp, err |
||||||
|
} |
||||||
|
|
||||||
|
// CheckServerVersionConstraint validates that the login's server satisfies a
|
||||||
|
// given version constraint such as ">= 1.11.0+dev"
|
||||||
|
func (c *Client) CheckServerVersionConstraint(constraint string) error { |
||||||
|
c.versionLock.RLock() |
||||||
|
if c.serverVersion == nil { |
||||||
|
c.versionLock.RUnlock() |
||||||
|
if err := c.loadClientServerVersion(); err != nil { |
||||||
|
return err |
||||||
|
} |
||||||
|
} else { |
||||||
|
c.versionLock.RUnlock() |
||||||
|
} |
||||||
|
|
||||||
|
check, err := version.NewConstraint(constraint) |
||||||
|
if err != nil { |
||||||
|
return err |
||||||
|
} |
||||||
|
if !check.Check(c.serverVersion) { |
||||||
|
return fmt.Errorf("gitea server at %s does not satisfy version constraint %s", c.url, constraint) |
||||||
|
} |
||||||
|
return nil |
||||||
|
} |
||||||
|
|
||||||
|
// loadClientServerVersion init the serverVersion variable
|
||||||
|
func (c *Client) loadClientServerVersion() error { |
||||||
|
c.versionLock.Lock() |
||||||
|
defer c.versionLock.Unlock() |
||||||
|
|
||||||
|
raw, _, err := c.ServerVersion() |
||||||
|
if err != nil { |
||||||
|
return err |
||||||
|
} |
||||||
|
if c.serverVersion, err = version.NewVersion(raw); err != nil { |
||||||
|
return err |
||||||
|
} |
||||||
|
return nil |
||||||
|
} |
||||||
|
After Width: | Height: | Size: 1.7 KiB |
Loading…
Reference in new issue