mirror of
				https://github.com/go-gitea/gitea.git
				synced 2025-10-31 21:28:11 +09:00 
			
		
		
		
	* use numbers and not http.Status___ enum
* fix test
* add many missing swagger responses
* code format
* Deletion Sould return 204 ...
* error handling improvements
* if special error type ... then add it to swagger too
* one smal nit
* invalidTopicsError is []string
* valid swagger specification 2.0
 - if you add responses swagger can tell you if you do it right 👍
* use ctx.InternalServerError
* Revert "use numbers and not http.Status___ enum"
This reverts commit b1ff386e24.
* use http.Status* enum everywhere
		
	
		
			
				
	
	
		
			121 lines
		
	
	
		
			3.2 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
			
		
		
	
	
			121 lines
		
	
	
		
			3.2 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
| // Copyright 2016 The Gogs Authors. All rights reserved.
 | |
| // 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"
 | |
| 
 | |
| 	"code.gitea.io/gitea/modules/context"
 | |
| 	"code.gitea.io/gitea/modules/convert"
 | |
| 	"code.gitea.io/gitea/modules/git"
 | |
| 	api "code.gitea.io/gitea/modules/structs"
 | |
| )
 | |
| 
 | |
| // GetBranch get a branch of a repository
 | |
| func GetBranch(ctx *context.APIContext) {
 | |
| 	// swagger:operation GET /repos/{owner}/{repo}/branches/{branch} repository repoGetBranch
 | |
| 	// ---
 | |
| 	// summary: Retrieve a specific branch from a repository, including its effective branch protection
 | |
| 	// 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: branch
 | |
| 	//   in: path
 | |
| 	//   description: branch to get
 | |
| 	//   type: string
 | |
| 	//   required: true
 | |
| 	// responses:
 | |
| 	//   "200":
 | |
| 	//     "$ref": "#/responses/Branch"
 | |
| 
 | |
| 	if ctx.Repo.TreePath != "" {
 | |
| 		// if TreePath != "", then URL contained extra slashes
 | |
| 		// (i.e. "master/subbranch" instead of "master"), so branch does
 | |
| 		// not exist
 | |
| 		ctx.NotFound()
 | |
| 		return
 | |
| 	}
 | |
| 	branch, err := ctx.Repo.Repository.GetBranch(ctx.Repo.BranchName)
 | |
| 	if err != nil {
 | |
| 		if git.IsErrBranchNotExist(err) {
 | |
| 			ctx.NotFound(err)
 | |
| 		} else {
 | |
| 			ctx.Error(http.StatusInternalServerError, "GetBranch", err)
 | |
| 		}
 | |
| 		return
 | |
| 	}
 | |
| 
 | |
| 	c, err := branch.GetCommit()
 | |
| 	if err != nil {
 | |
| 		ctx.Error(http.StatusInternalServerError, "GetCommit", err)
 | |
| 		return
 | |
| 	}
 | |
| 
 | |
| 	branchProtection, err := ctx.Repo.Repository.GetBranchProtection(ctx.Repo.BranchName)
 | |
| 	if err != nil {
 | |
| 		ctx.Error(http.StatusInternalServerError, "GetBranchProtection", err)
 | |
| 		return
 | |
| 	}
 | |
| 
 | |
| 	ctx.JSON(http.StatusOK, convert.ToBranch(ctx.Repo.Repository, branch, c, branchProtection, ctx.User))
 | |
| }
 | |
| 
 | |
| // ListBranches list all the branches of a repository
 | |
| func ListBranches(ctx *context.APIContext) {
 | |
| 	// swagger:operation GET /repos/{owner}/{repo}/branches repository repoListBranches
 | |
| 	// ---
 | |
| 	// summary: List a repository's branches
 | |
| 	// 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
 | |
| 	// responses:
 | |
| 	//   "200":
 | |
| 	//     "$ref": "#/responses/BranchList"
 | |
| 
 | |
| 	branches, err := ctx.Repo.Repository.GetBranches()
 | |
| 	if err != nil {
 | |
| 		ctx.Error(http.StatusInternalServerError, "GetBranches", err)
 | |
| 		return
 | |
| 	}
 | |
| 
 | |
| 	apiBranches := make([]*api.Branch, len(branches))
 | |
| 	for i := range branches {
 | |
| 		c, err := branches[i].GetCommit()
 | |
| 		if err != nil {
 | |
| 			ctx.Error(http.StatusInternalServerError, "GetCommit", err)
 | |
| 			return
 | |
| 		}
 | |
| 		branchProtection, err := ctx.Repo.Repository.GetBranchProtection(branches[i].Name)
 | |
| 		if err != nil {
 | |
| 			ctx.Error(http.StatusInternalServerError, "GetBranchProtection", err)
 | |
| 			return
 | |
| 		}
 | |
| 		apiBranches[i] = convert.ToBranch(ctx.Repo.Repository, branches[i], c, branchProtection, ctx.User)
 | |
| 	}
 | |
| 
 | |
| 	ctx.JSON(http.StatusOK, &apiBranches)
 | |
| }
 |