Help us shape the future of Go! Take the 2026 Go Developer Survey

Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

diff

package

Go to main page

Versions in this module

v0

v0.0.8

May 18, 2026

v0.0.7

May 11, 2026

v0.0.6

May 8, 2026

v0.0.5

Apr 25, 2026

v0.0.4

Apr 24, 2026

v0.0.3

Feb 18, 2026

v0.0.2

Nov 18, 2025

v0.0.1

Nov 12, 2025

Changes in this version

+ var ErrAutoBranchCheckoutFailed = errors.New("auto-branch checkout failed")

+ var ErrOperationCancelled = errors.New("operation cancelled by user")

+ var ErrStaleRemote = errors.New("operation declined due to stale remote")

+ func FormatAutoBranchSuccess(branchName string, checkoutFailed bool, style *OutputStyle) string

+ func FormatAutoBranchWarning(commitsAhead int, defaultBranch string, branchName string, style *OutputStyle) string

+ func FormatBaseChanged(oldBase, newBase string, style *OutputStyle) string

+ func FormatDependentPRList(dependentPRs []*github.PullRequest) string

+ func FormatDependentPRWarning(dependentPRs []*github.PullRequest) string

+ func FormatDiffResult(result *DiffResult, style *OutputStyle) string

+ func FormatDryRunOutput(currentBranch, detectedBase string, parentPR *github.PullRequest, ...) string

+ func FormatErrorWithContext(err error, style *OutputStyle) string

+ func FormatFastPathOutput(pr *github.PullRequest, messages []string, style *OutputStyle) string

+ func FormatNoNewCommits(style *OutputStyle) string

+ func FormatPRCreated(pr *github.PullRequest, parentPR *github.PullRequest, style *OutputStyle) string

+ func FormatPRUpdated(pr *github.PullRequest, baseChanged bool, oldBase, newBase string, ...) string

+ func FormatProgressIndicator(operation string, style *OutputStyle) string

+ func FormatPushedSuccessfully(style *OutputStyle) string

+ func FormatPushingBranch(branchName string, style *OutputStyle) string

+ func FormatReviewersAssigned(reviewers []string, style *OutputStyle) string

+ func FormatStackConfirmation(operation, currentBranch, baseBranch string, parentPR *github.PullRequest, ...) string

+ func FormatStackWarning(message string, details []string, style *OutputStyle) string

+ func FormatStackingOutput(currentBranch string, baseBranch string, parentPR *github.PullRequest, ...) string

+ func FormatValidationErrors(errors []string, templatePath string, style *OutputStyle) string

+ func IsParentBranch(dependentPRs []*github.PullRequest) bool

+ func ShowStackingStatus(parentBranch string, parentPR *github.PullRequest) string

+ type AutoBranchCheckoutError struct

+ BranchName string

+ Err error

+ func (e *AutoBranchCheckoutError) Error() string

+ func (e *AutoBranchCheckoutError) Is(target error) bool

+ func (e *AutoBranchCheckoutError) Unwrap() error

+ type AutoBranchContext struct

+ BranchName string

+ ShouldProceed bool

+ type AutoBranchDetector struct

+ func NewAutoBranchDetector(repo *git.Repository, cfg *config.DiffConfig) *AutoBranchDetector

+ func (d *AutoBranchDetector) CheckStaleRemote(ctx context.Context, defaultBranch string) (bool, error)

+ func (d *AutoBranchDetector) DetectCommitsOnMain(ctx context.Context) (*DetectionResult, error)

+ func (d *AutoBranchDetector) EnsureUniqueBranchName(baseName string) (string, error)

+ func (d *AutoBranchDetector) ExecuteAutoBranch(ctx context.Context, context *AutoBranchContext) (string, error)

+ func (d *AutoBranchDetector) GenerateBranchName() (string, bool, error)

+ func (d *AutoBranchDetector) PrepareAutoBranch(ctx context.Context, detection *DetectionResult) (*AutoBranchContext, error)

+ func (d *AutoBranchDetector) PushWithRetry(ctx context.Context, context *AutoBranchContext, maxAttempts int) (string, error)

+ func (d *AutoBranchDetector) ShouldAutoBranch(result *DetectionResult) bool

+ type BaseBranchDetector struct

+ func NewBaseBranchDetector(repo GitRepository, gitHubClient GitHubClient, cfg *config.DiffConfig, ...) *BaseBranchDetector

+ func (d *BaseBranchDetector) DetectBaseBranch(ctx context.Context, currentBranch string, baseFlagValue string) (*BaseBranchResult, error)

+ type BaseBranchResult struct

+ Base string

+ IsStacking bool

+ Method string

+ ParentPR *github.PullRequest

+ func (r *BaseBranchResult) FormatStackingMessage() string

+ type ContinueModeExecutor struct

+ func NewContinueModeExecutor(repo *git.Repository, client *github.Client, cfg *config.DiffConfig, ...) *ContinueModeExecutor

+ func (e *ContinueModeExecutor) Execute(ctx context.Context, opts *ContinueModeOptions) (*ContinueModeResult, error)

+ type ContinueModeOptions struct

+ CurrentBranch string

+ Draft bool

+ NoEdit bool

+ Ready bool

+ RequireTestPlan bool

+ type ContinueModeResult struct

+ BaseBranch string

+ HeadBranch string

+ Messages []string

+ PR *github.PullRequest

+ ParsedFields *template.TemplateFields

+ WasCreated bool

+ type DependentPRDetector struct

+ func NewDependentPRDetector(gitHubClient GitHubClient, cfg *config.DiffConfig, owner string, ...) *DependentPRDetector

+ func (d *DependentPRDetector) DetectDependentPRs(ctx context.Context, branchName string) (*DependentPRInfo, error)

+ func (d *DependentPRDetector) ShouldShowWarning() bool

+ type DependentPRInfo struct

+ DependentPRs []*github.PullRequest

+ HasDependents bool

+ func (info *DependentPRInfo) FormatDependentPRsInfo() string

+ func (info *DependentPRInfo) FormatDependentPRsWarning() string

+ type DetectionResult struct

+ CommitsAhead int

+ DefaultBranch string

+ OnMainBranch bool

+ type DiffOptions struct

+ Base string

+ Continue bool

+ Draft bool

+ Edit bool

+ NoEdit bool

+ Ready bool

+ type DiffResult struct

+ AutoBranchCheckoutFailed bool

+ AutoBranchName string

+ AutoBranchUsed bool

+ BaseBranch string

+ DraftChanged bool

+ IsStacking bool

+ Messages []string

+ PR *github.PullRequest

+ ParentPR *github.PullRequest

+ ReviewersAdded []string

+ WasCreated bool

+ type DiffWorkflow struct

+ func NewDiffWorkflow(repo *git.Repository, client *github.Client, cfg *config.Config, ...) *DiffWorkflow

+ func (w *DiffWorkflow) Execute(ctx context.Context, opts *DiffOptions) (*DiffResult, error)

+ type GitHubClient interface

+ GetPullRequests func(ctx context.Context, owner, repo string, opts *github.PullRequestListOptions) ([]*github.PullRequest, error)

+ type GitRepository interface

+ GetCommitRange func(from, to string) ([]git.CommitInfo, error)

+ GetCommitsBetween func(base, head string) ([]git.CommitInfo, error)

+ GetDefaultBranch func() (string, error)

+ GetMergeBase func(ref1, ref2 string) (string, error)

+ IsAncestor func(ancestorRef, descendantRef string) (bool, error)

+ ListBranches func(includeRemote bool) ([]git.BranchInfo, error)

+ Path func() string

+ type OutputStyle struct

+ func NewOutputStyle(useColor bool) *OutputStyle

+ func (s *OutputStyle) Dim(text string) string

+ func (s *OutputStyle) Error(message string) string

+ func (s *OutputStyle) Highlight(text string) string

+ func (s *OutputStyle) Info(message string) string

+ func (s *OutputStyle) Stack(message string) string

+ func (s *OutputStyle) Success(message string) string

+ func (s *OutputStyle) Warning(message string) string

+ type PRExecutor struct

+ func NewPRExecutor(client PRGitHubClient, repo PRGitRepository, owner, name string) *PRExecutor

+ func (e *PRExecutor) CreateOrUpdatePR(ctx context.Context, req *PRRequest) (*PRResult, error)

+ func (e *PRExecutor) UpdateDraftStatus(ctx context.Context, pr *github.PullRequest, wantDraft bool) (*github.PullRequest, error)

+ type PRGitHubClient interface

+ AssignReviewers func(ctx context.Context, owner, name string, number int, users, teams []string) error

+ ConvertPRToDraft func(ctx context.Context, owner, name string, pr *github.PullRequest) (*github.PullRequest, error)

+ CreatePullRequest func(ctx context.Context, owner, name, title, head, base, body string, draft bool, ...) (*github.PullRequest, error)

+ MarkPRReadyForReview func(ctx context.Context, owner, name string, pr *github.PullRequest) (*github.PullRequest, error)

+ UpdatePullRequest func(ctx context.Context, owner, name string, number int, title, body string, ...) (*github.PullRequest, error)

+ type PRGitRepository interface

+ HasUnpushedCommits func(branch string) (bool, error)

+ Push func(ctx context.Context, branch string) error

+ type PRRequest struct

+ BaseBranch string

+ Body string

+ CurrentUser string

+ Draft bool

+ ExistingPR *github.PullRequest

+ HeadBranch string

+ ParentPR *github.PullRequest

+ Reviewers []string

+ Title string

+ type PRResult struct

+ DraftChanged bool

+ Messages []string

+ PR *github.PullRequest

+ Pushed bool

+ ReviewersAdded []string

+ WasCreated bool