123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364 |
- // Copyright 2016 The Gogs Authors. All rights reserved.
- // Copyright 2018 The Gitea Authors. All rights reserved.
- // SPDX-License-Identifier: MIT
-
- package repo
-
- import (
- "errors"
- "net/http"
-
- "code.gitea.io/gitea/models/perm"
- access_model "code.gitea.io/gitea/models/perm/access"
- repo_model "code.gitea.io/gitea/models/repo"
- user_model "code.gitea.io/gitea/models/user"
- repo_module "code.gitea.io/gitea/modules/repository"
- api "code.gitea.io/gitea/modules/structs"
- "code.gitea.io/gitea/modules/web"
- "code.gitea.io/gitea/routers/api/v1/utils"
- "code.gitea.io/gitea/services/context"
- "code.gitea.io/gitea/services/convert"
- repo_service "code.gitea.io/gitea/services/repository"
- )
-
- // ListCollaborators list a repository's collaborators
- func ListCollaborators(ctx *context.APIContext) {
- // swagger:operation GET /repos/{owner}/{repo}/collaborators repository repoListCollaborators
- // ---
- // summary: List a repository's collaborators
- // produces:
- // - application/json
- // parameters:
- // - name: owner
- // in: path
- // description: owner of the repo
- // type: string
- // required: true
- // - name: repo
- // in: path
- // description: name of the repo
- // type: string
- // required: true
- // - name: page
- // in: query
- // description: page number of results to return (1-based)
- // type: integer
- // - name: limit
- // in: query
- // description: page size of results
- // type: integer
- // responses:
- // "200":
- // "$ref": "#/responses/UserList"
- // "404":
- // "$ref": "#/responses/notFound"
-
- collaborators, total, err := repo_model.GetCollaborators(ctx, &repo_model.FindCollaborationOptions{
- ListOptions: utils.GetListOptions(ctx),
- RepoID: ctx.Repo.Repository.ID,
- })
- if err != nil {
- ctx.Error(http.StatusInternalServerError, "ListCollaborators", err)
- return
- }
-
- users := make([]*api.User, len(collaborators))
- for i, collaborator := range collaborators {
- users[i] = convert.ToUser(ctx, collaborator.User, ctx.Doer)
- }
-
- ctx.SetTotalCountHeader(total)
- ctx.JSON(http.StatusOK, users)
- }
-
- // IsCollaborator check if a user is a collaborator of a repository
- func IsCollaborator(ctx *context.APIContext) {
- // swagger:operation GET /repos/{owner}/{repo}/collaborators/{collaborator} repository repoCheckCollaborator
- // ---
- // summary: Check if a user is a collaborator of a repository
- // produces:
- // - application/json
- // parameters:
- // - name: owner
- // in: path
- // description: owner of the repo
- // type: string
- // required: true
- // - name: repo
- // in: path
- // description: name of the repo
- // type: string
- // required: true
- // - name: collaborator
- // in: path
- // description: username of the collaborator
- // type: string
- // required: true
- // responses:
- // "204":
- // "$ref": "#/responses/empty"
- // "404":
- // "$ref": "#/responses/notFound"
- // "422":
- // "$ref": "#/responses/validationError"
-
- user, err := user_model.GetUserByName(ctx, ctx.Params(":collaborator"))
- if err != nil {
- if user_model.IsErrUserNotExist(err) {
- ctx.Error(http.StatusUnprocessableEntity, "", err)
- } else {
- ctx.Error(http.StatusInternalServerError, "GetUserByName", err)
- }
- return
- }
- isColab, err := repo_model.IsCollaborator(ctx, ctx.Repo.Repository.ID, user.ID)
- if err != nil {
- ctx.Error(http.StatusInternalServerError, "IsCollaborator", err)
- return
- }
- if isColab {
- ctx.Status(http.StatusNoContent)
- } else {
- ctx.NotFound()
- }
- }
-
- // AddCollaborator add a collaborator to a repository
- func AddCollaborator(ctx *context.APIContext) {
- // swagger:operation PUT /repos/{owner}/{repo}/collaborators/{collaborator} repository repoAddCollaborator
- // ---
- // summary: Add a collaborator to a repository
- // produces:
- // - application/json
- // parameters:
- // - name: owner
- // in: path
- // description: owner of the repo
- // type: string
- // required: true
- // - name: repo
- // in: path
- // description: name of the repo
- // type: string
- // required: true
- // - name: collaborator
- // in: path
- // description: username of the collaborator to add
- // type: string
- // required: true
- // - name: body
- // in: body
- // schema:
- // "$ref": "#/definitions/AddCollaboratorOption"
- // responses:
- // "204":
- // "$ref": "#/responses/empty"
- // "403":
- // "$ref": "#/responses/forbidden"
- // "404":
- // "$ref": "#/responses/notFound"
- // "422":
- // "$ref": "#/responses/validationError"
-
- form := web.GetForm(ctx).(*api.AddCollaboratorOption)
-
- collaborator, err := user_model.GetUserByName(ctx, ctx.Params(":collaborator"))
- if err != nil {
- if user_model.IsErrUserNotExist(err) {
- ctx.Error(http.StatusUnprocessableEntity, "", err)
- } else {
- ctx.Error(http.StatusInternalServerError, "GetUserByName", err)
- }
- return
- }
-
- if !collaborator.IsActive {
- ctx.Error(http.StatusInternalServerError, "InactiveCollaborator", errors.New("collaborator's account is inactive"))
- return
- }
-
- if err := repo_module.AddCollaborator(ctx, ctx.Repo.Repository, collaborator); err != nil {
- if errors.Is(err, user_model.ErrBlockedUser) {
- ctx.Error(http.StatusForbidden, "AddCollaborator", err)
- } else {
- ctx.Error(http.StatusInternalServerError, "AddCollaborator", err)
- }
- return
- }
-
- if form.Permission != nil {
- if err := repo_model.ChangeCollaborationAccessMode(ctx, ctx.Repo.Repository, collaborator.ID, perm.ParseAccessMode(*form.Permission)); err != nil {
- ctx.Error(http.StatusInternalServerError, "ChangeCollaborationAccessMode", err)
- return
- }
- }
-
- ctx.Status(http.StatusNoContent)
- }
-
- // DeleteCollaborator delete a collaborator from a repository
- func DeleteCollaborator(ctx *context.APIContext) {
- // swagger:operation DELETE /repos/{owner}/{repo}/collaborators/{collaborator} repository repoDeleteCollaborator
- // ---
- // summary: Delete a collaborator from a repository
- // produces:
- // - application/json
- // parameters:
- // - name: owner
- // in: path
- // description: owner of the repo
- // type: string
- // required: true
- // - name: repo
- // in: path
- // description: name of the repo
- // type: string
- // required: true
- // - name: collaborator
- // in: path
- // description: username of the collaborator to delete
- // type: string
- // required: true
- // responses:
- // "204":
- // "$ref": "#/responses/empty"
- // "404":
- // "$ref": "#/responses/notFound"
- // "422":
- // "$ref": "#/responses/validationError"
-
- collaborator, err := user_model.GetUserByName(ctx, ctx.Params(":collaborator"))
- if err != nil {
- if user_model.IsErrUserNotExist(err) {
- ctx.Error(http.StatusUnprocessableEntity, "", err)
- } else {
- ctx.Error(http.StatusInternalServerError, "GetUserByName", err)
- }
- return
- }
-
- if err := repo_service.DeleteCollaboration(ctx, ctx.Repo.Repository, collaborator); err != nil {
- ctx.Error(http.StatusInternalServerError, "DeleteCollaboration", err)
- return
- }
- ctx.Status(http.StatusNoContent)
- }
-
- // GetRepoPermissions gets repository permissions for a user
- func GetRepoPermissions(ctx *context.APIContext) {
- // swagger:operation GET /repos/{owner}/{repo}/collaborators/{collaborator}/permission repository repoGetRepoPermissions
- // ---
- // summary: Get repository permissions for a user
- // produces:
- // - application/json
- // parameters:
- // - name: owner
- // in: path
- // description: owner of the repo
- // type: string
- // required: true
- // - name: repo
- // in: path
- // description: name of the repo
- // type: string
- // required: true
- // - name: collaborator
- // in: path
- // description: username of the collaborator
- // type: string
- // required: true
- // responses:
- // "200":
- // "$ref": "#/responses/RepoCollaboratorPermission"
- // "404":
- // "$ref": "#/responses/notFound"
- // "403":
- // "$ref": "#/responses/forbidden"
-
- if !ctx.Doer.IsAdmin && ctx.Doer.LoginName != ctx.Params(":collaborator") && !ctx.IsUserRepoAdmin() {
- ctx.Error(http.StatusForbidden, "User", "Only admins can query all permissions, repo admins can query all repo permissions, collaborators can query only their own")
- return
- }
-
- collaborator, err := user_model.GetUserByName(ctx, ctx.Params(":collaborator"))
- if err != nil {
- if user_model.IsErrUserNotExist(err) {
- ctx.Error(http.StatusNotFound, "GetUserByName", err)
- } else {
- ctx.Error(http.StatusInternalServerError, "GetUserByName", err)
- }
- return
- }
-
- permission, err := access_model.GetUserRepoPermission(ctx, ctx.Repo.Repository, collaborator)
- if err != nil {
- ctx.Error(http.StatusInternalServerError, "GetUserRepoPermission", err)
- return
- }
-
- ctx.JSON(http.StatusOK, convert.ToUserAndPermission(ctx, collaborator, ctx.ContextUser, permission.AccessMode))
- }
-
- // GetReviewers return all users that can be requested to review in this repo
- func GetReviewers(ctx *context.APIContext) {
- // swagger:operation GET /repos/{owner}/{repo}/reviewers repository repoGetReviewers
- // ---
- // summary: Return all users that can be requested to review in this repo
- // produces:
- // - application/json
- // parameters:
- // - name: owner
- // in: path
- // description: owner of the repo
- // type: string
- // required: true
- // - name: repo
- // in: path
- // description: name of the repo
- // type: string
- // required: true
- // responses:
- // "200":
- // "$ref": "#/responses/UserList"
- // "404":
- // "$ref": "#/responses/notFound"
-
- reviewers, err := repo_model.GetReviewers(ctx, ctx.Repo.Repository, ctx.Doer.ID, 0)
- if err != nil {
- ctx.Error(http.StatusInternalServerError, "ListCollaborators", err)
- return
- }
- ctx.JSON(http.StatusOK, convert.ToUsers(ctx, ctx.Doer, reviewers))
- }
-
- // GetAssignees return all users that have write access and can be assigned to issues
- func GetAssignees(ctx *context.APIContext) {
- // swagger:operation GET /repos/{owner}/{repo}/assignees repository repoGetAssignees
- // ---
- // summary: Return all users that have write access and can be assigned to issues
- // produces:
- // - application/json
- // parameters:
- // - name: owner
- // in: path
- // description: owner of the repo
- // type: string
- // required: true
- // - name: repo
- // in: path
- // description: name of the repo
- // type: string
- // required: true
- // responses:
- // "200":
- // "$ref": "#/responses/UserList"
- // "404":
- // "$ref": "#/responses/notFound"
-
- assignees, err := repo_model.GetRepoAssignees(ctx, ctx.Repo.Repository)
- if err != nil {
- ctx.Error(http.StatusInternalServerError, "ListCollaborators", err)
- return
- }
- ctx.JSON(http.StatusOK, convert.ToUsers(ctx, ctx.Doer, assignees))
- }
|