mapsutil

README

mapsutil

The package contains various helpers to interact with maps

Documentation

Index

• Variables
• func Clear[K comparable, V any](mm ...map[K]V)
• func DNSToMap(msg *dns.Msg, format string) (m map[string]interface{})
• func Difference[K comparable, V any](m map[K]V, keys ...K) map[K]V
• func Flatten(m map[string]any, separator string) map[string]any
• func GetKeys[K comparable, V any](maps ...map[K]V) []K
• func GetValues[K comparable, V any](maps ...map[K]V) []V
• func HTTPRequestToMap(req *http.Request) (map[string]interface{}, error)
• func HTTPResponseToMap(resp *http.Response) (map[string]interface{}, error)
• func HTTPToMap(resp *http.Response, body, headers string, duration time.Duration, ...) (m map[string]interface{})
• func IsEmpty[K comparable, V any](m map[K]V) bool
• func Merge[K comparable, V any](maps ...map[K]V) (result map[K]V)
• func SliceToMap[T comparable](s []T, dflt T) map[T]T
• func Walk(m map[string]any, callback func(k string, v any))
• type Map
  • func (m Map[K, V]) GetKeyWithValue(value V) (K, bool)
  • func (m Map[K, V]) GetKeys(keys ...K) []V
  • func (m Map[K, V]) GetOrDefault(key K, defaultValue V) V
  • func (m Map[K, V]) Has(key K) bool
  • func (m Map[K, V]) Merge(n map[K]V)
• type SyncLockMap
  • func (s *SyncLockMap[K, V]) Get(k K) (V, bool)
  • func (s *SyncLockMap[K, V]) Iterate(f func(k K, v V) error) error
  • func (s *SyncLockMap[K, V]) Lock()
  • func (s *SyncLockMap[K, V]) Set(k K, v V) error
  • func (s *SyncLockMap[K, V]) Unlock()

Variables

var (
	ErrReadOnly = errors.New("read only mode")
)

Functions

func Clear

func Clear[K comparable, V any](mm ...map[K]V)

Clear the map passed as parameter

func DNSToMap

func DNSToMap(msg *dns.Msg, format string) (m map[string]interface{})

DNSToMap Converts DNS to Matcher Map

func Difference

func Difference[K comparable, V any](m map[K]V, keys ...K) map[K]V

Difference returns the inputted map without the keys specified as input.

func Flatten

func Flatten(m map[string]any, separator string) map[string]any

Flatten takes a map and returns a new one where nested maps are replaced by dot-delimited keys.

func GetKeys

func GetKeys[K comparable, V any](maps ...map[K]V) []K

GetKeys returns the map's keys.

func GetValues

func GetValues[K comparable, V any](maps ...map[K]V) []V

GetValues returns the map's values.

func HTTPRequestToMap

func HTTPRequestToMap(req *http.Request) (map[string]interface{}, error)

HTTPRequestToMap Converts HTTP Request to Matcher Map

func HTTPResponseToMap

func HTTPResponseToMap(resp *http.Response) (map[string]interface{}, error)

HTTPResponseToMap Converts HTTP Response to Matcher Map

func HTTPToMap

func HTTPToMap(resp *http.Response, body, headers string, duration time.Duration, format string) (m map[string]interface{})

HTTPToMap Converts HTTP to Matcher Map

func IsEmpty

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

IsEmpty checks if a map is empty.

func Merge

func Merge[K comparable, V any](maps ...map[K]V) (result map[K]V)

Merge merges the inputted maps into a new one. Be aware: In case of duplicated keys in multiple maps, the one ending in the result is unknown a priori.

func SliceToMap

func SliceToMap[T comparable](s []T, dflt T) map[T]T

SliceToMap returns a map having as keys the elements in even positions and as values the elements in odd positions. If the number of elements is odd the default value applies.

func Walk

func Walk(m map[string]any, callback func(k string, v any))

Walk a map and visit all the edge key:value pairs

Types

type Map

type Map[K, V comparable] map[K]V

Map wraps a generic map type

func (Map[K, V]) GetKeyWithValue

func (m Map[K, V]) GetKeyWithValue(value V) (K, bool)

GetKeyWithValue returns the first key having value

func (Map[K, V]) GetKeys

func (m Map[K, V]) GetKeys(keys ...K) []V

GetKeys from the map as a slice

func (Map[K, V]) GetOrDefault

func (m Map[K, V]) GetOrDefault(key K, defaultValue V) V

GetOrDefault the provided key or default to the provided value

func (Map[K, V]) Has

func (m Map[K, V]) Has(key K) bool

Has checks if the current map has the provided key

func (Map[K, V]) Merge

func (m Map[K, V]) Merge(n map[K]V)

Merge the current map with the provided one

type SyncLockMap

type SyncLockMap[K, V comparable] struct {
	ReadOnly atomic.Bool

	Map Map[K, V]
	// contains filtered or unexported fields
}

SyncLock adds sync and lock capabilities to generic map

func (*SyncLockMap[K, V]) Get

func (s *SyncLockMap[K, V]) Get(k K) (V, bool)

Get an item with syncronous access

func (*SyncLockMap[K, V]) Iterate

func (s *SyncLockMap[K, V]) Iterate(f func(k K, v V) error) error

Iterate with a callback function synchronously

func (*SyncLockMap[K, V]) Lock

func (s *SyncLockMap[K, V]) Lock()

Lock the current map to read-only mode

func (*SyncLockMap[K, V]) Set

func (s *SyncLockMap[K, V]) Set(k K, v V) error

Set an item with syncronous access

func (*SyncLockMap[K, V]) Unlock

func (s *SyncLockMap[K, V]) Unlock()

Unlock the current map