gitdomain

package
v20.2.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: May 15, 2025 License: MIT Imports: 6 Imported by: 0

Documentation

Overview

Package gitdomain defines basic concepts from the domain of Git: branches, remotes, commit SHAs, etc.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func NewAuthorOpt 

func NewAuthorOpt(name string) Option[Author]

func NewLocalBranchNameOption 

func NewLocalBranchNameOption(id string) Option[LocalBranchName]

func NewRemote 

func NewRemote(id string) Option[Remote]

func NewRemoteBranchNameOption 

func NewRemoteBranchNameOption(id string) Option[RemoteBranchName]

Types

type Author 

type Author string

Author represents the author of a commit in the format "name <email>"

func (Author) String 

func (self Author) String() string

implements fmt.Stringer

type BranchInfo 

type BranchInfo struct {
	// LocalName contains the local name of the branch.
	LocalName Option[LocalBranchName]

	// LocalSHA contains the SHA that this branch had locally before Git Town ran.
	LocalSHA Option[SHA]

	// RemoteName contains the fully qualified name of the tracking branch, i.e. "origin/foo".
	RemoteName Option[RemoteBranchName]

	// RemoteSHA contains the SHA of the tracking branch before Git Town ran.
	RemoteSHA Option[SHA]

	// SyncStatus of the branch
	SyncStatus SyncStatus
}

BranchInfo describes the sync status of a branch in relation to its tracking branch.

func (BranchInfo) GetLocal 

func (self BranchInfo) GetLocal() (bool, LocalBranchName, SHA)

provides both the name and SHA of the local branch

func (BranchInfo) GetLocalOrRemoteName 

func (self BranchInfo) GetLocalOrRemoteName() BranchName

func (BranchInfo) GetLocalOrRemoteSHA 

func (self BranchInfo) GetLocalOrRemoteSHA() SHA

func (BranchInfo) GetRemoteBranch 

func (self BranchInfo) GetRemoteBranch() (bool, RemoteBranchName, SHA)

provides both the name and SHA of the remote branch

func (BranchInfo) GetSHAs 

func (self BranchInfo) GetSHAs() (hasBothSHA bool, localSHA, remoteSHA SHA)

provides the SHAs of the local and remote branch

func (BranchInfo) HasLocalBranch 

func (self BranchInfo) HasLocalBranch() (hasLocalBranch bool, branchName LocalBranchName, sha SHA)

func (BranchInfo) HasOnlyLocalBranch 

func (self BranchInfo) HasOnlyLocalBranch() bool

func (BranchInfo) HasOnlyRemoteBranch 

func (self BranchInfo) HasOnlyRemoteBranch() bool

func (BranchInfo) HasRemoteBranch 

func (self BranchInfo) HasRemoteBranch() (hasRemoteBranch bool, remoteBranchName RemoteBranchName, remoteBranchSHA SHA)

func (BranchInfo) HasTrackingBranch 

func (self BranchInfo) HasTrackingBranch() bool

func (BranchInfo) IsLocalOnlyBranch 

func (self BranchInfo) IsLocalOnlyBranch() (bool, LocalBranchName)

func (BranchInfo) IsOmniBranch 

func (self BranchInfo) IsOmniBranch() (isOmni bool, branch LocalBranchName, sha SHA)

Indicates whether the branch described by this BranchInfo is omni and provides all relevant data around this scenario. An omni branch has the same SHA locally and remotely.

func (BranchInfo) LocalBranchName 

func (self BranchInfo) LocalBranchName() LocalBranchName

provides the name of this branch as a local branch, independent of whether this branch is local or not

func (BranchInfo) String 

func (self BranchInfo) String() string

type BranchInfos 

type BranchInfos []BranchInfo

BranchInfos contains the BranchInfos for all branches in a repo. Tracking branches on the origin remote don't get their own entry, they are listed in the `TrackingBranch` property of the local branch they track.

func (BranchInfos) BranchIsActiveInAnotherWorktree 

func (self BranchInfos) BranchIsActiveInAnotherWorktree(branch LocalBranchName) bool

func (BranchInfos) FindByLocalName 

func (self BranchInfos) FindByLocalName(branchName LocalBranchName) OptionalMutable[BranchInfo]

FindByLocalName provides the branch with the given name if one exists.

func (BranchInfos) FindByRemoteName 

func (self BranchInfos) FindByRemoteName(remoteBranch RemoteBranchName) OptionalMutable[BranchInfo]

FindByRemoteName provides the local branch that has the given remote branch as its tracking branch or nil if no such branch exists.

func (BranchInfos) FindLocalOrRemote 

func (self BranchInfos) FindLocalOrRemote(branchName LocalBranchName, remote Remote) OptionalMutable[BranchInfo]

func (BranchInfos) FindMatchingRecord 

func (self BranchInfos) FindMatchingRecord(other BranchInfo) OptionalMutable[BranchInfo]

func (BranchInfos) HasBranch 

func (self BranchInfos) HasBranch(branch LocalBranchName) bool

func (BranchInfos) HasLocalBranch 

func (self BranchInfos) HasLocalBranch(branch LocalBranchName) bool

HasLocalBranch indicates whether the given local branch is already known to this BranchInfos instance.

func (BranchInfos) HasLocalBranches 

func (self BranchInfos) HasLocalBranches(branches LocalBranchNames) bool

HasLocalBranches indicates whether this BranchInfos instance contains all the given branches.

func (BranchInfos) HasMatchingTrackingBranchFor 

func (self BranchInfos) HasMatchingTrackingBranchFor(localBranch LocalBranchName, devRemote Remote) bool

HasMatchingRemoteBranchFor indicates whether there is already a remote branch matching the given local branch.

func (BranchInfos) LocalBranches 

func (self BranchInfos) LocalBranches() BranchInfos

LocalBranches provides only the branches that exist on the local machine.

func (BranchInfos) LocalBranchesWithDeletedTrackingBranches 

func (self BranchInfos) LocalBranchesWithDeletedTrackingBranches() BranchInfos

LocalBranchesWithDeletedTrackingBranches provides only the branches that exist locally and have a deleted tracking branch.

func (BranchInfos) Names 

func (self BranchInfos) Names() LocalBranchNames

Names provides the names of all local branches in this BranchesSyncStatus instance.

func (BranchInfos) Remove 

func (self BranchInfos) Remove(branchName LocalBranchName) BranchInfos

func (BranchInfos) Select 

func (self BranchInfos) Select(remote Remote, names ...LocalBranchName) (result BranchInfos, nonExisting LocalBranchNames)

Select provides the BranchInfos with the given names.

func (BranchInfos) String 

func (self BranchInfos) String() string

func (BranchInfos) UpdateLocalSHA 

func (self BranchInfos) UpdateLocalSHA(branch LocalBranchName, sha SHA) error

type BranchName 

type BranchName string

BranchName is the name of a local or remote Git branch.

func NewBranchName 

func NewBranchName(id string) BranchName

func (BranchName) IsLocal 

func (self BranchName) IsLocal() bool

IsLocal indicates whether the branch with this BranchName exists locally.

func (BranchName) LocalName 

func (self BranchName) LocalName() LocalBranchName

LocalName provides the (theoretical) local version of this branch name.

func (BranchName) Location 

func (self BranchName) Location() Location

func (BranchName) RemoteName 

func (self BranchName) RemoteName() RemoteBranchName

RemoteName provides the remote version of this branch name.

func (BranchName) String 

func (self BranchName) String() string

Implementation of the fmt.Stringer interface.

type BranchNames 

type BranchNames []BranchName

func (BranchNames) Join 

func (self BranchNames) Join(sep string) string

func (BranchNames) Strings 

func (self BranchNames) Strings() []string

type BranchesSnapshot 

type BranchesSnapshot struct {
	// the branch that was checked out at the time the snapshot was taken
	Active Option[LocalBranchName]

	// Branches is a read-only copy of the branches that exist in this repo at the time the snapshot was taken.
	// Don't use these branches for business logic since businss logic might want to modify its in-memory cache of branches
	// as it adds or removes branches.
	Branches BranchInfos
}

BranchesSnapshot is a snapshot of the Git branches at a particular point in time.

func EmptyBranchesSnapshot 

func EmptyBranchesSnapshot() BranchesSnapshot

type Commit 

type Commit struct {
	Message CommitMessage
	SHA     SHA
}

type CommitMessage 

type CommitMessage string

CommitMessage is the entire textual messages of a Git commit.

func (CommitMessage) Parts 

func (self CommitMessage) Parts() CommitMessageParts

Parts separates the parts of the given commit message.

func (CommitMessage) String 

func (self CommitMessage) String() string

String implements the fmt.Stringer interface.

type CommitMessageParts 

type CommitMessageParts struct {
	Subject string // the first line of the commit message
	Text    string // the commit message text minus the first line and empty lines separating it from the rest of the message
}

CommitMessageParts describes the parts of a Git commit message.

type CommitMessages 

type CommitMessages []CommitMessage

func NewCommitMessages 

func NewCommitMessages(messages ...string) CommitMessages

type Commits 

type Commits []Commit

func (Commits) ContainsSHA 

func (self Commits) ContainsSHA(sha SHA) bool

ContainsSHA indicates whether this commits list contains a commit with the given SHA.

func (Commits) Messages 

func (self Commits) Messages() CommitMessages

func (Commits) SHAs 

func (self Commits) SHAs() SHAs

type ConflictResolution added in v20.2.0 

type ConflictResolution string
const (
	ConflictResolutionOurs   ConflictResolution = "ours"
	ConflictResolutionTheirs ConflictResolution = "theirs"
)

func (ConflictResolution) GitFlag added in v20.2.0 

func (self ConflictResolution) GitFlag() string

func (ConflictResolution) String added in v20.2.0 

func (self ConflictResolution) String() string

type LocalBranchName 

type LocalBranchName string

LocalBranchName is the name of a local Git branch. The zero value is an empty local branch name, i.e. a local branch name that is unknown or not configured.

func NewLocalBranchName 

func NewLocalBranchName(id string) LocalBranchName

func (LocalBranchName) AtRemote 

func (self LocalBranchName) AtRemote(remote Remote) RemoteBranchName

AtRemote provides the RemoteBranchName of this branch at the given remote.

func (LocalBranchName) BranchName 

func (self LocalBranchName) BranchName() BranchName

BranchName widens the type of this LocalBranchName to a more generic BranchName.

func (LocalBranchName) Location 

func (self LocalBranchName) Location() Location

Location widens the type of this LocalBranchName to a more generic Location.

func (LocalBranchName) String 

func (self LocalBranchName) String() string

Implementation of the fmt.Stringer interface.

func (LocalBranchName) TrackingBranch 

func (self LocalBranchName) TrackingBranch(devRemote Remote) RemoteBranchName

TrackingBranch provides the name of the tracking branch for this local branch.

type LocalBranchNames 

type LocalBranchNames []LocalBranchName

func NewLocalBranchNames 

func NewLocalBranchNames(names ...string) LocalBranchNames

func ParseLocalBranchNames 

func ParseLocalBranchNames(names string) LocalBranchNames

ParseLocalBranchNamesRef constructs a LocalBranchNames instance containing the branches listed in the given space-separated string.

func (LocalBranchNames) AppendAllMissing 

func (self LocalBranchNames) AppendAllMissing(others ...LocalBranchName) LocalBranchNames

AppendAllMissing provides a LocalBranchNames list consisting of the sum of this and elements of other list that aren't in this list.

func (LocalBranchNames) BranchNames 

func (self LocalBranchNames) BranchNames() []BranchName

func (LocalBranchNames) Contains 

func (self LocalBranchNames) Contains(branch LocalBranchName) bool

Contains indicates whether this collection contains the given branch.

func (LocalBranchNames) Hoist 

func (self LocalBranchNames) Hoist(needle LocalBranchName) LocalBranchNames

Hoist moves the given needle to the front of the list.

func (LocalBranchNames) Join 

func (self LocalBranchNames) Join(sep string) string

Join provides the names of all branches in this collection connected by the given separator.

func (LocalBranchNames) Remove 

func (self LocalBranchNames) Remove(toRemove ...LocalBranchName) LocalBranchNames

Remove removes the given branch names from this collection.

func (LocalBranchNames) Sort 

func (self LocalBranchNames) Sort()

Sort orders the branches in this collection alphabetically.

func (LocalBranchNames) String 

func (self LocalBranchNames) String() string

func (LocalBranchNames) Strings 

func (self LocalBranchNames) Strings() []string

Strings provides the names of all branches in this collection as strings.

type Location 

type Location string

Location is a location within a Git repo. Examples for locations are SHA addresses of commits or branch names.

func NewLocation 

func NewLocation(id string) Location

func (Location) IsRemoteBranchName 

func (self Location) IsRemoteBranchName() bool

func (Location) String 

func (self Location) String() string

Implementation of the fmt.Stringer interface.

type ProposalBody 

type ProposalBody string

ProposalBody is the body of a proposal

func (ProposalBody) String 

func (self ProposalBody) String() string

String implements the fmt.Stringer interface.

type ProposalBodyFile 

type ProposalBodyFile string

ProposalBody is the body of a proposal

func (ProposalBodyFile) ShouldReadStdin 

func (self ProposalBodyFile) ShouldReadStdin() bool

indicates whether the body should be read from STDIN

func (ProposalBodyFile) String 

func (self ProposalBodyFile) String() string

String implements the fmt.Stringer interface.

type ProposalTitle 

type ProposalTitle string

ProposalTitle is the title of a proposal

func (ProposalTitle) String 

func (self ProposalTitle) String() string

String implements the fmt.Stringer interface.

type Querier 

type Querier interface {
	Query(executable string, args ...string) (string, error)
	QueryTrim(executable string, args ...string) (string, error)
}

type Remote 

type Remote string

Remote represents a Git remote. 

const (
	RemoteOrigin   Remote = "origin"
	RemoteUpstream Remote = "upstream"
)

func (Remote) String 

func (self Remote) String() string

Implementation of the fmt.Stringer interface.

type RemoteBranchName 

type RemoteBranchName string

RemoteBranchName is the name of a remote branch, e.g. "origin/foo".

func NewRemoteBranchName 

func NewRemoteBranchName(id string) RemoteBranchName

func (RemoteBranchName) BranchName 

func (self RemoteBranchName) BranchName() BranchName

BranchName widens the type of this RemoteBranchName to a more generic BranchName.

func (RemoteBranchName) LocalBranchName 

func (self RemoteBranchName) LocalBranchName() LocalBranchName

LocalBranchName provides the name of the local branch that this remote branch tracks.

func (RemoteBranchName) Parts 

func (self RemoteBranchName) Parts() (Remote, LocalBranchName)

func (RemoteBranchName) Remote 

func (self RemoteBranchName) Remote() Remote

func (RemoteBranchName) String 

func (self RemoteBranchName) String() string

Implementation of the fmt.Stringer interface.

type RemoteBranchNames 

type RemoteBranchNames []RemoteBranchName

func (RemoteBranchNames) Sort 

func (self RemoteBranchNames) Sort()

Sort orders the branches in this collection alphabetically.

func (RemoteBranchNames) Strings 

func (self RemoteBranchNames) Strings() []string

Strings provides these remote branch names as strings.

type Remotes 

type Remotes []Remote

Remotes answers questions which Git remotes a repo has.

func NewRemotes 

func NewRemotes(remotes ...string) Remotes

func (Remotes) HasRemote 

func (self Remotes) HasRemote(remote Remote) bool

func (Remotes) HasUpstream 

func (self Remotes) HasUpstream() bool

type RepoRootDir 

type RepoRootDir string

RepoRootDir represents the root directory of a Git repository.

func NewRepoRootDir 

func NewRepoRootDir(dir string) RepoRootDir

func (RepoRootDir) String 

func (self RepoRootDir) String() string

type RepoStatus 

type RepoStatus struct {
	Conflicts        bool // the repo contains merge conflicts
	OpenChanges      bool // there are uncommitted changes
	RebaseInProgress bool // a rebase is in progress
	UntrackedChanges bool // the repo contains files that aren't tracked by Git
}

type Runner 

type Runner interface {
	Run(executable string, args ...string) error
	RunWithEnv(env []string, executable string, args ...string) error
}

type RunnerQuerier 

type RunnerQuerier interface {
	Runner
	Querier
}

type SHA 

type SHA string

SHA represents a Git SHA as a dedicated data type. This helps avoid stringly-typed code.

func NewSHA 

func NewSHA(id string) SHA

NewSHA creates a new SHA instance with the given value. The value is verified for correctness.

func NewSHAErr 

func NewSHAErr(id string) (SHA, error)

func (SHA) Location 

func (self SHA) Location() Location

Location widens the type of this SHA to a more generic Location.

func (SHA) String 

func (self SHA) String() string

Implementation of the fmt.Stringer interface.

func (SHA) Truncate 

func (self SHA) Truncate(newLen int) SHA

Truncates reduces the length of this SHA to the given length. This is only for test code. Please use git.Commands.ShortenSHA in production code.

type SHAs 

type SHAs []SHA

func NewSHAs 

func NewSHAs(ids ...string) SHAs

func (SHAs) First 

func (self SHAs) First() SHA

func (SHAs) Join 

func (self SHAs) Join(sep string) string

func (SHAs) Last 

func (self SHAs) Last() SHA

func (SHAs) Strings 

func (self SHAs) Strings() []string

type StashSize 

type StashSize int

StashSize contains the number of Git stashes.

type SyncStatus 

type SyncStatus string

SyncStatus encodes the places a branch can exist at. This is a type-safe enum, see https://npf.io/2022/05/safer-enums. 

const (
	SyncStatusUpToDate        SyncStatus = "up to date"                 // the branch exists locally and remotely, the local branch is up to date
	SyncStatusAhead           SyncStatus = "ahead"                      // the branch exists locally and remotely, the local branch is ahead of the remote branch
	SyncStatusBehind          SyncStatus = "behind"                     // the branch exists locally and remotely, the local branch is behind the remote branch
	SyncStatusNotInSync       SyncStatus = "not in sync"                // the branch exists locally and remotely, the local branch has different commits than the remote branch
	SyncStatusLocalOnly       SyncStatus = "local only"                 // the branch was created locally and hasn't been pushed to the remote yet
	SyncStatusRemoteOnly      SyncStatus = "remote only"                // the branch exists only at the remote
	SyncStatusDeletedAtRemote SyncStatus = "deleted at remote"          // the branch was deleted on the remote
	SyncStatusOtherWorktree   SyncStatus = "active in another worktree" // the branch is active in another worktree and should not be synced
)

func (SyncStatus) String 

func (self SyncStatus) String() string

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.