git

package
v0.32.0 Latest Latest
Warning

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

 Go to latest Published: Mar 9, 2026 License: BSD-2-Clause Imports: 13 Imported by: 0

Documentation

Overview

Package git provides version control operations for commits, tags, branches, and PRs.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func CommitAndRelease 

func CommitAndRelease(ctx context.Context, bump VersionBump) error

CommitAndRelease performs the full git workflow: 1. git add -A 2. Read CHANGELOG.md and rename ## Unreleased to version 3. Bump version (patch or minor) 4. git commit 5. git tag 6. git push + push tag

func CommitCompletedFile added in v0.2.27 

func CommitCompletedFile(ctx context.Context, path string) error

CommitCompletedFile stages and commits a completed prompt file. This is called after MoveToCompleted() to ensure the moved file is committed. Does nothing if the file is already staged or committed.

func GetNextVersion added in v0.2.0 

func GetNextVersion(ctx context.Context, bump VersionBump) (string, error)

GetNextVersion determines the next version based on the bump type.

func MoveFile added in v0.2.36 

func MoveFile(ctx context.Context, oldPath string, newPath string) error

MoveFile moves a file using git mv to preserve history. Falls back to os.Rename if git operations fail or not in a git repo.

func ResolveGitRoot added in v0.32.0 

func ResolveGitRoot(ctx context.Context) (string, error)

ResolveGitRoot returns the absolute path to the root of the current git repository by running `git rev-parse --show-toplevel`. Returns an error if not inside a git repo.

Types

type Brancher added in v0.9.0 

type Brancher interface {
	CreateAndSwitch(ctx context.Context, name string) error
	Push(ctx context.Context, name string) error
	Switch(ctx context.Context, name string) error
	CurrentBranch(ctx context.Context) (string, error)
	Fetch(ctx context.Context) error
	FetchAndVerifyBranch(ctx context.Context, branch string) error
	DefaultBranch(ctx context.Context) (string, error)
	Pull(ctx context.Context) error
	MergeOriginDefault(ctx context.Context) error
}

Brancher handles git branch operations.

func NewBrancher added in v0.9.0 

func NewBrancher() Brancher

NewBrancher creates a new Brancher.

type Cloner added in v0.30.4 

type Cloner interface {
	Clone(ctx context.Context, srcDir string, destDir string, branch string) error
	Remove(ctx context.Context, path string) error
}

Cloner handles local git clone operations.

func NewCloner added in v0.30.4 

func NewCloner() Cloner

NewCloner creates a new Cloner.

type CollaboratorFetcher added in v0.30.12 

type CollaboratorFetcher interface {
	Fetch(ctx context.Context) []string
}

CollaboratorFetcher fetches GitHub repository collaborators.

func NewCollaboratorFetcher added in v0.30.12 

func NewCollaboratorFetcher(
	repoNameFetcher RepoNameFetcher,
	collaboratorLister CollaboratorLister,
	useCollaborators bool,
	allowedReviewers []string,
) CollaboratorFetcher

NewCollaboratorFetcher creates a CollaboratorFetcher. If useCollaborators is false or allowedReviewers is non-empty, collaborators are not fetched from GitHub.

type CollaboratorLister added in v0.30.15 

type CollaboratorLister interface {
	List(ctx context.Context, repoName string) ([]string, error)
}

CollaboratorLister lists collaborator logins for a GitHub repository.

func NewGHCollaboratorLister added in v0.30.15 

func NewGHCollaboratorLister(ghToken string) CollaboratorLister

NewGHCollaboratorLister creates a CollaboratorLister that uses gh CLI.

type PRCreator added in v0.9.0 

type PRCreator interface {
	Create(ctx context.Context, title string, body string) (string, error)
}

PRCreator handles GitHub pull request creation.

func NewPRCreator added in v0.9.0 

func NewPRCreator(ghToken string) PRCreator

NewPRCreator creates a new PRCreator.

type PRMerger added in v0.17.6 

type PRMerger interface {
	WaitAndMerge(ctx context.Context, prURL string) error
}

PRMerger watches a PR until mergeable and merges it.

func NewPRMerger added in v0.17.6 

func NewPRMerger(ghToken string) PRMerger

NewPRMerger creates a new PRMerger.

type Releaser added in v0.2.26 

type Releaser interface {
	GetNextVersion(ctx context.Context, bump VersionBump) (string, error)
	CommitAndRelease(ctx context.Context, bump VersionBump) error
	CommitCompletedFile(ctx context.Context, path string) error
	CommitOnly(ctx context.Context, message string) error
	HasChangelog(ctx context.Context) bool
	MoveFile(ctx context.Context, oldPath string, newPath string) error
}

Releaser handles git commit, tag, and push operations.

func NewReleaser added in v0.2.26 

func NewReleaser() Releaser

NewReleaser creates a new Releaser.

type RepoNameFetcher added in v0.30.15 

type RepoNameFetcher interface {
	Fetch(ctx context.Context) (string, error)
}

RepoNameFetcher fetches the current GitHub repository name with owner.

func NewGHRepoNameFetcher added in v0.30.15 

func NewGHRepoNameFetcher(ghToken string) RepoNameFetcher

NewGHRepoNameFetcher creates a RepoNameFetcher that uses gh CLI.

type ReviewFetcher added in v0.17.35 

type ReviewFetcher interface {
	// FetchLatestReview returns the latest review from a trusted reviewer.
	// Returns ReviewVerdictNone if no trusted review exists yet.
	FetchLatestReview(
		ctx context.Context,
		prURL string,
		allowedReviewers []string,
	) (*ReviewResult, error)
	// FetchPRState returns the raw PR state string: "OPEN", "MERGED", "CLOSED".
	FetchPRState(ctx context.Context, prURL string) (string, error)
}

ReviewFetcher polls a GitHub PR for reviews from trusted reviewers.

func NewReviewFetcher added in v0.17.35 

func NewReviewFetcher(ghToken string) ReviewFetcher

NewReviewFetcher creates a new ReviewFetcher.

type ReviewResult added in v0.17.35 

type ReviewResult struct {
	Verdict ReviewVerdict
	Body    string // full review body text
}

ReviewResult holds the latest review from a trusted reviewer.

type ReviewVerdict added in v0.17.35 

type ReviewVerdict string

ReviewVerdict represents the outcome of a PR review. 

const (
	ReviewVerdictNone             ReviewVerdict = ""
	ReviewVerdictApproved         ReviewVerdict = "approved"
	ReviewVerdictChangesRequested ReviewVerdict = "changes_requested"
)

type SemanticVersionNumber added in v0.2.33 

type SemanticVersionNumber struct {
	Major int
	Minor int
	Patch int
}

SemanticVersionNumber represents a parsed semantic version.

func ParseSemanticVersionNumber added in v0.2.33 

func ParseSemanticVersionNumber(ctx context.Context, tag string) (SemanticVersionNumber, error)

ParseSemanticVersionNumber parses "vX.Y.Z" into a SemanticVersionNumber. Returns error if format is invalid.

func (SemanticVersionNumber) BumpMinor added in v0.2.33 

func (v SemanticVersionNumber) BumpMinor() SemanticVersionNumber

BumpMinor returns a new version with minor incremented and patch reset to 0.

func (SemanticVersionNumber) BumpPatch added in v0.2.33 

func (v SemanticVersionNumber) BumpPatch() SemanticVersionNumber

BumpPatch returns a new version with patch incremented.

func (SemanticVersionNumber) Less added in v0.2.33 

func (v SemanticVersionNumber) Less(other SemanticVersionNumber) bool

Less returns true if v is lower than other.

func (SemanticVersionNumber) String added in v0.2.33 

func (v SemanticVersionNumber) String() string

String returns the "vX.Y.Z" representation.

type VersionBump added in v0.2.30 

type VersionBump int

VersionBump specifies the type of version bump to perform. 

const (
	// PatchBump increments the patch version (vX.Y.Z -> vX.Y.Z+1)
	PatchBump VersionBump = iota
	// MinorBump increments the minor version (vX.Y.Z -> vX.Y+1.0)
	MinorBump
)

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.