dyff

Documentation

Index

• Constants
• Variables
• func AsSequenceNode(list []string) *yamlv3.Node
• func ChangeRoot(inputFile *ytbx.InputFile, path string, useGoPatchPaths bool, ...) error
• func CreateTableStyleString(separator string, indent int, columns ...string) string
• func SetLoggingLevel(loggingLevel LogLevel)
• type BriefReport
  • func (report *BriefReport) WriteReport(out io.Writer) error
• type CompareOption
  • func IgnoreOrderChanges(value bool) CompareOption
  • func KubernetesEntityDetection(value bool) CompareOption
  • func NonStandardIdentifierGuessCountThreshold(nonStandardIdentifierGuessCountThreshold int) CompareOption
• type Detail
• type Diff
• type HumanReport
  • func (report *HumanReport) LoadX509Certs(from, to string) (string, string, error)
  • func (report *HumanReport) WriteReport(out io.Writer) error
• type ListItemIdentifierField
• type LogLevel
• type Report
  • func CompareInputFiles(from ytbx.InputFile, to ytbx.InputFile, compareOptions ...CompareOption) (Report, error)
• type ReportWriter

Constants

const (
	ADDITION     = '+'
	REMOVAL      = '-'
	MODIFICATION = '±'
	ORDERCHANGE  = '⇆'
)

Constants to distinguish between the different kinds of differences

Variables

var DebugLogger = log.New(ioutil.Discard, "Debug: ", log.Lshortfile)

DebugLogger is the debugging logger definition

var ErrorLogger = log.New(os.Stderr, "Error: ", log.Lshortfile)

ErrorLogger is the error logger definition

var LoggingLevel = ERROR

LoggingLevel stores the currently configured logging level

var WarningLogger = log.New(ioutil.Discard, "Warning: ", log.Lshortfile)

WarningLogger is the warning logger definition

Functions

func AsSequenceNode

func AsSequenceNode(list []string) *yamlv3.Node

AsSequenceNode translates a string list into a SequenceNode

func ChangeRoot

func ChangeRoot(inputFile *ytbx.InputFile, path string, useGoPatchPaths bool, translateListToDocuments bool) error

ChangeRoot changes the root of an input file to a position inside its document based on the given path. Input files with more than one document are not supported, since they could have multiple elements with that path.

func CreateTableStyleString

func CreateTableStyleString(separator string, indent int, columns ...string) string

CreateTableStyleString takes the multi-line input strings as columns and arranges an output string to create a table-style output format with proper padding so that the text blocks can be arranged next to each other.

func SetLoggingLevel

func SetLoggingLevel(loggingLevel LogLevel)

SetLoggingLevel will initialise the logging set-up according to the provided input

Types

type BriefReport

type BriefReport struct {
	Report
}

BriefReport is a reporter that only prints a summary

func (*BriefReport) WriteReport

func (report *BriefReport) WriteReport(out io.Writer) error

WriteReport writes a brief summary to the provided writer

type CompareOption

type CompareOption func(*compareSettings)

CompareOption sets a specific compare setting for the object comparison

func IgnoreOrderChanges

func IgnoreOrderChanges(value bool) CompareOption

IgnoreOrderChanges disables the detection for changes of the order in lists

func KubernetesEntityDetection

func KubernetesEntityDetection(value bool) CompareOption

KubernetesEntityDetection enabled detecting entity identifiers from Kubernetes "kind:" and "metadata:" fields.

func NonStandardIdentifierGuessCountThreshold

func NonStandardIdentifierGuessCountThreshold(nonStandardIdentifierGuessCountThreshold int) CompareOption

NonStandardIdentifierGuessCountThreshold specifies how many list entries are needed for the guess-the-identifier function to actually consider the key name. Or in short, if the lists only contain two entries each, there are more possibilities to find unique enough key, which might no qualify as such.

type Detail

type Detail struct {
	Kind rune
	From *yamlv3.Node
	To   *yamlv3.Node
}

Detail encapsulate the actual details of a change, mainly the kind of difference and the values

type Diff

type Diff struct {
	Path    ytbx.Path
	Details []Detail
}

Diff encapsulates everything noteworthy about a difference

type HumanReport

type HumanReport struct {
	NoTableStyle         bool
	DoNotInspectCerts    bool
	OmitHeader           bool
	UseGoPatchPaths      bool
	MinorChangeThreshold float64

	Report
}

HumanReport is a reporter with human readable output in mind

func (*HumanReport) LoadX509Certs

func (report *HumanReport) LoadX509Certs(from, to string) (string, string, error)

LoadX509Certs tries to load the provided strings as a cert each and returns a textual representation of the certs, or an error if the strings are not X509 certs

func (*HumanReport) WriteReport

func (report *HumanReport) WriteReport(out io.Writer) error

WriteReport writes a human readable report to the provided writer

type ListItemIdentifierField

type ListItemIdentifierField string

ListItemIdentifierField names the field that identifies a list.

type LogLevel

type LogLevel int

LogLevel covers different types of logging severities

const (
	NONE LogLevel = iota
	ERROR
	WARN
	DEBUG
)

List of possile logging levels

type Report

type Report struct {
	From  ytbx.InputFile
	To    ytbx.InputFile
	Diffs []Diff
}

Report encapsulates the actual end-result of the comparison: The input data and the list of differences

func CompareInputFiles

func CompareInputFiles(from ytbx.InputFile, to ytbx.InputFile, compareOptions ...CompareOption) (Report, error)

CompareInputFiles is one of the convenience main entry points for comparing objects. In this case the representation of an input file, which might contain multiple documents. It returns a report with the list of differences.

type ReportWriter

type ReportWriter interface {
	WriteReport(out io.Writer) error
}

ReportWriter defines the interface required for types that can write reports