util

package
v0.11.8 Latest Latest
Warning

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

 Go to latest Published: Aug 6, 2023 License: MIT Imports: 38 Imported by: 1

Documentation

Overview

Content managed by Project Forge, see [projectforge.md] for details.

Content managed by Project Forge, see [projectforge.md] for details.

Content managed by Project Forge, see [projectforge.md] for details.

Content managed by Project Forge, see [projectforge.md] for details.

Content managed by Project Forge, see [projectforge.md] for details.

Content managed by Project Forge, see [projectforge.md] for details.

Content managed by Project Forge, see [projectforge.md] for details.

Content managed by Project Forge, see [projectforge.md] for details.

Content managed by Project Forge, see [projectforge.md] for details.

Content managed by Project Forge, see [projectforge.md] for details.

Content managed by Project Forge, see [projectforge.md] for details.

Content managed by Project Forge, see [projectforge.md] for details.

Content managed by Project Forge, see [projectforge.md] for details.

Content managed by Project Forge, see [projectforge.md] for details.

Content managed by Project Forge, see [projectforge.md] for details.

Content managed by Project Forge, see [projectforge.md] for details.

Content managed by Project Forge, see [projectforge.md] for details.

Content managed by Project Forge, see [projectforge.md] for details.

Content managed by Project Forge, see [projectforge.md] for details.

Content managed by Project Forge, see [projectforge.md] for details.

Content managed by Project Forge, see [projectforge.md] for details.

Content managed by Project Forge, see [projectforge.md] for details.

Content managed by Project Forge, see [projectforge.md] for details.

Content managed by Project Forge, see [projectforge.md] for details.

Content managed by Project Forge, see [projectforge.md] for details.

Content managed by Project Forge, see [projectforge.md] for details.

Code generated from files in client/src/svg. See https://projectforge.dev for details. DO NOT EDIT.

Content managed by Project Forge, see [projectforge.md] for details.

Content managed by Project Forge, see [projectforge.md] for details.

Index

Constants

View Source 
const (
	AppKey     = "projectforge"
	AppName    = "Project Forge"
	AppSummary = "Build and maintain feature-rich applications using Golang"
	AppPort    = 40000
	AppContact = "Kyle U <projectforge@kyleu.com>"
	AppURL     = "https://projectforge.dev"
	AppSource  = "https://github.com/kyleu/projectforge"
	AppLegal   = `Built by <a href="mailto:projectforge@kyleu.com">Kyle U</a>, all rights reserved`

	BoolTrue   = "true"
	KeyError   = "error"
	KeyUnknown = "unknown"
)

Variables

View Source 
var SVGIconKeys = []string{} /* 135 elements not displayed */
View Source 
var SVGLibrary = map[string]string{}/* 136 elements not displayed */
View Source 
var StringDefaultLinebreak = func() string {
	if runtime.GOOS == "windows" {
		return winLB
	}
	return saneLB
}()
View Source 
var UUIDDefault = uuid.UUID{}

Functions

func ArrayDereference added in v0.9.29 

func ArrayDereference[T any](x []*T) []T

func ArrayFirstN added in v0.8.15 

func ArrayFirstN[V any](items []V, n int) []V

func ArrayFlatten added in v0.8.15 

func ArrayFlatten[T any](arrs ...[]T) []T

func ArrayFromAny added in v0.2.32 

func ArrayFromAny(dest any) []any

func ArrayLastN added in v0.8.15 

func ArrayLastN[V any](items []V, n int) []V

func ArrayRemoveDuplicates added in v0.2.33 

func ArrayRemoveDuplicates[T comparable](x []T) []T

func ArrayRemoveNil added in v0.6.15 

func ArrayRemoveNil[T any](x []*T) []*T

func ArraySorted added in v0.10.14 

func ArraySorted[T constraints.Ordered](x []T) []T

func AsyncCollect added in v0.2.29 

func AsyncCollect[T any, R any](items []T, f func(item T) (R, error)) ([]R, []error)

func AsyncCollectMap added in v0.6.9 

func AsyncCollectMap[T any, K comparable, R any](items []T, k func(item T) K, f func(item T) (R, error)) (map[K]R, map[K]error)

func AsyncRateLimit added in v0.6.0 

func AsyncRateLimit[T any, R any](items []T, f func(item T) (R, error), maxConcurrent int, timeout time.Duration) ([]R, []error)

func ByteSizeIEC added in v0.2.38 

func ByteSizeIEC(b int64) string

func ByteSizeSI added in v0.2.38 

func ByteSizeSI(b int64) string

func CountryFlag added in v0.6.3 

func CountryFlag(code string) string

func CycleJSON 

func CycleJSON(src any, tgt any) error

func DebugBuildInfo added in v0.11.5 

func DebugBuildInfo() *debug.BuildInfo

func DebugMemStats added in v0.11.5 

func DebugMemStats() *runtime.MemStats

func DebugStartCPUProfile added in v0.11.5 

func DebugStartCPUProfile() error

func DebugTakeHeapProfile added in v0.11.5 

func DebugTakeHeapProfile() error

func DecryptMessage 

func DecryptMessage(key []byte, message string, logger Logger) (string, error)

func DefaultIfNil added in v0.7.21 

func DefaultIfNil[T any](ptr *T, d T) T

func EncryptMessage 

func EncryptMessage(key []byte, message string, logger Logger) (string, error)

func ErrorMerge added in v0.3.15 

func ErrorMerge(errs ...error) error

func FromJSON 

func FromJSON(msg json.RawMessage, tgt any) error

func FromJSONInterface 

func FromJSONInterface(msg json.RawMessage) (any, error)

func FromJSONReader 

func FromJSONReader(r io.Reader, tgt any) error

func FromJSONStrict 

func FromJSONStrict(msg json.RawMessage, tgt any) error

func GetEnv added in v0.2.9 

func GetEnv(name string, defaultValue ...string) string

func GetEnvBool added in v0.2.14 

func GetEnvBool(name string, defaultValue bool) bool

func GetEnvDuration added in v0.3.8 

func GetEnvDuration(name string, defaultValue time.Duration) time.Duration

func GetEnvInt added in v0.3.1 

func GetEnvInt(name string, defaultValue int) int

func HashFNV32 

func HashFNV32(s string) uint32

func HashSHA256 

func HashSHA256(s string) string

HashSHA256 returns a Base64-encoded string representing the SHA-256 hash of the argument.

func InterfaceArrayFrom added in v0.2.10 

func InterfaceArrayFrom[T any](x ...T) []any

func JSONToMap 

func JSONToMap(i any) map[string]any

func LengthAny added in v0.2.32 

func LengthAny(dest any) int

func MarkdownTable added in v0.2.9 

func MarkdownTable(header []string, rows [][]string, linebreak string) (string, error)

func MicrosToMillis 

func MicrosToMillis(i int) string

func RandomBool 

func RandomBool() bool

func RandomBytes 

func RandomBytes(size int) []byte

func RandomDate 

func RandomDate() time.Time

func RandomFloat added in v0.5.1 

func RandomFloat(maxExclusive int) float64

func RandomInt 

func RandomInt(maxExclusive int) int

func RandomString 

func RandomString(length int) string

func ReplaceEnvVars 

func ReplaceEnvVars(s string, logger Logger) string

func RunProcess 

func RunProcess(cmd string, path string, in io.Reader, out io.Writer, er io.Writer, env ...string) (int, error)

func RunProcessSimple 

func RunProcessSimple(cmd string, path string) (int, string, error)

func StartProcess added in v0.6.10 

func StartProcess(cmd string, path string, in io.Reader, out io.Writer, er io.Writer, env ...string) (*exec.Cmd, error)

func StringArrayFromInterfaces 

func StringArrayFromInterfaces(a []any, maxLength int) []string

func StringArrayMaxLength 

func StringArrayMaxLength(a []string) int

func StringArrayOxfordComma 

func StringArrayOxfordComma(names []string, separator string) string

func StringArrayQuoted 

func StringArrayQuoted(a []string) []string

func StringDetectLinebreak added in v0.10.23 

func StringDetectLinebreak(s string) string

func StringForms 

func StringForms(s string) (string, string)

func StringHash added in v0.9.18 

func StringHash(s string) uint32

func StringPad 

func StringPad(s string, size int) string

func StringPadLeft added in v0.7.10 

func StringPadLeft(s string, size int, chr rune) string

func StringPadRight added in v0.7.10 

func StringPadRight(s string, size int, chr rune) string

func StringPlural 

func StringPlural(count int, s string) string

func StringPluralMaybe 

func StringPluralMaybe(s string, count int) string

func StringRepeat 

func StringRepeat(s string, n int) string

func StringReplaceBetween added in v0.7.5 

func StringReplaceBetween(s string, l string, r string, replacement string) (string, error)

func StringSplit 

func StringSplit(s string, sep byte, cutc bool) (string, string)

func StringSplitAndTrim 

func StringSplitAndTrim(s string, delim string) []string

func StringSplitLast 

func StringSplitLast(s string, sep byte, cutc bool) (string, string)

func StringSplitLastOnly added in v0.10.20 

func StringSplitLastOnly(s string, sep byte, cutc bool) string

func StringSplitLines added in v0.10.23 

func StringSplitLines(s string) []string

func StringSplitPath added in v0.10.20 

func StringSplitPath(s string) (string, string)

func StringSplitPathAndTrim added in v0.10.19 

func StringSplitPathAndTrim(s string) []string

func StringSubstringBetween added in v0.7.5 

func StringSubstringBetween(s string, l string, r string) string

func StringToCamel 

func StringToCamel(s string, extraAcronyms ...string) string

func StringToLowerCamel 

func StringToLowerCamel(s string, extraAcronyms ...string) string

func StringToPlural 

func StringToPlural(s string) string

func StringToSingular 

func StringToSingular(s string) string

func StringToSnake added in v0.3.15 

func StringToSnake(s string, extraAcronyms ...string) string

func StringToTitle 

func StringToTitle(s string, extraAcronyms ...string) string

func StringTruncate 

func StringTruncate(s string, max int) string

func TimeCurrent added in v0.10.14 

func TimeCurrent() time.Time

func TimeCurrentMillis 

func TimeCurrentMillis() int64

func TimeCurrentNanos added in v0.10.14 

func TimeCurrentNanos() int64

func TimeCurrentP added in v0.10.14 

func TimeCurrentP() *time.Time

func TimeCurrentUnix added in v0.10.14 

func TimeCurrentUnix() int64

func TimeFromFull 

func TimeFromFull(s string) (*time.Time, error)

func TimeFromHTML 

func TimeFromHTML(s string) (*time.Time, error)

func TimeFromJS 

func TimeFromJS(s string) (*time.Time, error)

func TimeFromString 

func TimeFromString(s string) (*time.Time, error)

func TimeFromStringFmt 

func TimeFromStringFmt(s string, fmt string) (*time.Time, error)

func TimeFromVerbose added in v0.9.17 

func TimeFromVerbose(s string) (*time.Time, error)

func TimeFromYMD 

func TimeFromYMD(s string) (*time.Time, error)

func TimeRelative 

func TimeRelative(t *time.Time) string

func TimeToFull 

func TimeToFull(d *time.Time) string

func TimeToHTML 

func TimeToHTML(d *time.Time) string

func TimeToJS 

func TimeToJS(d *time.Time) string

func TimeToMap added in v0.6.3 

func TimeToMap(t time.Time) map[string]any

func TimeToString 

func TimeToString(d *time.Time, fmt string) string

func TimeToVerbose added in v0.9.17 

func TimeToVerbose(d *time.Time) string

func TimeToYMD 

func TimeToYMD(d *time.Time) string

func TimeToday added in v0.7.0 

func TimeToday() *time.Time

func TimeTruncate added in v0.7.2 

func TimeTruncate(t *time.Time) *time.Time

func ToJSON 

func ToJSON(x any) string

func ToJSONBytes 

func ToJSONBytes(x any, indent bool) []byte

func ToJSONCompact 

func ToJSONCompact(x any) string

func UUID 

func UUID() uuid.UUID

func UUIDFromString 

func UUIDFromString(s string) *uuid.UUID

func UUIDFromStringOK added in v0.8.24 

func UUIDFromStringOK(s string) uuid.UUID

func UUIDP 

func UUIDP() *uuid.UUID

func UUIDString added in v0.6.24 

func UUIDString(u *uuid.UUID) string

Types

type DebugInfo 

type DebugInfo struct {
	ServerTags  *OrderedMap[string]
	AppTags     *OrderedMap[string]
	RuntimeTags *OrderedMap[string]
	Mods        []*debug.Module
}

func DebugGetInfo added in v0.11.5 

func DebugGetInfo(version string, started time.Time) *DebugInfo

type Diff 

type Diff struct {
	Path string `json:"path"`
	Old  string `json:"o,omitempty"`
	New  string `json:"n"`
}

func NewDiff 

func NewDiff(p string, o string, n string) *Diff

func (Diff) String 

func (d Diff) String() string

func (Diff) StringVerbose added in v0.5.6 

func (d Diff) StringVerbose() string

type Diffs 

type Diffs []*Diff

func DiffObjects 

func DiffObjects(l any, r any, path ...string) Diffs

func DiffObjectsIgnoring 

func DiffObjectsIgnoring(l any, r any, ignored []string, path ...string) Diffs

func RandomDiffs 

func RandomDiffs(size int) Diffs

func (Diffs) String 

func (d Diffs) String() string

func (Diffs) StringVerbose added in v0.5.6 

func (d Diffs) StringVerbose() string

type EpochTimestamp added in v0.6.23 

type EpochTimestamp struct {
	Epoch   int64      `json:"epoch,omitempty"`
	ISO8601 string     `json:"iso8601,omitempty"`
	Time    *time.Time `json:"-"`
}

func NewEpochTimestamp added in v0.6.23 

func NewEpochTimestamp() *EpochTimestamp

type ErrorDetail 

type ErrorDetail struct {
	Type       string            `json:"type"`
	Message    string            `json:"message"`
	StackTrace errors.StackTrace `json:"-"`
	Cause      *ErrorDetail      `json:"cause,omitempty"`
}

func GetErrorDetail 

func GetErrorDetail(e error) *ErrorDetail

type ErrorFrame 

type ErrorFrame struct {
	Key string
	Loc string
}

func TraceDetail 

func TraceDetail(trace errors.StackTrace) []ErrorFrame

type KeyTypeDesc added in v0.2.9 

type KeyTypeDesc struct {
	Key         string `json:"key"`
	Type        string `json:"type"`
	Description string `json:"description"`
}

func (*KeyTypeDesc) Array added in v0.2.9 

func (k *KeyTypeDesc) Array(key string) []string

type KeyTypeDescs added in v0.2.9 

type KeyTypeDescs []*KeyTypeDesc

func (KeyTypeDescs) Array added in v0.2.9 

func (k KeyTypeDescs) Array(key string) [][]string

func (KeyTypeDescs) Sort added in v0.2.9 

func (k KeyTypeDescs) Sort() KeyTypeDescs

type KeyVal added in v0.8.17 

type KeyVal[T any] struct {
	Key string `json:"key" db:"key"`
	Val T      `json:"val" db:"val"`
}

func (KeyVal[T]) String added in v0.8.17 

func (k KeyVal[T]) String() string

type KeyValInt 

type KeyValInt struct {
	Key   string `json:"key" db:"key"`
	Count int    `json:"val" db:"val"`
}

func (KeyValInt) String added in v0.2.30 

func (k KeyValInt) String() string

type KeyValInts added in v0.2.30 

type KeyValInts []*KeyValInt

func (KeyValInts) String added in v0.2.30 

func (k KeyValInts) String() string

func (KeyValInts) ToMap added in v0.2.30 

func (k KeyValInts) ToMap() map[string]int

type KeyVals added in v0.8.17 

type KeyVals[T any] []*KeyVal[T]

func (KeyVals[T]) String added in v0.8.17 

func (k KeyVals[T]) String() string

func (KeyVals[T]) ToMap added in v0.8.17 

func (k KeyVals[T]) ToMap() map[string]T

func (KeyVals[T]) Values added in v0.8.17 

func (k KeyVals[T]) Values() []T

type Logger added in v0.2.35 

type Logger = *zap.SugaredLogger

type OrderedMap 

type OrderedMap[V any] struct {
	Lexical bool
	Order   []string
	Map     map[string]V
}

func NewOrderedMap 

func NewOrderedMap[V any](lexical bool, capacity int) *OrderedMap[V]

func (*OrderedMap[V]) Append 

func (o *OrderedMap[V]) Append(k string, v V)

func (*OrderedMap[V]) Get 

func (o *OrderedMap[V]) Get(k string) (V, bool)

func (*OrderedMap[V]) GetSimple 

func (o *OrderedMap[V]) GetSimple(k string) V

func (OrderedMap[V]) MarshalJSON 

func (o OrderedMap[V]) MarshalJSON() ([]byte, error)

func (OrderedMap[V]) MarshalXML 

func (o OrderedMap[V]) MarshalXML(e *xml.Encoder, start xml.StartElement) error

func (OrderedMap[V]) MarshalYAML 

func (o OrderedMap[V]) MarshalYAML() (any, error)

func (*OrderedMap[V]) UnmarshalJSON 

func (o *OrderedMap[V]) UnmarshalJSON(b []byte) error

type Pkg 

type Pkg []string

func (Pkg) Drop 

func (p Pkg) Drop(n int) Pkg

func (Pkg) Equals 

func (p Pkg) Equals(other Pkg) bool

func (Pkg) Last 

func (p Pkg) Last() string

func (Pkg) Push 

func (p Pkg) Push(name string) Pkg

func (Pkg) Quoted 

func (p Pkg) Quoted(quote string) string

func (Pkg) Shift 

func (p Pkg) Shift() Pkg

func (Pkg) StartsWith 

func (p Pkg) StartsWith(t Pkg) bool

func (Pkg) String 

func (p Pkg) String() string

func (Pkg) StringWith 

func (p Pkg) StringWith(extra ...string) string

func (Pkg) ToPath 

func (p Pkg) ToPath(extra ...string) string

func (Pkg) Trim 

func (p Pkg) Trim(src Pkg) Pkg

func (Pkg) With 

func (p Pkg) With(key string) Pkg

type Timer added in v0.2.9 

type Timer struct {
	Started   int64 `json:"started"`
	Completed int64 `json:"complete"`
}

func TimerStart 

func TimerStart() *Timer

func (*Timer) Elapsed added in v0.2.9 

func (t *Timer) Elapsed() int

func (*Timer) End added in v0.2.9 

func (t *Timer) End() int

func (*Timer) EndString added in v0.2.9 

func (t *Timer) EndString() string

func (*Timer) String added in v0.2.9 

func (t *Timer) String() string

type ValueMap 

type ValueMap map[string]any

func RandomValueMap 

func RandomValueMap(keys int) ValueMap

func ValueMapFor 

func ValueMapFor(kvs ...any) ValueMap

func (ValueMap) Add 

func (m ValueMap) Add(kvs ...any)

func (ValueMap) AsChanges 

func (m ValueMap) AsChanges() (ValueMap, error)

func (ValueMap) Clone 

func (m ValueMap) Clone() ValueMap

func (ValueMap) Filter added in v0.7.13 

func (m ValueMap) Filter(keys []string) ValueMap

func (ValueMap) GetArray 

func (m ValueMap) GetArray(key string, allowEmpty bool) ([]any, error)

func (ValueMap) GetBool 

func (m ValueMap) GetBool(key string, allowEmpty bool) (bool, error)

func (ValueMap) GetBoolOpt added in v0.2.33 

func (m ValueMap) GetBoolOpt(key string) bool

func (ValueMap) GetFloat 

func (m ValueMap) GetFloat(key string, allowEmpty bool) (float64, error)

func (ValueMap) GetInt 

func (m ValueMap) GetInt(key string, allowEmpty bool) (int, error)

func (ValueMap) GetInt64 

func (m ValueMap) GetInt64(key string, allowEmpty bool) (int64, error)

func (ValueMap) GetIntOpt added in v0.6.4 

func (m ValueMap) GetIntOpt(key string) int

func (ValueMap) GetMap 

func (m ValueMap) GetMap(key string, allowEmpty bool) (ValueMap, error)

func (ValueMap) GetPath 

func (m ValueMap) GetPath(path string, allowMissing bool) (any, error)

func (ValueMap) GetRequired 

func (m ValueMap) GetRequired(k string) (any, error)

func (ValueMap) GetString 

func (m ValueMap) GetString(key string, allowEmpty bool) (string, error)

func (ValueMap) GetStringArray 

func (m ValueMap) GetStringArray(key string, allowEmpty bool) ([]string, error)

func (ValueMap) GetStringOpt 

func (m ValueMap) GetStringOpt(key string) string

func (ValueMap) GetStringPtr added in v0.8.23 

func (m ValueMap) GetStringPtr(key string) *string

func (ValueMap) GetTime 

func (m ValueMap) GetTime(key string, allowEmpty bool) (*time.Time, error)

func (ValueMap) GetType 

func (m ValueMap) GetType(key string, ret any) error

func (ValueMap) GetUUID 

func (m ValueMap) GetUUID(key string, allowEmpty bool) (*uuid.UUID, error)

func (ValueMap) Keys 

func (m ValueMap) Keys() []string

func (ValueMap) KeysAndValues 

func (m ValueMap) KeysAndValues() ([]string, []any)

func (ValueMap) MarshalXML 

func (m ValueMap) MarshalXML(e *xml.Encoder, start xml.StartElement) error

func (ValueMap) Merge 

func (m ValueMap) Merge(args ...ValueMap) ValueMap

func (ValueMap) Overwrite added in v0.7.13 

func (m ValueMap) Overwrite(sourceMap ValueMap) ValueMap

func (ValueMap) ParseArray 

func (m ValueMap) ParseArray(path string, allowMissing bool, allowEmpty bool) ([]any, error)

func (ValueMap) ParseArrayInt added in v0.3.16 

func (m ValueMap) ParseArrayInt(path string, allowMissing bool, allowEmpty bool) ([]int, error)

func (ValueMap) ParseArrayString added in v0.3.16 

func (m ValueMap) ParseArrayString(path string, allowMissing bool, allowEmpty bool) ([]string, error)

func (ValueMap) ParseBool 

func (m ValueMap) ParseBool(path string, allowMissing bool, allowEmpty bool) (bool, error)

func (ValueMap) ParseFloat 

func (m ValueMap) ParseFloat(path string, allowMissing bool, allowEmpty bool) (float64, error)

func (ValueMap) ParseInt 

func (m ValueMap) ParseInt(path string, allowMissing bool, allowEmpty bool) (int, error)

func (ValueMap) ParseMap 

func (m ValueMap) ParseMap(path string, allowMissing bool, allowEmpty bool) (ValueMap, error)

func (ValueMap) ParseString 

func (m ValueMap) ParseString(path string, allowMissing bool, allowEmpty bool) (string, error)

func (ValueMap) ParseTime 

func (m ValueMap) ParseTime(path string, allowMissing bool, allowEmpty bool) (*time.Time, error)

func (ValueMap) ParseUUID 

func (m ValueMap) ParseUUID(path string, allowMissing bool, allowEmpty bool) (*uuid.UUID, error)

func (ValueMap) SetPath 

func (m ValueMap) SetPath(path string, val any) error

func (ValueMap) ToQueryString 

func (m ValueMap) ToQueryString() string

func (ValueMap) ToStringMap added in v0.11.6 

func (m ValueMap) ToStringMap() map[string]string

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.