git

Documentation

Overview

Package git contains various commands that shell out to git

Package git contains various commands that shell out to git

Index

• Constants
• Variables
• func CloneWithoutFilters(args []string) error
• func DefaultRemote() (string, error)
• func FormatGitDate(tm time.Time) string
• func GitAndRootDirs() (string, string, error)
• func GitDir() (string, error)
• func IsVersionAtLeast(actualVersion, desiredVersion string) bool
• func LsRemote(remote, remoteRef string) (string, error)
• func ParseGitDate(str string) (time.Time, error)
• func RemoteBranchForLocalBranch(localBranch string) string
• func RemoteForBranch(localBranch string) string
• func RemoteForCurrentBranch() (string, error)
• func RemoteList() ([]string, error)
• func RemoteRefNameForCurrentBranch() (string, error)
• func RootDir() (string, error)
• func UpdateIndex(file string) error
• func ValidateRemote(remote string) error
• type CommitSummary
  • func GetCommitSummary(commit string) (*CommitSummary, error)
• type Ref
  • func CurrentRef() (*Ref, error)
  • func CurrentRemoteRef() (*Ref, error)
  • func GetAllWorkTreeHEADs(storageDir string) ([]*Ref, error)
  • func RecentBranches(since time.Time, includeRemoteBranches bool, onlyRemote string) ([]*Ref, error)
  • func ResolveRef(ref string) (*Ref, error)
• type RefType
  • func ParseRefToTypeAndName(fullref string) (t RefType, name string)

Constants

const (
	RefTypeLocalBranch  = RefType(iota)
	RefTypeRemoteBranch = RefType(iota)
	RefTypeLocalTag     = RefType(iota)
	RefTypeRemoteTag    = RefType(iota)
	RefTypeHEAD         = RefType(iota) // current checkout
	RefTypeOther        = RefType(iota) // stash or unknown
)

Variables

var Config = &gitConfig{}

Functions

func CloneWithoutFilters

func CloneWithoutFilters(args []string) error

CloneWithoutFilters clones a git repo but without the smudge filter enabled so that files in the working copy will be pointers and not real LFS data

func DefaultRemote

func DefaultRemote() (string, error)

DefaultRemote returns the default remote based on: 1. The currently tracked remote branch, if present 2. "origin", if defined 3. Any other SINGLE remote defined in .git/config Returns an error if all of these fail, i.e. no tracked remote branch, no "origin", and either no remotes defined or 2+ non-"origin" remotes

func FormatGitDate

func FormatGitDate(tm time.Time) string

FormatGitDate converts a Go date into a git command line format date

func GitAndRootDirs

func GitAndRootDirs() (string, string, error)

func GitDir

func GitDir() (string, error)

func IsVersionAtLeast

func IsVersionAtLeast(actualVersion, desiredVersion string) bool

IsVersionAtLeast compares 2 version strings (ok to be prefixed with 'git version', ignores)

func LsRemote

func LsRemote(remote, remoteRef string) (string, error)

func ParseGitDate

func ParseGitDate(str string) (time.Time, error)

Parse a Git date formatted in ISO 8601 format (%ci/%ai)

func RemoteBranchForLocalBranch

func RemoteBranchForLocalBranch(localBranch string) string

RemoteBranchForLocalBranch returns the name (only) of the remote branch that the local branch is tracking If no specific branch is configured, returns local branch name

func RemoteForBranch

func RemoteForBranch(localBranch string) string

RemoteForBranch returns the remote name that a given local branch is tracking (blank if none)

func RemoteForCurrentBranch

func RemoteForCurrentBranch() (string, error)

RemoteForCurrentBranch returns the name of the remote that the current branch is tracking

func RemoteList

func RemoteList() ([]string, error)

func RemoteRefNameForCurrentBranch

func RemoteRefNameForCurrentBranch() (string, error)

RemoteRefForCurrentBranch returns the full remote ref (remote/remotebranch) that the current branch is tracking

func RootDir

func RootDir() (string, error)

func UpdateIndex

func UpdateIndex(file string) error

func ValidateRemote

func ValidateRemote(remote string) error

ValidateRemote checks that a named remote is valid for use Mainly to check user-supplied remotes & fail more nicely

Types

type CommitSummary

type CommitSummary struct {
	Sha            string
	ShortSha       string
	Parents        []string
	CommitDate     time.Time
	AuthorDate     time.Time
	AuthorName     string
	AuthorEmail    string
	CommitterName  string
	CommitterEmail string
	Subject        string
}

Some top level information about a commit (only first line of message)

func GetCommitSummary

func GetCommitSummary(commit string) (*CommitSummary, error)

Get summary information about a commit

type Ref

type Ref struct {
	Name string
	Type RefType
	Sha  string
}

A git reference (branch, tag etc)

func CurrentRef

func CurrentRef() (*Ref, error)

func CurrentRemoteRef

func CurrentRemoteRef() (*Ref, error)

func GetAllWorkTreeHEADs

func GetAllWorkTreeHEADs(storageDir string) ([]*Ref, error)

GetAllWorkTreeHEADs returns the refs that all worktrees are using as HEADs This returns all worktrees plus the master working copy, and works even if working dir is actually in a worktree right now Pass in the git storage dir (parent of 'objects') to work from

func RecentBranches

func RecentBranches(since time.Time, includeRemoteBranches bool, onlyRemote string) ([]*Ref, error)

RecentBranches returns branches with commit dates on or after the given date/time Return full Ref type for easier detection of duplicate SHAs etc since: refs with commits on or after this date will be included includeRemoteBranches: true to include refs on remote branches onlyRemote: set to non-blank to only include remote branches on a single remote

func ResolveRef

func ResolveRef(ref string) (*Ref, error)

type RefType

type RefType int

func ParseRefToTypeAndName

func ParseRefToTypeAndName(fullref string) (t RefType, name string)

Get the type & name of a git reference