git

Documentation

Index

• func IsCommitSHA(sha string) bool
• func IsSSHURL(url string) (bool, string)
• func IsTruncatedCommitSHA(sha string) bool
• func NormalizeGitURL(repo string) string
• func SameURL(leftRepo, rightRepo string) bool
• func TestRepo(repo, username, password string, sshPrivateKey string, ...) error
• type Client
• type ClientFactory
  • func NewFactory() ClientFactory
• type Creds
• type HTTPSCreds
  • func NewHTTPSCreds(username, password string) HTTPSCreds
  • func (c HTTPSCreds) Environ() (io.Closer, []string, error)
• type NopCloser
  • func (c NopCloser) Close() error
• type NopCreds
  • func (c NopCreds) Environ() (io.Closer, []string, error)
• type SSHCreds
  • func NewSSHCreds(sshPrivateKey string, insecureIgnoreHostKey bool) SSHCreds
  • func (c SSHCreds) Environ() (io.Closer, []string, error)

Functions

func IsCommitSHA

func IsCommitSHA(sha string) bool

IsCommitSHA returns whether or not a string is a 40 character SHA-1

func IsSSHURL

func IsSSHURL(url string) (bool, string)

IsSSHURL returns true if supplied URL is SSH URL

func IsTruncatedCommitSHA

func IsTruncatedCommitSHA(sha string) bool

IsTruncatedCommitSHA returns whether or not a string is a truncated SHA-1

func NormalizeGitURL

func NormalizeGitURL(repo string) string

NormalizeGitURL normalizes a git URL for purposes of comparison, as well as preventing redundant local clones (by normalizing various forms of a URL to a consistent location). Prefer using SameURL() over this function when possible. This algorithm may change over time and should not be considered stable from release to release

func SameURL

func SameURL(leftRepo, rightRepo string) bool

SameURL returns whether or not the two repository URLs are equivalent in location

func TestRepo

func TestRepo(repo, username, password string, sshPrivateKey string, insecureIgnoreHostKey bool) error

TestRepo tests if a repo exists and is accessible with the given credentials

Types

type Client

type Client interface {
	Root() string
	Init() error
	Fetch() error
	Checkout(revision string) error
	LsRemote(revision string) (string, error)
	LsFiles(path string) ([]string, error)
	CommitSHA() (string, error)
}

Client is a generic git client interface

type ClientFactory

type ClientFactory interface {
	NewClient(repoURL, path, username, password, sshPrivateKey string, insecureIgnoreHostKey bool) (Client, error)
}

ClientFactory is a factory of Git Clients Primarily used to support creation of mock git clients during unit testing

func NewFactory

func NewFactory() ClientFactory

type Creds

type Creds interface {
	Environ() (io.Closer, []string, error)
}

type HTTPSCreds

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

HTTPS creds implementation

func NewHTTPSCreds

func NewHTTPSCreds(username, password string) HTTPSCreds

func (HTTPSCreds) Environ

func (c HTTPSCreds) Environ() (io.Closer, []string, error)

type NopCloser

type NopCloser struct {
}

nop implementation

func (NopCloser) Close

func (c NopCloser) Close() error

type NopCreds

type NopCreds struct {
}

func (NopCreds) Environ

func (c NopCreds) Environ() (io.Closer, []string, error)

type SSHCreds

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

SSH implementation

func NewSSHCreds

func NewSSHCreds(sshPrivateKey string, insecureIgnoreHostKey bool) SSHCreds

func (SSHCreds) Environ

func (c SSHCreds) Environ() (io.Closer, []string, error)