diff

Documentation

Index

• type Diff
• type Limits
• type NumStat
• type NumStatParser
  • func NewDiffNumStatParser(src io.Reader) *NumStatParser
  • func (parser *NumStatParser) NextNumStat() (*NumStat, error)
• type Parser
  • func NewDiffParser(src io.Reader, limits Limits) *Parser
  • func (parser *Parser) Diff() *Diff
  • func (parser *Parser) Err() error
  • func (parser *Parser) Parse() bool

Types

type Diff

type Diff struct {
	FromID         string
	ToID           string
	OldMode        int32
	NewMode        int32
	FromPath       []byte
	ToPath         []byte
	Binary         bool
	Status         byte
	Patch          []byte
	OverflowMarker bool
	Collapsed      bool
	TooLarge       bool
	// contains filtered or unexported fields
}

Diff represents a single parsed diff entry

type Limits

type Limits struct {
	// If true, Max{Files,Lines,Bytes} will cause parsing to stop if any of these limits is reached
	EnforceLimits bool
	// If true, SafeMax{Files,Lines,Bytes} will cause diffs to collapse (i.e. patches are emptied) after any of these limits reached
	CollapseDiffs bool
	// Number of maximum files to parse. The file parsed after this limit is reached is marked as the overflow.
	MaxFiles int
	// Number of diffs lines to parse (including lines preceded with --- or +++).
	// The file in which this limit is reached is discarded and marked as the overflow.
	MaxLines int
	// Number of bytes to parse (including lines preceded with --- or +++).
	// The file in which this limit is reached is discarded and marked as the overflow.
	MaxBytes int
	// Number of files to parse, after which all subsequent files are collapsed.
	SafeMaxFiles int
	// Number of lines to parse (including lines preceded with --- or +++), after which all subsequent files are collapsed.
	SafeMaxLines int
	// Number of bytes to parse (including lines preceded with --- or +++), after which all subsequent files are collapsed.
	SafeMaxBytes int
	// Number of bytes a single patch can have. Patches surpassing this limit are pruned / nullified.
	MaxPatchBytes int
}

Limits holds the limits at which either parsing stops or patches are collapsed

type NumStat

type NumStat struct {
	Path      []byte
	Additions int32
	Deletions int32
}

NumStat represents a single parsed diff file change

type NumStatParser

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

NumStatParser holds necessary state for parsing the numstat output

func NewDiffNumStatParser

func NewDiffNumStatParser(src io.Reader) *NumStatParser

NewDiffNumStatParser returns a new NumStatParser

func (*NumStatParser) NextNumStat

func (parser *NumStatParser) NextNumStat() (*NumStat, error)

NextNumStat reads from git diff --numstat -z command, parses the stats and returns a *NumStat.

type Parser

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

Parser holds necessary state for parsing a diff stream

func NewDiffParser

func NewDiffParser(src io.Reader, limits Limits) *Parser

NewDiffParser returns a new Parser

func (*Parser) Diff

func (parser *Parser) Diff() *Diff

Diff returns a successfully parsed diff. It should be called only when Parser.Parse() returns true.

func (*Parser) Err

func (parser *Parser) Err() error

Err returns the error encountered (if any) when parsing the diff stream. It should be called only when Parser.Parse() returns false.

func (*Parser) Parse

func (parser *Parser) Parse() bool

Parse parses a single diff. It returns true if successful, false if it finished parsing all diffs or when it encounters an error, in which case use Parser.Err() to get the error.