2014-08-26 06:11:15 -04:00
// Copyright 2014 The Gogs Authors. All rights reserved.
2018-11-28 06:26:14 -05:00
// Copyright 2018 The Gitea Authors. All rights reserved.
2014-08-26 06:11:15 -04:00
// Use of this source code is governed by a MIT-style
// license that can be found in the LICENSE file.
2015-12-04 17:16:42 -05:00
package repo
2014-08-26 06:11:15 -04:00
import (
2017-08-16 21:31:34 -04:00
"fmt"
2017-10-26 17:16:13 -04:00
"net/http"
2017-02-10 23:00:01 -05:00
"strings"
2021-01-02 18:47:47 -05:00
"time"
2014-08-26 06:11:15 -04:00
2016-11-10 11:24:48 -05:00
"code.gitea.io/gitea/models"
2021-11-09 14:57:58 -05:00
unit_model "code.gitea.io/gitea/models/unit"
2016-11-10 11:24:48 -05:00
"code.gitea.io/gitea/modules/context"
2020-12-02 16:38:30 -05:00
"code.gitea.io/gitea/modules/convert"
2019-11-17 01:30:01 -05:00
"code.gitea.io/gitea/modules/git"
2016-11-10 11:24:48 -05:00
"code.gitea.io/gitea/modules/log"
"code.gitea.io/gitea/modules/setting"
2019-08-23 12:40:30 -04:00
api "code.gitea.io/gitea/modules/structs"
2017-10-26 17:16:13 -04:00
"code.gitea.io/gitea/modules/util"
2019-10-02 05:30:41 -04:00
"code.gitea.io/gitea/modules/validation"
2021-01-26 10:36:53 -05:00
"code.gitea.io/gitea/modules/web"
2020-01-24 14:00:29 -05:00
"code.gitea.io/gitea/routers/api/v1/utils"
2019-10-26 02:54:11 -04:00
repo_service "code.gitea.io/gitea/services/repository"
2014-08-26 06:11:15 -04:00
)
2018-08-02 04:10:02 -04:00
var searchOrderByMap = map [ string ] map [ string ] models . SearchOrderBy {
"asc" : {
"alpha" : models . SearchOrderByAlphabetically ,
"created" : models . SearchOrderByOldest ,
"updated" : models . SearchOrderByLeastUpdated ,
"size" : models . SearchOrderBySize ,
"id" : models . SearchOrderByID ,
} ,
"desc" : {
"alpha" : models . SearchOrderByAlphabeticallyReverse ,
"created" : models . SearchOrderByNewest ,
"updated" : models . SearchOrderByRecentUpdated ,
"size" : models . SearchOrderBySizeReverse ,
"id" : models . SearchOrderByIDReverse ,
} ,
}
2016-11-24 02:04:31 -05:00
// Search repositories via options
2016-03-13 18:49:16 -04:00
func Search ( ctx * context . APIContext ) {
2017-11-13 02:02:25 -05:00
// swagger:operation GET /repos/search repository repoSearch
// ---
// summary: Search for repositories
// produces:
// - application/json
// parameters:
// - name: q
// in: query
// description: keyword
// type: string
2019-08-23 23:17:10 -04:00
// - name: topic
// in: query
// description: Limit search to repositories with keyword as topic
// type: boolean
2019-08-25 13:06:36 -04:00
// - name: includeDesc
// in: query
// description: include search of keyword within repository description
// type: boolean
2017-11-13 02:02:25 -05:00
// - name: uid
// in: query
2017-11-15 03:10:26 -05:00
// description: search only for repos that the user with the given id owns or contributes to
// type: integer
2018-10-20 23:40:42 -04:00
// format: int64
2019-11-11 10:15:29 -05:00
// - name: priority_owner_id
// in: query
// description: repo owner to prioritize in the results
// type: integer
// format: int64
2020-12-27 14:58:03 -05:00
// - name: team_id
// in: query
// description: search only for repos that belong to the given team id
// type: integer
// format: int64
2019-05-15 11:24:39 -04:00
// - name: starredBy
// in: query
// description: search only for repos that the user with the given id has starred
// type: integer
// format: int64
// - name: private
// in: query
// description: include private repositories this user has access to (defaults to true)
// type: boolean
2020-05-20 21:15:30 -04:00
// - name: is_private
2020-05-16 16:07:01 -04:00
// in: query
2020-05-20 21:15:30 -04:00
// description: show only pubic, private or all repositories (defaults to all)
2020-05-16 16:07:01 -04:00
// type: boolean
2019-11-11 10:15:29 -05:00
// - name: template
// in: query
// description: include template repositories this user has access to (defaults to true)
// type: boolean
2020-05-16 16:07:01 -04:00
// - name: archived
// in: query
// description: show only archived, non-archived or all repositories (defaults to all)
// type: boolean
2017-11-13 02:02:25 -05:00
// - name: mode
// in: query
// description: type of repository to search for. Supported values are
// "fork", "source", "mirror" and "collaborative"
// type: string
// - name: exclusive
// in: query
2017-11-15 03:10:26 -05:00
// description: if `uid` is given, search only for repos that the user owns
2017-11-13 02:02:25 -05:00
// type: boolean
2018-08-02 04:10:02 -04:00
// - name: sort
// in: query
// description: sort repos by attribute. Supported values are
// "alpha", "created", "updated", "size", and "id".
// Default is "alpha"
// type: string
// - name: order
// in: query
// description: sort order, either "asc" (ascending) or "desc" (descending).
// Default is "asc", ignored if "sort" is not specified.
// type: string
2020-01-24 14:00:29 -05:00
// - name: page
// in: query
// description: page number of results to return (1-based)
// type: integer
// - name: limit
// in: query
2020-06-09 00:57:38 -04:00
// description: page size of results
2020-01-24 14:00:29 -05:00
// type: integer
2017-11-13 02:02:25 -05:00
// responses:
// "200":
// "$ref": "#/responses/SearchResults"
// "422":
// "$ref": "#/responses/validationError"
2019-12-20 12:07:12 -05:00
2016-03-11 15:33:12 -05:00
opts := & models . SearchRepoOptions {
2020-01-24 14:00:29 -05:00
ListOptions : utils . GetListOptions ( ctx ) ,
2020-01-13 12:33:46 -05:00
Actor : ctx . User ,
2021-08-11 11:08:52 -04:00
Keyword : ctx . FormTrim ( "q" ) ,
2021-07-28 21:42:15 -04:00
OwnerID : ctx . FormInt64 ( "uid" ) ,
PriorityOwnerID : ctx . FormInt64 ( "priority_owner_id" ) ,
TeamID : ctx . FormInt64 ( "team_id" ) ,
TopicOnly : ctx . FormBool ( "topic" ) ,
2019-08-25 13:06:36 -04:00
Collaborate : util . OptionalBoolNone ,
2021-08-10 20:31:13 -04:00
Private : ctx . IsSigned && ( ctx . FormString ( "private" ) == "" || ctx . FormBool ( "private" ) ) ,
2019-11-11 10:15:29 -05:00
Template : util . OptionalBoolNone ,
2021-07-28 21:42:15 -04:00
StarredByID : ctx . FormInt64 ( "starredBy" ) ,
IncludeDescription : ctx . FormBool ( "includeDesc" ) ,
2017-10-26 17:16:13 -04:00
}
2021-08-10 20:31:13 -04:00
if ctx . FormString ( "template" ) != "" {
2021-07-28 21:42:15 -04:00
opts . Template = util . OptionalBoolOf ( ctx . FormBool ( "template" ) )
2019-11-11 10:15:29 -05:00
}
2021-07-28 21:42:15 -04:00
if ctx . FormBool ( "exclusive" ) {
2017-10-26 17:16:13 -04:00
opts . Collaborate = util . OptionalBoolFalse
}
2021-08-10 20:31:13 -04:00
var mode = ctx . FormString ( "mode" )
2017-10-26 17:16:13 -04:00
switch mode {
case "source" :
opts . Fork = util . OptionalBoolFalse
opts . Mirror = util . OptionalBoolFalse
case "fork" :
opts . Fork = util . OptionalBoolTrue
case "mirror" :
opts . Mirror = util . OptionalBoolTrue
case "collaborative" :
opts . Mirror = util . OptionalBoolFalse
opts . Collaborate = util . OptionalBoolTrue
case "" :
default :
ctx . Error ( http . StatusUnprocessableEntity , "" , fmt . Errorf ( "Invalid search mode: \"%s\"" , mode ) )
return
2014-08-26 06:11:15 -04:00
}
2021-08-10 20:31:13 -04:00
if ctx . FormString ( "archived" ) != "" {
2021-07-28 21:42:15 -04:00
opts . Archived = util . OptionalBoolOf ( ctx . FormBool ( "archived" ) )
2020-05-16 16:07:01 -04:00
}
2021-08-10 20:31:13 -04:00
if ctx . FormString ( "is_private" ) != "" {
2021-07-28 21:42:15 -04:00
opts . IsPrivate = util . OptionalBoolOf ( ctx . FormBool ( "is_private" ) )
2020-05-20 21:15:30 -04:00
}
2021-08-10 20:31:13 -04:00
var sortMode = ctx . FormString ( "sort" )
2018-08-02 04:10:02 -04:00
if len ( sortMode ) > 0 {
2021-08-10 20:31:13 -04:00
var sortOrder = ctx . FormString ( "order" )
2018-08-02 04:10:02 -04:00
if len ( sortOrder ) == 0 {
sortOrder = "asc"
}
if searchModeMap , ok := searchOrderByMap [ sortOrder ] ; ok {
if orderBy , ok := searchModeMap [ sortMode ] ; ok {
opts . OrderBy = orderBy
} else {
ctx . Error ( http . StatusUnprocessableEntity , "" , fmt . Errorf ( "Invalid sort mode: \"%s\"" , sortMode ) )
return
}
} else {
ctx . Error ( http . StatusUnprocessableEntity , "" , fmt . Errorf ( "Invalid sort order: \"%s\"" , sortOrder ) )
return
}
}
2017-10-26 17:16:13 -04:00
var err error
2019-08-25 13:06:36 -04:00
repos , count , err := models . SearchRepository ( opts )
2014-08-26 06:11:15 -04:00
if err != nil {
2019-12-20 12:07:12 -05:00
ctx . JSON ( http . StatusInternalServerError , api . SearchError {
2017-05-02 09:35:59 -04:00
OK : false ,
Error : err . Error ( ) ,
2014-08-26 06:11:15 -04:00
} )
return
}
2014-11-14 17:11:30 -05:00
results := make ( [ ] * api . Repository , len ( repos ) )
2017-02-09 20:30:26 -05:00
for i , repo := range repos {
if err = repo . GetOwner ( ) ; err != nil {
2019-12-20 12:07:12 -05:00
ctx . JSON ( http . StatusInternalServerError , api . SearchError {
2017-05-02 09:35:59 -04:00
OK : false ,
Error : err . Error ( ) ,
2014-08-26 06:11:15 -04:00
} )
return
}
2018-11-28 06:26:14 -05:00
accessMode , err := models . AccessLevel ( ctx . User , repo )
2017-02-09 20:30:26 -05:00
if err != nil {
2019-12-20 12:07:12 -05:00
ctx . JSON ( http . StatusInternalServerError , api . SearchError {
2017-05-02 09:35:59 -04:00
OK : false ,
Error : err . Error ( ) ,
2017-02-09 20:30:26 -05:00
} )
2014-08-26 06:11:15 -04:00
}
2020-12-02 16:38:30 -05:00
results [ i ] = convert . ToRepo ( repo , accessMode )
2014-08-26 06:11:15 -04:00
}
2020-01-24 14:00:29 -05:00
ctx . SetLinkHeader ( int ( count ) , opts . PageSize )
2021-08-12 08:43:08 -04:00
ctx . SetTotalCountHeader ( count )
2019-12-20 12:07:12 -05:00
ctx . JSON ( http . StatusOK , api . SearchResults {
2017-05-02 09:35:59 -04:00
OK : true ,
Data : results ,
2014-08-26 06:11:15 -04:00
} )
}
2014-08-28 23:24:37 -04:00
2016-11-24 02:04:31 -05:00
// CreateUserRepo create a repository for a user
2016-03-13 18:49:16 -04:00
func CreateUserRepo ( ctx * context . APIContext , owner * models . User , opt api . CreateRepoOption ) {
2019-02-21 17:07:58 -05:00
if opt . AutoInit && opt . Readme == "" {
opt . Readme = "Default"
}
2019-10-26 02:54:11 -04:00
repo , err := repo_service . CreateRepository ( ctx . User , owner , models . CreateRepoOptions {
2020-03-26 15:14:51 -04:00
Name : opt . Name ,
Description : opt . Description ,
IssueLabels : opt . IssueLabels ,
Gitignores : opt . Gitignores ,
License : opt . License ,
Readme : opt . Readme ,
IsPrivate : opt . Private ,
AutoInit : opt . AutoInit ,
DefaultBranch : opt . DefaultBranch ,
2020-09-19 12:44:55 -04:00
TrustModel : models . ToTrustModel ( opt . TrustModel ) ,
2020-09-25 01:18:37 -04:00
IsTemplate : opt . Template ,
2015-08-28 06:33:09 -04:00
} )
2014-12-12 20:30:32 -05:00
if err != nil {
2019-03-15 10:19:09 -04:00
if models . IsErrRepoAlreadyExist ( err ) {
2019-12-20 12:07:12 -05:00
ctx . Error ( http . StatusConflict , "" , "The repository with the same name already exists." )
2019-03-15 10:19:09 -04:00
} else if models . IsErrNameReserved ( err ) ||
2015-03-26 17:11:47 -04:00
models . IsErrNamePatternNotAllowed ( err ) {
2019-12-20 12:07:12 -05:00
ctx . Error ( http . StatusUnprocessableEntity , "" , err )
2014-12-12 20:30:32 -05:00
} else {
2019-12-20 12:07:12 -05:00
ctx . Error ( http . StatusInternalServerError , "CreateRepository" , err )
2014-12-12 20:30:32 -05:00
}
return
}
2020-09-15 18:42:19 -04:00
// reload repo from db to get a real state after creation
repo , err = models . GetRepositoryByID ( repo . ID )
if err != nil {
ctx . Error ( http . StatusInternalServerError , "GetRepositoryByID" , err )
}
2020-12-02 16:38:30 -05:00
ctx . JSON ( http . StatusCreated , convert . ToRepo ( repo , models . AccessModeOwner ) )
2014-12-12 20:30:32 -05:00
}
2016-10-07 13:17:27 -04:00
// Create one repository of mine
2021-01-26 10:36:53 -05:00
func Create ( ctx * context . APIContext ) {
2017-11-13 02:02:25 -05:00
// swagger:operation POST /user/repos repository user createCurrentUserRepo
// ---
// summary: Create a repository
// consumes:
// - application/json
// produces:
// - application/json
// parameters:
// - name: body
// in: body
// schema:
// "$ref": "#/definitions/CreateRepoOption"
// responses:
// "201":
// "$ref": "#/responses/Repository"
2019-05-30 11:09:05 -04:00
// "409":
// description: The repository with the same name already exists.
// "422":
// "$ref": "#/responses/validationError"
2021-01-26 10:36:53 -05:00
opt := web . GetForm ( ctx ) . ( * api . CreateRepoOption )
2014-12-12 20:30:32 -05:00
if ctx . User . IsOrganization ( ) {
2017-11-13 02:02:25 -05:00
// Shouldn't reach this condition, but just in case.
2019-12-20 12:07:12 -05:00
ctx . Error ( http . StatusUnprocessableEntity , "" , "not allowed creating repository for organization" )
2014-12-12 20:30:32 -05:00
return
}
2021-01-26 10:36:53 -05:00
CreateUserRepo ( ctx , ctx . User , * opt )
2014-12-12 20:30:32 -05:00
}
2021-07-05 11:29:08 -04:00
// Generate Create a repository using a template
func Generate ( ctx * context . APIContext ) {
// swagger:operation POST /repos/{template_owner}/{template_repo}/generate repository generateRepo
// ---
// summary: Create a repository using a template
// consumes:
// - application/json
// produces:
// - application/json
// parameters:
// - name: template_owner
// in: path
// description: name of the template repository owner
// type: string
// required: true
// - name: template_repo
// in: path
// description: name of the template repository
// type: string
// required: true
// - name: body
// in: body
// schema:
// "$ref": "#/definitions/GenerateRepoOption"
// responses:
// "201":
// "$ref": "#/responses/Repository"
// "403":
// "$ref": "#/responses/forbidden"
// "404":
// "$ref": "#/responses/notFound"
// "409":
// description: The repository with the same name already exists.
// "422":
// "$ref": "#/responses/validationError"
form := web . GetForm ( ctx ) . ( * api . GenerateRepoOption )
if ! ctx . Repo . Repository . IsTemplate {
ctx . Error ( http . StatusUnprocessableEntity , "" , "this is not a template repo" )
return
}
if ctx . User . IsOrganization ( ) {
ctx . Error ( http . StatusUnprocessableEntity , "" , "not allowed creating repository for organization" )
return
}
opts := models . GenerateRepoOptions {
Name : form . Name ,
Description : form . Description ,
Private : form . Private ,
GitContent : form . GitContent ,
Topics : form . Topics ,
GitHooks : form . GitHooks ,
Webhooks : form . Webhooks ,
Avatar : form . Avatar ,
IssueLabels : form . Labels ,
}
if ! opts . IsValid ( ) {
ctx . Error ( http . StatusUnprocessableEntity , "" , "must select at least one template item" )
return
}
ctxUser := ctx . User
var err error
if form . Owner != ctxUser . Name {
2021-07-15 14:19:39 -04:00
ctxUser , err = models . GetUserByName ( form . Owner )
2021-07-05 11:29:08 -04:00
if err != nil {
2021-07-15 14:19:39 -04:00
if models . IsErrUserNotExist ( err ) {
2021-07-05 11:29:08 -04:00
ctx . JSON ( http . StatusNotFound , map [ string ] interface { } {
2021-07-15 14:19:39 -04:00
"error" : "request owner `" + form . Owner + "` does not exist" ,
2021-07-05 11:29:08 -04:00
} )
return
}
2021-07-15 14:19:39 -04:00
ctx . Error ( http . StatusInternalServerError , "GetUserByName" , err )
return
}
if ! ctx . User . IsAdmin && ! ctxUser . IsOrganization ( ) {
ctx . Error ( http . StatusForbidden , "" , "Only admin can generate repository for other user." )
2021-07-05 11:29:08 -04:00
return
}
if ! ctx . User . IsAdmin {
2021-11-19 06:41:40 -05:00
canCreate , err := models . OrgFromUser ( ctxUser ) . CanCreateOrgRepo ( ctx . User . ID )
2021-07-05 11:29:08 -04:00
if err != nil {
ctx . ServerError ( "CanCreateOrgRepo" , err )
return
} else if ! canCreate {
ctx . Error ( http . StatusForbidden , "" , "Given user is not allowed to create repository in organization." )
return
}
}
}
repo , err := repo_service . GenerateRepository ( ctx . User , ctxUser , ctx . Repo . Repository , opts )
if err != nil {
if models . IsErrRepoAlreadyExist ( err ) {
ctx . Error ( http . StatusConflict , "" , "The repository with the same name already exists." )
} else if models . IsErrNameReserved ( err ) ||
models . IsErrNamePatternNotAllowed ( err ) {
ctx . Error ( http . StatusUnprocessableEntity , "" , err )
} else {
ctx . Error ( http . StatusInternalServerError , "CreateRepository" , err )
}
return
}
log . Trace ( "Repository generated [%d]: %s/%s" , repo . ID , ctxUser . Name , repo . Name )
ctx . JSON ( http . StatusCreated , convert . ToRepo ( repo , models . AccessModeOwner ) )
}
2020-01-09 11:40:01 -05:00
// CreateOrgRepoDeprecated create one repository of the organization
2021-01-26 10:36:53 -05:00
func CreateOrgRepoDeprecated ( ctx * context . APIContext ) {
2020-01-09 11:40:01 -05:00
// swagger:operation POST /org/{org}/repos organization createOrgRepoDeprecated
2017-11-13 02:02:25 -05:00
// ---
// summary: Create a repository in an organization
2020-01-09 11:40:01 -05:00
// deprecated: true
2017-11-13 02:02:25 -05:00
// consumes:
// - application/json
// produces:
// - application/json
// parameters:
// - name: org
// in: path
// description: name of organization
// type: string
// required: true
// - name: body
// in: body
// schema:
// "$ref": "#/definitions/CreateRepoOption"
// responses:
// "201":
// "$ref": "#/responses/Repository"
// "422":
// "$ref": "#/responses/validationError"
// "403":
// "$ref": "#/responses/forbidden"
2019-12-20 12:07:12 -05:00
2021-01-26 10:36:53 -05:00
CreateOrgRepo ( ctx )
2020-01-09 11:40:01 -05:00
}
// CreateOrgRepo create one repository of the organization
2021-01-26 10:36:53 -05:00
func CreateOrgRepo ( ctx * context . APIContext ) {
2020-01-09 11:40:01 -05:00
// swagger:operation POST /orgs/{org}/repos organization createOrgRepo
// ---
// summary: Create a repository in an organization
// consumes:
// - application/json
// produces:
// - application/json
// parameters:
// - name: org
// in: path
// description: name of organization
// type: string
// required: true
// - name: body
// in: body
// schema:
// "$ref": "#/definitions/CreateRepoOption"
// responses:
// "201":
// "$ref": "#/responses/Repository"
// "404":
// "$ref": "#/responses/notFound"
// "403":
// "$ref": "#/responses/forbidden"
2021-01-26 10:36:53 -05:00
opt := web . GetForm ( ctx ) . ( * api . CreateRepoOption )
2014-12-12 20:30:32 -05:00
org , err := models . GetOrgByName ( ctx . Params ( ":org" ) )
if err != nil {
2017-07-06 09:30:19 -04:00
if models . IsErrOrgNotExist ( err ) {
2019-12-20 12:07:12 -05:00
ctx . Error ( http . StatusUnprocessableEntity , "" , err )
2014-12-12 20:30:32 -05:00
} else {
2019-12-20 12:07:12 -05:00
ctx . Error ( http . StatusInternalServerError , "GetOrgByName" , err )
2014-12-12 20:30:32 -05:00
}
return
}
2021-11-19 06:41:40 -05:00
if ! models . HasOrgOrUserVisible ( org . AsUser ( ) , ctx . User ) {
2021-06-26 15:53:14 -04:00
ctx . NotFound ( "HasOrgOrUserVisible" , nil )
2019-02-18 11:00:27 -05:00
return
}
2018-07-04 19:51:02 -04:00
if ! ctx . User . IsAdmin {
2019-11-20 06:27:49 -05:00
canCreate , err := org . CanCreateOrgRepo ( ctx . User . ID )
2018-07-04 19:51:02 -04:00
if err != nil {
2020-09-20 16:20:14 -04:00
ctx . Error ( http . StatusInternalServerError , "CanCreateOrgRepo" , err )
2018-07-04 19:51:02 -04:00
return
2019-11-20 06:27:49 -05:00
} else if ! canCreate {
2019-12-20 12:07:12 -05:00
ctx . Error ( http . StatusForbidden , "" , "Given user is not allowed to create repository in organization." )
2018-07-04 19:51:02 -04:00
return
}
2014-12-12 20:30:32 -05:00
}
2021-11-19 06:41:40 -05:00
CreateUserRepo ( ctx , org . AsUser ( ) , * opt )
2014-12-12 20:30:32 -05:00
}
2016-10-07 13:17:27 -04:00
// Get one repository
2016-03-13 18:49:16 -04:00
func Get ( ctx * context . APIContext ) {
2017-11-13 02:02:25 -05:00
// swagger:operation GET /repos/{owner}/{repo} repository repoGet
// ---
// summary: Get 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
// responses:
// "200":
// "$ref": "#/responses/Repository"
2019-12-20 12:07:12 -05:00
2020-12-02 16:38:30 -05:00
ctx . JSON ( http . StatusOK , convert . ToRepo ( ctx . Repo . Repository , ctx . Repo . AccessMode ) )
2015-10-22 17:46:07 -04:00
}
2016-10-03 06:35:42 -04:00
// GetByID returns a single Repository
func GetByID ( ctx * context . APIContext ) {
2017-11-13 02:02:25 -05:00
// swagger:operation GET /repositories/{id} repository repoGetByID
// ---
// summary: Get a repository by id
// produces:
// - application/json
// parameters:
// - name: id
// in: path
// description: id of the repo to get
// type: integer
2018-10-20 23:40:42 -04:00
// format: int64
2017-11-13 02:02:25 -05:00
// required: true
// responses:
// "200":
// "$ref": "#/responses/Repository"
2019-12-20 12:07:12 -05:00
2016-10-03 06:35:42 -04:00
repo , err := models . GetRepositoryByID ( ctx . ParamsInt64 ( ":id" ) )
if err != nil {
if models . IsErrRepoNotExist ( err ) {
2019-03-18 22:29:43 -04:00
ctx . NotFound ( )
2016-10-03 06:35:42 -04:00
} else {
2019-12-20 12:07:12 -05:00
ctx . Error ( http . StatusInternalServerError , "GetRepositoryByID" , err )
2016-10-03 06:35:42 -04:00
}
return
}
2018-11-28 06:26:14 -05:00
perm , err := models . GetUserRepoPermission ( repo , ctx . User )
2016-12-05 18:48:51 -05:00
if err != nil {
2019-12-20 12:07:12 -05:00
ctx . Error ( http . StatusInternalServerError , "AccessLevel" , err )
2017-07-29 21:13:33 -04:00
return
2018-11-28 06:26:14 -05:00
} else if ! perm . HasAccess ( ) {
2019-03-18 22:29:43 -04:00
ctx . NotFound ( )
2016-12-05 18:48:51 -05:00
return
}
2020-12-02 16:38:30 -05:00
ctx . JSON ( http . StatusOK , convert . ToRepo ( repo , perm . AccessMode ) )
2016-10-03 06:35:42 -04:00
}
2019-05-30 11:09:05 -04:00
// Edit edit repository properties
2021-01-26 10:36:53 -05:00
func Edit ( ctx * context . APIContext ) {
2019-05-30 11:09:05 -04:00
// swagger:operation PATCH /repos/{owner}/{repo} repository repoEdit
// ---
// summary: Edit a repository's properties. Only fields that are set will be changed.
// produces:
// - application/json
// parameters:
// - name: owner
// in: path
// description: owner of the repo to edit
// type: string
// required: true
// - name: repo
// in: path
// description: name of the repo to edit
// type: string
// required: true
// required: true
// - name: body
// in: body
// description: "Properties of a repo that you can edit"
// schema:
// "$ref": "#/definitions/EditRepoOption"
// responses:
// "200":
// "$ref": "#/responses/Repository"
// "403":
// "$ref": "#/responses/forbidden"
// "422":
// "$ref": "#/responses/validationError"
2019-12-20 12:07:12 -05:00
2021-01-26 10:36:53 -05:00
opts := * web . GetForm ( ctx ) . ( * api . EditRepoOption )
2019-05-30 11:09:05 -04:00
if err := updateBasicProperties ( ctx , opts ) ; err != nil {
return
}
if err := updateRepoUnits ( ctx , opts ) ; err != nil {
return
}
if opts . Archived != nil {
if err := updateRepoArchivedState ( ctx , opts ) ; err != nil {
return
}
}
2021-01-02 18:47:47 -05:00
if opts . MirrorInterval != nil {
if err := updateMirrorInterval ( ctx , opts ) ; err != nil {
return
}
}
2021-07-13 15:31:59 -04:00
repo , err := models . GetRepositoryByID ( ctx . Repo . Repository . ID )
if err != nil {
ctx . InternalServerError ( err )
return
}
ctx . JSON ( http . StatusOK , convert . ToRepo ( repo , ctx . Repo . AccessMode ) )
2019-05-30 11:09:05 -04:00
}
// updateBasicProperties updates the basic properties of a repo: Name, Description, Website and Visibility
func updateBasicProperties ( ctx * context . APIContext , opts api . EditRepoOption ) error {
owner := ctx . Repo . Owner
repo := ctx . Repo . Repository
newRepoName := repo . Name
if opts . Name != nil {
newRepoName = * opts . Name
}
// Check if repository name has been changed and not just a case change
if repo . LowerName != strings . ToLower ( newRepoName ) {
2019-11-15 03:06:11 -05:00
if err := repo_service . ChangeRepositoryName ( ctx . User , repo , newRepoName ) ; err != nil {
2019-05-30 11:09:05 -04:00
switch {
case models . IsErrRepoAlreadyExist ( err ) :
ctx . Error ( http . StatusUnprocessableEntity , fmt . Sprintf ( "repo name is already taken [name: %s]" , newRepoName ) , err )
case models . IsErrNameReserved ( err ) :
ctx . Error ( http . StatusUnprocessableEntity , fmt . Sprintf ( "repo name is reserved [name: %s]" , newRepoName ) , err )
case models . IsErrNamePatternNotAllowed ( err ) :
ctx . Error ( http . StatusUnprocessableEntity , fmt . Sprintf ( "repo name's pattern is not allowed [name: %s, pattern: %s]" , newRepoName , err . ( models . ErrNamePatternNotAllowed ) . Pattern ) , err )
default :
ctx . Error ( http . StatusUnprocessableEntity , "ChangeRepositoryName" , err )
}
return err
}
log . Trace ( "Repository name changed: %s/%s -> %s" , ctx . Repo . Owner . Name , repo . Name , newRepoName )
}
// Update the name in the repo object for the response
repo . Name = newRepoName
repo . LowerName = strings . ToLower ( newRepoName )
if opts . Description != nil {
repo . Description = * opts . Description
}
if opts . Website != nil {
repo . Website = * opts . Website
}
visibilityChanged := false
if opts . Private != nil {
// Visibility of forked repository is forced sync with base repository.
if repo . IsFork {
2021-03-11 13:09:52 -05:00
if err := repo . GetBaseRepo ( ) ; err != nil {
ctx . Error ( http . StatusInternalServerError , "Unable to load base repository" , err )
return err
}
2019-05-30 11:09:05 -04:00
* opts . Private = repo . BaseRepo . IsPrivate
}
visibilityChanged = repo . IsPrivate != * opts . Private
// when ForcePrivate enabled, you could change public repo to private, but only admin users can change private to public
if visibilityChanged && setting . Repository . ForcePrivate && ! * opts . Private && ! ctx . User . IsAdmin {
err := fmt . Errorf ( "cannot change private repository to public" )
ctx . Error ( http . StatusUnprocessableEntity , "Force Private enabled" , err )
return err
}
repo . IsPrivate = * opts . Private
}
2019-11-11 10:15:29 -05:00
if opts . Template != nil {
repo . IsTemplate = * opts . Template
}
2021-05-08 08:11:36 -04:00
if ctx . Repo . GitRepo == nil && ! repo . IsEmpty {
2021-02-11 14:53:41 -05:00
var err error
ctx . Repo . GitRepo , err = git . OpenRepository ( ctx . Repo . Repository . RepoPath ( ) )
if err != nil {
ctx . Error ( http . StatusInternalServerError , "Unable to OpenRepository" , err )
return err
}
defer ctx . Repo . GitRepo . Close ( )
}
// Default branch only updated if changed and exist or the repository is empty
2021-05-08 08:11:36 -04:00
if opts . DefaultBranch != nil && repo . DefaultBranch != * opts . DefaultBranch && ( repo . IsEmpty || ctx . Repo . GitRepo . IsBranchExist ( * opts . DefaultBranch ) ) {
if ! repo . IsEmpty {
if err := ctx . Repo . GitRepo . SetDefaultBranch ( * opts . DefaultBranch ) ; err != nil {
if ! git . IsErrUnsupportedVersion ( err ) {
ctx . Error ( http . StatusInternalServerError , "SetDefaultBranch" , err )
return err
}
2019-11-17 01:30:01 -05:00
}
}
repo . DefaultBranch = * opts . DefaultBranch
}
2019-05-30 11:09:05 -04:00
if err := models . UpdateRepository ( repo , visibilityChanged ) ; err != nil {
ctx . Error ( http . StatusInternalServerError , "UpdateRepository" , err )
return err
}
log . Trace ( "Repository basic settings updated: %s/%s" , owner . Name , repo . Name )
return nil
}
// updateRepoUnits updates repo units: Issue settings, Wiki settings, PR settings
func updateRepoUnits ( ctx * context . APIContext , opts api . EditRepoOption ) error {
owner := ctx . Repo . Owner
repo := ctx . Repo . Repository
var units [ ] models . RepoUnit
2021-11-09 14:57:58 -05:00
var deleteUnitTypes [ ] unit_model . Type
2019-05-30 11:09:05 -04:00
2020-01-17 02:34:37 -05:00
if opts . HasIssues != nil {
2021-11-09 14:57:58 -05:00
if * opts . HasIssues && opts . ExternalTracker != nil && ! unit_model . TypeExternalTracker . UnitGlobalDisabled ( ) {
2019-10-02 05:30:41 -04:00
// Check that values are valid
if ! validation . IsValidExternalURL ( opts . ExternalTracker . ExternalTrackerURL ) {
err := fmt . Errorf ( "External tracker URL not valid" )
ctx . Error ( http . StatusUnprocessableEntity , "Invalid external tracker URL" , err )
return err
}
if len ( opts . ExternalTracker . ExternalTrackerFormat ) != 0 && ! validation . IsValidExternalTrackerURLFormat ( opts . ExternalTracker . ExternalTrackerFormat ) {
err := fmt . Errorf ( "External tracker URL format not valid" )
ctx . Error ( http . StatusUnprocessableEntity , "Invalid external tracker URL format" , err )
return err
2019-05-30 11:09:05 -04:00
}
2019-10-02 05:30:41 -04:00
units = append ( units , models . RepoUnit {
RepoID : repo . ID ,
2021-11-09 14:57:58 -05:00
Type : unit_model . TypeExternalTracker ,
2019-10-02 05:30:41 -04:00
Config : & models . ExternalTrackerConfig {
ExternalTrackerURL : opts . ExternalTracker . ExternalTrackerURL ,
ExternalTrackerFormat : opts . ExternalTracker . ExternalTrackerFormat ,
ExternalTrackerStyle : opts . ExternalTracker . ExternalTrackerStyle ,
} ,
} )
2021-11-09 14:57:58 -05:00
deleteUnitTypes = append ( deleteUnitTypes , unit_model . TypeIssues )
} else if * opts . HasIssues && opts . ExternalTracker == nil && ! unit_model . TypeIssues . UnitGlobalDisabled ( ) {
2019-10-02 05:30:41 -04:00
// Default to built-in tracker
var config * models . IssuesConfig
if opts . InternalTracker != nil {
config = & models . IssuesConfig {
EnableTimetracker : opts . InternalTracker . EnableTimeTracker ,
AllowOnlyContributorsToTrackTime : opts . InternalTracker . AllowOnlyContributorsToTrackTime ,
EnableDependencies : opts . InternalTracker . EnableIssueDependencies ,
}
2021-11-09 14:57:58 -05:00
} else if unit , err := repo . GetUnit ( unit_model . TypeIssues ) ; err != nil {
2019-10-02 05:30:41 -04:00
// Unit type doesn't exist so we make a new config file with default values
config = & models . IssuesConfig {
EnableTimetracker : true ,
AllowOnlyContributorsToTrackTime : true ,
EnableDependencies : true ,
}
} else {
config = unit . IssuesConfig ( )
}
units = append ( units , models . RepoUnit {
RepoID : repo . ID ,
2021-11-09 14:57:58 -05:00
Type : unit_model . TypeIssues ,
2019-10-02 05:30:41 -04:00
Config : config ,
} )
2021-11-09 14:57:58 -05:00
deleteUnitTypes = append ( deleteUnitTypes , unit_model . TypeExternalTracker )
2020-01-17 02:34:37 -05:00
} else if ! * opts . HasIssues {
2021-11-09 14:57:58 -05:00
if ! unit_model . TypeExternalTracker . UnitGlobalDisabled ( ) {
deleteUnitTypes = append ( deleteUnitTypes , unit_model . TypeExternalTracker )
2020-01-17 02:34:37 -05:00
}
2021-11-09 14:57:58 -05:00
if ! unit_model . TypeIssues . UnitGlobalDisabled ( ) {
deleteUnitTypes = append ( deleteUnitTypes , unit_model . TypeIssues )
2020-01-17 02:34:37 -05:00
}
2019-05-30 11:09:05 -04:00
}
}
2020-01-17 02:34:37 -05:00
if opts . HasWiki != nil {
2021-11-09 14:57:58 -05:00
if * opts . HasWiki && opts . ExternalWiki != nil && ! unit_model . TypeExternalWiki . UnitGlobalDisabled ( ) {
2019-10-02 05:30:41 -04:00
// Check that values are valid
if ! validation . IsValidExternalURL ( opts . ExternalWiki . ExternalWikiURL ) {
err := fmt . Errorf ( "External wiki URL not valid" )
ctx . Error ( http . StatusUnprocessableEntity , "" , "Invalid external wiki URL" )
return err
}
units = append ( units , models . RepoUnit {
RepoID : repo . ID ,
2021-11-09 14:57:58 -05:00
Type : unit_model . TypeExternalWiki ,
2019-10-02 05:30:41 -04:00
Config : & models . ExternalWikiConfig {
ExternalWikiURL : opts . ExternalWiki . ExternalWikiURL ,
} ,
} )
2021-11-09 14:57:58 -05:00
deleteUnitTypes = append ( deleteUnitTypes , unit_model . TypeWiki )
} else if * opts . HasWiki && opts . ExternalWiki == nil && ! unit_model . TypeWiki . UnitGlobalDisabled ( ) {
2019-10-02 05:30:41 -04:00
config := & models . UnitConfig { }
units = append ( units , models . RepoUnit {
RepoID : repo . ID ,
2021-11-09 14:57:58 -05:00
Type : unit_model . TypeWiki ,
2019-10-02 05:30:41 -04:00
Config : config ,
} )
2021-11-09 14:57:58 -05:00
deleteUnitTypes = append ( deleteUnitTypes , unit_model . TypeExternalWiki )
2020-01-17 02:34:37 -05:00
} else if ! * opts . HasWiki {
2021-11-09 14:57:58 -05:00
if ! unit_model . TypeExternalWiki . UnitGlobalDisabled ( ) {
deleteUnitTypes = append ( deleteUnitTypes , unit_model . TypeExternalWiki )
2020-01-17 02:34:37 -05:00
}
2021-11-09 14:57:58 -05:00
if ! unit_model . TypeWiki . UnitGlobalDisabled ( ) {
deleteUnitTypes = append ( deleteUnitTypes , unit_model . TypeWiki )
2020-01-17 02:34:37 -05:00
}
2019-10-02 05:30:41 -04:00
}
2019-05-30 11:09:05 -04:00
}
2020-01-17 02:34:37 -05:00
if opts . HasPullRequests != nil {
2021-11-09 14:57:58 -05:00
if * opts . HasPullRequests && ! unit_model . TypePullRequests . UnitGlobalDisabled ( ) {
2020-01-17 02:34:37 -05:00
// We do allow setting individual PR settings through the API, so
// we get the config settings and then set them
// if those settings were provided in the opts.
2021-11-09 14:57:58 -05:00
unit , err := repo . GetUnit ( unit_model . TypePullRequests )
2020-01-17 02:34:37 -05:00
var config * models . PullRequestsConfig
if err != nil {
// Unit type doesn't exist so we make a new config file with default values
config = & models . PullRequestsConfig {
2021-07-12 19:26:25 -04:00
IgnoreWhitespaceConflicts : false ,
AllowMerge : true ,
AllowRebase : true ,
AllowRebaseMerge : true ,
AllowSquash : true ,
AllowManualMerge : true ,
AutodetectManualMerge : false ,
DefaultDeleteBranchAfterMerge : false ,
DefaultMergeStyle : models . MergeStyleMerge ,
2020-01-17 02:34:37 -05:00
}
} else {
config = unit . PullRequestsConfig ( )
2019-05-30 11:09:05 -04:00
}
2020-01-17 02:34:37 -05:00
if opts . IgnoreWhitespaceConflicts != nil {
config . IgnoreWhitespaceConflicts = * opts . IgnoreWhitespaceConflicts
}
if opts . AllowMerge != nil {
config . AllowMerge = * opts . AllowMerge
}
if opts . AllowRebase != nil {
config . AllowRebase = * opts . AllowRebase
}
if opts . AllowRebaseMerge != nil {
config . AllowRebaseMerge = * opts . AllowRebaseMerge
}
if opts . AllowSquash != nil {
config . AllowSquash = * opts . AllowSquash
}
2021-03-03 22:41:23 -05:00
if opts . AllowManualMerge != nil {
config . AllowManualMerge = * opts . AllowManualMerge
}
if opts . AutodetectManualMerge != nil {
config . AutodetectManualMerge = * opts . AutodetectManualMerge
}
2021-07-12 19:26:25 -04:00
if opts . DefaultDeleteBranchAfterMerge != nil {
config . DefaultDeleteBranchAfterMerge = * opts . DefaultDeleteBranchAfterMerge
}
2021-03-27 10:55:40 -04:00
if opts . DefaultMergeStyle != nil {
config . DefaultMergeStyle = models . MergeStyle ( * opts . DefaultMergeStyle )
}
2019-08-10 05:32:46 -04:00
2020-01-17 02:34:37 -05:00
units = append ( units , models . RepoUnit {
RepoID : repo . ID ,
2021-11-09 14:57:58 -05:00
Type : unit_model . TypePullRequests ,
2020-01-17 02:34:37 -05:00
Config : config ,
} )
2021-11-09 14:57:58 -05:00
} else if ! * opts . HasPullRequests && ! unit_model . TypePullRequests . UnitGlobalDisabled ( ) {
deleteUnitTypes = append ( deleteUnitTypes , unit_model . TypePullRequests )
2020-01-17 02:34:37 -05:00
}
2019-05-30 11:09:05 -04:00
}
2021-11-09 14:57:58 -05:00
if opts . HasProjects != nil && ! unit_model . TypeProjects . UnitGlobalDisabled ( ) {
2020-08-16 23:07:38 -04:00
if * opts . HasProjects {
units = append ( units , models . RepoUnit {
RepoID : repo . ID ,
2021-11-09 14:57:58 -05:00
Type : unit_model . TypeProjects ,
2020-08-16 23:07:38 -04:00
} )
} else {
2021-11-09 14:57:58 -05:00
deleteUnitTypes = append ( deleteUnitTypes , unit_model . TypeProjects )
2020-08-16 23:07:38 -04:00
}
}
2020-01-17 02:34:37 -05:00
if err := models . UpdateRepositoryUnits ( repo , units , deleteUnitTypes ) ; err != nil {
2019-05-30 11:09:05 -04:00
ctx . Error ( http . StatusInternalServerError , "UpdateRepositoryUnits" , err )
return err
}
log . Trace ( "Repository advanced settings updated: %s/%s" , owner . Name , repo . Name )
return nil
}
// updateRepoArchivedState updates repo's archive state
func updateRepoArchivedState ( ctx * context . APIContext , opts api . EditRepoOption ) error {
repo := ctx . Repo . Repository
// archive / un-archive
if opts . Archived != nil {
if repo . IsMirror {
err := fmt . Errorf ( "repo is a mirror, cannot archive/un-archive" )
ctx . Error ( http . StatusUnprocessableEntity , err . Error ( ) , err )
return err
}
if * opts . Archived {
if err := repo . SetArchiveRepoState ( * opts . Archived ) ; err != nil {
log . Error ( "Tried to archive a repo: %s" , err )
ctx . Error ( http . StatusInternalServerError , "ArchiveRepoState" , err )
return err
}
log . Trace ( "Repository was archived: %s/%s" , ctx . Repo . Owner . Name , repo . Name )
} else {
if err := repo . SetArchiveRepoState ( * opts . Archived ) ; err != nil {
log . Error ( "Tried to un-archive a repo: %s" , err )
ctx . Error ( http . StatusInternalServerError , "ArchiveRepoState" , err )
return err
}
log . Trace ( "Repository was un-archived: %s/%s" , ctx . Repo . Owner . Name , repo . Name )
}
}
return nil
}
2021-01-02 18:47:47 -05:00
// updateMirrorInterval updates the repo's mirror Interval
func updateMirrorInterval ( ctx * context . APIContext , opts api . EditRepoOption ) error {
repo := ctx . Repo . Repository
if opts . MirrorInterval != nil {
if ! repo . IsMirror {
err := fmt . Errorf ( "repo is not a mirror, can not change mirror interval" )
ctx . Error ( http . StatusUnprocessableEntity , err . Error ( ) , err )
return err
}
if err := repo . GetMirror ( ) ; err != nil {
log . Error ( "Failed to get mirror: %s" , err )
ctx . Error ( http . StatusInternalServerError , "MirrorInterval" , err )
return err
}
if interval , err := time . ParseDuration ( * opts . MirrorInterval ) ; err == nil {
repo . Mirror . Interval = interval
if err := models . UpdateMirror ( repo . Mirror ) ; err != nil {
log . Error ( "Failed to Set Mirror Interval: %s" , err )
ctx . Error ( http . StatusUnprocessableEntity , "MirrorInterval" , err )
return err
}
log . Trace ( "Repository %s/%s Mirror Interval was Updated to %s" , ctx . Repo . Owner . Name , repo . Name , interval )
} else {
log . Error ( "Wrong format for MirrorInternal Sent: %s" , err )
ctx . Error ( http . StatusUnprocessableEntity , "MirrorInterval" , err )
return err
}
}
return nil
}
2016-10-07 13:17:27 -04:00
// Delete one repository
2016-03-13 18:49:16 -04:00
func Delete ( ctx * context . APIContext ) {
2017-11-13 02:02:25 -05:00
// swagger:operation DELETE /repos/{owner}/{repo} repository repoDelete
// ---
// summary: Delete a repository
// produces:
// - application/json
// parameters:
// - name: owner
// in: path
// description: owner of the repo to delete
// type: string
// required: true
// - name: repo
// in: path
// description: name of the repo to delete
// type: string
// required: true
// responses:
// "204":
// "$ref": "#/responses/empty"
// "403":
// "$ref": "#/responses/forbidden"
2019-12-20 12:07:12 -05:00
2016-11-14 17:33:58 -05:00
owner := ctx . Repo . Owner
repo := ctx . Repo . Repository
2015-10-04 11:09:16 -04:00
2019-10-26 02:54:11 -04:00
canDelete , err := repo . CanUserDelete ( ctx . User )
if err != nil {
2019-12-20 12:07:12 -05:00
ctx . Error ( http . StatusInternalServerError , "CanUserDelete" , err )
2019-10-26 02:54:11 -04:00
return
} else if ! canDelete {
2019-12-20 12:07:12 -05:00
ctx . Error ( http . StatusForbidden , "" , "Given user is not owner of organization." )
2019-10-26 02:54:11 -04:00
return
2015-10-04 11:09:16 -04:00
}
2021-05-14 16:19:38 -04:00
if ctx . Repo . GitRepo != nil {
ctx . Repo . GitRepo . Close ( )
}
2019-10-26 02:54:11 -04:00
if err := repo_service . DeleteRepository ( ctx . User , repo ) ; err != nil {
2019-12-20 12:07:12 -05:00
ctx . Error ( http . StatusInternalServerError , "DeleteRepository" , err )
2015-10-04 11:09:16 -04:00
return
}
2015-10-22 17:46:07 -04:00
log . Trace ( "Repository deleted: %s/%s" , owner . Name , repo . Name )
2019-12-20 12:07:12 -05:00
ctx . Status ( http . StatusNoContent )
2015-10-04 11:09:16 -04:00
}
2020-09-11 10:48:39 -04:00
// GetIssueTemplates returns the issue templates for a repository
func GetIssueTemplates ( ctx * context . APIContext ) {
// swagger:operation GET /repos/{owner}/{repo}/issue_templates repository repoGetIssueTemplates
// ---
// summary: Get available issue templates for 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
// responses:
// "200":
// "$ref": "#/responses/IssueTemplates"
ctx . JSON ( http . StatusOK , ctx . IssueTemplatesFromDefaultBranch ( ) )
}