git

Documentation

Index

• Variables
• type Author
• type Commit
• type Git
  • func New(auth transport.AuthMethod, wrapper wrapper.Git) Git
• type GoGit
  • func (g *GoGit) Clone(ctx context.Context, path, url, branch string) (bool, error)
  • func (g *GoGit) Commit(message Commit, filters ...func(string) bool) (string, error)
  • func (g *GoGit) GetRemoteUrl(dir string, remoteName string) (string, error)
  • func (g *GoGit) Head() (string, error)
  • func (g *GoGit) Init(path, url, branch string) (bool, error)
  • func (g *GoGit) Open(path string) (*gogit.Repository, error)
  • func (g *GoGit) Push(ctx context.Context) error
  • func (g *GoGit) Remove(path string) error
  • func (g *GoGit) Status() (bool, error)
  • func (g *GoGit) ValidateAccess(ctx context.Context, url string, branch string) error
  • func (g *GoGit) Write(path string, content []byte) error

Variables

var (
	ErrNoGitRepository = errors.New("no git repository")
	ErrNoStagedFiles   = errors.New("no staged files")
)

Types

type Author

type Author struct {
	Name  string
	Email string
}

type Commit

type Commit struct {
	Author
	Hash    string
	Message string
}

type Git

type Git interface {
	Open(path string) (*gogit.Repository, error)
	Init(path, url, branch string) (bool, error)
	Clone(ctx context.Context, path, url, branch string) (bool, error)
	Write(path string, content []byte) error
	Remove(path string) error
	Commit(message Commit, filters ...func(string) bool) (string, error)
	Push(ctx context.Context) error
	Status() (bool, error)
	Head() (string, error)
	GetRemoteUrl(dir string, remoteName string) (string, error)
	ValidateAccess(ctx context.Context, url string, branch string) error
}

Git is an interface for basic Git operations on a single branch of a remote repository.

func New

func New(auth transport.AuthMethod, wrapper wrapper.Git) Git

type GoGit

type GoGit struct {
	// contains filtered or unexported fields
}

func (*GoGit) Clone

func (g *GoGit) Clone(ctx context.Context, path, url, branch string) (bool, error)

Clone clones a starting repository URL to a path, and checks out the provided branch name.

If the directory is successfully initialised, it returns true, otherwise it returns false.

func (*GoGit) Commit

func (g *GoGit) Commit(message Commit, filters ...func(string) bool) (string, error)

func (*GoGit) GetRemoteUrl

func (g *GoGit) GetRemoteUrl(dir string, remoteName string) (string, error)

GetRemoteUrl returns the url of the first listed remote server

func (*GoGit) Head

func (g *GoGit) Head() (string, error)

func (*GoGit) Init

func (g *GoGit) Init(path, url, branch string) (bool, error)

Init initialises the directory at path with the remote and branch provided.

If the directory is successfully initialised it returns true, otherwise if the directory is already initialised, it returns false.

func (*GoGit) Open

func (g *GoGit) Open(path string) (*gogit.Repository, error)

Open opens a git repository in the provided path, and returns a repository.

func (*GoGit) Push

func (g *GoGit) Push(ctx context.Context) error

func (*GoGit) Remove

func (g *GoGit) Remove(path string) error

Remove removes the file at path

func (*GoGit) Status

func (g *GoGit) Status() (bool, error)

Status returns true if no files in the repository have been modified.

func (*GoGit) ValidateAccess

func (g *GoGit) ValidateAccess(ctx context.Context, url string, branch string) error

func (*GoGit) Write

func (g *GoGit) Write(path string, content []byte) error

Write writes the provided content to the path, if the file exists, it will be truncated.