diff

Documentation

Index

• type ChangeType
• type DiffLine
  • func ParseUnifiedDiff(raw string) ([]DiffLine, error)
• type DirectoryReader
  • func NewDirectoryReader(workDir string) *DirectoryReader
  • func (dr *DirectoryReader) ChangedFiles(_ string, _ bool) ([]string, error)
  • func (dr *DirectoryReader) FileDiff(_, file string, _ bool) ([]DiffLine, error)
• type ExcludeFilter
  • func NewExcludeFilter(inner renderer, prefixes []string) *ExcludeFilter
  • func (ef *ExcludeFilter) ChangedFiles(ref string, staged bool) ([]string, error)
  • func (ef *ExcludeFilter) FileDiff(ref, file string, staged bool) ([]DiffLine, error)
• type FallbackRenderer
  • func NewFallbackRenderer(inner *Git, only []string, workDir string) *FallbackRenderer
  • func (fr *FallbackRenderer) ChangedFiles(ref string, staged bool) ([]string, error)
  • func (fr *FallbackRenderer) FileDiff(ref, file string, staged bool) ([]DiffLine, error)
• type FileReader
  • func NewFileReader(files []string, workDir string) *FileReader
  • func (r *FileReader) ChangedFiles(_ string, _ bool) ([]string, error)
  • func (r *FileReader) FileDiff(_, file string, _ bool) ([]DiffLine, error)
• type Git
  • func NewGit(workDir string) *Git
  • func (g *Git) ChangedFiles(ref string, staged bool) ([]string, error)
  • func (g *Git) FileDiff(ref, file string, staged bool) ([]DiffLine, error)

Types

type ChangeType

type ChangeType string

ChangeType represents the type of change for a diff line.

const (
	ChangeAdd     ChangeType = "+"
	ChangeRemove  ChangeType = "-"
	ChangeContext ChangeType = " "
	ChangeDivider ChangeType = "~" // separates non-adjacent hunks

)

type DiffLine

type DiffLine struct {
	OldNum     int        // line number in old version (0 for additions)
	NewNum     int        // line number in new version (0 for removals)
	Content    string     // line content without the +/- prefix
	ChangeType ChangeType // changeAdd, ChangeRemove, ChangeContext, or ChangeDivider
}

DiffLine holds parsed line info from a diff.

func ParseUnifiedDiff

func ParseUnifiedDiff(raw string) ([]DiffLine, error)

ParseUnifiedDiff parses unified diff output into a slice of DiffLine entries. It handles the diff header, hunk headers, and content lines.

type DirectoryReader

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

DirectoryReader is a Renderer that lists all git-tracked files and reads them as context lines. used for --all-files mode where every tracked file is browsable, not just changed files.

func NewDirectoryReader

func NewDirectoryReader(workDir string) *DirectoryReader

NewDirectoryReader creates a DirectoryReader rooted at the given working directory. the directory must be inside a git repository.

func (*DirectoryReader) ChangedFiles

func (dr *DirectoryReader) ChangedFiles(_ string, _ bool) ([]string, error)

ChangedFiles returns all git-tracked files as sorted relative paths. ref and staged parameters are ignored since all tracked files are returned.

func (*DirectoryReader) FileDiff

func (dr *DirectoryReader) FileDiff(_, file string, _ bool) ([]DiffLine, error)

FileDiff reads the file from disk and returns all lines as context DiffLines. ref and staged parameters are ignored since the file is read directly from disk.

type ExcludeFilter

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

ExcludeFilter wraps a renderer and filters out files matching any of the given prefixes. filtering is applied only at the file list level (ChangedFiles); FileDiff delegates directly.

func NewExcludeFilter

func NewExcludeFilter(inner renderer, prefixes []string) *ExcludeFilter

NewExcludeFilter creates an ExcludeFilter that removes files matching any prefix from results.

func (*ExcludeFilter) ChangedFiles

func (ef *ExcludeFilter) ChangedFiles(ref string, staged bool) ([]string, error)

ChangedFiles returns files from the inner renderer, excluding any that match a prefix.

func (*ExcludeFilter) FileDiff

func (ef *ExcludeFilter) FileDiff(ref, file string, staged bool) ([]DiffLine, error)

FileDiff delegates directly to the inner renderer without filtering.

type FallbackRenderer

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

FallbackRenderer wraps a *Git renderer and knows about --only file paths. it delegates to the inner renderer, falling back to disk read for --only files that are not present in the git diff.

func NewFallbackRenderer

func NewFallbackRenderer(inner *Git, only []string, workDir string) *FallbackRenderer

NewFallbackRenderer creates a FallbackRenderer that delegates to inner and falls back to reading files from disk for --only patterns not found in the git diff.

func (*FallbackRenderer) ChangedFiles

func (fr *FallbackRenderer) ChangedFiles(ref string, staged bool) ([]string, error)

ChangedFiles returns changed files from the inner renderer, then appends any --only files not already present in the result if they exist on disk.

func (*FallbackRenderer) FileDiff

func (fr *FallbackRenderer) FileDiff(ref, file string, staged bool) ([]DiffLine, error)

FileDiff returns the diff for a file. for files outside the repo (absolute paths that escape workDir), it skips the inner git renderer entirely and reads from disk. for in-repo files, it calls the inner renderer first; if the result is empty (no error, no lines) and the file matches an --only pattern, it falls back to reading the file from disk as all-context lines.

type FileReader

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

FileReader is a standalone Renderer for use when no git repo is available. it reads --only files directly from disk and presents them as all-context lines.

func NewFileReader

func NewFileReader(files []string, workDir string) *FileReader

NewFileReader creates a FileReader that reads the given files from disk. relative paths are resolved against workDir.

func (*FileReader) ChangedFiles

func (r *FileReader) ChangedFiles(_ string, _ bool) ([]string, error)

ChangedFiles returns the file list, resolved against workDir, filtered to only those that exist on disk.

func (*FileReader) FileDiff

func (r *FileReader) FileDiff(_, file string, _ bool) ([]DiffLine, error)

FileDiff reads the file from disk and returns all lines as context DiffLines.

type Git

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

Git provides methods to extract changed files and build full-file diff views.

func NewGit

func NewGit(workDir string) *Git

NewGit creates a new Git diff renderer rooted at the given working directory.

func (*Git) ChangedFiles

func (g *Git) ChangedFiles(ref string, staged bool) ([]string, error)

ChangedFiles returns a list of files changed relative to the given ref. If ref is empty, it shows uncommitted changes. If staged is true, shows only staged changes.

func (*Git) FileDiff

func (g *Git) FileDiff(ref, file string, staged bool) ([]DiffLine, error)

FileDiff returns the full-file diff view for a single file. The result is a sequence of DiffLine entries representing unchanged, added, and removed lines interleaved at their correct positions.