tools

package module

Go to main page

Versions in this module

v0

v0.2.1

May 31, 2026

v0.2.0

Apr 26, 2026

Changes in this version

+ const QRCodeDefaultLogoCover

+ var ErrLogoCoverNeedsLogo = errors.New("tools/qr: logo-cover requires logo")

+ var ErrLogoSourceConflict = errors.New("tools/qr: logo source conflict")

+ var ErrMissingText = errors.New("tools/qr: text is missing")

+ var ErrOutputPathEmpty = errors.New("tools/qr: output path cannot be empty")

+ var ErrOutputWriterNil = errors.New("tools/qr: output writer cannot be nil")

+ func GenerateQRCode(text, output string, options QRCodeOptions) error

+ func GenerateQRCodeToWriter(text string, output io.Writer, options QRCodeOptions) error

+ type QRCodeOptions struct

+ DisableForceHighestWhenLogo bool

+ Level QRCodeRecoveryLevel

+ LogoCover float64

+ LogoPath string

+ LogoReader io.Reader

+ Size int

+ Version int

+ type QRCodeRecoveryLevel int

+ const QRCodeRecoveryHigh

+ const QRCodeRecoveryHighest

+ const QRCodeRecoveryLow

+ const QRCodeRecoveryMedium

v0.1.4

Apr 24, 2026

Changes in this version

type SS

+ func (ss SS) DedupIn(transfers ...func(input string) (string, bool)) SS

v0.1.3

Dec 23, 2025

Changes in this version

+ func AllMapValueSlices[K comparable, T comparable](m map[K][]T, needDedup ...bool) []T

v0.1.2

Oct 15, 2025

Changes in this version

+ const DateTruncater

+ const DefaultDateFormat

+ const DefaultParseLayout

+ func BatchCall[T any](op func([]T) bool, batchSize int, ts ...T)

+ func OpenWriteFile(fullFilePathName string) (*os.File, error)

+ func RandomBytes(length int) []byte

+ func RemoveFile(fullFilePathName string) error

+ type Date time.Time

+ func NewADate(year int, month time.Month, day int, loc ...*time.Location) Date

+ func (d *Date) Scan(value any) error

+ func (d *Date) UnmarshalJSON(data []byte) error

+ func (d Date) Formalize() Date

+ func (d Date) MarshalJSON() ([]byte, error)

+ func (d Date) String() string

+ func (d Date) ToTime() Time

+ func (d Date) Value() (driver.Value, error)

+ type Exister interface

+ IsExist func(k K) bool

type KMap

+ func (km KMap[K, V]) KeySeq(filters ...func(k K, v V) bool) iter.Seq[K]

+ func (km KMap[K, V]) RangeSubMap(batchSize int, ranger func(m KMap[K, V]) bool)

type KS

+ func (ks KS[K]) In(e Exister[K]) KS[K]

+ func (ks KS[K]) NotIn(e Exister[K]) KS[K]

type KSet

+ func NewKSet[K comparable](ks ...K) KSet[K]

+ func (km KSet[K]) Adds(it iter.Seq[K]) KSet[K]

+ func (km KSet[K]) In(input iter.Seq[K]) iter.Seq[K]

+ func (km KSet[K]) Keys() iter.Seq[K]

+ func (km KSet[K]) RangeSubSet(batchSize int, ranger func(s KSet[K]) bool)

+ type List struct

+ func NewList[T any]() *List[T]

+ func (l *List[T]) All() iter.Seq[T]

+ func (l *List[T]) Back() *ListElement[T]

+ func (l *List[T]) Front() *ListElement[T]

+ func (l *List[T]) Init() *List[T]

+ func (l *List[T]) InsertAfter(v T, mark *ListElement[T]) *ListElement[T]

+ func (l *List[T]) InsertBefore(v T, mark *ListElement[T]) *ListElement[T]

+ func (l *List[T]) Len() int

+ func (l *List[T]) MoveAfter(e, mark *ListElement[T])

+ func (l *List[T]) MoveBefore(e, mark *ListElement[T])

+ func (l *List[T]) MoveToBack(e *ListElement[T])

+ func (l *List[T]) MoveToFront(e *ListElement[T])

+ func (l *List[T]) PushBack(v T) *ListElement[T]

+ func (l *List[T]) PushBackList(other *List[T])

+ func (l *List[T]) PushFront(v T) *ListElement[T]

+ func (l *List[T]) PushFrontList(other *List[T])

+ func (l *List[T]) Remove(e *ListElement[T]) T

+ type ListElement struct

+ Value T

+ func (e *ListElement[T]) Next() *ListElement[T]

+ func (e *ListElement[T]) Prev() *ListElement[T]

type NullInt32

+ func NewNullInt32(i int32) NullInt32

type NullInt64

+ func NewNullInt64(i int64) NullInt64

type NullString

+ func EmptyNullString(s string) NullString

+ func NewNullString(s string, valid bool) NullString

type NullTime

+ func ParseNullTime(layout, value string) NullTime

+ type OrderMap struct

+ func NewOrderMap[K comparable, V any]() *OrderMap[K, V]

+ func (m *OrderMap[K, V]) All() iter.Seq2[K, V]

+ func (m *OrderMap[K, V]) Del(k K)

+ func (m *OrderMap[K, V]) Get(k K) (V, bool)

+ func (m *OrderMap[K, V]) Keys() iter.Seq[K]

+ func (m *OrderMap[K, V]) Len() int

+ func (m *OrderMap[K, V]) Put(k K, v V) *OrderMap[K, V]

type S

+ func (s S) Float64() (float64, error)

type Time

+ func ParseTime(layout, value string) (Time, error)

+ func (t Time) AddDate(year, month, day int) Time

+ func (t Time) Day() int

+ func (t Time) Month() time.Month

+ func (t Time) Sub(o Time) time.Duration

+ func (t Time) ToDate() Date

+ func (t Time) ToNullTime() NullTime

+ func (t Time) Year() int

v0.1.1

Sep 17, 2025

Changes in this version

+ var ErrNilValue = errors.New("tools: nil value")

+ func Abs[I ~int | ~int8 | ~int16 | ~int32 | ~int64](i I) I

+ func IndirectType(typ reflect.Type) reflect.Type

+ func IndirectValue(val reflect.Value) reflect.Value

+ func NewIDValuer(ids ...int64) []driver.Valuer

+ func SplitNetAddr(addr string) (host string, port int)

+ func ValidAndCreateDir(pstr string, checkAndCreateIfAbsent bool) (string, error)

+ func VariadicParam[T any](params []T, defaultValue ...T) T

type KMap

+ func (km KMap[K, V]) Puts(it iter.Seq2[K, V]) KMap[K, V]

+ func (km KMap[K, V]) ValuesSeq(filters ...func(k K, v V) bool) iter.Seq[V]

type KS

+ func (ks KS[K]) All() iter.Seq[K]

type KSet

+ func (km KSet[K]) Appends(it iter.Seq[K]) KSet[K]

+ type NullInt32 sql.NullInt32

+ func LE0NullInt32(i int32) NullInt32

+ func (i *NullInt32) Scan(value any) error

+ func (i *NullInt32) UnmarshalJSON(input []byte) error

+ func (i NullInt32) Int() int32

+ func (i NullInt32) IsAvailable() bool

+ func (i NullInt32) IsNull() bool

+ func (i NullInt32) MarshalJSON() ([]byte, error)

+ func (i NullInt32) String() string

+ func (i NullInt32) Value() (driver.Value, error)

+ type NullInt64 sql.NullInt64

+ func LE0NullInt64(i int64) NullInt64

+ func (i *NullInt64) Clear()

+ func (i *NullInt64) Scan(value any) error

+ func (i *NullInt64) SetValue(val int64)

+ func (i *NullInt64) UnmarshalJSON(input []byte) error

+ func (i NullInt64) Int() int64

+ func (i NullInt64) IsAvailable() bool

+ func (i NullInt64) IsNull() bool

+ func (i NullInt64) MarshalJSON() ([]byte, error)

+ func (i NullInt64) String() string

+ func (i NullInt64) Value() (driver.Value, error)

+ type NullString sql.Null[string]

+ func (n *NullString) Scan(value any) error

+ func (n *NullString) UnmarshalJSON(data []byte) error

+ func (n NullString) IsNull() bool

+ func (n NullString) MarshalJSON() ([]byte, error)

+ func (n NullString) String() string

+ func (n NullString) Value() (driver.Value, error)

+ type NullTime sql.NullTime

+ func NewNullTime(t ...time.Time) NullTime

+ func NewNullUnixTime(ut int64) NullTime

+ func (n *NullTime) Scan(value any) error

+ func (n *NullTime) UnmarshalJSON(data []byte) error

+ func (n NullTime) Compare(ti time.Time) int

+ func (n NullTime) Equal(o NullTime) bool

+ func (n NullTime) Format(layout string) string

+ func (n NullTime) IsNull() bool

+ func (n NullTime) MarshalJSON() ([]byte, error)

+ func (n NullTime) Obj() time.Time

+ func (n NullTime) String() string

+ func (n NullTime) ToTime() Time

+ func (n NullTime) Value() (driver.Value, error)

+ type Version int64

+ func NewVersion(major, minor, patch uint64, alpha bool) (Version, error)

+ func ParseVersion(s string) (Version, error)

+ func (v Version) Alpha() Version

+ func (v Version) Major() uint64

+ func (v Version) Minor() uint64

+ func (v Version) Patch() uint64

+ func (v Version) String() string

v0.1.0

Sep 12, 2025

Changes in this version

+ const DefaultTimeFormat

+ const TimeFormatWithMS

+ const TimeTruncater

+ var ByteSliceType = reflect.TypeOf([]byte{})

+ var ErrNilDest = errors.New("destination value is nil")

+ var ErrNilSource = errors.New("source value is nil")

+ var ErrUnsupportedScan = errors.New("unsupported scan")

+ var Int64SliceType = reflect.TypeOf([]int64{})

+ var Int64Type = reflect.TypeOf(int64(0))

+ var StringSliceType = reflect.TypeOf([]string{})

+ var StringType = reflect.TypeOf("")

+ func IsByteSlice(typ reflect.Type) bool

+ func IsDefaultZero[T any](t T) bool

+ func SetByteSliceValue(val reflect.Value, bs []byte) error

+ type S string

+ func (s S) Bytes() []byte

+ func (s S) CSVLike() string

+ func (s S) CSVSplit() []string

+ func (s S) CamelToSnake() S

+ func (s S) FirstByte() byte

+ func (s S) FirstRune() rune

+ func (s S) FirstRuneString() S

+ func (s S) Formalize() S

+ func (s S) ID() (ID, error)

+ func (s S) Includes(ss ...string) bool

+ func (s S) Int64() (int64, error)

+ func (s S) IsValid() bool

+ func (s S) JSON() (JSON, error)

+ func (s S) Like() string

+ func (s S) MustID() ID

+ func (s S) RegexpSplit(expr string) ([]string, error)

+ func (s S) Replace(source, target string) S

+ func (s S) SplitBy(sep string) []string

+ func (s S) SplitLines() (SS, error)

+ func (s S) String() string

+ func (s S) ToLower() S

+ func (s S) ToUpper() S

+ func (s S) Trim() S

+ type Time time.Time

+ func NewDate(year int, month time.Month, day, hour, min, sec int) Time

+ func NewFullDate(year int, month time.Month, day, hour, min, sec, nsec int, loc *time.Location) Time

+ func NewTime(t time.Time) Time

+ func NewUnixTime(ts int64) Time

+ func Now() Time

+ func ZeroTime() Time

+ func (t *Time) Scan(value any) error

+ func (t *Time) UnmarshalJSON(data []byte) error

+ func (t Time) After(d time.Duration) Time

+ func (t Time) Before(d time.Duration) Time

+ func (t Time) Compare(o Time) int

+ func (t Time) CurrentHour() Time

+ func (t Time) CurrentRound(interval time.Duration) Time

+ func (t Time) DetailString() string

+ func (t Time) Equal(o Time) bool

+ func (t Time) FromUnix(seconds int64) Time

+ func (t Time) HourAfter(d time.Duration) Time

+ func (t Time) IsZero() bool

+ func (t Time) MarshalJSON() ([]byte, error)

+ func (t Time) NNUnixMilli() int64

+ func (t Time) NextHour() Time

+ func (t Time) NextRound(interval time.Duration) Time

+ func (t Time) String() string

+ func (t Time) Time() time.Time

+ func (t Time) UTCString() string

+ func (t Time) Unix() int64

+ func (t Time) UnixMilli() int64

+ func (t Time) UnixMilliString() string

+ func (t Time) UnixString() string

+ func (t Time) Value() (driver.Value, error)

v0.0.7

Sep 12, 2025

Changes in this version

+ type B byte

+ func (b B) PopCount() int

+ type Bs []byte

+ func (bs Bs) PopCount() int

+ type F float64

+ func (f F) ID() (i ID, overflow bool)

+ func (f F) Int() (i int64, flowed bool)

+ func (f F) MustID() ID

+ func (f F) MustInt() int64

+ type ID int64

+ func (id ID) Decr() int64

+ func (id ID) FullBytes() []byte

+ func (id ID) Incr() int64

+ func (id ID) Int() int64

+ func (id ID) IsValid() bool

+ func (id ID) PadZeros() string

+ func (id ID) String() string

v0.0.6

Sep 8, 2025

Changes in this version

+ type JSONArray []T

+ func NewJSONArray[T comparable](data JSON) (ja JSONArray[T], err error)

+ func (ja JSONArray[T]) Equal(jt JSONArray[T]) bool

+ func (ja JSONArray[T]) Index(v T) int

+ func (ja JSONArray[T]) MarshalJSON() ([]byte, error)

+ func (ja JSONArray[T]) ToArray() []T

+ func (ja JSONArray[T]) ToJSON() (JSON, error)

+ func (ja JSONArray[T]) ToNotNullJSON() (NotNullJSON, error)

v0.0.5

Sep 8, 2025

Changes in this version

+ func JsonPrettyString(m any) (string, error)

+ func MustJsonPrettyString(m any) string

+ func MustJsonString(m any) string

type KKMap

+ func (kkm KKMap[K1, K2, V]) IsExistKey(k1 K1) (exist bool)

type KMap

+ func (km KMap[K, V]) ExistingList(keys ...K) []V

type KS

+ func (ks KS[K]) Append(k K) KS[K]

+ func (ks KS[K]) Equal(os KS[K]) bool

+ func (ks KS[K]) Sub(offset, limit int) KS[K]

type KSet

+ func (km KSet[K]) ExsitingList(ks ...K) []K

type NotNullJSON

+ func (n NotNullJSON) ToJSON() JSON

type SS

+ func (ss SS) Has(s string) bool

+ func (ss SS) Matchs(str string) bool

+ func (ss SS) Sort() SS

v0.0.4

Nov 11, 2024

Changes in this version

type KKMap

+ func (kkm KKMap[K1, K2, V]) GetByKey(k1 K1) (KMap[K2, V], bool)

+ func (kkm KKMap[K1, K2, V]) IsExist(k1 K1, k2 K2) (exist bool)

+ func (kkm KKMap[K1, K2, V]) PutKey(k1 K1, km2 map[K2]V) KKMap[K1, K2, V]

type KMap

+ func (km KMap[K, V]) SubMap(ks ...K) KMap[K, V]

v0.0.3

Sep 24, 2024

Changes in this version

type KKMap

+ func (kkm KKMap[K1, K2, V]) Range(callback func(k1 K1, k2 K2, v V) (goon bool))

v0.0.2

Sep 24, 2024

Changes in this version

+ func IF[T any](condition bool, trueValue T, falseValue T) T

v0.0.1

Sep 24, 2024

Changes in this version

+ func CopySlice[T any](src []T) []T

+ func JsonString(m any) (string, error)

+ func SsToTs[S, T any](transmitter func(S) T, ss ...S) []T

+ func TsToSs[T, S any](transmitter func(T) (S, bool), ts ...T) []S

+ type JSON json.RawMessage

+ func (j *JSON) Bytes() []byte

+ func (j *JSON) Clone() JSON

+ func (j *JSON) Equal(o *JSON) bool

+ func (j *JSON) Scan(value interface{}) error

+ func (j *JSON) String() string

+ func (j *JSON) UnmarshalJSON(data []byte) error

+ func (j JSON) Format(f fmt.State, c rune)

+ func (j JSON) IsNull() bool

+ func (j JSON) MarshalJSON() ([]byte, error)

+ func (j JSON) Value() (driver.Value, error)

+ type JSONBuilder struct

+ func (b JSONBuilder) FromObj(obj any) (JSON, error)

+ func (b JSONBuilder) FromString(jsonStr string) (JSON, error)

+ func (b JSONBuilder) NoErrObj(obj any) JSON

+ func (b JSONBuilder) NoErrString(jsonStr string) JSON

+ type KKMap map[K1]map[K2]V

+ func (kkm KKMap[K1, K2, V]) Delete(k1 K1, k2 K2)

+ func (kkm KKMap[K1, K2, V]) DeleteKey(k1 K1)

+ func (kkm KKMap[K1, K2, V]) Get(k1 K1, k2 K2) (v V, exist bool)

+ func (kkm KKMap[K1, K2, V]) Put(k1 K1, k2 K2, v V) KKMap[K1, K2, V]

+ type KMap map[K]V

+ func (km KMap[K, V]) Delete(ks ...K)

+ func (km KMap[K, V]) Get(k K) (v V, exist bool)

+ func (km KMap[K, V]) IsExist(key K) bool

+ func (km KMap[K, V]) Keys(filters ...func(k K, v V) bool) []K

+ func (km KMap[K, V]) List(keys ...K) []V

+ func (km KMap[K, V]) Map() map[K]V

+ func (km KMap[K, V]) Merge(kmo KMap[K, V]) KMap[K, V]

+ func (km KMap[K, V]) Put(key K, value V) KMap[K, V]

+ func (km KMap[K, V]) Values(filters ...func(k K, v V) bool) []V

+ type KS []K

+ func (ks KS[K]) Clone() KS[K]

+ func (ks KS[K]) Contains(tgt K) bool

+ func (ks KS[K]) Dedup(validators ...func(k K) bool) KS[K]

+ func (ks KS[K]) DedupRange(one func(k K) error) error

+ func (ks KS[K]) IterateRemove(tgt K) KS[K]

+ func (ks KS[K]) Map() KSet[K]

+ func (ks KS[K]) Remove(tgts ...K) KS[K]

+ func (ks KS[K]) Slice() []K

+ type KSet map[K]struct

+ func (km KSet[K]) Add(ks ...K) KSet[K]

+ func (km KSet[K]) Append(ks ...K) KSet[K]

+ func (km KSet[K]) AppendSet(s KSet[K]) KSet[K]

+ func (km KSet[K]) CAS(k K) (set KSet[K], changed bool)

+ func (km KSet[K]) Clone() KSet[K]

+ func (km KSet[K]) Delete(ks ...K) KSet[K]

+ func (km KSet[K]) Equal(o KSet[K]) bool

+ func (km KSet[K]) IsExist(k K) bool

+ func (km KSet[K]) Slice() []K

+ type KV struct

+ func (KV[K, V]) KeyNotInMap(m map[K]V, ks ...K) []K

+ func (KV[K, V]) List(keys []K, valuesMap map[K]V) []V

+ func (KV[K, V]) MapKeys(m map[K]V) []K

+ func (KV[K, V]) MapValues(m map[K]V) []V

+ func (KV[K, V]) OneOfMap(k K, mapper func([]K) (map[K]V, error)) (v V, err error)

+ func (KV[K, V]) PutToMap(m map[K]V, k K, v V) map[K]V

+ func (KV[K, V]) RangeByK(ks []K, m map[K]V, dowork func(k K, v V) error) error

+ func (KV[K, V]) SubMap(valuesMap map[K]V, ks ...K) map[K]V

+ type NotNullJSON JSON

+ func (n *NotNullJSON) Bytes() []byte

+ func (n *NotNullJSON) Clone() NotNullJSON

+ func (n *NotNullJSON) Equal(o *NotNullJSON) bool

+ func (n *NotNullJSON) Scan(value interface{}) error

+ func (n *NotNullJSON) String() string

+ func (n *NotNullJSON) UnmarshalJSON(data []byte) error

+ func (n NotNullJSON) IsNull() bool

+ func (n NotNullJSON) MarshalJSON() ([]byte, error)

+ func (n NotNullJSON) Value() (driver.Value, error)

+ type SS []string

+ func (ss SS) Append(s ...string) SS

+ func (ss SS) Clone() SS

+ func (ss SS) Dedup(transfers ...func(input string) (string, bool)) SS

+ func (ss SS) Join(sep string) string

+ func (ss SS) Map() KSet[string]

+ func (ss SS) Remove(strs ...string) SS

+ func (ss SS) Slice() []string

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