mirror of
https://github.com/go-gitea/gitea
synced 2024-08-18 05:10:41 +02:00
* Update swagger documentation Add docs for missing endpoints Add documentation for request parameters Make parameter naming consistent Fix response documentation * Restore delete comments
111 lines
3.0 KiB
Go
111 lines
3.0 KiB
Go
// 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 user
|
|
|
|
import (
|
|
"code.gitea.io/gitea/models"
|
|
"code.gitea.io/gitea/modules/context"
|
|
api "code.gitea.io/sdk/gitea"
|
|
)
|
|
|
|
// listUserRepos - List the repositories owned by the given user.
|
|
func listUserRepos(ctx *context.APIContext, u *models.User) {
|
|
showPrivateRepos := ctx.IsSigned && (ctx.User.ID == u.ID || ctx.User.IsAdmin)
|
|
repos, err := models.GetUserRepositories(u.ID, showPrivateRepos, 1, u.NumRepos, "")
|
|
if err != nil {
|
|
ctx.Error(500, "GetUserRepositories", err)
|
|
return
|
|
}
|
|
apiRepos := make([]*api.Repository, len(repos))
|
|
var ctxUserID int64
|
|
if ctx.User != nil {
|
|
ctxUserID = ctx.User.ID
|
|
}
|
|
for i := range repos {
|
|
access, err := models.AccessLevel(ctxUserID, repos[i])
|
|
if err != nil {
|
|
ctx.Error(500, "AccessLevel", err)
|
|
return
|
|
}
|
|
apiRepos[i] = repos[i].APIFormat(access)
|
|
}
|
|
ctx.JSON(200, &apiRepos)
|
|
}
|
|
|
|
// ListUserRepos - list the repos owned by the given user.
|
|
func ListUserRepos(ctx *context.APIContext) {
|
|
// swagger:operation GET /users/{username}/repos user userListRepos
|
|
// ---
|
|
// summary: List the repos owned by the given user
|
|
// produces:
|
|
// - application/json
|
|
// parameters:
|
|
// - name: username
|
|
// in: path
|
|
// description: username of user
|
|
// type: string
|
|
// required: true
|
|
// responses:
|
|
// "200":
|
|
// "$ref": "#/responses/RepositoryList"
|
|
user := GetUserByParams(ctx)
|
|
if ctx.Written() {
|
|
return
|
|
}
|
|
listUserRepos(ctx, user)
|
|
}
|
|
|
|
// ListMyRepos - list the repositories you own or have access to.
|
|
func ListMyRepos(ctx *context.APIContext) {
|
|
// swagger:operation GET /user/repos user userCurrentListRepos
|
|
// ---
|
|
// summary: List the repos that the authenticated user owns or has access to
|
|
// produces:
|
|
// - application/json
|
|
// responses:
|
|
// "200":
|
|
// "$ref": "#/responses/RepositoryList"
|
|
ownRepos, err := models.GetUserRepositories(ctx.User.ID, true, 1, ctx.User.NumRepos, "")
|
|
if err != nil {
|
|
ctx.Error(500, "GetUserRepositories", err)
|
|
return
|
|
}
|
|
accessibleReposMap, err := ctx.User.GetRepositoryAccesses()
|
|
if err != nil {
|
|
ctx.Error(500, "GetRepositoryAccesses", err)
|
|
return
|
|
}
|
|
|
|
apiRepos := make([]*api.Repository, len(ownRepos)+len(accessibleReposMap))
|
|
for i := range ownRepos {
|
|
apiRepos[i] = ownRepos[i].APIFormat(models.AccessModeOwner)
|
|
}
|
|
i := len(ownRepos)
|
|
for repo, access := range accessibleReposMap {
|
|
apiRepos[i] = repo.APIFormat(access)
|
|
i++
|
|
}
|
|
ctx.JSON(200, &apiRepos)
|
|
}
|
|
|
|
// ListOrgRepos - list the repositories of an organization.
|
|
func ListOrgRepos(ctx *context.APIContext) {
|
|
// swagger:operation GET /orgs/{org}/repos organization orgListRepos
|
|
// ---
|
|
// summary: List an organization's repos
|
|
// produces:
|
|
// - application/json
|
|
// parameters:
|
|
// - name: org
|
|
// in: path
|
|
// description: name of the organization
|
|
// type: string
|
|
// required: true
|
|
// responses:
|
|
// "200":
|
|
// "$ref": "#/responses/RepositoryList"
|
|
listUserRepos(ctx, ctx.Org.Organization)
|
|
}
|