vcs

type BlameLine struct {
	Author     string
	AuthorName string
	Text       string
}

type BlameResult struct {
	Lines []BlameLine
}

type Change interface {
	// From returns the source file name (empty for new files).
	FromName() string
	// To returns the destination file name (empty for deleted files).
	ToName() string
	// Patch computes the patch for this change.
	Patch() (Patch, error)
}

type Changes []Change

type Chunk interface {
	Type() ChunkType
	Content() string
}

type ChunkType int

type Commit interface {
	// Hash returns the commit hash.
	Hash() plumbing.Hash
	// NumParents returns the number of parent commits.
	NumParents() int
	// Parent returns the nth parent commit.
	Parent(n int) (Commit, error)
	// Tree returns the tree object for this commit.
	Tree() (Tree, error)
	// Stats returns file stats for this commit.
	Stats() (object.FileStats, error)
	// Author returns commit author information.
	Author() object.Signature
}

type CommitIterator interface {
	ForEach(fn func(Commit) error) error
	Close()
}

type ContextAwareRepository interface {
	Repository
	// LogWithContext returns a commit iterator with context support.
	LogWithContext(ctx context.Context, opts *LogOptions) (CommitIterator, error)
}

type FilePatch interface {
	Chunks() []Chunk
}

type GitOpener struct{}

type LogOptions struct {
	Since *time.Time
}

type Opener interface {
	// PlainOpen opens an existing git repository.
	PlainOpen(path string) (Repository, error)
	// PlainOpenWithDetect opens a git repository, detecting .git in parent directories.
	PlainOpenWithDetect(path string) (Repository, error)
}

type Patch interface {
	FilePatches() []FilePatch
}

type Reference interface {
	Hash() plumbing.Hash
}

type Repository interface {
	// Head returns a reference to the HEAD commit.
	Head() (Reference, error)
	// Log returns a commit iterator starting from HEAD.
	Log(opts *LogOptions) (CommitIterator, error)
	// CommitObject returns the commit with the given hash.
	CommitObject(hash plumbing.Hash) (Commit, error)
	// Blame returns blame information for a file at a specific commit.
	Blame(commit Commit, path string) (*BlameResult, error)
}

type Tree interface {
	// Diff computes differences between this tree and another.
	Diff(to Tree) (Changes, error)
}