mirror of
				https://github.com/go-gitea/gitea
				synced 2025-11-03 21:08:25 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			277 lines
		
	
	
		
			12 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
			
		
		
	
	
			277 lines
		
	
	
		
			12 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
// Copyright 2019 The Gitea Authors. All rights reserved.
 | 
						|
// SPDX-License-Identifier: MIT
 | 
						|
 | 
						|
package integration
 | 
						|
 | 
						|
import (
 | 
						|
	"io"
 | 
						|
	"net/http"
 | 
						|
	"net/url"
 | 
						|
	"slices"
 | 
						|
	"testing"
 | 
						|
	"time"
 | 
						|
 | 
						|
	auth_model "code.gitea.io/gitea/models/auth"
 | 
						|
	repo_model "code.gitea.io/gitea/models/repo"
 | 
						|
	"code.gitea.io/gitea/models/unittest"
 | 
						|
	user_model "code.gitea.io/gitea/models/user"
 | 
						|
	"code.gitea.io/gitea/modules/git"
 | 
						|
	"code.gitea.io/gitea/modules/gitrepo"
 | 
						|
	"code.gitea.io/gitea/modules/setting"
 | 
						|
	api "code.gitea.io/gitea/modules/structs"
 | 
						|
	"code.gitea.io/gitea/modules/util"
 | 
						|
	repo_service "code.gitea.io/gitea/services/repository"
 | 
						|
 | 
						|
	"github.com/stretchr/testify/assert"
 | 
						|
	"github.com/stretchr/testify/require"
 | 
						|
)
 | 
						|
 | 
						|
func getExpectedContentsResponseForContents(ref, refType, lastCommitSHA string) *api.ContentsResponse {
 | 
						|
	treePath := "README.md"
 | 
						|
	selfURL := setting.AppURL + "api/v1/repos/user2/repo1/contents/" + treePath + "?ref=" + ref
 | 
						|
	htmlURL := setting.AppURL + "user2/repo1/src/" + refType + "/" + ref + "/" + treePath
 | 
						|
	gitURL := setting.AppURL + "api/v1/repos/user2/repo1/git/blobs/4b4851ad51df6a7d9f25c979345979eaeb5b349f"
 | 
						|
	return &api.ContentsResponse{
 | 
						|
		Name:              treePath,
 | 
						|
		Path:              treePath,
 | 
						|
		SHA:               "4b4851ad51df6a7d9f25c979345979eaeb5b349f",
 | 
						|
		LastCommitSHA:     lastCommitSHA,
 | 
						|
		LastCommitterDate: time.Date(2017, time.March, 19, 16, 47, 59, 0, time.FixedZone("", -14400)),
 | 
						|
		LastAuthorDate:    time.Date(2017, time.March, 19, 16, 47, 59, 0, time.FixedZone("", -14400)),
 | 
						|
		Type:              "file",
 | 
						|
		Size:              30,
 | 
						|
		Encoding:          util.ToPointer("base64"),
 | 
						|
		Content:           util.ToPointer("IyByZXBvMQoKRGVzY3JpcHRpb24gZm9yIHJlcG8x"),
 | 
						|
		URL:               &selfURL,
 | 
						|
		HTMLURL:           &htmlURL,
 | 
						|
		GitURL:            &gitURL,
 | 
						|
		DownloadURL:       util.ToPointer(setting.AppURL + "user2/repo1/raw/" + refType + "/" + ref + "/" + treePath),
 | 
						|
		Links: &api.FileLinksResponse{
 | 
						|
			Self:    &selfURL,
 | 
						|
			GitURL:  &gitURL,
 | 
						|
			HTMLURL: &htmlURL,
 | 
						|
		},
 | 
						|
	}
 | 
						|
}
 | 
						|
 | 
						|
func TestAPIGetContents(t *testing.T) {
 | 
						|
	onGiteaRun(t, func(t *testing.T, u *url.URL) {
 | 
						|
		testAPIGetContentsRefFormats(t)
 | 
						|
		testAPIGetContents(t, u)
 | 
						|
		testAPIGetContentsExt(t)
 | 
						|
	})
 | 
						|
}
 | 
						|
 | 
						|
func testAPIGetContents(t *testing.T, u *url.URL) {
 | 
						|
	/*** SETUP ***/
 | 
						|
	user2 := unittest.AssertExistsAndLoadBean(t, &user_model.User{ID: 2})         // owner of the repo1 & repo16
 | 
						|
	org3 := unittest.AssertExistsAndLoadBean(t, &user_model.User{ID: 3})          // owner of the repo3, is an org
 | 
						|
	user4 := unittest.AssertExistsAndLoadBean(t, &user_model.User{ID: 4})         // owner of neither repos
 | 
						|
	repo1 := unittest.AssertExistsAndLoadBean(t, &repo_model.Repository{ID: 1})   // public repo
 | 
						|
	repo3 := unittest.AssertExistsAndLoadBean(t, &repo_model.Repository{ID: 3})   // public repo
 | 
						|
	repo16 := unittest.AssertExistsAndLoadBean(t, &repo_model.Repository{ID: 16}) // private repo
 | 
						|
	treePath := "README.md"
 | 
						|
 | 
						|
	// Get user2's token
 | 
						|
	session := loginUser(t, user2.Name)
 | 
						|
	token2 := getTokenForLoggedInUser(t, session, auth_model.AccessTokenScopeReadRepository)
 | 
						|
	// Get user4's token
 | 
						|
	session = loginUser(t, user4.Name)
 | 
						|
	token4 := getTokenForLoggedInUser(t, session, auth_model.AccessTokenScopeReadRepository)
 | 
						|
 | 
						|
	// Get the commit ID of the default branch
 | 
						|
	gitRepo, err := gitrepo.OpenRepository(git.DefaultContext, repo1)
 | 
						|
	require.NoError(t, err)
 | 
						|
	defer gitRepo.Close()
 | 
						|
 | 
						|
	// Make a new branch in repo1
 | 
						|
	newBranch := "test_branch"
 | 
						|
	err = repo_service.CreateNewBranch(git.DefaultContext, user2, repo1, gitRepo, repo1.DefaultBranch, newBranch)
 | 
						|
	require.NoError(t, err)
 | 
						|
 | 
						|
	commitID, err := gitRepo.GetBranchCommitID(repo1.DefaultBranch)
 | 
						|
	require.NoError(t, err)
 | 
						|
	// Make a new tag in repo1
 | 
						|
	newTag := "test_tag"
 | 
						|
	err = gitRepo.CreateTag(newTag, commitID)
 | 
						|
	require.NoError(t, err)
 | 
						|
	/*** END SETUP ***/
 | 
						|
 | 
						|
	// ref is default ref
 | 
						|
	ref := repo1.DefaultBranch
 | 
						|
	refType := "branch"
 | 
						|
	req := NewRequestf(t, "GET", "/api/v1/repos/%s/%s/contents/%s?ref=%s", user2.Name, repo1.Name, treePath, ref)
 | 
						|
	resp := MakeRequest(t, req, http.StatusOK)
 | 
						|
	var contentsResponse api.ContentsResponse
 | 
						|
	DecodeJSON(t, resp, &contentsResponse)
 | 
						|
	lastCommit, _ := gitRepo.GetCommitByPath("README.md")
 | 
						|
	expectedContentsResponse := getExpectedContentsResponseForContents(ref, refType, lastCommit.ID.String())
 | 
						|
	assert.Equal(t, *expectedContentsResponse, contentsResponse)
 | 
						|
 | 
						|
	// No ref
 | 
						|
	refType = "branch"
 | 
						|
	req = NewRequestf(t, "GET", "/api/v1/repos/%s/%s/contents/%s", user2.Name, repo1.Name, treePath)
 | 
						|
	resp = MakeRequest(t, req, http.StatusOK)
 | 
						|
	DecodeJSON(t, resp, &contentsResponse)
 | 
						|
	expectedContentsResponse = getExpectedContentsResponseForContents(repo1.DefaultBranch, refType, lastCommit.ID.String())
 | 
						|
	assert.Equal(t, *expectedContentsResponse, contentsResponse)
 | 
						|
 | 
						|
	// ref is the branch we created above  in setup
 | 
						|
	ref = newBranch
 | 
						|
	refType = "branch"
 | 
						|
	req = NewRequestf(t, "GET", "/api/v1/repos/%s/%s/contents/%s?ref=%s", user2.Name, repo1.Name, treePath, ref)
 | 
						|
	resp = MakeRequest(t, req, http.StatusOK)
 | 
						|
	DecodeJSON(t, resp, &contentsResponse)
 | 
						|
	branchCommit, _ := gitRepo.GetBranchCommit(ref)
 | 
						|
	lastCommit, _ = branchCommit.GetCommitByPath("README.md")
 | 
						|
	expectedContentsResponse = getExpectedContentsResponseForContents(ref, refType, lastCommit.ID.String())
 | 
						|
	assert.Equal(t, *expectedContentsResponse, contentsResponse)
 | 
						|
 | 
						|
	// ref is the new tag we created above in setup
 | 
						|
	ref = newTag
 | 
						|
	refType = "tag"
 | 
						|
	req = NewRequestf(t, "GET", "/api/v1/repos/%s/%s/contents/%s?ref=%s", user2.Name, repo1.Name, treePath, ref)
 | 
						|
	resp = MakeRequest(t, req, http.StatusOK)
 | 
						|
	DecodeJSON(t, resp, &contentsResponse)
 | 
						|
	tagCommit, _ := gitRepo.GetTagCommit(ref)
 | 
						|
	lastCommit, _ = tagCommit.GetCommitByPath("README.md")
 | 
						|
	expectedContentsResponse = getExpectedContentsResponseForContents(ref, refType, lastCommit.ID.String())
 | 
						|
	assert.Equal(t, *expectedContentsResponse, contentsResponse)
 | 
						|
 | 
						|
	// ref is a commit
 | 
						|
	ref = commitID
 | 
						|
	refType = "commit"
 | 
						|
	req = NewRequestf(t, "GET", "/api/v1/repos/%s/%s/contents/%s?ref=%s", user2.Name, repo1.Name, treePath, ref)
 | 
						|
	resp = MakeRequest(t, req, http.StatusOK)
 | 
						|
	DecodeJSON(t, resp, &contentsResponse)
 | 
						|
	expectedContentsResponse = getExpectedContentsResponseForContents(ref, refType, commitID)
 | 
						|
	assert.Equal(t, *expectedContentsResponse, contentsResponse)
 | 
						|
 | 
						|
	// Test file contents a file with a bad ref
 | 
						|
	ref = "badref"
 | 
						|
	req = NewRequestf(t, "GET", "/api/v1/repos/%s/%s/contents/%s?ref=%s", user2.Name, repo1.Name, treePath, ref)
 | 
						|
	MakeRequest(t, req, http.StatusNotFound)
 | 
						|
 | 
						|
	// Test accessing private ref with user token that does not have access - should fail
 | 
						|
	req = NewRequestf(t, "GET", "/api/v1/repos/%s/%s/contents/%s", user2.Name, repo16.Name, treePath).
 | 
						|
		AddTokenAuth(token4)
 | 
						|
	MakeRequest(t, req, http.StatusNotFound)
 | 
						|
 | 
						|
	// Test access private ref of owner of token
 | 
						|
	req = NewRequestf(t, "GET", "/api/v1/repos/%s/%s/contents/readme.md", user2.Name, repo16.Name).
 | 
						|
		AddTokenAuth(token2)
 | 
						|
	MakeRequest(t, req, http.StatusOK)
 | 
						|
 | 
						|
	// Test access of org org3 private repo file by owner user2
 | 
						|
	req = NewRequestf(t, "GET", "/api/v1/repos/%s/%s/contents/%s", org3.Name, repo3.Name, treePath).
 | 
						|
		AddTokenAuth(token2)
 | 
						|
	MakeRequest(t, req, http.StatusOK)
 | 
						|
}
 | 
						|
 | 
						|
func testAPIGetContentsRefFormats(t *testing.T) {
 | 
						|
	file := "README.md"
 | 
						|
	sha := "65f1bf27bc3bf70f64657658635e66094edbcb4d"
 | 
						|
	content := "# repo1\n\nDescription for repo1"
 | 
						|
 | 
						|
	resp := MakeRequest(t, NewRequest(t, http.MethodGet, "/api/v1/repos/user2/repo1/raw/"+file), http.StatusOK)
 | 
						|
	raw, err := io.ReadAll(resp.Body)
 | 
						|
	assert.NoError(t, err)
 | 
						|
	assert.Equal(t, content, string(raw))
 | 
						|
 | 
						|
	resp = MakeRequest(t, NewRequest(t, http.MethodGet, "/api/v1/repos/user2/repo1/raw/"+sha+"/"+file), http.StatusOK)
 | 
						|
	raw, err = io.ReadAll(resp.Body)
 | 
						|
	assert.NoError(t, err)
 | 
						|
	assert.Equal(t, content, string(raw))
 | 
						|
 | 
						|
	resp = MakeRequest(t, NewRequest(t, http.MethodGet, "/api/v1/repos/user2/repo1/raw/"+file+"?ref="+sha), http.StatusOK)
 | 
						|
	raw, err = io.ReadAll(resp.Body)
 | 
						|
	assert.NoError(t, err)
 | 
						|
	assert.Equal(t, content, string(raw))
 | 
						|
 | 
						|
	resp = MakeRequest(t, NewRequest(t, http.MethodGet, "/api/v1/repos/user2/repo1/raw/"+file+"?ref=master"), http.StatusOK)
 | 
						|
	raw, err = io.ReadAll(resp.Body)
 | 
						|
	assert.NoError(t, err)
 | 
						|
	assert.Equal(t, content, string(raw))
 | 
						|
 | 
						|
	_ = MakeRequest(t, NewRequest(t, http.MethodGet, "/api/v1/repos/user2/repo1/raw/docs/README.md?ref=main"), http.StatusNotFound)
 | 
						|
	_ = MakeRequest(t, NewRequest(t, http.MethodGet, "/api/v1/repos/user2/repo1/raw/README.md?ref=main"), http.StatusOK)
 | 
						|
	_ = MakeRequest(t, NewRequest(t, http.MethodGet, "/api/v1/repos/user2/repo1/raw/docs/README.md?ref=sub-home-md-img-check"), http.StatusOK)
 | 
						|
	_ = MakeRequest(t, NewRequest(t, http.MethodGet, "/api/v1/repos/user2/repo1/raw/README.md?ref=sub-home-md-img-check"), http.StatusNotFound)
 | 
						|
 | 
						|
	// FIXME: this is an incorrect behavior, non-existing branch falls back to default branch
 | 
						|
	_ = MakeRequest(t, NewRequest(t, http.MethodGet, "/api/v1/repos/user2/repo1/raw/README.md?ref=no-such"), http.StatusOK)
 | 
						|
}
 | 
						|
 | 
						|
func testAPIGetContentsExt(t *testing.T) {
 | 
						|
	session := loginUser(t, "user2")
 | 
						|
	token2 := getTokenForLoggedInUser(t, session, auth_model.AccessTokenScopeWriteRepository)
 | 
						|
	t.Run("DirContents", func(t *testing.T) {
 | 
						|
		req := NewRequestf(t, "GET", "/api/v1/repos/user2/repo1/contents-ext/docs?ref=sub-home-md-img-check")
 | 
						|
		resp := MakeRequest(t, req, http.StatusOK)
 | 
						|
		var contentsResponse api.ContentsExtResponse
 | 
						|
		DecodeJSON(t, resp, &contentsResponse)
 | 
						|
		assert.Nil(t, contentsResponse.FileContents)
 | 
						|
		assert.Equal(t, "README.md", contentsResponse.DirContents[0].Name)
 | 
						|
		assert.Nil(t, contentsResponse.DirContents[0].Encoding)
 | 
						|
		assert.Nil(t, contentsResponse.DirContents[0].Content)
 | 
						|
 | 
						|
		// "includes=file_content" shouldn't affect directory listing
 | 
						|
		req = NewRequestf(t, "GET", "/api/v1/repos/user2/repo1/contents-ext/docs?ref=sub-home-md-img-check&includes=file_content")
 | 
						|
		resp = MakeRequest(t, req, http.StatusOK)
 | 
						|
		contentsResponse = api.ContentsExtResponse{}
 | 
						|
		DecodeJSON(t, resp, &contentsResponse)
 | 
						|
		assert.Nil(t, contentsResponse.FileContents)
 | 
						|
		assert.Equal(t, "README.md", contentsResponse.DirContents[0].Name)
 | 
						|
		assert.Nil(t, contentsResponse.DirContents[0].Encoding)
 | 
						|
		assert.Nil(t, contentsResponse.DirContents[0].Content)
 | 
						|
 | 
						|
		req = NewRequestf(t, "GET", "/api/v1/repos/user2/lfs/contents-ext?includes=file_content,lfs_metadata").AddTokenAuth(token2)
 | 
						|
		resp = session.MakeRequest(t, req, http.StatusOK)
 | 
						|
		contentsResponse = api.ContentsExtResponse{}
 | 
						|
		DecodeJSON(t, resp, &contentsResponse)
 | 
						|
		assert.Nil(t, contentsResponse.FileContents)
 | 
						|
		respFileIdx := slices.IndexFunc(contentsResponse.DirContents, func(response *api.ContentsResponse) bool { return response.Name == "jpeg.jpg" })
 | 
						|
		require.NotEqual(t, -1, respFileIdx)
 | 
						|
		respFile := contentsResponse.DirContents[respFileIdx]
 | 
						|
		assert.Equal(t, "jpeg.jpg", respFile.Name)
 | 
						|
		assert.Nil(t, respFile.Encoding)
 | 
						|
		assert.Nil(t, respFile.Content)
 | 
						|
		assert.Equal(t, util.ToPointer(int64(107)), respFile.LfsSize)
 | 
						|
		assert.Equal(t, util.ToPointer("0b8d8b5f15046343fd32f451df93acc2bdd9e6373be478b968e4cad6b6647351"), respFile.LfsOid)
 | 
						|
	})
 | 
						|
	t.Run("FileContents", func(t *testing.T) {
 | 
						|
		// by default, no file content is returned
 | 
						|
		req := NewRequestf(t, "GET", "/api/v1/repos/user2/repo1/contents-ext/docs/README.md?ref=sub-home-md-img-check")
 | 
						|
		resp := MakeRequest(t, req, http.StatusOK)
 | 
						|
		var contentsResponse api.ContentsExtResponse
 | 
						|
		DecodeJSON(t, resp, &contentsResponse)
 | 
						|
		assert.Nil(t, contentsResponse.DirContents)
 | 
						|
		assert.Equal(t, "README.md", contentsResponse.FileContents.Name)
 | 
						|
		assert.Nil(t, contentsResponse.FileContents.Encoding)
 | 
						|
		assert.Nil(t, contentsResponse.FileContents.Content)
 | 
						|
 | 
						|
		// file content is only returned when `includes=file_content`
 | 
						|
		req = NewRequestf(t, "GET", "/api/v1/repos/user2/repo1/contents-ext/docs/README.md?ref=sub-home-md-img-check&includes=file_content")
 | 
						|
		resp = MakeRequest(t, req, http.StatusOK)
 | 
						|
		contentsResponse = api.ContentsExtResponse{}
 | 
						|
		DecodeJSON(t, resp, &contentsResponse)
 | 
						|
		assert.Nil(t, contentsResponse.DirContents)
 | 
						|
		assert.Equal(t, "README.md", contentsResponse.FileContents.Name)
 | 
						|
		assert.NotNil(t, contentsResponse.FileContents.Encoding)
 | 
						|
		assert.NotNil(t, contentsResponse.FileContents.Content)
 | 
						|
 | 
						|
		req = NewRequestf(t, "GET", "/api/v1/repos/user2/lfs/contents-ext/jpeg.jpg?includes=file_content").AddTokenAuth(token2)
 | 
						|
		resp = session.MakeRequest(t, req, http.StatusOK)
 | 
						|
		contentsResponse = api.ContentsExtResponse{}
 | 
						|
		DecodeJSON(t, resp, &contentsResponse)
 | 
						|
		assert.Nil(t, contentsResponse.DirContents)
 | 
						|
		assert.NotNil(t, contentsResponse.FileContents)
 | 
						|
		respFile := contentsResponse.FileContents
 | 
						|
		assert.Equal(t, "jpeg.jpg", respFile.Name)
 | 
						|
		assert.NotNil(t, respFile.Encoding)
 | 
						|
		assert.NotNil(t, respFile.Content)
 | 
						|
		assert.Equal(t, util.ToPointer(int64(107)), respFile.LfsSize)
 | 
						|
		assert.Equal(t, util.ToPointer("0b8d8b5f15046343fd32f451df93acc2bdd9e6373be478b968e4cad6b6647351"), respFile.LfsOid)
 | 
						|
	})
 | 
						|
}
 |