123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295 |
- // 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 (
- "net/http"
- "strings"
-
- "code.gitea.io/gitea/models"
- "code.gitea.io/gitea/modules/context"
- "code.gitea.io/gitea/modules/convert"
- "code.gitea.io/gitea/modules/log"
- api "code.gitea.io/gitea/modules/structs"
- "code.gitea.io/gitea/modules/web"
- "code.gitea.io/gitea/routers/api/v1/utils"
- )
-
- // ListTopics returns list of current topics for repo
- func ListTopics(ctx *context.APIContext) {
- // swagger:operation GET /repos/{owner}/{repo}/topics repository repoListTopics
- // ---
- // summary: Get list of topics that a repository has
- // 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
- // type: integer
- // responses:
- // "200":
- // "$ref": "#/responses/TopicNames"
-
- opts := &models.FindTopicOptions{
- ListOptions: utils.GetListOptions(ctx),
- RepoID: ctx.Repo.Repository.ID,
- }
-
- topics, total, err := models.FindTopics(opts)
- if err != nil {
- ctx.InternalServerError(err)
- return
- }
-
- topicNames := make([]string, len(topics))
- for i, topic := range topics {
- topicNames[i] = topic.Name
- }
-
- ctx.SetTotalCountHeader(total)
- ctx.JSON(http.StatusOK, map[string]interface{}{
- "topics": topicNames,
- })
- }
-
- // UpdateTopics updates repo with a new set of topics
- func UpdateTopics(ctx *context.APIContext) {
- // swagger:operation PUT /repos/{owner}/{repo}/topics repository repoUpdateTopics
- // ---
- // summary: Replace list of topics for 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/RepoTopicOptions"
- // responses:
- // "204":
- // "$ref": "#/responses/empty"
- // "422":
- // "$ref": "#/responses/invalidTopicsError"
-
- form := web.GetForm(ctx).(*api.RepoTopicOptions)
- topicNames := form.Topics
- validTopics, invalidTopics := models.SanitizeAndValidateTopics(topicNames)
-
- if len(validTopics) > 25 {
- ctx.JSON(http.StatusUnprocessableEntity, map[string]interface{}{
- "invalidTopics": nil,
- "message": "Exceeding maximum number of topics per repo",
- })
- return
- }
-
- if len(invalidTopics) > 0 {
- ctx.JSON(http.StatusUnprocessableEntity, map[string]interface{}{
- "invalidTopics": invalidTopics,
- "message": "Topic names are invalid",
- })
- return
- }
-
- err := models.SaveTopics(ctx.Repo.Repository.ID, validTopics...)
- if err != nil {
- log.Error("SaveTopics failed: %v", err)
- ctx.InternalServerError(err)
- return
- }
-
- ctx.Status(http.StatusNoContent)
- }
-
- // AddTopic adds a topic name to a repo
- func AddTopic(ctx *context.APIContext) {
- // swagger:operation PUT /repos/{owner}/{repo}/topics/{topic} repository repoAddTopic
- // ---
- // summary: Add a topic to 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: topic
- // in: path
- // description: name of the topic to add
- // type: string
- // required: true
- // responses:
- // "204":
- // "$ref": "#/responses/empty"
- // "422":
- // "$ref": "#/responses/invalidTopicsError"
-
- topicName := strings.TrimSpace(strings.ToLower(ctx.Params(":topic")))
-
- if !models.ValidateTopic(topicName) {
- ctx.JSON(http.StatusUnprocessableEntity, map[string]interface{}{
- "invalidTopics": topicName,
- "message": "Topic name is invalid",
- })
- return
- }
-
- // Prevent adding more topics than allowed to repo
- count, err := models.CountTopics(&models.FindTopicOptions{
- RepoID: ctx.Repo.Repository.ID,
- })
- if err != nil {
- log.Error("CountTopics failed: %v", err)
- ctx.InternalServerError(err)
- return
- }
- if count >= 25 {
- ctx.JSON(http.StatusUnprocessableEntity, map[string]interface{}{
- "message": "Exceeding maximum allowed topics per repo.",
- })
- return
- }
-
- _, err = models.AddTopic(ctx.Repo.Repository.ID, topicName)
- if err != nil {
- log.Error("AddTopic failed: %v", err)
- ctx.InternalServerError(err)
- return
- }
-
- ctx.Status(http.StatusNoContent)
- }
-
- // DeleteTopic removes topic name from repo
- func DeleteTopic(ctx *context.APIContext) {
- // swagger:operation DELETE /repos/{owner}/{repo}/topics/{topic} repository repoDeleteTopic
- // ---
- // summary: Delete a topic from 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: topic
- // in: path
- // description: name of the topic to delete
- // type: string
- // required: true
- // responses:
- // "204":
- // "$ref": "#/responses/empty"
- // "422":
- // "$ref": "#/responses/invalidTopicsError"
-
- topicName := strings.TrimSpace(strings.ToLower(ctx.Params(":topic")))
-
- if !models.ValidateTopic(topicName) {
- ctx.JSON(http.StatusUnprocessableEntity, map[string]interface{}{
- "invalidTopics": topicName,
- "message": "Topic name is invalid",
- })
- return
- }
-
- topic, err := models.DeleteTopic(ctx.Repo.Repository.ID, topicName)
- if err != nil {
- log.Error("DeleteTopic failed: %v", err)
- ctx.InternalServerError(err)
- return
- }
-
- if topic == nil {
- ctx.NotFound()
- }
-
- ctx.Status(http.StatusNoContent)
- }
-
- // TopicSearch search for creating topic
- func TopicSearch(ctx *context.APIContext) {
- // swagger:operation GET /topics/search repository topicSearch
- // ---
- // summary: search topics via keyword
- // produces:
- // - application/json
- // parameters:
- // - name: q
- // in: query
- // description: keywords to search
- // required: true
- // 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/TopicListResponse"
- // "403":
- // "$ref": "#/responses/forbidden"
-
- opts := &models.FindTopicOptions{
- Keyword: ctx.FormString("q"),
- ListOptions: utils.GetListOptions(ctx),
- }
-
- topics, total, err := models.FindTopics(opts)
- if err != nil {
- ctx.InternalServerError(err)
- return
- }
-
- topicResponses := make([]*api.TopicResponse, len(topics))
- for i, topic := range topics {
- topicResponses[i] = convert.ToTopicResponse(topic)
- }
-
- ctx.SetTotalCountHeader(total)
- ctx.JSON(http.StatusOK, map[string]interface{}{
- "topics": topicResponses,
- })
- }
|