testhelper

Documentation

Index

• Constants
• func AddWorktree(t *testing.T, repoPath string, worktreeName string)
• func AssertFileNotExists(t *testing.T, path string)
• func AuthorsEqual(a *gitalypb.CommitAuthor, b *gitalypb.CommitAuthor) bool
• func CaptureHookEnv(t *testing.T) (hookPath string, cleanup func())
• func ConfigureGitalySSH()
• func ConfigureRuby()
• func Context() (context.Context, func())
• func CreateCommit(t *testing.T, repoPath, branchName string, opts *CreateCommitOpts) string
• func CreateCommitInAlternateObjectDirectory(t *testing.T, repoPath, altObjectsDir string, cmd *exec.Cmd) (currentHead []byte)
• func CreateRemoteBranch(t *testing.T, repoPath, remoteName, branchName, ref string)
• func CreateRepo(t *testing.T, storagePath string) (repo *gitalypb.Repository, repoPath, relativePath string)
• func CreateTag(t *testing.T, repoPath, tagName, targetID string, opts *CreateTagOpts) string
• func EnableGitProtocolV2Support() func()
• func FindLocalBranchCommitAuthorsEqual(a *gitalypb.FindLocalBranchCommitAuthor, ...) bool
• func FindLocalBranchResponsesEqual(a *gitalypb.FindLocalBranchResponse, b *gitalypb.FindLocalBranchResponse) bool
• func GetGitEnvData() (string, error)
• func GetRepositoryRefs(t *testing.T, repoPath string) string
• func GetTemporaryGitalySocketFileName() string
• func GitCommitEqual(a, b *gitalypb.GitCommit) error
• func GitalyServersMetadata(t *testing.T, serverSocketPath string) metadata.MD
• func GitlabTestStoragePath() string
• func InitBareRepo(t *testing.T) (*gitalypb.Repository, string, func())
• func InitRepoWithWorktree(t *testing.T) (*gitalypb.Repository, string, func())
• func MustHaveNoChildProcess()
• func MustReadFile(t *testing.T, filename string) []byte
• func MustRunCommand(t *testing.T, stdin io.Reader, name string, args ...string) []byte
• func NewTestGrpcServer(t *testing.T, streamInterceptors []grpc.StreamServerInterceptor, ...) *grpc.Server
• func NewTestLogger(t *testing.T) *log.Logger
• func NewTestObjectPoolName(t *testing.T) string
• func NewTestRepo(t *testing.T) (repo *gitalypb.Repository, repoPath string, cleanup func())
• func NewTestRepoWithWorktree(t *testing.T) (repo *gitalypb.Repository, repoPath string, cleanup func())
• func RemoteExists(t *testing.T, repoPath string, remoteName string) bool
• func RequireGrpcError(t *testing.T, err error, expectedCode codes.Code)
• func TestRepository() *gitalypb.Repository
• type CreateCommitOpts
• type CreateTagOpts

Constants

const (
	TestRelativePath    = "gitlab-test.git"
	RepositoryAuthToken = "the-secret-token"
	DefaultStorageName  = "default"
)

TestRelativePath is the path inside its storage of the gitlab-test repo

Functions

func AddWorktree

func AddWorktree(t *testing.T, repoPath string, worktreeName string)

AddWorktree creates a worktree in the repository path for tests

func AssertFileNotExists

func AssertFileNotExists(t *testing.T, path string)

AssertFileNotExists asserts true if the file doesn't exist, false otherwise

func AuthorsEqual

func AuthorsEqual(a *gitalypb.CommitAuthor, b *gitalypb.CommitAuthor) bool

AuthorsEqual tests if two `CommitAuthor`s are equal

func CaptureHookEnv

func CaptureHookEnv(t *testing.T) (hookPath string, cleanup func())

CaptureHookEnv creates a bogus 'update' Git hook to sniff out what environment variables get set for hooks.

func ConfigureGitalySSH

func ConfigureGitalySSH()

ConfigureGitalySSH configures the gitaly-ssh command for tests

func ConfigureRuby

func ConfigureRuby()

ConfigureRuby configures Ruby settings for test purposes at run time.

func Context

func Context() (context.Context, func())

Context returns a cancellable context.

func CreateCommit

func CreateCommit(t *testing.T, repoPath, branchName string, opts *CreateCommitOpts) string

CreateCommit makes a new empty commit and updates the named branch to point to it.

func CreateCommitInAlternateObjectDirectory

func CreateCommitInAlternateObjectDirectory(t *testing.T, repoPath, altObjectsDir string, cmd *exec.Cmd) (currentHead []byte)

CreateCommitInAlternateObjectDirectory runs a command such that its created objects will live in an alternate objects directory. It returns the current head after the command is run and the alternate objects directory path

func CreateRemoteBranch

func CreateRemoteBranch(t *testing.T, repoPath, remoteName, branchName, ref string)

CreateRemoteBranch creates a new remote branch

func CreateRepo

func CreateRepo(t *testing.T, storagePath string) (repo *gitalypb.Repository, repoPath, relativePath string)

CreateRepo creates an temporary directory for a repo, without initializing it

func CreateTag

func CreateTag(t *testing.T, repoPath, tagName, targetID string, opts *CreateTagOpts) string

CreateTag creates a new tag.

func EnableGitProtocolV2Support

func EnableGitProtocolV2Support() func()

EnableGitProtocolV2Support ensures that Git protocol v2 support is enabled, and replaces the git binary in config with an `env_git` wrapper that allows the protocol to be tested. It returns a function that restores the given settings.

Because we don't know how to get to that wrapper script from the current working directory, callers must create a symbolic link to the `env_git` file in their own `testdata` directories.

func FindLocalBranchCommitAuthorsEqual

func FindLocalBranchCommitAuthorsEqual(a *gitalypb.FindLocalBranchCommitAuthor, b *gitalypb.FindLocalBranchCommitAuthor) bool

FindLocalBranchCommitAuthorsEqual tests if two `FindLocalBranchCommitAuthor`s are equal

func FindLocalBranchResponsesEqual

func FindLocalBranchResponsesEqual(a *gitalypb.FindLocalBranchResponse, b *gitalypb.FindLocalBranchResponse) bool

FindLocalBranchResponsesEqual tests if two `FindLocalBranchResponse`s are equal

func GetGitEnvData

func GetGitEnvData() (string, error)

GetGitEnvData reads and returns the content of testGitEnv

func GetRepositoryRefs

func GetRepositoryRefs(t *testing.T, repoPath string) string

GetRepositoryRefs gives a list of each repository ref as a string

func GetTemporaryGitalySocketFileName

func GetTemporaryGitalySocketFileName() string

GetTemporaryGitalySocketFileName will return a unique, useable socket file name

func GitCommitEqual

func GitCommitEqual(a, b *gitalypb.GitCommit) error

GitCommitEqual tests if two `GitCommit`s are equal

func GitalyServersMetadata

func GitalyServersMetadata(t *testing.T, serverSocketPath string) metadata.MD

GitalyServersMetadata returns a metadata pair for gitaly-servers to be used in inter-gitaly operations.

func GitlabTestStoragePath

func GitlabTestStoragePath() string

GitlabTestStoragePath returns the storage path to the gitlab-test repo.

func InitBareRepo

func InitBareRepo(t *testing.T) (*gitalypb.Repository, string, func())

InitBareRepo creates a new bare repository

func InitRepoWithWorktree

func InitRepoWithWorktree(t *testing.T) (*gitalypb.Repository, string, func())

InitRepoWithWorktree creates a new repository with a worktree

func MustHaveNoChildProcess

func MustHaveNoChildProcess()

MustHaveNoChildProcess panics if it finds a running or finished child process. It waits for 2 seconds for processes to be cleaned up by other goroutines.

func MustReadFile

func MustReadFile(t *testing.T, filename string) []byte

MustReadFile returns the content of a file or fails at once.

func MustRunCommand

func MustRunCommand(t *testing.T, stdin io.Reader, name string, args ...string) []byte

MustRunCommand runs a command with an optional standard input and returns the standard output, or fails.

func NewTestGrpcServer

func NewTestGrpcServer(t *testing.T, streamInterceptors []grpc.StreamServerInterceptor, unaryInterceptors []grpc.UnaryServerInterceptor) *grpc.Server

NewTestGrpcServer creates a GRPC Server for testing purposes

func NewTestLogger

func NewTestLogger(t *testing.T) *log.Logger

NewTestLogger created a logrus hook which can be used with testing logs

func NewTestObjectPoolName

func NewTestObjectPoolName(t *testing.T) string

NewTestObjectPoolName returns a random pool repository name.

func NewTestRepo

func NewTestRepo(t *testing.T) (repo *gitalypb.Repository, repoPath string, cleanup func())

NewTestRepo creates a bare copy of the test repository.

func NewTestRepoWithWorktree

func NewTestRepoWithWorktree(t *testing.T) (repo *gitalypb.Repository, repoPath string, cleanup func())

NewTestRepoWithWorktree creates a copy of the test repository with a worktree. This is allows you to run normal 'non-bare' Git commands.

func RemoteExists

func RemoteExists(t *testing.T, repoPath string, remoteName string) bool

RemoteExists tests if the repository at repoPath has a Git remote named remoteName.

func RequireGrpcError

func RequireGrpcError(t *testing.T, err error, expectedCode codes.Code)

RequireGrpcError asserts the passed err is of the same code as expectedCode.

func TestRepository

func TestRepository() *gitalypb.Repository

TestRepository returns the `Repository` object for the gitlab-test repo. Tests should be calling this function instead of cloning the repo themselves. Tests that involve modifications to the repo should copy/clone the repo via the `Repository` returned from this function.

Types

type CreateCommitOpts

type CreateCommitOpts struct {
	Message  string
	ParentID string
}

CreateCommitOpts holds extra options for CreateCommit.

type CreateTagOpts

type CreateTagOpts struct {
	Message string
}

CreateTagOpts holds extra options for CreateTag.