// Copyright 2019 The Gitea 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 ( "errors" "fmt" "net/http" "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/web" "code.gitea.io/gitea/routers/api/v1/utils" releaseservice "code.gitea.io/gitea/services/release" ) // ListTags list all the tags of a repository func ListTags(ctx *context.APIContext) { // swagger:operation GET /repos/{owner}/{repo}/tags repository repoListTags // --- // summary: List a repository's tags // 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: page // in: query // description: page number of results to return (1-based) // type: integer // - name: limit // in: query // description: page size of results, default maximum page size is 50 // type: integer // responses: // "200": // "$ref": "#/responses/TagList" listOpts := utils.GetListOptions(ctx) tags, err := ctx.Repo.GitRepo.GetTagInfos(listOpts.Page, listOpts.PageSize) if err != nil { ctx.Error(http.StatusInternalServerError, "GetTags", err) return } apiTags := make([]*api.Tag, len(tags)) for i := range tags { apiTags[i] = convert.ToTag(ctx.Repo.Repository, tags[i]) } ctx.JSON(http.StatusOK, &apiTags) } // GetTag get the tag of a repository. func GetTag(ctx *context.APIContext) { // swagger:operation GET /repos/{owner}/{repo}/git/tags/{sha} repository GetTag // --- // summary: Gets the tag object of an annotated tag (not lightweight tags) // 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: sha // in: path // description: sha of the tag. The Git tags API only supports annotated tag objects, not lightweight tags. // type: string // required: true // responses: // "200": // "$ref": "#/responses/AnnotatedTag" // "400": // "$ref": "#/responses/error" sha := ctx.Params("sha") if len(sha) == 0 { ctx.Error(http.StatusBadRequest, "", "SHA not provided") return } if tag, err := ctx.Repo.GitRepo.GetAnnotatedTag(sha); err != nil { ctx.Error(http.StatusBadRequest, "GetTag", err) } else { commit, err := tag.Commit() if err != nil { ctx.Error(http.StatusBadRequest, "GetTag", err) } ctx.JSON(http.StatusOK, convert.ToAnnotatedTag(ctx.Repo.Repository, tag, commit)) } } // DeleteTag delete a specific tag of in a repository by name func DeleteTag(ctx *context.APIContext) { // swagger:operation DELETE /repos/{owner}/{repo}/tags/{tag} repository repoDeleteTag // --- // summary: Delete a repository's tag by name // 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: tag // in: path // description: name of tag to delete // type: string // required: true // responses: // "204": // "$ref": "#/responses/empty" // "404": // "$ref": "#/responses/notFound" // "409": // "$ref": "#/responses/conflict" tag, err := models.GetRelease(ctx.Repo.Repository.ID, ctx.Params("tag")) if err != nil { if models.IsErrReleaseNotExist(err) { ctx.NotFound() return } ctx.Error(http.StatusInternalServerError, "GetRelease", err) return } if !tag.IsTag { ctx.Error(http.StatusConflict, "IsTag", errors.New("a tag attached to a release cannot be deleted directly")) return } if err = releaseservice.DeleteReleaseByID(tag.ID, ctx.User, true); err != nil { ctx.Error(http.StatusInternalServerError, "DeleteReleaseByID", err) } ctx.Status(http.StatusNoContent) } // CreateTag create a new git tag in a repository func CreateTag(ctx *context.APIContext) { // swagger:operation POST /repos/{owner}/{repo}/tags repository repoCreateTag // --- // summary: Create a new git tag in 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 // - name: body // in: body // schema: // "$ref": "#/definitions/CreateTagOption" // responses: // "200": // "$ref": "#/responses/AnnotatedTag" // "404": // "$ref": "#/responses/notFound" // "409": // "$ref": "#/responses/conflict" form := web.GetForm(ctx).(*api.CreateTagOption) // If target is not provided use default branch if len(form.Target) == 0 { form.Target = ctx.Repo.Repository.DefaultBranch } commit, err := ctx.Repo.GitRepo.GetCommit(form.Target) if err != nil { ctx.Error(http.StatusNotFound, "target not found", fmt.Errorf("target not found: %v", err)) return } if err := releaseservice.CreateNewTag(ctx.User, ctx.Repo.Repository, commit.ID.String(), form.TagName, form.Message); err != nil { if models.IsErrTagAlreadyExists(err) { ctx.Error(http.StatusConflict, "tag exist", err) return } ctx.InternalServerError(err) return } tag, err := ctx.Repo.GitRepo.GetTag(form.TagName) if err != nil { ctx.InternalServerError(err) return } ctx.JSON(http.StatusCreated, convert.ToTag(ctx.Repo.Repository, tag)) }