2016-08-25 01:18:56 +03:00
// 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 repo
import (
2016-08-25 02:05:56 +03:00
"time"
2016-11-10 19:24:48 +03:00
"code.gitea.io/gitea/models"
"code.gitea.io/gitea/modules/context"
2019-05-11 13:21:34 +03:00
api "code.gitea.io/gitea/modules/structs"
2019-08-15 17:46:21 +03:00
"code.gitea.io/gitea/modules/timeutil"
2016-08-25 01:18:56 +03:00
)
2019-06-06 03:37:45 +03:00
// ListMilestones list milestones for a repository
2016-08-25 01:18:56 +03:00
func ListMilestones ( ctx * context . APIContext ) {
2018-06-12 17:59:22 +03:00
// swagger:operation GET /repos/{owner}/{repo}/milestones issue issueGetMilestonesList
2017-11-13 10:02:25 +03:00
// ---
2018-11-26 11:45:42 +03:00
// summary: Get all of a repository's opened milestones
2017-11-13 10:02:25 +03:00
// produces:
// - application/json
2018-06-12 17:59:22 +03:00
// 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
2019-06-06 03:37:45 +03:00
// - name: state
// in: query
// description: Milestone state, Recognised values are open, closed and all. Defaults to "open"
// type: string
2017-11-13 10:02:25 +03:00
// responses:
// "200":
2018-06-12 17:59:22 +03:00
// "$ref": "#/responses/MilestoneList"
2019-06-06 03:37:45 +03:00
milestones , err := models . GetMilestonesByRepoID ( ctx . Repo . Repository . ID , api . StateType ( ctx . Query ( "state" ) ) )
2016-08-25 01:18:56 +03:00
if err != nil {
2016-08-25 02:05:56 +03:00
ctx . Error ( 500 , "GetMilestonesByRepoID" , err )
2016-08-25 01:18:56 +03:00
return
}
apiMilestones := make ( [ ] * api . Milestone , len ( milestones ) )
for i := range milestones {
2016-08-25 02:05:56 +03:00
apiMilestones [ i ] = milestones [ i ] . APIFormat ( )
2016-08-25 01:18:56 +03:00
}
ctx . JSON ( 200 , & apiMilestones )
}
2016-11-24 10:04:31 +03:00
// GetMilestone get a milestone for a repository
2016-08-25 01:18:56 +03:00
func GetMilestone ( ctx * context . APIContext ) {
2018-06-12 17:59:22 +03:00
// swagger:operation GET /repos/{owner}/{repo}/milestones/{id} issue issueGetMilestone
2017-11-13 10:02:25 +03:00
// ---
2018-06-12 17:59:22 +03:00
// summary: Get a milestone
2017-11-13 10:02:25 +03:00
// 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: id
// in: path
2018-06-12 17:59:22 +03:00
// description: id of the milestone
2017-11-13 10:02:25 +03:00
// type: integer
2018-10-21 06:40:42 +03:00
// format: int64
2017-11-13 10:02:25 +03:00
// required: true
// responses:
// "200":
2018-06-12 17:59:22 +03:00
// "$ref": "#/responses/Milestone"
2016-08-25 02:05:56 +03:00
milestone , err := models . GetMilestoneByRepoID ( ctx . Repo . Repository . ID , ctx . ParamsInt64 ( ":id" ) )
2016-08-25 01:18:56 +03:00
if err != nil {
if models . IsErrMilestoneNotExist ( err ) {
2019-03-19 05:29:43 +03:00
ctx . NotFound ( )
2016-08-25 01:18:56 +03:00
} else {
2016-08-25 02:05:56 +03:00
ctx . Error ( 500 , "GetMilestoneByRepoID" , err )
2016-08-25 01:18:56 +03:00
}
return
}
2016-08-25 02:05:56 +03:00
ctx . JSON ( 200 , milestone . APIFormat ( ) )
2016-08-25 01:18:56 +03:00
}
2016-11-24 10:04:31 +03:00
// CreateMilestone create a milestone for a repository
2016-08-25 01:18:56 +03:00
func CreateMilestone ( ctx * context . APIContext , form api . CreateMilestoneOption ) {
2017-11-13 10:02:25 +03:00
// swagger:operation POST /repos/{owner}/{repo}/milestones issue issueCreateMilestone
// ---
// summary: Create a milestone
// consumes:
// - application/json
// 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: body
// in: body
// schema:
// "$ref": "#/definitions/CreateMilestoneOption"
// responses:
// "201":
// "$ref": "#/responses/Milestone"
2016-08-25 01:18:56 +03:00
if form . Deadline == nil {
defaultDeadline , _ := time . ParseInLocation ( "2006-01-02" , "9999-12-31" , time . Local )
form . Deadline = & defaultDeadline
}
milestone := & models . Milestone {
2017-12-11 07:37:04 +03:00
RepoID : ctx . Repo . Repository . ID ,
Name : form . Title ,
Content : form . Description ,
2019-08-15 17:46:21 +03:00
DeadlineUnix : timeutil . TimeStamp ( form . Deadline . Unix ( ) ) ,
2016-08-25 01:18:56 +03:00
}
if err := models . NewMilestone ( milestone ) ; err != nil {
ctx . Error ( 500 , "NewMilestone" , err )
return
}
2016-08-25 02:05:56 +03:00
ctx . JSON ( 201 , milestone . APIFormat ( ) )
2016-08-25 01:18:56 +03:00
}
2016-11-24 10:04:31 +03:00
// EditMilestone modify a milestone for a repository
2016-08-25 01:18:56 +03:00
func EditMilestone ( ctx * context . APIContext , form api . EditMilestoneOption ) {
2017-11-13 10:02:25 +03:00
// swagger:operation PATCH /repos/{owner}/{repo}/milestones/{id} issue issueEditMilestone
// ---
// summary: Update a milestone
// consumes:
// - application/json
// 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
2018-06-12 17:59:22 +03:00
// - name: id
// in: path
// description: id of the milestone
// type: integer
2018-10-21 06:40:42 +03:00
// format: int64
2018-06-12 17:59:22 +03:00
// required: true
2017-11-13 10:02:25 +03:00
// - name: body
// in: body
// schema:
// "$ref": "#/definitions/EditMilestoneOption"
// responses:
// "200":
// "$ref": "#/responses/Milestone"
2016-08-25 02:05:56 +03:00
milestone , err := models . GetMilestoneByRepoID ( ctx . Repo . Repository . ID , ctx . ParamsInt64 ( ":id" ) )
2016-08-25 01:18:56 +03:00
if err != nil {
if models . IsErrMilestoneNotExist ( err ) {
2019-03-19 05:29:43 +03:00
ctx . NotFound ( )
2016-08-25 01:18:56 +03:00
} else {
2016-08-25 02:05:56 +03:00
ctx . Error ( 500 , "GetMilestoneByRepoID" , err )
2016-08-25 01:18:56 +03:00
}
return
}
if len ( form . Title ) > 0 {
milestone . Name = form . Title
}
2016-08-25 02:05:56 +03:00
if form . Description != nil {
milestone . Content = * form . Description
2016-08-25 01:18:56 +03:00
}
2016-08-25 02:05:56 +03:00
if form . Deadline != nil && ! form . Deadline . IsZero ( ) {
2019-08-15 17:46:21 +03:00
milestone . DeadlineUnix = timeutil . TimeStamp ( form . Deadline . Unix ( ) )
2016-08-25 01:18:56 +03:00
}
2016-08-25 02:05:56 +03:00
2016-08-25 01:18:56 +03:00
if err := models . UpdateMilestone ( milestone ) ; err != nil {
2018-01-11 00:34:17 +03:00
ctx . ServerError ( "UpdateMilestone" , err )
2016-08-25 01:18:56 +03:00
return
}
2016-08-25 02:05:56 +03:00
ctx . JSON ( 200 , milestone . APIFormat ( ) )
2016-08-25 01:18:56 +03:00
}
2016-11-24 10:04:31 +03:00
// DeleteMilestone delete a milestone for a repository
2016-08-25 01:18:56 +03:00
func DeleteMilestone ( ctx * context . APIContext ) {
2017-11-13 10:02:25 +03:00
// swagger:operation DELETE /repos/{owner}/{repo}/milestones/{id} issue issueDeleteMilestone
// ---
// summary: Delete a milestone
// 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
2018-06-12 17:59:22 +03:00
// - name: id
2017-11-13 10:02:25 +03:00
// in: path
// description: id of the milestone to delete
// type: integer
2018-10-21 06:40:42 +03:00
// format: int64
2017-11-13 10:02:25 +03:00
// required: true
// responses:
// "204":
// "$ref": "#/responses/empty"
2016-08-25 02:05:56 +03:00
if err := models . DeleteMilestoneByRepoID ( ctx . Repo . Repository . ID , ctx . ParamsInt64 ( ":id" ) ) ; err != nil {
ctx . Error ( 500 , "DeleteMilestoneByRepoID" , err )
2016-08-25 01:18:56 +03:00
return
}
ctx . Status ( 204 )
}