2016-08-25 06:18:56 +08:00
|
|
|
// Copyright 2016 The Gogs Authors. All rights reserved.
|
2020-01-25 03:00:29 +08:00
|
|
|
// Copyright 2020 The Gitea Authors.
|
2016-08-25 06:18:56 +08:00
|
|
|
// Use of this source code is governed by a MIT-style
|
|
|
|
// license that can be found in the LICENSE file.
|
|
|
|
|
|
|
|
package repo
|
|
|
|
|
|
|
|
import (
|
2019-12-21 01:07:12 +08:00
|
|
|
"net/http"
|
2016-08-25 07:05:56 +08:00
|
|
|
"time"
|
|
|
|
|
2016-11-11 00:24:48 +08:00
|
|
|
"code.gitea.io/gitea/models"
|
|
|
|
"code.gitea.io/gitea/modules/context"
|
2020-05-13 05:54:35 +08:00
|
|
|
"code.gitea.io/gitea/modules/convert"
|
2019-05-11 18:21:34 +08:00
|
|
|
api "code.gitea.io/gitea/modules/structs"
|
2019-08-15 22:46:21 +08:00
|
|
|
"code.gitea.io/gitea/modules/timeutil"
|
2020-01-25 03:00:29 +08:00
|
|
|
"code.gitea.io/gitea/routers/api/v1/utils"
|
2016-08-25 06:18:56 +08:00
|
|
|
)
|
|
|
|
|
2019-06-06 08:37:45 +08:00
|
|
|
// ListMilestones list milestones for a repository
|
2016-08-25 06:18:56 +08:00
|
|
|
func ListMilestones(ctx *context.APIContext) {
|
2018-06-12 22:59:22 +08:00
|
|
|
// swagger:operation GET /repos/{owner}/{repo}/milestones issue issueGetMilestonesList
|
2017-11-13 15:02:25 +08:00
|
|
|
// ---
|
2018-11-26 16:45:42 +08:00
|
|
|
// summary: Get all of a repository's opened milestones
|
2017-11-13 15:02:25 +08:00
|
|
|
// produces:
|
|
|
|
// - application/json
|
2018-06-12 22:59:22 +08: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 08:37:45 +08:00
|
|
|
// - name: state
|
|
|
|
// in: query
|
|
|
|
// description: Milestone state, Recognised values are open, closed and all. Defaults to "open"
|
|
|
|
// type: string
|
2020-01-25 03:00:29 +08:00
|
|
|
// - name: page
|
|
|
|
// in: query
|
|
|
|
// description: page number of results to return (1-based)
|
|
|
|
// type: integer
|
|
|
|
// - name: limit
|
|
|
|
// in: query
|
2020-06-09 12:57:38 +08:00
|
|
|
// description: page size of results
|
2020-01-25 03:00:29 +08:00
|
|
|
// type: integer
|
2017-11-13 15:02:25 +08:00
|
|
|
// responses:
|
|
|
|
// "200":
|
2018-06-12 22:59:22 +08:00
|
|
|
// "$ref": "#/responses/MilestoneList"
|
2019-12-21 01:07:12 +08:00
|
|
|
|
2020-01-25 03:00:29 +08:00
|
|
|
milestones, err := models.GetMilestonesByRepoID(ctx.Repo.Repository.ID, api.StateType(ctx.Query("state")), utils.GetListOptions(ctx))
|
2016-08-25 06:18:56 +08:00
|
|
|
if err != nil {
|
2019-12-21 01:07:12 +08:00
|
|
|
ctx.Error(http.StatusInternalServerError, "GetMilestonesByRepoID", err)
|
2016-08-25 06:18:56 +08:00
|
|
|
return
|
|
|
|
}
|
|
|
|
|
|
|
|
apiMilestones := make([]*api.Milestone, len(milestones))
|
|
|
|
for i := range milestones {
|
2020-05-13 05:54:35 +08:00
|
|
|
apiMilestones[i] = convert.ToAPIMilestone(milestones[i])
|
2016-08-25 06:18:56 +08:00
|
|
|
}
|
2019-12-21 01:07:12 +08:00
|
|
|
ctx.JSON(http.StatusOK, &apiMilestones)
|
2016-08-25 06:18:56 +08:00
|
|
|
}
|
|
|
|
|
2016-11-24 15:04:31 +08:00
|
|
|
// GetMilestone get a milestone for a repository
|
2016-08-25 06:18:56 +08:00
|
|
|
func GetMilestone(ctx *context.APIContext) {
|
2018-06-12 22:59:22 +08:00
|
|
|
// swagger:operation GET /repos/{owner}/{repo}/milestones/{id} issue issueGetMilestone
|
2017-11-13 15:02:25 +08:00
|
|
|
// ---
|
2018-06-12 22:59:22 +08:00
|
|
|
// summary: Get a milestone
|
2017-11-13 15:02:25 +08: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 22:59:22 +08:00
|
|
|
// description: id of the milestone
|
2017-11-13 15:02:25 +08:00
|
|
|
// type: integer
|
2018-10-21 11:40:42 +08:00
|
|
|
// format: int64
|
2017-11-13 15:02:25 +08:00
|
|
|
// required: true
|
|
|
|
// responses:
|
|
|
|
// "200":
|
2018-06-12 22:59:22 +08:00
|
|
|
// "$ref": "#/responses/Milestone"
|
2019-12-21 01:07:12 +08:00
|
|
|
|
2016-08-25 07:05:56 +08:00
|
|
|
milestone, err := models.GetMilestoneByRepoID(ctx.Repo.Repository.ID, ctx.ParamsInt64(":id"))
|
2016-08-25 06:18:56 +08:00
|
|
|
if err != nil {
|
|
|
|
if models.IsErrMilestoneNotExist(err) {
|
2019-03-19 10:29:43 +08:00
|
|
|
ctx.NotFound()
|
2016-08-25 06:18:56 +08:00
|
|
|
} else {
|
2019-12-21 01:07:12 +08:00
|
|
|
ctx.Error(http.StatusInternalServerError, "GetMilestoneByRepoID", err)
|
2016-08-25 06:18:56 +08:00
|
|
|
}
|
|
|
|
return
|
|
|
|
}
|
2020-05-13 05:54:35 +08:00
|
|
|
ctx.JSON(http.StatusOK, convert.ToAPIMilestone(milestone))
|
2016-08-25 06:18:56 +08:00
|
|
|
}
|
|
|
|
|
2016-11-24 15:04:31 +08:00
|
|
|
// CreateMilestone create a milestone for a repository
|
2016-08-25 06:18:56 +08:00
|
|
|
func CreateMilestone(ctx *context.APIContext, form api.CreateMilestoneOption) {
|
2017-11-13 15:02:25 +08: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"
|
2019-12-21 01:07:12 +08:00
|
|
|
|
2016-08-25 06:18:56 +08: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 12:37:04 +08:00
|
|
|
RepoID: ctx.Repo.Repository.ID,
|
|
|
|
Name: form.Title,
|
|
|
|
Content: form.Description,
|
2019-08-15 22:46:21 +08:00
|
|
|
DeadlineUnix: timeutil.TimeStamp(form.Deadline.Unix()),
|
2016-08-25 06:18:56 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
if err := models.NewMilestone(milestone); err != nil {
|
2019-12-21 01:07:12 +08:00
|
|
|
ctx.Error(http.StatusInternalServerError, "NewMilestone", err)
|
2016-08-25 06:18:56 +08:00
|
|
|
return
|
|
|
|
}
|
2020-05-13 05:54:35 +08:00
|
|
|
ctx.JSON(http.StatusCreated, convert.ToAPIMilestone(milestone))
|
2016-08-25 06:18:56 +08:00
|
|
|
}
|
|
|
|
|
2016-11-24 15:04:31 +08:00
|
|
|
// EditMilestone modify a milestone for a repository
|
2016-08-25 06:18:56 +08:00
|
|
|
func EditMilestone(ctx *context.APIContext, form api.EditMilestoneOption) {
|
2017-11-13 15:02:25 +08: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 22:59:22 +08:00
|
|
|
// - name: id
|
|
|
|
// in: path
|
|
|
|
// description: id of the milestone
|
|
|
|
// type: integer
|
2018-10-21 11:40:42 +08:00
|
|
|
// format: int64
|
2018-06-12 22:59:22 +08:00
|
|
|
// required: true
|
2017-11-13 15:02:25 +08:00
|
|
|
// - name: body
|
|
|
|
// in: body
|
|
|
|
// schema:
|
|
|
|
// "$ref": "#/definitions/EditMilestoneOption"
|
|
|
|
// responses:
|
|
|
|
// "200":
|
|
|
|
// "$ref": "#/responses/Milestone"
|
2019-12-21 01:07:12 +08:00
|
|
|
|
2016-08-25 07:05:56 +08:00
|
|
|
milestone, err := models.GetMilestoneByRepoID(ctx.Repo.Repository.ID, ctx.ParamsInt64(":id"))
|
2016-08-25 06:18:56 +08:00
|
|
|
if err != nil {
|
|
|
|
if models.IsErrMilestoneNotExist(err) {
|
2019-03-19 10:29:43 +08:00
|
|
|
ctx.NotFound()
|
2016-08-25 06:18:56 +08:00
|
|
|
} else {
|
2019-12-21 01:07:12 +08:00
|
|
|
ctx.Error(http.StatusInternalServerError, "GetMilestoneByRepoID", err)
|
2016-08-25 06:18:56 +08:00
|
|
|
}
|
|
|
|
return
|
|
|
|
}
|
|
|
|
|
|
|
|
if len(form.Title) > 0 {
|
|
|
|
milestone.Name = form.Title
|
|
|
|
}
|
2016-08-25 07:05:56 +08:00
|
|
|
if form.Description != nil {
|
|
|
|
milestone.Content = *form.Description
|
2016-08-25 06:18:56 +08:00
|
|
|
}
|
2016-08-25 07:05:56 +08:00
|
|
|
if form.Deadline != nil && !form.Deadline.IsZero() {
|
2019-08-15 22:46:21 +08:00
|
|
|
milestone.DeadlineUnix = timeutil.TimeStamp(form.Deadline.Unix())
|
2016-08-25 06:18:56 +08:00
|
|
|
}
|
2016-08-25 07:05:56 +08:00
|
|
|
|
2020-01-29 14:36:32 +08:00
|
|
|
var oldIsClosed = milestone.IsClosed
|
|
|
|
if form.State != nil {
|
|
|
|
milestone.IsClosed = *form.State == string(api.StateClosed)
|
|
|
|
}
|
|
|
|
|
|
|
|
if err := models.UpdateMilestone(milestone, oldIsClosed); err != nil {
|
2018-01-11 05:34:17 +08:00
|
|
|
ctx.ServerError("UpdateMilestone", err)
|
2016-08-25 06:18:56 +08:00
|
|
|
return
|
|
|
|
}
|
2020-05-13 05:54:35 +08:00
|
|
|
ctx.JSON(http.StatusOK, convert.ToAPIMilestone(milestone))
|
2016-08-25 06:18:56 +08:00
|
|
|
}
|
|
|
|
|
2016-11-24 15:04:31 +08:00
|
|
|
// DeleteMilestone delete a milestone for a repository
|
2016-08-25 06:18:56 +08:00
|
|
|
func DeleteMilestone(ctx *context.APIContext) {
|
2017-11-13 15:02:25 +08: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 22:59:22 +08:00
|
|
|
// - name: id
|
2017-11-13 15:02:25 +08:00
|
|
|
// in: path
|
|
|
|
// description: id of the milestone to delete
|
|
|
|
// type: integer
|
2018-10-21 11:40:42 +08:00
|
|
|
// format: int64
|
2017-11-13 15:02:25 +08:00
|
|
|
// required: true
|
|
|
|
// responses:
|
|
|
|
// "204":
|
|
|
|
// "$ref": "#/responses/empty"
|
2019-12-21 01:07:12 +08:00
|
|
|
|
2016-08-25 07:05:56 +08:00
|
|
|
if err := models.DeleteMilestoneByRepoID(ctx.Repo.Repository.ID, ctx.ParamsInt64(":id")); err != nil {
|
2019-12-21 01:07:12 +08:00
|
|
|
ctx.Error(http.StatusInternalServerError, "DeleteMilestoneByRepoID", err)
|
2016-08-25 06:18:56 +08:00
|
|
|
return
|
|
|
|
}
|
2019-12-21 01:07:12 +08:00
|
|
|
ctx.Status(http.StatusNoContent)
|
2016-08-25 06:18:56 +08:00
|
|
|
}
|