keepsorted

Documentation

Index

• type BlockOptions
  • func DefaultBlockOptions() BlockOptions
  • func ParseBlockOptions(options string) (BlockOptions, error)
  • func (opts BlockOptions) String() string
• type Finding
• type Fix
• type Fixer
  • func New(id string, defaultOptions BlockOptions) *Fixer
  • func (f *Fixer) Findings(filename, contents string, modifiedLines []LineRange) []*Finding
  • func (f *Fixer) Fix(filename, contents string, modifiedLines []LineRange) (fixed string, alreadyCorrect bool, warnings []*Finding)
• type LineRange
  • func (lr LineRange) HighAtDimension(uint64) int64
  • func (lr LineRange) ID() uint64
  • func (lr LineRange) LowAtDimension(uint64) int64
  • func (lr LineRange) OverlapsAtDimension(i augmentedtree.Interval, d uint64) bool
• type Replacement

Types

type BlockOptions

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

func DefaultBlockOptions

func DefaultBlockOptions() BlockOptions

func ParseBlockOptions

func ParseBlockOptions(options string) (BlockOptions, error)

func (BlockOptions) String

func (opts BlockOptions) String() string

type Finding

type Finding struct {
	// The name of the file that this finding is for.
	Path string `json:"path"`
	// The lines that this finding applies to.
	Lines LineRange `json:"lines"`
	// A human-readable message about what the finding is.
	Message string `json:"message"`
	// Possible fixes that could be applied to resolve the problem.
	// Each fix in this slice would independently fix the problem, they do not
	// and should not all be applied.
	// At most one of these Fixes may have Fix.automatic set to true.
	Fixes []Fix `json:"fixes"`
}

Finding is something that keep-sorted thinks is wrong with a particular file.

type Fix

type Fix struct {
	// The changes that should be made to the file to resolve the Finding.
	// All of these changes need to be made.
	Replacements []Replacement `json:"replacements"`
	// contains filtered or unexported fields
}

Fix is a set of changes that could be made to resolve a Finding.

type Fixer

type Fixer struct {
	ID string
	// contains filtered or unexported fields
}

Fixer runs the business logic of keep-sorted.

func New

func New(id string, defaultOptions BlockOptions) *Fixer

New creates a new fixer with the given string as its identifier. By default, id is "keep-sorted"

func (*Fixer) Findings

func (f *Fixer) Findings(filename, contents string, modifiedLines []LineRange) []*Finding

Findings returns a slice of things that need to be addressed in the file to make keep-sorted happy.

If modifiedLines is non-nil, we only report findings for issues within the modified lines. Otherwise, we report all findings.

func (*Fixer) Fix

func (f *Fixer) Fix(filename, contents string, modifiedLines []LineRange) (fixed string, alreadyCorrect bool, warnings []*Finding)

Fix all of the findings on contents to make keep-sorted happy.

type LineRange

type LineRange struct {
	Start int `json:"start"`
	End   int `json:"end"`
}

LineRange is a 1-based range of continuous lines within a file. Both start and end are inclusive. You can designate a single line by setting start and end to the same line number.

func (LineRange) HighAtDimension

func (lr LineRange) HighAtDimension(uint64) int64

func (LineRange) ID

func (lr LineRange) ID() uint64

func (LineRange) LowAtDimension

func (lr LineRange) LowAtDimension(uint64) int64

func (LineRange) OverlapsAtDimension

func (lr LineRange) OverlapsAtDimension(i augmentedtree.Interval, d uint64) bool

type Replacement

type Replacement struct {
	// The lines that should be replaced with NewContent.
	Lines      LineRange `json:"lines"`
	NewContent string    `json:"new_content"`
}

Replacement is a single substitution to apply to a file.