relec

README

relec

Go Utilities to be used in your project

Documentation

Index

• func Absolute[T int | int8 | int16 | int32 | int64 | float32 | float64](value T) T
• func ArrayContains[T ~string | int | int8 | int16 | int32 | int64 | float32 | float64](set []T, value T) bool
• func CheckIfFilesExists(files ...string) error
• func Concurrent[T any](ctx context.Context, array []T, concurrency int, ...) error
• func ConcurrentC[T any](ctx context.Context, next *Next[T], concurrency int, ...) error
• func ConcurrentF(ctx context.Context, functions ...CtxFunc) error
• func ConcurrentInGroup[T any](group *CxGroup, array []T, execute func(ctx context.Context, one T) error)
• func FindInArray[T any](set []T, match func(elem T) bool) (int, bool)
• func IsInstance(val any, typ reflect.Kind) bool
• func IsOfType(object interface{}, decidingKey string) (bool, error)
• func IsSubset[T comparable](setArray, subsetArray []T) bool
• func MaxDate(v1, v2 time.Time) time.Time
• func Unmarshal(from interface{}, object interface{}) error
• func UnmarshalFile(file string, dest any) error
• func Validate[T any](structure T) error
• type CtxFunc
• type CxGroup
  • func NewCGroup(ctx context.Context) *CxGroup
  • func NewCGroupWithLimit(ctx context.Context, limit int) *CxGroup
  • func (g *CxGroup) Add(execute func(ctx context.Context) error)
  • func (g *CxGroup) Block() error
• type Hashable
• type Identifier
• type Logger
• type Next
  • func Yield[T any](next func(prev T) (bool, T, error)) *Next[T]
  • func (n *Next[T]) Close()
  • func (n *Next[T]) Next() bool
• type Set
  • func NewSet[T comparable](initial ...T) *Set[T]
  • func (this *Set[T]) Array() []T
  • func (this *Set[T]) Difference(set *Set[T]) *Set[T]
  • func (this *Set[T]) Exists(element T) bool
  • func (this *Set[T]) Hash(elem T) string
  • func (this *Set[T]) Insert(element T)
  • func (this *Set[T]) Intersection(set *Set[T]) *Set[T]
  • func (this *Set[T]) Len() int
  • func (this *Set[T]) MarshalJSON() ([]byte, error)
  • func (this *Set[T]) ProperSubsetOf(set *Set[T]) bool
  • func (this *Set[T]) Range(f func(T))
  • func (this *Set[T]) Remove(element T)
  • func (this *Set[T]) String() string
  • func (this *Set[T]) SubsetOf(set *Set[T]) bool
  • func (this *Set[T]) Union(set *Set[T]) *Set[T]
  • func (this *Set[T]) UnmarshalJSON(data []byte) error
  • func (this *Set[T]) WithHasher(f func(T) string) *Set[T]

Functions

func Absolute

func Absolute[T int | int8 | int16 | int32 | int64 | float32 | float64](value T) T

func ArrayContains

func ArrayContains[T ~string | int | int8 | int16 | int32 | int64 | float32 | float64](set []T, value T) bool

func CheckIfFilesExists

func CheckIfFilesExists(files ...string) error

func Concurrent

func Concurrent[T any](ctx context.Context, array []T, concurrency int, execute func(ctx context.Context, one T, executionNumber int) error) error

func ConcurrentC

func ConcurrentC[T any](ctx context.Context, next *Next[T], concurrency int, execute func(ctx context.Context, one T, sequence int64) error) error

func ConcurrentF

func ConcurrentF(ctx context.Context, functions ...CtxFunc) error

func ConcurrentInGroup

func ConcurrentInGroup[T any](group *CxGroup, array []T, execute func(ctx context.Context, one T) error)

func FindInArray

func FindInArray[T any](set []T, match func(elem T) bool) (int, bool)

func IsInstance

func IsInstance(val any, typ reflect.Kind) bool

func IsOfType

func IsOfType(object interface{}, decidingKey string) (bool, error)

func IsSubset

func IsSubset[T comparable](setArray, subsetArray []T) bool

func MaxDate

func MaxDate(v1, v2 time.Time) time.Time

func Unmarshal

func Unmarshal(from interface{}, object interface{}) error

Unmarshal serializes and deserializes any from into the object return error if occurred

func UnmarshalFile

func UnmarshalFile(file string, dest any) error

func Validate

func Validate[T any](structure T) error

Types

type CtxFunc

type CtxFunc = func(ctx context.Context) error

type CxGroup

type CxGroup struct {
	// contains filtered or unexported fields
}

func NewCGroup

func NewCGroup(ctx context.Context) *CxGroup

func NewCGroupWithLimit

func NewCGroupWithLimit(ctx context.Context, limit int) *CxGroup

func (*CxGroup) Add

func (g *CxGroup) Add(execute func(ctx context.Context) error)

func (*CxGroup) Block

func (g *CxGroup) Block() error

type Hashable

type Hashable interface {
	Hash() string
}

type Identifier

type Identifier interface {
	ID() string
}

type Logger

type Logger interface {
	Info(v ...interface{})
	Infof(format string, v ...interface{})
	Debug(v ...interface{})
	Debugf(format string, v ...interface{})
	Error(v ...interface{})
	Fatal(v ...interface{})
	Fatalf(format string, v ...interface{})
	Errorf(format string, v ...interface{})
	Warn(v ...interface{})
	Warnf(format string, v ...interface{})
}

type Next

type Next[T any] struct {
	// contains filtered or unexported fields
}

func Yield

func Yield[T any](next func(prev T) (bool, T, error)) *Next[T]

func (*Next[T]) Close

func (n *Next[T]) Close()

func (*Next[T]) Next

func (n *Next[T]) Next() bool

type Set

type Set[T comparable] struct {
	// contains filtered or unexported fields
}

func NewSet

func NewSet[T comparable](initial ...T) *Set[T]

Create a new set

func (*Set[T]) Array

func (this *Set[T]) Array() []T

func (*Set[T]) Difference

func (this *Set[T]) Difference(set *Set[T]) *Set[T]

Find the difference between two sets

func (*Set[T]) Exists

func (this *Set[T]) Exists(element T) bool

Test to see whether or not the element is in the set

func (*Set[T]) Hash

func (this *Set[T]) Hash(elem T) string

func (*Set[T]) Insert

func (this *Set[T]) Insert(element T)

Add an element to the set

func (*Set[T]) Intersection

func (this *Set[T]) Intersection(set *Set[T]) *Set[T]

Find the intersection of two sets

func (*Set[T]) Len

func (this *Set[T]) Len() int

Return the number of items in the set

func (*Set[T]) MarshalJSON

func (this *Set[T]) MarshalJSON() ([]byte, error)

func (*Set[T]) ProperSubsetOf

func (this *Set[T]) ProperSubsetOf(set *Set[T]) bool

Test whether or not this set is a proper subset of "set"

func (*Set[T]) Range

func (this *Set[T]) Range(f func(T))

Call f for each item in the set

func (*Set[T]) Remove

func (this *Set[T]) Remove(element T)

Remove an element from the set

func (*Set[T]) String

func (this *Set[T]) String() string

func (*Set[T]) SubsetOf

func (this *Set[T]) SubsetOf(set *Set[T]) bool

Test whether or not this set is a subset of "set"

func (*Set[T]) Union

func (this *Set[T]) Union(set *Set[T]) *Set[T]

Find the union of two sets

func (*Set[T]) UnmarshalJSON

func (this *Set[T]) UnmarshalJSON(data []byte) error

func (*Set[T]) WithHasher

func (this *Set[T]) WithHasher(f func(T) string) *Set[T]