helper

package
v1.6.112 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 13, 2023 License: MPL-2.0 Imports: 23 Imported by: 0

Documentation

Overview

These functions are coming from consul/lib/eof.go

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func CheckHCLKeys added in v0.7.0

func CheckHCLKeys(node ast.Node, valid []string) error

func CheckNamespaceScope added in v1.6.105

func CheckNamespaceScope(provided string, requested []string) []string

CheckNamespaceScope ensures that the provided namespace is equal to or a parent of the requested namespaces. Returns requested namespaces which are not equal to or a child of the provided namespace.

func CleanEnvVar added in v0.5.5

func CleanEnvVar(s string, r byte) string

CleanEnvVar replaces all occurrences of illegal characters in an environment variable with the specified byte.

func CleanFilename added in v1.6.105

func CleanFilename(filename string, replace string) string

CleanFilename replaces invalid characters in filename

func CleanFilenameASCIIOnly added in v1.6.105

func CleanFilenameASCIIOnly(filename string, replace string) string

CleanFilenameASCIIOnly replaces invalid and non-ASCII characters in filename

func CleanFilenameStrict added in v1.6.105

func CleanFilenameStrict(filename string, replace string) string

CleanFilenameStrict replaces invalid and punctuation characters in filename

func ConvertMap added in v1.6.105

func ConvertMap[K comparable, A, B any](original map[K]A, conversion func(a A) B) map[K]B

ConvertMap takes the input map and generates a new one using the supplied conversion function to convert the values. This is useful when converting one map to another using the same keys.

func ConvertSlice added in v1.6.105

func ConvertSlice[A, B any](original []A, conversion func(a A) B) []B

ConvertSlice takes the input slice and generates a new one using the supplied conversion function to covert the element. This is useful when converting a slice of strings to a slice of structs which wraps the string.

func CopyMapOfSlice added in v1.6.105

func CopyMapOfSlice[K comparable, V any](m map[K][]V) map[K][]V

CopyMapOfSlice creates a copy of m, making copies of each []V.

func CopySlice added in v1.6.105

func CopySlice[S ~[]E, E Copyable[E]](s S) S

CopySlice creates a deep copy of s. For slices with elements that do not implement Copy(), use slices.Clone.

func DeepCopyMap added in v1.6.105

func DeepCopyMap[M ~map[K]V, K comparable, V Copyable[V]](m M) M

DeepCopyMap creates a copy of m by calling Copy() on each value.

If m is nil the return value is nil.

func ElementsEqual added in v1.6.105

func ElementsEqual[T EqualFunc[T]](a, b []T) bool

ElementsEqual returns true if slices a and b contain the same elements (in no particular order) using the Equal function defined on their type for comparison.

func HashUUID added in v0.6.0

func HashUUID(input string) (output string, hashed bool)

HashUUID takes an input UUID and returns a hashed version of the UUID to ensure it is well distributed.

func IsDisjoint added in v1.6.105

func IsDisjoint[T comparable](first, second []T) (bool, []T)

IsDisjoint returns whether first and second are disjoint sets, and the set of offending elements if not.

func IsErrEOF added in v1.6.105

func IsErrEOF(err error) bool

IsErrEOF returns true if we get an EOF error from the socket itself, or an EOF equivalent error from yamux.

func IsMethodHTTP added in v1.6.105

func IsMethodHTTP(s string) bool

IsMethodHTTP returns whether s is a known HTTP method, ignoring case.

func IsSubset added in v1.6.105

func IsSubset[T comparable](larger, smaller []T) (bool, []T)

IsSubset returns whether the smaller set of items is a subset of the larger. If the smaller set is not a subset, the offending elements are returned.

func IsUUID added in v0.5.5

func IsUUID(str string) bool

IsUUID returns true if the given string is a valid UUID.

func IsValidInterpVariable added in v0.9.0

func IsValidInterpVariable(str string) bool

IsValidInterpVariable returns true if a valid dotted variable names for interpolation. The string must begin with one or more non-dot characters which may be followed by sequences containing a dot followed by a one or more non-dot characters.

func Max added in v1.6.105

func Max[T constraints.Ordered](a, b T) T

Max returns the maximum of a and b.

func Merge added in v1.6.105

func Merge[T comparable](a, b T) T

Merge takes two variables and returns variable b in case a has zero value. For pointer values please use pointer.Merge.

func MergeMapStringString added in v1.6.105

func MergeMapStringString(m map[string]string, n map[string]string) map[string]string

MergeMapStringString will merge two maps into one. If a duplicate key exists the value in the second map will replace the value in the first map. If both maps are empty or nil this returns an empty map.

func MergeMultierrorWarnings added in v1.6.105

func MergeMultierrorWarnings(errs ...error) string

MergeMultierrorWarnings takes warnings and merges them into a returnable string. This method is used to return API and CLI errors.

func Min added in v1.6.105

func Min[T constraints.Ordered](a, b T) T

Min returns the minimum of a and b.

func OpaqueMapsEqual added in v1.6.105

func OpaqueMapsEqual[M ~map[K]V, K comparable, V any](m1, m2 M) bool

OpaqueMapsEqual compare maps[<comparable>]<any> for equality, but safely by using the cmp package and ignoring un-exported types, and by treating nil/empty slices and maps as equal.

This is intended as a substitute for reflect.DeepEqual in the case of "opaque maps", e.g. `map[comparable]any` - such as the case for Task Driver config or Envoy proxy pass-through configuration.

func RandomStagger added in v1.6.105

func RandomStagger(interval time.Duration) time.Duration

RandomStagger returns an interval between 0 and the duration

func RateScaledInterval added in v1.6.105

func RateScaledInterval(rate float64, min time.Duration, n int) time.Duration

RateScaledInterval is used to choose an interval to perform an action in order to target an aggregate number of actions per second across the whole cluster.

func RemoveEqualFold added in v0.11.0

func RemoveEqualFold(xs *[]string, search string)

RemoveEqualFold removes the first string that EqualFold matches. It updates xs in place

func SliceSetEq added in v1.6.105

func SliceSetEq[T comparable](a, b []T) bool

SliceSetEq returns true if slices a and b contain the same elements (in no particular order), using '==' for comparison.

Note: for pointers, consider implementing an Equal method and using ElementsEqual instead.

func StringHasPrefixInSlice added in v1.6.105

func StringHasPrefixInSlice(s string, prefixes []string) bool

StringHasPrefixInSlice returns true if s starts with any prefix in list.

func UniqueMapSliceValues added in v1.6.105

func UniqueMapSliceValues[K, V comparable](m map[K][]V) []V

UniqueMapSliceValues returns the union of values from each slice in a map[K][]V.

func UnusedKeys added in v0.11.0

func UnusedKeys(obj interface{}) error

UnusedKeys returns a pretty-printed error if any `hcl:",unusedKeys"` is not empty

func WithLock added in v1.6.105

func WithLock(lock sync.Locker, f func())

WithLock executes a function while holding a lock.

Types

type Copyable added in v1.6.105

type Copyable[T any] interface {
	Copy() T
}

type EqualFunc added in v1.6.105

type EqualFunc[A any] interface {
	Equal(A) bool
}

EqualFunc represents a type implementing the Equal method.

type StopFunc added in v1.6.105

type StopFunc func()

StopFunc is used to stop a time.Timer created with NewSafeTimer

func NewSafeTimer added in v1.6.105

func NewSafeTimer(duration time.Duration) (*time.Timer, StopFunc)

NewSafeTimer creates a time.Timer but does not panic if duration is <= 0.

Using a time.Timer is recommended instead of time.After when it is necessary to avoid leaking goroutines (e.g. in a select inside a loop).

Returns the time.Timer and also a StopFunc, forcing the caller to deal with stopping the time.Timer to avoid leaking a goroutine.

Note: If creating a Timer that should do nothing until Reset is called, use NewStoppedTimer instead for safely creating the timer in a stopped state.

func NewStoppedTimer added in v1.6.105

func NewStoppedTimer() (*time.Timer, StopFunc)

NewStoppedTimer creates a time.Timer in a stopped state. This is useful when the actual wait time will computed and set later via Reset.

Directories

Path Synopsis
Package boltdd contains a wrapper around BBoltDB to deduplicate writes and encode values using mgspack.
Package boltdd contains a wrapper around BBoltDB to deduplicate writes and encode values using mgspack.
constraints
semver
semver is a Semver Constraints package copied from github.com/hashicorp/go-version @ 2046c9d0f0b03c779670f5186a2a4b2c85493a71
semver is a Semver Constraints package copied from github.com/hashicorp/go-version @ 2046c9d0f0b03c779670f5186a2a4b2c85493a71
Package envoy provides a high level view of the variables that go into selecting an envoy version.
Package envoy provides a high level view of the variables that go into selecting an envoy version.
grpc-middleware
Package noxssrw (No XSS ResponseWriter) behaves like the Go standard library's ResponseWriter by detecting the Content-Type of a response if it has not been explicitly set.
Package noxssrw (No XSS ResponseWriter) behaves like the Go standard library's ResponseWriter by detecting the Content-Type of a response if it has not been explicitly set.
pluginutils
catalog
Package catalog is used to register internal plugins such that they can be loaded.
Package catalog is used to register internal plugins such that they can be loaded.
Package pointer provides helper functions related to Go pointers.
Package pointer provides helper functions related to Go pointers.
Code generated by go generate; DO NOT EDIT.
Code generated by go generate; DO NOT EDIT.
The archive utilities manage the internal format of a snapshot, which is a tar file with the following contents:
The archive utilities manage the internal format of a snapshot, which is a tar file with the following contents:
Package subproc provides helper utilities for executing the Nomad binary as a child process of the Nomad agent.
Package subproc provides helper utilities for executing the Nomad binary as a child process of the Nomad agent.
Package testlog creates a *log.Logger backed by *testing.T to ease logging in tests.
Package testlog creates a *log.Logger backed by *testing.T to ease logging in tests.
Package testtask implements a portable set of commands useful as stand-ins for user tasks.
Package testtask implements a portable set of commands useful as stand-ins for user tasks.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL