123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291 |
- // 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"
- "strconv"
- "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/modules/web"
- "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, total, err := models.GetMilestones(models.GetMilestonesOption{
- ListOptions: utils.GetListOptions(ctx),
- RepoID: ctx.Repo.Repository.ID,
- State: api.StateType(ctx.FormString("state")),
- Name: ctx.FormString("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.SetTotalCountHeader(total)
- ctx.JSON(http.StatusOK, &apiMilestones)
- }
-
- // GetMilestone get a milestone for a repository by ID and if not available by name
- 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: the milestone to get, identified by ID and if not available by name
- // type: string
- // required: true
- // responses:
- // "200":
- // "$ref": "#/responses/Milestone"
-
- milestone := getMilestoneByIDOrName(ctx)
- if ctx.Written() {
- return
- }
-
- ctx.JSON(http.StatusOK, convert.ToAPIMilestone(milestone))
- }
-
- // CreateMilestone create a milestone for a repository
- func CreateMilestone(ctx *context.APIContext) {
- // 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"
- form := web.GetForm(ctx).(*api.CreateMilestoneOption)
-
- 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 by ID and if not available by name
- func EditMilestone(ctx *context.APIContext) {
- // 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: the milestone to edit, identified by ID and if not available by name
- // type: string
- // required: true
- // - name: body
- // in: body
- // schema:
- // "$ref": "#/definitions/EditMilestoneOption"
- // responses:
- // "200":
- // "$ref": "#/responses/Milestone"
- form := web.GetForm(ctx).(*api.EditMilestoneOption)
- milestone := getMilestoneByIDOrName(ctx)
- if ctx.Written() {
- 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.Error(http.StatusInternalServerError, "UpdateMilestone", err)
- return
- }
- ctx.JSON(http.StatusOK, convert.ToAPIMilestone(milestone))
- }
-
- // DeleteMilestone delete a milestone for a repository by ID and if not available by name
- 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: the milestone to delete, identified by ID and if not available by name
- // type: string
- // required: true
- // responses:
- // "204":
- // "$ref": "#/responses/empty"
-
- m := getMilestoneByIDOrName(ctx)
- if ctx.Written() {
- return
- }
-
- if err := models.DeleteMilestoneByRepoID(ctx.Repo.Repository.ID, m.ID); err != nil {
- ctx.Error(http.StatusInternalServerError, "DeleteMilestoneByRepoID", err)
- return
- }
- ctx.Status(http.StatusNoContent)
- }
-
- // getMilestoneByIDOrName get milestone by ID and if not available by name
- func getMilestoneByIDOrName(ctx *context.APIContext) *models.Milestone {
- mile := ctx.Params(":id")
- mileID, _ := strconv.ParseInt(mile, 0, 64)
-
- if mileID != 0 {
- milestone, err := models.GetMilestoneByRepoID(ctx.Repo.Repository.ID, mileID)
- if err == nil {
- return milestone
- } else if !models.IsErrMilestoneNotExist(err) {
- ctx.Error(http.StatusInternalServerError, "GetMilestoneByRepoID", err)
- return nil
- }
- }
-
- milestone, err := models.GetMilestoneByRepoIDANDName(ctx.Repo.Repository.ID, mile)
- if err != nil {
- if models.IsErrMilestoneNotExist(err) {
- ctx.NotFound()
- return nil
- }
- ctx.Error(http.StatusInternalServerError, "GetMilestoneByRepoID", err)
- return nil
- }
-
- return milestone
- }
|