util

Documentation

Index

• func Address(network, host string) string
• func AddressUnspecifiedLess(a, b net.Addr) bool
• func CallWithContext(ctx context.Context, fn func() error) error
• func CopyMatchingTag(from interface{}, to interface{}, tag string, ...)
• func FillNil(data interface{})
• func FillNilExceptDeprecated(data interface{})
• func FillNilSlices(data interface{}) error
• func NiceDurationString(d time.Duration) string
• func NoRestartErr(err error) error
• func OnDone(ctx context.Context, fn func())
• func SetDefaults(data interface{})
• func UniqueTrimmedStrings(ss []string) []string
• type ExitStatus
  • func (s ExitStatus) AsInt() int
• type FatalErr
  • func (e *FatalErr) Error() string
  • func (e *FatalErr) Is(target error) bool
  • func (e *FatalErr) Unwrap() error

Functions

func Address

func Address(network, host string) string

Address constructs a URL from the given network and hostname.

func AddressUnspecifiedLess

func AddressUnspecifiedLess(a, b net.Addr) bool

AddressUnspecifiedLess is a comparator function preferring least specific network address (most widely listening, namely preferring 0.0.0.0 over some IP), if both IPs are equal, it prefers the less restrictive network (prefers tcp over tcp4)

func CallWithContext

func CallWithContext(ctx context.Context, fn func() error) error

func CopyMatchingTag

func CopyMatchingTag(from interface{}, to interface{}, tag string, shouldCopy func(value string) bool)

CopyMatchingTag copies fields tagged tag:"value" from "from" struct onto "to" struct.

func FillNil

func FillNil(data interface{})

func FillNilExceptDeprecated

func FillNilExceptDeprecated(data interface{})

func FillNilSlices

func FillNilSlices(data interface{}) error

FillNilSlices sets default value on slices that are still nil.

func NiceDurationString

func NiceDurationString(d time.Duration) string

func NoRestartErr

func NoRestartErr(err error) error

NoRestartErr wraps the given error err (which may be nil) to make sure that `errors.Is(err, suture.ErrDoNotRestart) == true`.

func OnDone

func OnDone(ctx context.Context, fn func())

OnDone calls fn when ctx is cancelled.

func SetDefaults

func SetDefaults(data interface{})

SetDefaults sets default values on a struct, based on the default annotation.

func UniqueTrimmedStrings

func UniqueTrimmedStrings(ss []string) []string

UniqueTrimmedStrings returns a list on unique strings, trimming at the same time.

Types

type ExitStatus

type ExitStatus int

const (
	ExitSuccess            ExitStatus = 0
	ExitError              ExitStatus = 1
	ExitNoUpgradeAvailable ExitStatus = 2
	ExitRestart            ExitStatus = 3
	ExitUpgrade            ExitStatus = 4
)

func (ExitStatus) AsInt

func (s ExitStatus) AsInt() int

type FatalErr

type FatalErr struct {
	Err    error
	Status ExitStatus
}

func (*FatalErr) Error

func (e *FatalErr) Error() string

func (*FatalErr) Is

func (e *FatalErr) Is(target error) bool

func (*FatalErr) Unwrap

func (e *FatalErr) Unwrap() error