segments

package

v2.0.0-rc2 Latest Latest Go to latest Published: Dec 18, 2025 License: Apache-2.0 Imports: 1 Imported by: 0

Details

This section is empty.

This section is empty.

func Diff[P any, S Segment[P], StepT comparable, D Diffabble[P, StepT]](
	haves []S, needs []S, step StepT, diff D,
) []S

Diff compares haves to needs and returns a []Segments missing from needs

type Diffabble[P any, StepT any] interface {
	Add(a P, step StepT) P
	Less(a, b P) bool
	Equal(a, b P) bool
	Zero() P
	Neg(step StepT) StepT
}

Diffabble is a named type of a slice of an implementation of Segment that can be passed into Difference() as diff D

type Int64 struct{}

Int64 implements Diffable for int64 (bytes, IPv4s, etc.)

func (Int64) Add(a int64, step int64) int64

func (Int64) Equal(a, b int64) bool

func (Int64) Less(a, b int64) bool

func (Int64) Neg(step int64) int64

func (Int64) Zero() int64

type Segment[U any] interface {
	StartVal() U
	EndVal() U
	NewSegment(start, end U) Segment[U]
	String() string
}

Segment represents a range with inclusive Start/End points of type U.

type Time struct{}

Time implements Diffable for time.Time

func (Time) Add(a time.Time, step time.Duration) time.Time

func (Time) Equal(a, b time.Time) bool

func (Time) Less(a, b time.Time) bool

func (Time) Neg(step time.Duration) time.Duration

func (Time) Zero() time.Time