123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292 |
- // Copyright 2016 The Gogs Authors. All rights reserved.
- // 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 repo
-
- import (
- "errors"
- "net/http"
-
- "code.gitea.io/gitea/models"
- "code.gitea.io/gitea/modules/context"
- "code.gitea.io/gitea/modules/convert"
- api "code.gitea.io/gitea/modules/structs"
- "code.gitea.io/gitea/modules/web"
- "code.gitea.io/gitea/routers/api/v1/utils"
- )
-
- // 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"
-
- count, err := ctx.Repo.Repository.CountCollaborators()
- if err != nil {
- ctx.InternalServerError(err)
- return
- }
-
- collaborators, err := ctx.Repo.Repository.GetCollaborators(utils.GetListOptions(ctx))
- 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(collaborator.User, ctx.User)
- }
-
- ctx.SetTotalCountHeader(count)
- 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 := models.GetUserByName(ctx.Params(":collaborator"))
- if err != nil {
- if models.IsErrUserNotExist(err) {
- ctx.Error(http.StatusUnprocessableEntity, "", err)
- } else {
- ctx.Error(http.StatusInternalServerError, "GetUserByName", err)
- }
- return
- }
- isColab, err := ctx.Repo.Repository.IsCollaborator(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"
- // "422":
- // "$ref": "#/responses/validationError"
-
- form := web.GetForm(ctx).(*api.AddCollaboratorOption)
-
- collaborator, err := models.GetUserByName(ctx.Params(":collaborator"))
- if err != nil {
- if models.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 := ctx.Repo.Repository.AddCollaborator(collaborator); err != nil {
- ctx.Error(http.StatusInternalServerError, "AddCollaborator", err)
- return
- }
-
- if form.Permission != nil {
- if err := ctx.Repo.Repository.ChangeCollaborationAccessMode(collaborator.ID, models.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"
- // "422":
- // "$ref": "#/responses/validationError"
-
- collaborator, err := models.GetUserByName(ctx.Params(":collaborator"))
- if err != nil {
- if models.IsErrUserNotExist(err) {
- ctx.Error(http.StatusUnprocessableEntity, "", err)
- } else {
- ctx.Error(http.StatusInternalServerError, "GetUserByName", err)
- }
- return
- }
-
- if err := ctx.Repo.Repository.DeleteCollaboration(collaborator.ID); err != nil {
- ctx.Error(http.StatusInternalServerError, "DeleteCollaboration", err)
- return
- }
- ctx.Status(http.StatusNoContent)
- }
-
- // 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"
-
- reviewers, err := ctx.Repo.Repository.GetReviewers(ctx.User.ID, 0)
- if err != nil {
- ctx.Error(http.StatusInternalServerError, "ListCollaborators", err)
- return
- }
- ctx.JSON(http.StatusOK, convert.ToUsers(ctx.User, 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"
-
- assignees, err := ctx.Repo.Repository.GetAssignees()
- if err != nil {
- ctx.Error(http.StatusInternalServerError, "ListCollaborators", err)
- return
- }
- ctx.JSON(http.StatusOK, convert.ToUsers(ctx.User, assignees))
- }
|