utils

Documentation

Index

• Constants
• func AlphaReverseMap(alphabet string, out map[rune]uint) map[rune]uint
• func BatchGet[T any](ids []string, reqMaker func(string) (T, error)) (out map[string]T)
• func Call(req *http.Request) (response interface{}, err error)
• func EncodeURIComponent(str string) string
• func EnsureDirOf(path string) error
• func EnsureEnvOrDefault(currval string, envvar string, defaultValue string) string
• func ExcelDecode(encoded string, alphabet string, revmap map[rune]uint) uint64
• func ExcelEncode(value uint64, alphabet string) string
• func ExpandUserPath(path string) string
• func Filter[T any](items []T, filtfunc func(T) bool) (out []T)
• func FormatDate(t time.Time) string
• func FormatTime(t time.Time) string
• func GetEnvOrDefault(envvar string, defaultValue string, ensure bool) string
• func GetEnvOrDefaultInt(envvar string, defaultvalue int) (int, error)
• func GetMapField(input StringMap, fieldPath interface{}) (any, error)
• func GetMapFieldForced(input StringMap, fieldPath interface{}) any
• func HTTPErrorCode(err error) int
• func IndexOf[T any](items []T, matchfunc func(T) bool) int
• func Insert[T any](list []T, item T, index int) []T
• func IsDirEmpty(name string) (bool, error)
• func JsonDecodeBytes(bytes []byte) (interface{}, error)
• func JsonDecodeStr(str string) (interface{}, error)
• func JsonGet(url string, onReq func(req *http.Request)) (interface{}, *http.Response, error)
• func JsonReadFile(path string) (interface{}, error)
• func JsonToQueryString(json StringMap) string
• func JsonWriteFile(data interface{}, path string, perm os.FileMode) error
• func MakeUrl(host, path string, args string) (url string)
• func Map[T any, U any](items []T, mapfunc func(T) U) (out []U)
• func MapKeys[K comparable, V any](input map[K]V) []K
• func MapValues[V any, K comparable](input map[K]V) []V
• func NeedsRefresh(refresh_type int32, last_refreshed_at time.Time, now time.Time) bool
• func NewBytesRequest(method string, endpoint string, body []byte) (req *http.Request, err error)
• func NewJsonRequest(method string, endpoint string, body StringMap) (req *http.Request, err error)
• func NewRequest(method string, endpoint string, bodyReader io.Reader) (req *http.Request, err error)
• func OpenBrowser(url string)
• func PaddedWith(input string, padding byte) string
• func ParseDate(str string) time.Time
• func ParseTime(str string) time.Time
• func PriceString(value float64) string
• func RandString(length int, chars string) string
• func Reduce[T any, V any](input []T, reducer func(index int, item T, output V) V, out V) V
• type DefaultMap
  • func NewDefaultMap[V any](creator func(key string) V) *DefaultMap[V]
  • func (tm *DefaultMap[V]) Ensure(key string) V
  • func (tm *DefaultMap[V]) Get(key string) (V, bool)
• type HTTPError
  • func (t *HTTPError) Error() string
• type StringMap
  • func CopyMapFields(input StringMap, output StringMap, field_paths ...interface{}) (StringMap, error)
  • func SetMapField(input StringMap, fieldPath interface{}, value interface{}) (StringMap, error)
  • func SetMapFields(input StringMap, field_paths_and_values ...interface{}) (StringMap, error)

Constants

const (
	DATE_FORMAT     = "2006-01-02"
	DATETIME_FORMAT = "2006-01-02 03-04-05"
)

const (
	ErrCodeInvalidRequest     = 400
	ErrCodeInvalidCredentials = 401
	ErrCodeAuthorized         = 403
	ErrCodeEntityNotFound     = 404
)

Functions

func AlphaReverseMap

func AlphaReverseMap(alphabet string, out map[rune]uint) map[rune]uint

func BatchGet

func BatchGet[T any](ids []string, reqMaker func(string) (T, error)) (out map[string]T)

func Call

func Call(req *http.Request) (response interface{}, err error)

func EncodeURIComponent

func EncodeURIComponent(str string) string

func EnsureDirOf

func EnsureDirOf(path string) error

func EnsureEnvOrDefault

func EnsureEnvOrDefault(currval string, envvar string, defaultValue string) string

func ExcelDecode

func ExcelDecode(encoded string, alphabet string, revmap map[rune]uint) uint64

func ExcelEncode

func ExcelEncode(value uint64, alphabet string) string

func ExpandUserPath

func ExpandUserPath(path string) string

func Filter

func Filter[T any](items []T, filtfunc func(T) bool) (out []T)

func FormatDate

func FormatDate(t time.Time) string

func FormatTime

func FormatTime(t time.Time) string

func GetEnvOrDefault

func GetEnvOrDefault(envvar string, defaultValue string, ensure bool) string

*

• Gets the value of an environment value and if it is missing returns the
• default value.

func GetEnvOrDefaultInt

func GetEnvOrDefaultInt(envvar string, defaultvalue int) (int, error)

func GetMapField

func GetMapField(input StringMap, fieldPath interface{}) (any, error)

func GetMapFieldForced

func GetMapFieldForced(input StringMap, fieldPath interface{}) any

func HTTPErrorCode

func HTTPErrorCode(err error) int

func IndexOf

func IndexOf[T any](items []T, matchfunc func(T) bool) int

func Insert

func Insert[T any](list []T, item T, index int) []T

*

• A method to insert an item at an index in a slice.

func IsDirEmpty

func IsDirEmpty(name string) (bool, error)

func JsonDecodeBytes

func JsonDecodeBytes(bytes []byte) (interface{}, error)

func JsonDecodeStr

func JsonDecodeStr(str string) (interface{}, error)

func JsonGet

func JsonGet(url string, onReq func(req *http.Request)) (interface{}, *http.Response, error)

func JsonReadFile

func JsonReadFile(path string) (interface{}, error)

func JsonToQueryString

func JsonToQueryString(json StringMap) string

func JsonWriteFile

func JsonWriteFile(data interface{}, path string, perm os.FileMode) error

func MakeUrl

func MakeUrl(host, path string, args string) (url string)

func Map

func Map[T any, U any](items []T, mapfunc func(T) U) (out []U)

func MapKeys

func MapKeys[K comparable, V any](input map[K]V) []K

func MapValues

func MapValues[V any, K comparable](input map[K]V) []V

func NeedsRefresh

func NeedsRefresh(refresh_type int32, last_refreshed_at time.Time, now time.Time) bool

func NewBytesRequest

func NewBytesRequest(method string, endpoint string, body []byte) (req *http.Request, err error)

func NewJsonRequest

func NewJsonRequest(method string, endpoint string, body StringMap) (req *http.Request, err error)

func NewRequest

func NewRequest(method string, endpoint string, bodyReader io.Reader) (req *http.Request, err error)

func OpenBrowser

func OpenBrowser(url string)

*

• Opens the browser pointing to a given URL.

func PaddedWith

func PaddedWith(input string, padding byte) string

func ParseDate

func ParseDate(str string) time.Time

func ParseTime

func ParseTime(str string) time.Time

func PriceString

func PriceString(value float64) string

func RandString

func RandString(length int, chars string) string

func Reduce

func Reduce[T any, V any](input []T, reducer func(index int, item T, output V) V, out V) V

Types

type DefaultMap

type DefaultMap[V interface{}] struct {
	// contains filtered or unexported fields
}

func NewDefaultMap

func NewDefaultMap[V any](creator func(key string) V) *DefaultMap[V]

func (*DefaultMap[V]) Ensure

func (tm *DefaultMap[V]) Ensure(key string) V

func (*DefaultMap[V]) Get

func (tm *DefaultMap[V]) Get(key string) (V, bool)

type HTTPError

type HTTPError struct {
	Code    int
	Message string
}

func (*HTTPError) Error

func (t *HTTPError) Error() string

type StringMap

type StringMap = map[string]interface{}

func CopyMapFields

func CopyMapFields(input StringMap, output StringMap, field_paths ...interface{}) (StringMap, error)

*

• Copy a value in a given field path from the source into a fieldpath in the dest if
• a. source field path is valid and exists
• b. dest field path is valid (or needs to be created).

func SetMapField

func SetMapField(input StringMap, fieldPath interface{}, value interface{}) (StringMap, error)

*

• Sets a map field at a given field path ensuring that everything until the leaf is a dictionary indeed.

func SetMapFields

func SetMapFields(input StringMap, field_paths_and_values ...interface{}) (StringMap, error)

*

• SetMapFields takes a map and a list of field paths and values and sets the values in the map
• @param input the map to set the values in
• @param field_paths_and_values a list of field paths and values. The field paths are strings separated by "/" and the values are the values to set
• @return error if there is an error at the first fieldpath that failed.