git

type AgitOptions struct {
	Directory, Remote, Head, Base, Topic, Title, Body string
	CredentialArgs                                    []string
	Prompt                                            bool
}

type BackportConflict struct {
	Target, Branch string
	Files          []string
	Kept           bool
}

type BackportOptions struct {
	// CredentialArgs contains per-operation Git configuration for the fetches only.
	CredentialArgs []string
	Directory      string
	Remote         string
	Prompt         bool
	Number         int64
	// Base is the branch the pull request was merged into, MergeCommit the commit the merge left
	// there and MergeBase the commit of Base the pull request started from.
	Base, MergeCommit, MergeBase string
	Target, Branch               string
	// Keep leaves a conflicting cherry-pick in progress to resolve instead of undoing the backport.
	Keep bool
	// Hold, when set, returns a runner for one cherry-pick that holds back Git's diagnostics and a
	// function that shows them, so that only those of a cherry-pick left to the user are shown.
	Hold func() (Runner, func())
}

type BackportResult struct {
	Target  string   `json:"target"`
	Branch  string   `json:"branch"`
	Picked  []string `json:"picked"`
	Commits []string `json:"commits"`
	Number  int64    `json:"-"`
}

type BackportSkipped struct{ Err error }

type BranchConfig struct {
	// Name is the local branch.
	Name string
	// Remote and Merge are the remote and branch the branch tracks, Merge without refs/heads/;
	// both are empty for a branch that tracks nothing or another local branch.
	Remote, Merge string
	// PullNumber and BaseRemote are what pr checkout recorded: the pull request the branch was
	// checked out from and the remote of that pull request's base repository.
	PullNumber int64
	BaseRemote string
}

type CheckoutOptions struct {
	// CredentialArgs contains per-operation Git configuration for the fetch only.
	CredentialArgs []string
	Directory      string
	Remote         string
	Number         int64
	Branch         string
	Detached       bool
	Update         bool
	Prompt         bool
	ExpectedCommit string
	// HeadRemote and HeadBranch select fork tracking when the head branch still exists.
	// When HeadBranch is empty, checkout fetches the retained pull ref from Remote.
	HeadRemote string
	HeadBranch string
}

type CheckoutResult struct {
	Detached bool   `json:"detached"`
	Branch   string `json:"branch"`
	Commit   string `json:"commit"`
	Remote   string `json:"remote,omitempty"`
	Tracking string `json:"tracking,omitempty"`
	// Unpushed counts the commits an existing branch has on top of the PR head, which it keeps.
	Unpushed int `json:"-"`
}

type CleanOptions struct {
	Directory, DefaultBranch, LocalBranch, Remote, RemoteBranch, RemoteSHA string
	CredentialArgs                                                         []string
	Prompt, DeleteRemote                                                   bool
}

type CleanResult struct {
	LocalBranch      string `json:"local_branch"`
	Remote           string `json:"remote,omitempty"`
	RemoteBranch     string `json:"remote_branch,omitempty"`
	DefaultBranch    string `json:"default_branch"`
	RemoteDeleted    bool   `json:"remote_deleted"`
	RemoteSkipped    bool   `json:"remote_skipped"`
	RemoteSkipReason string `json:"remote_skip_reason,omitempty"`
	// RemovedRemote is the Git remote that pr checkout added for the branch, removed with it.
	RemovedRemote string `json:"removed_remote,omitempty"`
}

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

type CommandError struct{ ExitCode int }

type CredentialSetup struct {
	Directory, Instance, Executable, User, ConfigDirectory string
	Local                                                  bool
	// KeepHelpers adds gt's helper after other helpers instead of resetting them for the instance,
	// replacing only a helper gt installed before.
	KeepHelpers bool
}

type FindCleanBranchOptions struct {
	Directory, HeadSHA, HeadBranch  string
	DefaultBranch                   string
	PreferredNames, MatchingRemotes []string
	IgnoreSHA                       bool
	// PullNumber is the pull request being cleaned; a branch that pr checkout recorded for it
	// wins over branches that merely share the head branch's name.
	PullNumber int64
}

type InputRunner interface {
	Input(ctx context.Context, dir, input string, args ...string) (string, error)
}

type LocalBranch struct {
	BranchConfig
	Commit  string
	Current bool
	// Committed and UpstreamCommitted are the committer dates of the branch's tip and of the
	// remote-tracking branch it tracks, which is zero when there is none.
	Committed, UpstreamCommitted time.Time
}

type Runner interface {
	Output(context.Context, string, bool, ...string) (string, error)
}

type SyncOptions struct {
	Directory, Remote, Branch string
	CredentialArgs            []string
	Prompt                    bool
}

type SyncResult struct {
	Branch   string `json:"branch"`
	Commit   string `json:"commit"`
	Previous string `json:"previous"`
	Remote   string `json:"remote"`
}

type System struct {
	// Env overrides the subprocess environment when supplied.
	Env    []string
	In     io.Reader
	ErrOut io.Writer
}