forked from Gitlink/gitea-1120-rc1
1247 lines
33 KiB
Go
1247 lines
33 KiB
Go
// Copyright 2014 The Gogs Authors. All rights reserved.
|
||
// Copyright 2018 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 (
|
||
"bytes"
|
||
"encoding/base64"
|
||
"fmt"
|
||
gotemplate "html/template"
|
||
"io/ioutil"
|
||
"net/http"
|
||
"net/url"
|
||
"path"
|
||
"strconv"
|
||
"strings"
|
||
"time"
|
||
|
||
"code.gitea.io/gitea/models"
|
||
"code.gitea.io/gitea/modules/base"
|
||
"code.gitea.io/gitea/modules/cache"
|
||
"code.gitea.io/gitea/modules/charset"
|
||
"code.gitea.io/gitea/modules/context"
|
||
"code.gitea.io/gitea/modules/git"
|
||
"code.gitea.io/gitea/modules/highlight"
|
||
"code.gitea.io/gitea/modules/lfs"
|
||
"code.gitea.io/gitea/modules/log"
|
||
"code.gitea.io/gitea/modules/markup"
|
||
"code.gitea.io/gitea/modules/repofiles"
|
||
"code.gitea.io/gitea/modules/setting"
|
||
api "code.gitea.io/gitea/modules/structs"
|
||
"code.gitea.io/gitea/routers/repo"
|
||
)
|
||
|
||
// GetRawFile get a file by path on a repository
|
||
func GetRawFile(ctx *context.APIContext) {
|
||
// swagger:operation GET /repos/{owner}/{repo}/raw/{filepath} repository repoGetRawFile
|
||
// ---
|
||
// summary: Get a file 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: filepath
|
||
// in: path
|
||
// description: filepath of the file to get
|
||
// type: string
|
||
// required: true
|
||
// responses:
|
||
// 200:
|
||
// description: success
|
||
// "404":
|
||
// "$ref": "#/responses/notFound"
|
||
|
||
if ctx.Repo.Repository.IsEmpty {
|
||
ctx.NotFound()
|
||
return
|
||
}
|
||
|
||
blob, err := ctx.Repo.Commit.GetBlobByPath(ctx.Repo.TreePath)
|
||
if err != nil {
|
||
if git.IsErrNotExist(err) {
|
||
ctx.NotFound()
|
||
} else {
|
||
ctx.Error(http.StatusInternalServerError, "GetBlobByPath", err)
|
||
}
|
||
return
|
||
}
|
||
if err = repo.ServeBlob(ctx.Context, blob); err != nil {
|
||
ctx.Error(http.StatusInternalServerError, "ServeBlob", err)
|
||
}
|
||
}
|
||
|
||
// GetArchive get archive of a repository
|
||
func GetArchive(ctx *context.APIContext) {
|
||
// swagger:operation GET /repos/{owner}/{repo}/archive/{archive} repository repoGetArchive
|
||
// ---
|
||
// summary: Get an archive of 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: archive
|
||
// in: path
|
||
// description: archive to download, consisting of a git reference and archive
|
||
// type: string
|
||
// required: true
|
||
// responses:
|
||
// 200:
|
||
// description: success
|
||
// "404":
|
||
// "$ref": "#/responses/notFound"
|
||
|
||
repoPath := models.RepoPath(ctx.Params(":username"), ctx.Params(":reponame"))
|
||
gitRepo, err := git.OpenRepository(repoPath)
|
||
if err != nil {
|
||
ctx.Error(http.StatusInternalServerError, "OpenRepository", err)
|
||
return
|
||
}
|
||
ctx.Repo.GitRepo = gitRepo
|
||
defer gitRepo.Close()
|
||
|
||
repo.Download(ctx.Context)
|
||
}
|
||
|
||
// GetEditorconfig get editor config of a repository
|
||
func GetEditorconfig(ctx *context.APIContext) {
|
||
// swagger:operation GET /repos/{owner}/{repo}/editorconfig/{filepath} repository repoGetEditorConfig
|
||
// ---
|
||
// summary: Get the EditorConfig definitions of a file 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: filepath
|
||
// in: path
|
||
// description: filepath of file to get
|
||
// type: string
|
||
// required: true
|
||
// responses:
|
||
// 200:
|
||
// description: success
|
||
// "404":
|
||
// "$ref": "#/responses/notFound"
|
||
|
||
ec, err := ctx.Repo.GetEditorconfig()
|
||
if err != nil {
|
||
if git.IsErrNotExist(err) {
|
||
ctx.NotFound(err)
|
||
} else {
|
||
ctx.Error(http.StatusInternalServerError, "GetEditorconfig", err)
|
||
}
|
||
return
|
||
}
|
||
|
||
fileName := ctx.Params("filename")
|
||
def, err := ec.GetDefinitionForFilename(fileName)
|
||
if def == nil {
|
||
ctx.NotFound(err)
|
||
return
|
||
}
|
||
ctx.JSON(http.StatusOK, def)
|
||
}
|
||
|
||
// canWriteFiles returns true if repository is editable and user has proper access level.
|
||
func canWriteFiles(r *context.Repository) bool {
|
||
return r.Permission.CanWrite(models.UnitTypeCode) && !r.Repository.IsMirror && !r.Repository.IsArchived
|
||
}
|
||
|
||
// canReadFiles returns true if repository is readable and user has proper access level.
|
||
func canReadFiles(r *context.Repository) bool {
|
||
return r.Permission.CanRead(models.UnitTypeCode)
|
||
}
|
||
|
||
// CreateFile handles API call for creating a file
|
||
func CreateFile(ctx *context.APIContext, apiOpts api.CreateFileOptions) {
|
||
// swagger:operation POST /repos/{owner}/{repo}/contents/{filepath} repository repoCreateFile
|
||
// ---
|
||
// summary: Create a file in a repository
|
||
// consumes:
|
||
// - application/json
|
||
// 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: filepath
|
||
// in: path
|
||
// description: path of the file to create
|
||
// type: string
|
||
// required: true
|
||
// - name: body
|
||
// in: body
|
||
// required: true
|
||
// schema:
|
||
// "$ref": "#/definitions/CreateFileOptions"
|
||
// responses:
|
||
// "201":
|
||
// "$ref": "#/responses/FileResponse"
|
||
// "403":
|
||
// "$ref": "#/responses/error"
|
||
// "404":
|
||
// "$ref": "#/responses/notFound"
|
||
// "422":
|
||
// "$ref": "#/responses/error"
|
||
|
||
if ctx.Repo.Repository.IsEmpty {
|
||
ctx.Error(http.StatusUnprocessableEntity, "RepoIsEmpty", fmt.Errorf("repo is empty"))
|
||
}
|
||
|
||
if apiOpts.BranchName == "" {
|
||
apiOpts.BranchName = ctx.Repo.Repository.DefaultBranch
|
||
}
|
||
|
||
opts := &repofiles.UpdateRepoFileOptions{
|
||
Content: apiOpts.Content,
|
||
IsNewFile: true,
|
||
Message: apiOpts.Message,
|
||
TreePath: ctx.Params("*"),
|
||
OldBranch: apiOpts.BranchName,
|
||
NewBranch: apiOpts.NewBranchName,
|
||
Committer: &repofiles.IdentityOptions{
|
||
Name: apiOpts.Committer.Name,
|
||
Email: apiOpts.Committer.Email,
|
||
},
|
||
Author: &repofiles.IdentityOptions{
|
||
Name: apiOpts.Author.Name,
|
||
Email: apiOpts.Author.Email,
|
||
},
|
||
Dates: &repofiles.CommitDateOptions{
|
||
Author: apiOpts.Dates.Author,
|
||
Committer: apiOpts.Dates.Committer,
|
||
},
|
||
}
|
||
if opts.Dates.Author.IsZero() {
|
||
opts.Dates.Author = time.Now()
|
||
}
|
||
if opts.Dates.Committer.IsZero() {
|
||
opts.Dates.Committer = time.Now()
|
||
}
|
||
|
||
if opts.Message == "" {
|
||
opts.Message = ctx.Tr("repo.editor.add", opts.TreePath)
|
||
}
|
||
|
||
if fileResponse, err := createOrUpdateFile(ctx, opts); err != nil {
|
||
handleCreateOrUpdateFileError(ctx, err)
|
||
} else {
|
||
ctx.JSON(http.StatusCreated, fileResponse)
|
||
}
|
||
}
|
||
|
||
// UpdateFile handles API call for updating a file
|
||
func UpdateFile(ctx *context.APIContext, apiOpts api.UpdateFileOptions) {
|
||
// swagger:operation PUT /repos/{owner}/{repo}/contents/{filepath} repository repoUpdateFile
|
||
// ---
|
||
// summary: Update a file in a repository
|
||
// consumes:
|
||
// - application/json
|
||
// 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: filepath
|
||
// in: path
|
||
// description: path of the file to update
|
||
// type: string
|
||
// required: true
|
||
// - name: body
|
||
// in: body
|
||
// required: true
|
||
// schema:
|
||
// "$ref": "#/definitions/UpdateFileOptions"
|
||
// responses:
|
||
// "200":
|
||
// "$ref": "#/responses/FileResponse"
|
||
// "403":
|
||
// "$ref": "#/responses/error"
|
||
// "404":
|
||
// "$ref": "#/responses/notFound"
|
||
// "422":
|
||
// "$ref": "#/responses/error"
|
||
|
||
if ctx.Repo.Repository.IsEmpty {
|
||
ctx.Error(http.StatusUnprocessableEntity, "RepoIsEmpty", fmt.Errorf("repo is empty"))
|
||
}
|
||
|
||
if apiOpts.BranchName == "" {
|
||
apiOpts.BranchName = ctx.Repo.Repository.DefaultBranch
|
||
}
|
||
|
||
opts := &repofiles.UpdateRepoFileOptions{
|
||
Content: apiOpts.Content,
|
||
SHA: apiOpts.SHA,
|
||
IsNewFile: false,
|
||
Message: apiOpts.Message,
|
||
FromTreePath: apiOpts.FromPath,
|
||
TreePath: ctx.Params("*"),
|
||
OldBranch: apiOpts.BranchName,
|
||
NewBranch: apiOpts.NewBranchName,
|
||
Committer: &repofiles.IdentityOptions{
|
||
Name: apiOpts.Committer.Name,
|
||
Email: apiOpts.Committer.Email,
|
||
},
|
||
Author: &repofiles.IdentityOptions{
|
||
Name: apiOpts.Author.Name,
|
||
Email: apiOpts.Author.Email,
|
||
},
|
||
Dates: &repofiles.CommitDateOptions{
|
||
Author: apiOpts.Dates.Author,
|
||
Committer: apiOpts.Dates.Committer,
|
||
},
|
||
}
|
||
if opts.Dates.Author.IsZero() {
|
||
opts.Dates.Author = time.Now()
|
||
}
|
||
if opts.Dates.Committer.IsZero() {
|
||
opts.Dates.Committer = time.Now()
|
||
}
|
||
|
||
if opts.Message == "" {
|
||
opts.Message = ctx.Tr("repo.editor.update", opts.TreePath)
|
||
}
|
||
|
||
if fileResponse, err := createOrUpdateFile(ctx, opts); err != nil {
|
||
handleCreateOrUpdateFileError(ctx, err)
|
||
} else {
|
||
ctx.JSON(http.StatusOK, fileResponse)
|
||
}
|
||
}
|
||
|
||
func handleCreateOrUpdateFileError(ctx *context.APIContext, err error) {
|
||
if models.IsErrUserCannotCommit(err) || models.IsErrFilePathProtected(err) {
|
||
ctx.Error(http.StatusForbidden, "Access", err)
|
||
return
|
||
}
|
||
if models.IsErrBranchAlreadyExists(err) || models.IsErrFilenameInvalid(err) || models.IsErrSHADoesNotMatch(err) ||
|
||
models.IsErrFilePathInvalid(err) || models.IsErrRepoFileAlreadyExists(err) {
|
||
ctx.Error(http.StatusUnprocessableEntity, "Invalid", err)
|
||
return
|
||
}
|
||
if models.IsErrBranchDoesNotExist(err) || git.IsErrBranchNotExist(err) {
|
||
ctx.Error(http.StatusNotFound, "BranchDoesNotExist", err)
|
||
return
|
||
}
|
||
|
||
ctx.Error(http.StatusInternalServerError, "UpdateFile", err)
|
||
}
|
||
|
||
// Called from both CreateFile or UpdateFile to handle both
|
||
func createOrUpdateFile(ctx *context.APIContext, opts *repofiles.UpdateRepoFileOptions) (*api.FileResponse, error) {
|
||
if !canWriteFiles(ctx.Repo) {
|
||
return nil, models.ErrUserDoesNotHaveAccessToRepo{
|
||
UserID: ctx.User.ID,
|
||
RepoName: ctx.Repo.Repository.LowerName,
|
||
}
|
||
}
|
||
|
||
content, err := base64.StdEncoding.DecodeString(opts.Content)
|
||
if err != nil {
|
||
return nil, err
|
||
}
|
||
opts.Content = string(content)
|
||
|
||
return repofiles.CreateOrUpdateRepoFile(ctx.Repo.Repository, ctx.User, opts)
|
||
}
|
||
|
||
// DeleteFile Delete a fle in a repository
|
||
func DeleteFile(ctx *context.APIContext, apiOpts api.DeleteFileOptions) {
|
||
// swagger:operation DELETE /repos/{owner}/{repo}/contents/{filepath} repository repoDeleteFile
|
||
// ---
|
||
// summary: Delete a file in a repository
|
||
// consumes:
|
||
// - application/json
|
||
// 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: filepath
|
||
// in: path
|
||
// description: path of the file to delete
|
||
// type: string
|
||
// required: true
|
||
// - name: body
|
||
// in: body
|
||
// required: true
|
||
// schema:
|
||
// "$ref": "#/definitions/DeleteFileOptions"
|
||
// responses:
|
||
// "200":
|
||
// "$ref": "#/responses/FileDeleteResponse"
|
||
// "400":
|
||
// "$ref": "#/responses/error"
|
||
// "403":
|
||
// "$ref": "#/responses/error"
|
||
// "404":
|
||
// "$ref": "#/responses/error"
|
||
|
||
if !canWriteFiles(ctx.Repo) {
|
||
ctx.Error(http.StatusForbidden, "DeleteFile", models.ErrUserDoesNotHaveAccessToRepo{
|
||
UserID: ctx.User.ID,
|
||
RepoName: ctx.Repo.Repository.LowerName,
|
||
})
|
||
return
|
||
}
|
||
|
||
if apiOpts.BranchName == "" {
|
||
apiOpts.BranchName = ctx.Repo.Repository.DefaultBranch
|
||
}
|
||
|
||
opts := &repofiles.DeleteRepoFileOptions{
|
||
Message: apiOpts.Message,
|
||
OldBranch: apiOpts.BranchName,
|
||
NewBranch: apiOpts.NewBranchName,
|
||
SHA: apiOpts.SHA,
|
||
TreePath: ctx.Params("*"),
|
||
Committer: &repofiles.IdentityOptions{
|
||
Name: apiOpts.Committer.Name,
|
||
Email: apiOpts.Committer.Email,
|
||
},
|
||
Author: &repofiles.IdentityOptions{
|
||
Name: apiOpts.Author.Name,
|
||
Email: apiOpts.Author.Email,
|
||
},
|
||
Dates: &repofiles.CommitDateOptions{
|
||
Author: apiOpts.Dates.Author,
|
||
Committer: apiOpts.Dates.Committer,
|
||
},
|
||
}
|
||
if opts.Dates.Author.IsZero() {
|
||
opts.Dates.Author = time.Now()
|
||
}
|
||
if opts.Dates.Committer.IsZero() {
|
||
opts.Dates.Committer = time.Now()
|
||
}
|
||
|
||
if opts.Message == "" {
|
||
opts.Message = ctx.Tr("repo.editor.delete", opts.TreePath)
|
||
}
|
||
|
||
if fileResponse, err := repofiles.DeleteRepoFile(ctx.Repo.Repository, ctx.User, opts); err != nil {
|
||
if git.IsErrBranchNotExist(err) || models.IsErrRepoFileDoesNotExist(err) || git.IsErrNotExist(err) {
|
||
ctx.Error(http.StatusNotFound, "DeleteFile", err)
|
||
return
|
||
} else if models.IsErrBranchAlreadyExists(err) ||
|
||
models.IsErrFilenameInvalid(err) ||
|
||
models.IsErrSHADoesNotMatch(err) ||
|
||
models.IsErrCommitIDDoesNotMatch(err) ||
|
||
models.IsErrSHAOrCommitIDNotProvided(err) {
|
||
ctx.Error(http.StatusBadRequest, "DeleteFile", err)
|
||
return
|
||
} else if models.IsErrUserCannotCommit(err) {
|
||
ctx.Error(http.StatusForbidden, "DeleteFile", err)
|
||
return
|
||
}
|
||
ctx.Error(http.StatusInternalServerError, "DeleteFile", err)
|
||
} else {
|
||
ctx.JSON(http.StatusOK, fileResponse) // FIXME on APIv2: return http.StatusNoContent
|
||
}
|
||
}
|
||
|
||
// GetContents Get the metadata and contents (if a file) of an entry in a repository, or a list of entries if a dir
|
||
func GetContents(ctx *context.APIContext) {
|
||
// swagger:operation GET /repos/{owner}/{repo}/contents/{filepath} repository repoGetContents
|
||
// ---
|
||
// summary: Gets the metadata and contents (if a file) of an entry in a repository, or a list of entries if a dir
|
||
// 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: filepath
|
||
// in: path
|
||
// description: path of the dir, file, symlink or submodule in the repo
|
||
// type: string
|
||
// required: true
|
||
// - name: ref
|
||
// in: query
|
||
// description: "The name of the commit/branch/tag. Default the repository’s default branch (usually master)"
|
||
// type: string
|
||
// required: false
|
||
// responses:
|
||
// "200":
|
||
// "$ref": "#/responses/ContentsResponse"
|
||
// "404":
|
||
// "$ref": "#/responses/notFound"
|
||
|
||
|
||
start:=time.Now()
|
||
|
||
if !canReadFiles(ctx.Repo) {
|
||
ctx.Error(http.StatusInternalServerError, "GetContentsOrList", models.ErrUserDoesNotHaveAccessToRepo{
|
||
UserID: ctx.User.ID,
|
||
RepoName: ctx.Repo.Repository.LowerName,
|
||
})
|
||
return
|
||
}
|
||
//log.Info("*****************GetContents.1:%v",time.Now().Sub(start))
|
||
treePath := ctx.Params("*")
|
||
ref := ctx.QueryTrim("ref")
|
||
|
||
fmt.Println("***GetContents.treePath:",treePath)
|
||
fmt.Println("***GetContents.ref:",ref)
|
||
if fileList, err := repofiles.GetContentsOrList(ctx.Repo.Repository, treePath, ref); err != nil {
|
||
if git.IsErrNotExist(err) {
|
||
ctx.NotFound("GetContentsOrList", err)
|
||
return
|
||
}
|
||
ctx.Error(http.StatusInternalServerError, "GetContentsOrList", err)
|
||
} else {
|
||
ctx.JSON(http.StatusOK, fileList)
|
||
}
|
||
log.Info("*****************GetContents:%v",time.Now().Sub(start))
|
||
}
|
||
|
||
// add by qiubing
|
||
|
||
const (
|
||
tplRepoEMPTY base.TplName = "repo/empty"
|
||
tplRepoHome base.TplName = "repo/home"
|
||
tplWatchers base.TplName = "repo/watchers"
|
||
tplForks base.TplName = "repo/forks"
|
||
tplMigrating base.TplName = "repo/migrating"
|
||
)
|
||
|
||
type namedBlob struct {
|
||
name string
|
||
isSymlink bool
|
||
blob *git.Blob
|
||
}
|
||
|
||
func GetFileContents(ctx *context.APIContext) {
|
||
if len(ctx.Repo.Units) > 0 {
|
||
if ctx.Repo.Repository.IsBeingCreated() {
|
||
task, err := models.GetMigratingTask(ctx.Repo.Repository.ID)
|
||
if err != nil {
|
||
ctx.ServerError("models.GetMigratingTask", err)
|
||
return
|
||
}
|
||
cfg, err := task.MigrateConfig()
|
||
if err != nil {
|
||
ctx.ServerError("task.MigrateConfig", err)
|
||
return
|
||
}
|
||
|
||
ctx.Data["Repo"] = ctx.Repo
|
||
ctx.Data["MigrateTask"] = task
|
||
ctx.Data["CloneAddr"] = safeURL(cfg.CloneAddr)
|
||
ctx.HTML(200, tplMigrating)
|
||
return
|
||
}
|
||
|
||
var firstUnit *models.Unit
|
||
for _, repoUnit := range ctx.Repo.Units {
|
||
if repoUnit.Type == models.UnitTypeCode {
|
||
renderCode(ctx.Context)
|
||
fileContent := struct {
|
||
Content interface{}
|
||
}{
|
||
Content: ctx.Data["FileContent"],
|
||
}
|
||
ctx.JSON(http.StatusOK, fileContent)
|
||
return
|
||
}
|
||
|
||
unit, ok := models.Units[repoUnit.Type]
|
||
if ok && (firstUnit == nil || !firstUnit.IsLessThan(unit)) {
|
||
firstUnit = &unit
|
||
}
|
||
}
|
||
|
||
if firstUnit != nil {
|
||
ctx.Redirect(fmt.Sprintf("%s/%s%s", setting.AppSubURL, ctx.Repo.Repository.FullName(), firstUnit.URI))
|
||
return
|
||
}
|
||
}
|
||
|
||
ctx.NotFound("Home", fmt.Errorf(ctx.Tr("units.error.no_unit_allowed_repo")))
|
||
}
|
||
|
||
func safeURL(address string) string {
|
||
u, err := url.Parse(address)
|
||
if err != nil {
|
||
return address
|
||
}
|
||
u.User = nil
|
||
return u.String()
|
||
}
|
||
|
||
func renderCode(ctx *context.Context) {
|
||
ctx.Data["PageIsViewCode"] = true
|
||
|
||
if ctx.Repo.Repository.IsEmpty {
|
||
ctx.HTML(200, tplRepoEMPTY)
|
||
return
|
||
}
|
||
|
||
title := ctx.Repo.Repository.Owner.Name + "/" + ctx.Repo.Repository.Name
|
||
if len(ctx.Repo.Repository.Description) > 0 {
|
||
title += ": " + ctx.Repo.Repository.Description
|
||
}
|
||
ctx.Data["Title"] = title
|
||
|
||
branchLink := ctx.Repo.RepoLink + "/src/" + ctx.Repo.BranchNameSubURL()
|
||
treeLink := branchLink
|
||
rawLink := ctx.Repo.RepoLink + "/raw/" + ctx.Repo.BranchNameSubURL()
|
||
|
||
if len(ctx.Repo.TreePath) > 0 {
|
||
treeLink += "/" + ctx.Repo.TreePath
|
||
}
|
||
|
||
// Get Topics of this repo
|
||
renderRepoTopics(ctx)
|
||
if ctx.Written() {
|
||
return
|
||
}
|
||
|
||
// Get current entry user currently looking at.
|
||
entry, err := ctx.Repo.Commit.GetTreeEntryByPath(ctx.Repo.TreePath)
|
||
if err != nil {
|
||
return
|
||
}
|
||
|
||
renderLanguageStats(ctx)
|
||
if ctx.Written() {
|
||
return
|
||
}
|
||
|
||
if entry.IsDir() {
|
||
renderDirectory(ctx, treeLink)
|
||
} else {
|
||
renderFile(ctx, entry, treeLink, rawLink)
|
||
}
|
||
if ctx.Written() {
|
||
return
|
||
}
|
||
|
||
var treeNames []string
|
||
paths := make([]string, 0, 5)
|
||
if len(ctx.Repo.TreePath) > 0 {
|
||
treeNames = strings.Split(ctx.Repo.TreePath, "/")
|
||
for i := range treeNames {
|
||
paths = append(paths, strings.Join(treeNames[:i+1], "/"))
|
||
}
|
||
|
||
ctx.Data["HasParentPath"] = true
|
||
if len(paths)-2 >= 0 {
|
||
ctx.Data["ParentPath"] = "/" + paths[len(paths)-2]
|
||
}
|
||
}
|
||
|
||
ctx.Data["Paths"] = paths
|
||
ctx.Data["TreeLink"] = treeLink
|
||
ctx.Data["TreeNames"] = treeNames
|
||
ctx.Data["BranchLink"] = branchLink
|
||
// ctx.HTML(200, tplRepoHome)
|
||
}
|
||
|
||
func renderRepoTopics(ctx *context.Context) {
|
||
topics, err := models.FindTopics(&models.FindTopicOptions{
|
||
RepoID: ctx.Repo.Repository.ID,
|
||
})
|
||
if err != nil {
|
||
ctx.ServerError("models.FindTopics", err)
|
||
return
|
||
}
|
||
ctx.Data["Topics"] = topics
|
||
}
|
||
|
||
func renderLanguageStats(ctx *context.Context) {
|
||
langs, err := ctx.Repo.Repository.GetTopLanguageStats(5)
|
||
if err != nil {
|
||
ctx.ServerError("Repo.GetTopLanguageStats", err)
|
||
return
|
||
}
|
||
|
||
ctx.Data["LanguageStats"] = langs
|
||
}
|
||
|
||
func renderDirectory(ctx *context.Context, treeLink string) {
|
||
tree, err := ctx.Repo.Commit.SubTree(ctx.Repo.TreePath)
|
||
if err != nil {
|
||
ctx.NotFoundOrServerError("Repo.Commit.SubTree", git.IsErrNotExist, err)
|
||
return
|
||
}
|
||
|
||
entries, err := tree.ListEntries()
|
||
if err != nil {
|
||
ctx.ServerError("ListEntries", err)
|
||
return
|
||
}
|
||
entries.CustomSort(base.NaturalSortLess)
|
||
|
||
var c git.LastCommitCache
|
||
if setting.CacheService.LastCommit.Enabled && ctx.Repo.CommitsCount >= setting.CacheService.LastCommit.CommitsCount {
|
||
c = cache.NewLastCommitCache(ctx.Repo.Repository.FullName(), ctx.Repo.GitRepo, int64(setting.CacheService.LastCommit.TTL.Seconds()))
|
||
}
|
||
|
||
var latestCommit *git.Commit
|
||
ctx.Data["Files"], latestCommit, err = entries.GetCommitsInfo(ctx.Repo.Commit, ctx.Repo.TreePath, c)
|
||
if err != nil {
|
||
ctx.ServerError("GetCommitsInfo", err)
|
||
return
|
||
}
|
||
|
||
// 3 for the extensions in exts[] in order
|
||
// the last one is for a readme that doesn't
|
||
// strictly match an extension
|
||
var readmeFiles [4]*namedBlob
|
||
var docsEntries [3]*git.TreeEntry
|
||
var exts = []string{".md", ".txt", ""} // sorted by priority
|
||
for _, entry := range entries {
|
||
if entry.IsDir() {
|
||
lowerName := strings.ToLower(entry.Name())
|
||
switch lowerName {
|
||
case "docs":
|
||
if entry.Name() == "docs" || docsEntries[0] == nil {
|
||
docsEntries[0] = entry
|
||
}
|
||
case ".gitea":
|
||
if entry.Name() == ".gitea" || docsEntries[1] == nil {
|
||
docsEntries[1] = entry
|
||
}
|
||
case ".github":
|
||
if entry.Name() == ".github" || docsEntries[2] == nil {
|
||
docsEntries[2] = entry
|
||
}
|
||
}
|
||
continue
|
||
}
|
||
|
||
for i, ext := range exts {
|
||
if markup.IsReadmeFile(entry.Name(), ext) {
|
||
log.Debug("%s", entry.Name())
|
||
name := entry.Name()
|
||
isSymlink := entry.IsLink()
|
||
target := entry
|
||
if isSymlink {
|
||
target, err = entry.FollowLinks()
|
||
if err != nil && !git.IsErrBadLink(err) {
|
||
ctx.ServerError("FollowLinks", err)
|
||
return
|
||
}
|
||
}
|
||
log.Debug("%t", target == nil)
|
||
if target != nil && (target.IsExecutable() || target.IsRegular()) {
|
||
readmeFiles[i] = &namedBlob{
|
||
name,
|
||
isSymlink,
|
||
target.Blob(),
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
if markup.IsReadmeFile(entry.Name()) {
|
||
name := entry.Name()
|
||
isSymlink := entry.IsLink()
|
||
if isSymlink {
|
||
entry, err = entry.FollowLinks()
|
||
if err != nil && !git.IsErrBadLink(err) {
|
||
ctx.ServerError("FollowLinks", err)
|
||
return
|
||
}
|
||
}
|
||
if entry != nil && (entry.IsExecutable() || entry.IsRegular()) {
|
||
readmeFiles[3] = &namedBlob{
|
||
name,
|
||
isSymlink,
|
||
entry.Blob(),
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
var readmeFile *namedBlob
|
||
readmeTreelink := treeLink
|
||
for _, f := range readmeFiles {
|
||
if f != nil {
|
||
readmeFile = f
|
||
break
|
||
}
|
||
}
|
||
|
||
if ctx.Repo.TreePath == "" && readmeFile == nil {
|
||
for _, entry := range docsEntries {
|
||
if entry == nil {
|
||
continue
|
||
}
|
||
readmeFile, err = getReadmeFileFromPath(ctx.Repo.Commit, entry.GetSubJumpablePathName())
|
||
if err != nil {
|
||
ctx.ServerError("getReadmeFileFromPath", err)
|
||
return
|
||
}
|
||
if readmeFile != nil {
|
||
readmeFile.name = entry.Name() + "/" + readmeFile.name
|
||
readmeTreelink = treeLink + "/" + entry.GetSubJumpablePathName()
|
||
break
|
||
}
|
||
}
|
||
}
|
||
|
||
if readmeFile != nil {
|
||
ctx.Data["RawFileLink"] = ""
|
||
ctx.Data["ReadmeInList"] = true
|
||
ctx.Data["ReadmeExist"] = true
|
||
ctx.Data["FileIsSymlink"] = readmeFile.isSymlink
|
||
|
||
dataRc, err := readmeFile.blob.DataAsync()
|
||
if err != nil {
|
||
ctx.ServerError("Data", err)
|
||
return
|
||
}
|
||
defer dataRc.Close()
|
||
|
||
buf := make([]byte, 1024)
|
||
n, _ := dataRc.Read(buf)
|
||
buf = buf[:n]
|
||
|
||
isTextFile := base.IsTextFile(buf)
|
||
ctx.Data["FileIsText"] = isTextFile
|
||
ctx.Data["FileName"] = readmeFile.name
|
||
fileSize := int64(0)
|
||
isLFSFile := false
|
||
ctx.Data["IsLFSFile"] = false
|
||
|
||
// FIXME: what happens when README file is an image?
|
||
if isTextFile && setting.LFS.StartServer {
|
||
meta := lfs.IsPointerFile(&buf)
|
||
if meta != nil {
|
||
meta, err = ctx.Repo.Repository.GetLFSMetaObjectByOid(meta.Oid)
|
||
if err != nil && err != models.ErrLFSObjectNotExist {
|
||
ctx.ServerError("GetLFSMetaObject", err)
|
||
return
|
||
}
|
||
}
|
||
|
||
if meta != nil {
|
||
ctx.Data["IsLFSFile"] = true
|
||
isLFSFile = true
|
||
|
||
// OK read the lfs object
|
||
var err error
|
||
dataRc, err = lfs.ReadMetaObject(meta)
|
||
if err != nil {
|
||
ctx.ServerError("ReadMetaObject", err)
|
||
return
|
||
}
|
||
defer dataRc.Close()
|
||
|
||
buf = make([]byte, 1024)
|
||
n, err = dataRc.Read(buf)
|
||
if err != nil {
|
||
ctx.ServerError("Data", err)
|
||
return
|
||
}
|
||
buf = buf[:n]
|
||
|
||
isTextFile = base.IsTextFile(buf)
|
||
ctx.Data["IsTextFile"] = isTextFile
|
||
|
||
fileSize = meta.Size
|
||
ctx.Data["FileSize"] = meta.Size
|
||
filenameBase64 := base64.RawURLEncoding.EncodeToString([]byte(readmeFile.name))
|
||
ctx.Data["RawFileLink"] = fmt.Sprintf("%s%s.git/info/lfs/objects/%s/%s", setting.AppURL, ctx.Repo.Repository.FullName(), meta.Oid, filenameBase64)
|
||
}
|
||
}
|
||
|
||
if !isLFSFile {
|
||
fileSize = readmeFile.blob.Size()
|
||
}
|
||
|
||
if isTextFile {
|
||
if fileSize >= setting.UI.MaxDisplayFileSize {
|
||
// Pretend that this is a normal text file to display 'This file is too large to be shown'
|
||
ctx.Data["IsFileTooLarge"] = true
|
||
ctx.Data["IsTextFile"] = true
|
||
ctx.Data["FileSize"] = fileSize
|
||
} else {
|
||
d, _ := ioutil.ReadAll(dataRc)
|
||
buf = charset.ToUTF8WithFallback(append(buf, d...))
|
||
|
||
if markupType := markup.Type(readmeFile.name); markupType != "" {
|
||
ctx.Data["IsMarkup"] = true
|
||
ctx.Data["MarkupType"] = string(markupType)
|
||
ctx.Data["FileContent"] = string(markup.Render(readmeFile.name, buf, readmeTreelink, ctx.Repo.Repository.ComposeDocumentMetas()))
|
||
} else {
|
||
ctx.Data["IsRenderedHTML"] = true
|
||
ctx.Data["FileContent"] = strings.Replace(
|
||
gotemplate.HTMLEscapeString(string(buf)), "\n", `<br>`, -1,
|
||
)
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
// Show latest commit info of repository in table header,
|
||
// or of directory if not in root directory.
|
||
ctx.Data["LatestCommit"] = latestCommit
|
||
verification := models.ParseCommitWithSignature(latestCommit)
|
||
|
||
if err := models.CalculateTrustStatus(verification, ctx.Repo.Repository, nil); err != nil {
|
||
ctx.ServerError("CalculateTrustStatus", err)
|
||
return
|
||
}
|
||
ctx.Data["LatestCommitVerification"] = verification
|
||
|
||
ctx.Data["LatestCommitUser"] = models.ValidateCommitWithEmail(latestCommit)
|
||
|
||
statuses, err := models.GetLatestCommitStatus(ctx.Repo.Repository, ctx.Repo.Commit.ID.String(), 0)
|
||
if err != nil {
|
||
log.Error("GetLatestCommitStatus: %v", err)
|
||
}
|
||
|
||
ctx.Data["LatestCommitStatus"] = models.CalcCommitStatus(statuses)
|
||
|
||
// Check permission to add or upload new file.
|
||
if ctx.Repo.CanWrite(models.UnitTypeCode) && ctx.Repo.IsViewBranch {
|
||
ctx.Data["CanAddFile"] = !ctx.Repo.Repository.IsArchived
|
||
ctx.Data["CanUploadFile"] = setting.Repository.Upload.Enabled && !ctx.Repo.Repository.IsArchived
|
||
}
|
||
}
|
||
|
||
func renderFile(ctx *context.Context, entry *git.TreeEntry, treeLink, rawLink string) {
|
||
ctx.Data["IsViewFile"] = true
|
||
blob := entry.Blob()
|
||
dataRc, err := blob.DataAsync()
|
||
if err != nil {
|
||
ctx.ServerError("DataAsync", err)
|
||
return
|
||
}
|
||
defer dataRc.Close()
|
||
|
||
ctx.Data["Title"] = ctx.Data["Title"].(string) + " - " + ctx.Repo.TreePath + " at " + ctx.Repo.BranchName
|
||
|
||
fileSize := blob.Size()
|
||
ctx.Data["FileIsSymlink"] = entry.IsLink()
|
||
ctx.Data["FileSize"] = fileSize
|
||
ctx.Data["FileName"] = blob.Name()
|
||
ctx.Data["RawFileLink"] = rawLink + "/" + ctx.Repo.TreePath
|
||
|
||
buf := make([]byte, 1024)
|
||
n, _ := dataRc.Read(buf)
|
||
buf = buf[:n]
|
||
|
||
isTextFile := base.IsTextFile(buf)
|
||
isLFSFile := false
|
||
ctx.Data["IsTextFile"] = isTextFile
|
||
|
||
//Check for LFS meta file
|
||
if isTextFile && setting.LFS.StartServer {
|
||
meta := lfs.IsPointerFile(&buf)
|
||
if meta != nil {
|
||
meta, err = ctx.Repo.Repository.GetLFSMetaObjectByOid(meta.Oid)
|
||
if err != nil && err != models.ErrLFSObjectNotExist {
|
||
ctx.ServerError("GetLFSMetaObject", err)
|
||
return
|
||
}
|
||
}
|
||
if meta != nil {
|
||
ctx.Data["IsLFSFile"] = true
|
||
isLFSFile = true
|
||
|
||
// OK read the lfs object
|
||
var err error
|
||
dataRc, err = lfs.ReadMetaObject(meta)
|
||
if err != nil {
|
||
ctx.ServerError("ReadMetaObject", err)
|
||
return
|
||
}
|
||
defer dataRc.Close()
|
||
|
||
buf = make([]byte, 1024)
|
||
n, err = dataRc.Read(buf)
|
||
if err != nil {
|
||
ctx.ServerError("Data", err)
|
||
return
|
||
}
|
||
buf = buf[:n]
|
||
|
||
isTextFile = base.IsTextFile(buf)
|
||
ctx.Data["IsTextFile"] = isTextFile
|
||
|
||
fileSize = meta.Size
|
||
ctx.Data["FileSize"] = meta.Size
|
||
filenameBase64 := base64.RawURLEncoding.EncodeToString([]byte(blob.Name()))
|
||
ctx.Data["RawFileLink"] = fmt.Sprintf("%s%s.git/info/lfs/objects/%s/%s", setting.AppURL, ctx.Repo.Repository.FullName(), meta.Oid, filenameBase64)
|
||
}
|
||
}
|
||
// Check LFS Lock
|
||
lfsLock, err := ctx.Repo.Repository.GetTreePathLock(ctx.Repo.TreePath)
|
||
ctx.Data["LFSLock"] = lfsLock
|
||
if err != nil {
|
||
ctx.ServerError("GetTreePathLock", err)
|
||
return
|
||
}
|
||
if lfsLock != nil {
|
||
ctx.Data["LFSLockOwner"] = lfsLock.Owner.DisplayName()
|
||
ctx.Data["LFSLockHint"] = ctx.Tr("repo.editor.this_file_locked")
|
||
}
|
||
|
||
// Assume file is not editable first.
|
||
if isLFSFile {
|
||
ctx.Data["EditFileTooltip"] = ctx.Tr("repo.editor.cannot_edit_lfs_files")
|
||
} else if !isTextFile {
|
||
ctx.Data["EditFileTooltip"] = ctx.Tr("repo.editor.cannot_edit_non_text_files")
|
||
}
|
||
|
||
switch {
|
||
case isTextFile:
|
||
if fileSize >= setting.UI.MaxDisplayFileSize {
|
||
ctx.Data["IsFileTooLarge"] = true
|
||
break
|
||
}
|
||
|
||
d, _ := ioutil.ReadAll(dataRc)
|
||
buf = charset.ToUTF8WithFallback(append(buf, d...))
|
||
readmeExist := markup.IsReadmeFile(blob.Name())
|
||
ctx.Data["ReadmeExist"] = readmeExist
|
||
if markupType := markup.Type(blob.Name()); markupType != "" {
|
||
ctx.Data["IsMarkup"] = true
|
||
ctx.Data["MarkupType"] = markupType
|
||
ctx.Data["FileContent"] = string(markup.Render(blob.Name(), buf, path.Dir(treeLink), ctx.Repo.Repository.ComposeDocumentMetas()))
|
||
} else if readmeExist {
|
||
ctx.Data["IsRenderedHTML"] = true
|
||
ctx.Data["FileContent"] = strings.Replace(
|
||
gotemplate.HTMLEscapeString(string(buf)), "\n", `<br>`, -1,
|
||
)
|
||
} else {
|
||
buf = charset.ToUTF8WithFallback(buf)
|
||
lineNums := linesBytesCount(buf)
|
||
ctx.Data["NumLines"] = strconv.Itoa(lineNums)
|
||
ctx.Data["NumLinesSet"] = true
|
||
ctx.Data["FileContent"] = highlight.File(lineNums, blob.Name(), buf)
|
||
}
|
||
if !isLFSFile {
|
||
if ctx.Repo.CanEnableEditor() {
|
||
if lfsLock != nil && lfsLock.OwnerID != ctx.User.ID {
|
||
ctx.Data["CanEditFile"] = false
|
||
ctx.Data["EditFileTooltip"] = ctx.Tr("repo.editor.this_file_locked")
|
||
} else {
|
||
ctx.Data["CanEditFile"] = true
|
||
ctx.Data["EditFileTooltip"] = ctx.Tr("repo.editor.edit_this_file")
|
||
}
|
||
} else if !ctx.Repo.IsViewBranch {
|
||
ctx.Data["EditFileTooltip"] = ctx.Tr("repo.editor.must_be_on_a_branch")
|
||
} else if !ctx.Repo.CanWrite(models.UnitTypeCode) {
|
||
ctx.Data["EditFileTooltip"] = ctx.Tr("repo.editor.fork_before_edit")
|
||
}
|
||
}
|
||
|
||
case base.IsPDFFile(buf):
|
||
ctx.Data["IsPDFFile"] = true
|
||
case base.IsVideoFile(buf):
|
||
ctx.Data["IsVideoFile"] = true
|
||
case base.IsAudioFile(buf):
|
||
ctx.Data["IsAudioFile"] = true
|
||
case base.IsImageFile(buf):
|
||
ctx.Data["IsImageFile"] = true
|
||
default:
|
||
if fileSize >= setting.UI.MaxDisplayFileSize {
|
||
ctx.Data["IsFileTooLarge"] = true
|
||
break
|
||
}
|
||
|
||
if markupType := markup.Type(blob.Name()); markupType != "" {
|
||
d, _ := ioutil.ReadAll(dataRc)
|
||
buf = append(buf, d...)
|
||
ctx.Data["IsMarkup"] = true
|
||
ctx.Data["MarkupType"] = markupType
|
||
ctx.Data["FileContent"] = string(markup.Render(blob.Name(), buf, path.Dir(treeLink), ctx.Repo.Repository.ComposeDocumentMetas()))
|
||
}
|
||
|
||
}
|
||
|
||
if ctx.Repo.CanEnableEditor() {
|
||
if lfsLock != nil && lfsLock.OwnerID != ctx.User.ID {
|
||
ctx.Data["CanDeleteFile"] = false
|
||
ctx.Data["DeleteFileTooltip"] = ctx.Tr("repo.editor.this_file_locked")
|
||
} else {
|
||
ctx.Data["CanDeleteFile"] = true
|
||
ctx.Data["DeleteFileTooltip"] = ctx.Tr("repo.editor.delete_this_file")
|
||
}
|
||
} else if !ctx.Repo.IsViewBranch {
|
||
ctx.Data["DeleteFileTooltip"] = ctx.Tr("repo.editor.must_be_on_a_branch")
|
||
} else if !ctx.Repo.CanWrite(models.UnitTypeCode) {
|
||
ctx.Data["DeleteFileTooltip"] = ctx.Tr("repo.editor.must_have_write_access")
|
||
}
|
||
}
|
||
|
||
func getReadmeFileFromPath(commit *git.Commit, treePath string) (*namedBlob, error) {
|
||
tree, err := commit.SubTree(treePath)
|
||
if err != nil {
|
||
return nil, err
|
||
}
|
||
|
||
entries, err := tree.ListEntries()
|
||
if err != nil {
|
||
return nil, err
|
||
}
|
||
|
||
var readmeFiles [4]*namedBlob
|
||
var exts = []string{".md", ".txt", ""} // sorted by priority
|
||
for _, entry := range entries {
|
||
if entry.IsDir() {
|
||
continue
|
||
}
|
||
for i, ext := range exts {
|
||
if markup.IsReadmeFile(entry.Name(), ext) {
|
||
if readmeFiles[i] == nil || base.NaturalSortLess(readmeFiles[i].name, entry.Blob().Name()) {
|
||
name := entry.Name()
|
||
isSymlink := entry.IsLink()
|
||
target := entry
|
||
if isSymlink {
|
||
target, err = entry.FollowLinks()
|
||
if err != nil && !git.IsErrBadLink(err) {
|
||
return nil, err
|
||
}
|
||
}
|
||
if target != nil && (target.IsExecutable() || target.IsRegular()) {
|
||
readmeFiles[i] = &namedBlob{
|
||
name,
|
||
isSymlink,
|
||
target.Blob(),
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
if markup.IsReadmeFile(entry.Name()) {
|
||
if readmeFiles[3] == nil || base.NaturalSortLess(readmeFiles[3].name, entry.Blob().Name()) {
|
||
name := entry.Name()
|
||
isSymlink := entry.IsLink()
|
||
if isSymlink {
|
||
entry, err = entry.FollowLinks()
|
||
if err != nil && !git.IsErrBadLink(err) {
|
||
return nil, err
|
||
}
|
||
}
|
||
if entry != nil && (entry.IsExecutable() || entry.IsRegular()) {
|
||
readmeFiles[3] = &namedBlob{
|
||
name,
|
||
isSymlink,
|
||
entry.Blob(),
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
var readmeFile *namedBlob
|
||
for _, f := range readmeFiles {
|
||
if f != nil {
|
||
readmeFile = f
|
||
break
|
||
}
|
||
}
|
||
return readmeFile, nil
|
||
}
|
||
|
||
func linesBytesCount(s []byte) int {
|
||
nl := []byte{'\n'}
|
||
n := bytes.Count(s, nl)
|
||
if len(s) > 0 && !bytes.HasSuffix(s, nl) {
|
||
n++
|
||
}
|
||
return n
|
||
}
|
||
|
||
// end by qiubing
|
||
|
||
// GetContentsList Get the metadata of all the entries of the root dir
|
||
func GetContentsList(ctx *context.APIContext) {
|
||
// swagger:operation GET /repos/{owner}/{repo}/contents repository repoGetContentsList
|
||
// ---
|
||
// summary: Gets the metadata of all the entries of the root dir
|
||
// 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: ref
|
||
// in: query
|
||
// description: "The name of the commit/branch/tag. Default the repository’s default branch (usually master)"
|
||
// type: string
|
||
// required: false
|
||
// responses:
|
||
// "200":
|
||
// "$ref": "#/responses/ContentsListResponse"
|
||
// "404":
|
||
// "$ref": "#/responses/notFound"
|
||
|
||
// same as GetContents(), this function is here because swagger fails if path is empty in GetContents() interface
|
||
GetContents(ctx)
|
||
}
|