// 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" "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/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) }