update swagger for explore code

Author: knudtty

modules/structs/explore.go

@@ -3,7 +3,7 @@
 
 package structs // import "code.gitea.io/gitea/modules/structs"
 
-// ExploreCodeSearchItem A single search match
+// ExploreCodeSearchItem A code search match
 // swagger:model
 type ExploreCodeSearchItem struct {
 	RepoName   string `json:"repoName"`
@@ -12,7 +12,7 @@ type ExploreCodeSearchItem struct {
 	LineText   string `json:"lineText"`
 }
 
-// ExploreCodeResult all returned search results
+// ExploreCodeResult all returned code search results
 // swagger:model
 type ExploreCodeResult struct {
 	Total   int                     `json:"total"`

routers/api/v1/explore/code.go

@@ -17,18 +17,43 @@ import (
 
 // Code explore code
 func Code(ctx *context.APIContext) {
+	// swagger:operation GET /explore/code explore codeSearch
+	// ---
+	// summary: Search for code
+	// produces:
+	// - application/json
+	// parameters:
+	// - name: q
+	//   in: query
+	//   description: keyword
+	//   type: string
+	// - name: page
+	//   in: query
+	//   description: page number of results to return (1-based)
+	//   type: integer
+	// - name: fuzzy
+	//   in: query
+	//   description: whether to search fuzzy or strict
+	//   type: boolean
+	// responses:
+	//   "200":
+	//     description: "SearchResults of a successful search"
+	//     schema:
+	//			 "$ref": "#/definitions/ExploreCodeResult"
 	if !setting.Indexer.RepoIndexerEnabled {
 		ctx.NotFound("Indexer not enabled")
 		return
 	}
 
-	language := ctx.FormTrim("l")
 	keyword := ctx.FormTrim("q")
 
 	isFuzzy := ctx.FormOptionalBool("fuzzy").ValueOrDefault(true)
 
 	if keyword == "" {
-		ctx.JSON(http.StatusInternalServerError, api.SearchError{OK: false, Error: "No keyword provided"})
+		ctx.JSON(http.StatusInternalServerError, api.SearchError{
+			OK:    false,
+			Error: "No keyword provided",
+		})
 		return
 	}
 
@@ -50,7 +75,10 @@ func Code(ctx *context.APIContext) {
 	if ctx.Doer == nil || !isAdmin {
 		repoIDs, err = repo_model.FindUserCodeAccessibleRepoIDs(ctx, ctx.Doer)
 		if err != nil {
-			ctx.ServerError("FindUserCodeAccessibleRepoIDs", err)
+			ctx.JSON(http.StatusInternalServerError, api.SearchError{
+				OK:    false,
+				Error: err.Error(),
+			})
 			return
 		}
 	}
@@ -67,15 +95,17 @@ func Code(ctx *context.APIContext) {
 			Keyword:        keyword,
 			IsKeywordFuzzy: isFuzzy,
 			IsHtmlSafe:     false,
-			Language:       language,
 			Paginator: &db.ListOptions{
 				Page:     page,
 				PageSize: setting.API.DefaultPagingNum,
 			},
 		})
 		if err != nil {
 			if code_indexer.IsAvailable(ctx) {
-				ctx.ServerError("SearchResults", err)
+				ctx.JSON(http.StatusInternalServerError, api.SearchError{
+					OK:    false,
+					Error: err.Error(),
+				})
 				return
 			}
 		}
@@ -96,7 +126,10 @@ func Code(ctx *context.APIContext) {
 
 		repoMaps, err = repo_model.GetRepositoriesMapByIDs(ctx, loadRepoIDs)
 		if err != nil {
-			ctx.ServerError("GetRepositoriesMapByIDs", err)
+			ctx.JSON(http.StatusInternalServerError, api.SearchError{
+				OK:    false,
+				Error: err.Error(),
+			})
 			return
 		}
 

routers/api/v1/swagger/explore.go

@@ -0,0 +1,15 @@
+// Copyright 2024 The Gitea Authors. All rights reserved.
+// SPDX-License-Identifier: MIT
+
+package swagger
+
+import (
+	api "code.gitea.io/gitea/modules/structs"
+)
+
+// ExploreCode
+// swagger:response ExploreCode
+type swaggerResponseExploreCode struct {
+	// out:body
+	Body api.ExploreCodeResult  `json:"body"`
+}

services/convert/explore.go

@@ -15,7 +15,7 @@ func ToExploreCodeSearchResults(total int, results []*code_indexer.Result, repoM
 		if repo := repoMaps[res.RepoID]; repo != nil {
 			for _, r := range res.Lines {
 				out.Results = append(out.Results, api.ExploreCodeSearchItem{
-					RepoName:   repo.Name,
+					RepoName:   repo.FullName(),
 					FilePath:   res.Filename,
 					LineNumber: r.Num,
 					LineText:   r.RawContent,