mirror of
https://gitee.com/gitea/gitea.git
synced 2024-12-05 13:19:00 +08:00
8bdc9795d8
Adds a name filter to the API for GetMilestoneList Includes a small refactor: merge GetMilestones and GetMilestonesByRepoID Close #12260 Needed for https://gitea.com/gitea/go-sdk/issues/383 and https://gitea.com/gitea/tea/pulls/149
266 lines
6.9 KiB
Go
266 lines
6.9 KiB
Go
// Copyright 2016 The Gogs Authors. All rights reserved.
|
|
// Copyright 2020 The Gitea Authors.
|
|
// Use of this source code is governed by a MIT-style
|
|
// license that can be found in the LICENSE file.
|
|
|
|
package repo
|
|
|
|
import (
|
|
"net/http"
|
|
"time"
|
|
|
|
"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/timeutil"
|
|
"code.gitea.io/gitea/routers/api/v1/utils"
|
|
)
|
|
|
|
// ListMilestones list milestones for a repository
|
|
func ListMilestones(ctx *context.APIContext) {
|
|
// swagger:operation GET /repos/{owner}/{repo}/milestones issue issueGetMilestonesList
|
|
// ---
|
|
// summary: Get all of a repository's opened milestones
|
|
// 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: state
|
|
// in: query
|
|
// description: Milestone state, Recognised values are open, closed and all. Defaults to "open"
|
|
// type: string
|
|
// - name: name
|
|
// in: query
|
|
// description: filter by milestone name
|
|
// type: string
|
|
// - 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/MilestoneList"
|
|
|
|
milestones, err := models.GetMilestones(models.GetMilestonesOption{
|
|
ListOptions: utils.GetListOptions(ctx),
|
|
RepoID: ctx.Repo.Repository.ID,
|
|
State: api.StateType(ctx.Query("state")),
|
|
Name: ctx.Query("name"),
|
|
})
|
|
if err != nil {
|
|
ctx.Error(http.StatusInternalServerError, "GetMilestones", err)
|
|
return
|
|
}
|
|
|
|
apiMilestones := make([]*api.Milestone, len(milestones))
|
|
for i := range milestones {
|
|
apiMilestones[i] = convert.ToAPIMilestone(milestones[i])
|
|
}
|
|
ctx.JSON(http.StatusOK, &apiMilestones)
|
|
}
|
|
|
|
// GetMilestone get a milestone for a repository
|
|
func GetMilestone(ctx *context.APIContext) {
|
|
// swagger:operation GET /repos/{owner}/{repo}/milestones/{id} issue issueGetMilestone
|
|
// ---
|
|
// summary: Get a milestone
|
|
// 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
|
|
// description: id of the milestone
|
|
// type: integer
|
|
// format: int64
|
|
// required: true
|
|
// responses:
|
|
// "200":
|
|
// "$ref": "#/responses/Milestone"
|
|
|
|
milestone, err := models.GetMilestoneByRepoID(ctx.Repo.Repository.ID, ctx.ParamsInt64(":id"))
|
|
if err != nil {
|
|
if models.IsErrMilestoneNotExist(err) {
|
|
ctx.NotFound()
|
|
} else {
|
|
ctx.Error(http.StatusInternalServerError, "GetMilestoneByRepoID", err)
|
|
}
|
|
return
|
|
}
|
|
ctx.JSON(http.StatusOK, convert.ToAPIMilestone(milestone))
|
|
}
|
|
|
|
// CreateMilestone create a milestone for a repository
|
|
func CreateMilestone(ctx *context.APIContext, form api.CreateMilestoneOption) {
|
|
// 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"
|
|
|
|
if form.Deadline == nil {
|
|
defaultDeadline, _ := time.ParseInLocation("2006-01-02", "9999-12-31", time.Local)
|
|
form.Deadline = &defaultDeadline
|
|
}
|
|
|
|
milestone := &models.Milestone{
|
|
RepoID: ctx.Repo.Repository.ID,
|
|
Name: form.Title,
|
|
Content: form.Description,
|
|
DeadlineUnix: timeutil.TimeStamp(form.Deadline.Unix()),
|
|
}
|
|
|
|
if form.State == "closed" {
|
|
milestone.IsClosed = true
|
|
milestone.ClosedDateUnix = timeutil.TimeStampNow()
|
|
}
|
|
|
|
if err := models.NewMilestone(milestone); err != nil {
|
|
ctx.Error(http.StatusInternalServerError, "NewMilestone", err)
|
|
return
|
|
}
|
|
ctx.JSON(http.StatusCreated, convert.ToAPIMilestone(milestone))
|
|
}
|
|
|
|
// EditMilestone modify a milestone for a repository
|
|
func EditMilestone(ctx *context.APIContext, form api.EditMilestoneOption) {
|
|
// 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
|
|
// - name: id
|
|
// in: path
|
|
// description: id of the milestone
|
|
// type: integer
|
|
// format: int64
|
|
// required: true
|
|
// - name: body
|
|
// in: body
|
|
// schema:
|
|
// "$ref": "#/definitions/EditMilestoneOption"
|
|
// responses:
|
|
// "200":
|
|
// "$ref": "#/responses/Milestone"
|
|
|
|
milestone, err := models.GetMilestoneByRepoID(ctx.Repo.Repository.ID, ctx.ParamsInt64(":id"))
|
|
if err != nil {
|
|
if models.IsErrMilestoneNotExist(err) {
|
|
ctx.NotFound()
|
|
} else {
|
|
ctx.Error(http.StatusInternalServerError, "GetMilestoneByRepoID", err)
|
|
}
|
|
return
|
|
}
|
|
|
|
if len(form.Title) > 0 {
|
|
milestone.Name = form.Title
|
|
}
|
|
if form.Description != nil {
|
|
milestone.Content = *form.Description
|
|
}
|
|
if form.Deadline != nil && !form.Deadline.IsZero() {
|
|
milestone.DeadlineUnix = timeutil.TimeStamp(form.Deadline.Unix())
|
|
}
|
|
|
|
var oldIsClosed = milestone.IsClosed
|
|
if form.State != nil {
|
|
milestone.IsClosed = *form.State == string(api.StateClosed)
|
|
}
|
|
|
|
if err := models.UpdateMilestone(milestone, oldIsClosed); err != nil {
|
|
ctx.ServerError("UpdateMilestone", err)
|
|
return
|
|
}
|
|
ctx.JSON(http.StatusOK, convert.ToAPIMilestone(milestone))
|
|
}
|
|
|
|
// DeleteMilestone delete a milestone for a repository
|
|
func DeleteMilestone(ctx *context.APIContext) {
|
|
// 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
|
|
// - name: id
|
|
// in: path
|
|
// description: id of the milestone to delete
|
|
// type: integer
|
|
// format: int64
|
|
// required: true
|
|
// responses:
|
|
// "204":
|
|
// "$ref": "#/responses/empty"
|
|
|
|
if err := models.DeleteMilestoneByRepoID(ctx.Repo.Repository.ID, ctx.ParamsInt64(":id")); err != nil {
|
|
ctx.Error(http.StatusInternalServerError, "DeleteMilestoneByRepoID", err)
|
|
return
|
|
}
|
|
ctx.Status(http.StatusNoContent)
|
|
}
|