git

Documentation

Index

• type Client
  • func NewClient(serverURL string, gitKind string) (Client, error)
  • func NewClientWithDir(serverURL string, gitKind string, dir string) (Client, error)
• type Repo
  • func (r *Repo) Am(path string) error
  • func (r *Repo) Checkout(commitlike string) error
  • func (r *Repo) CheckoutNewBranch(branch string) error
  • func (r *Repo) CheckoutPullRequest(number int) error
  • func (r *Repo) Clean() error
  • func (r *Repo) Config(key, value string) error
  • func (r *Repo) Merge(commitlike string) (bool, error)
  • func (r *Repo) Push(repo, branch string) error
  • func (r *Repo) RevParse(commitlike string) (string, error)

Types

type Client

type Client interface {
	Clean() error
	SetRemote(remote string)
	SetCredentials(user string, tokenGenerator func() []byte)
	Clone(repo string) (*Repo, error)
	SparseClone(repo string, sparseCheckoutPatterns []string) (*Repo, error)
}

Client represents a git client

func NewClient

func NewClient(serverURL string, gitKind string) (Client, error)

NewClient returns a client that talks to GitHub. It will fail if git is not in the PATH.

func NewClientWithDir

func NewClientWithDir(serverURL string, gitKind string, dir string) (Client, error)

NewClientWithDir uses an existing directory for creating the client.

type Repo

type Repo struct {
	// Dir is the location of the git repo.
	Dir string
	// contains filtered or unexported fields
}

Repo is a clone of a git repository. Launch with Client.Clone, and don't forget to clean it up after.

func (*Repo) Am

func (r *Repo) Am(path string) error

Am tries to apply the patch in the given path into the current branch by performing a three-way merge (similar to git cherry-pick). It returns an error if the patch cannot be applied.

func (*Repo) Checkout

func (r *Repo) Checkout(commitlike string) error

Checkout runs git checkout.

func (*Repo) CheckoutNewBranch

func (r *Repo) CheckoutNewBranch(branch string) error

CheckoutNewBranch creates a new branch and checks it out.

func (*Repo) CheckoutPullRequest

func (r *Repo) CheckoutPullRequest(number int) error

CheckoutPullRequest does exactly that.

func (*Repo) Clean

func (r *Repo) Clean() error

Clean deletes the repo. It is unusable after calling.

func (*Repo) Config

func (r *Repo) Config(key, value string) error

Config runs git config.

func (*Repo) Merge

func (r *Repo) Merge(commitlike string) (bool, error)

Merge attempts to merge commitlike into the current branch. It returns true if the merge completes. It returns an error if the abort fails.

func (*Repo) Push

func (r *Repo) Push(repo, branch string) error

Push pushes over https to the provided owner/repo#branch using a password for basic auth.

func (*Repo) RevParse

func (r *Repo) RevParse(commitlike string) (string, error)

RevParse runs git rev-parse.