Lancet is a comprehensive, efficient, and reusable util function library of go. Inspired by the java apache common package and lodash.js.

English | 简体中文

Feature

• 👏 Comprehensive, efficient and reusable.
• 💪 300+ go util functions, support string, slice, datetime, net, crypt...
• 💅 Only depend on the go standard library.
• 🌍 Unit test for every exported function.

Installation

Note:

1. For users who use go1.18 and above, it is recommended to install lancet v2.x.x. Cause in v2.x.x all functions was rewriten with generics of go1.18.

go get github.com/duke-git/lancet/v2 // will install latest version of v2.x.x

2. For users who use version below go1.18, you should install v1.x.x. The latest of v1.x.x is v1.3.5.

go get github.com/duke-git/lancet@v1.3.5 // below go1.18, install latest version of v1.x.x

Usage

Lancet organizes the code into package structure, and you need to import the corresponding package name when use it. For example, if you use string-related functions,import the strutil package like below:

import "github.com/duke-git/lancet/v2/strutil"

Example

Here takes the string function Reverse (reverse order string) as an example, and the strutil package needs to be imported.

package main

import (
    "fmt"
    "github.com/duke-git/lancet/v2/strutil"
)

func main() {
    s := "hello"
    rs := strutil.Reverse(s)
    fmt.Println(rs) //olleh
}

Documentation

1. Algorithm package implements some basic algorithm. eg. sort, search.

import "github.com/duke-git/lancet/v2/algorithm"

Function list:

• BubbleSort : sorts slice with bubble sort algorithm, will change the original slice. [doc] [play]
• CountSort : sorts slice with bubble sort algorithm, don't change original slice. [doc] [play]
• HeapSort : sorts slice with heap sort algorithm, will change the original slice. [doc] [play]
• InsertionSort : sorts slice with insertion sort algorithm, will change the original slice. [doc] [play]
• MergeSort : sorts slice with merge sort algorithm, will change the original slice. [doc] [play]
• QuickSort : sorts slice with quick sort algorithm, will change the original slice. [doc] [play]
• SelectionSort : sorts slice with selection sort algorithm, will change the original slice. [doc] [play]
• ShellSort : sorts slice with shell sort algorithm, will change the original slice. [doc] [play]
• BinarySearch : returns the index of target within a sorted slice, use binary search (recursive call itself). [doc] [play]
• BinaryIterativeSearch : returns the index of target within a sorted slice, use binary search (no recursive). [doc] [play]
• LinearSearch : returns the index of target in slice base on equal function. [doc]
• LRUCache : implements memory cache with lru algorithm. [doc] [play]

2. Concurrency package contain some functions to support concurrent programming. eg, goroutine, channel, async.

import "github.com/duke-git/lancet/v2/concurrency"

Function list:

• NewChannel
• Bridge
• FanIn
• Generate
• Or
• OrDone
• Repeat
• RepeatFn
• Take
• Tee

3. Condition package contains some functions for conditional judgment. eg. And, Or, TernaryOperator...

import "github.com/duke-git/lancet/v2/condition"

Function list:

• Bool
• And
• Or
• Xor
• Nor
• Nand
• TernaryOperator

4. Convertor package contains some functions for data convertion.

import "github.com/duke-git/lancet/v2/convertor"

Function list:

• ColorHexToRGB
• ColorRGBToHex
• ToBool
• ToBytes
• ToChar
• ToChannel
• ToFloat
• ToInt
• ToJson
• ToMap
• ToPointer
• ToString
• StructToMap
• MapToSlice
• EncodeByte
• DecodeByte

5. Cryptor package is for data encryption and decryption.

import "github.com/duke-git/lancet/v2/cryptor"

Function list:

• AesEcbEncrypt
• AesEcbDecrypt
• AesCbcEncrypt
• AesCbcDecrypt
• AesCtrCrypt
• AesCfbEncrypt
• AesCfbDecrypt
• AesOfbEncrypt
• AesOfbDecrypt
• Base64StdEncode
• Base64StdDecode
• DesEcbEncrypt
• DesEcbDecrypt
• DesCbcEncrypt
• DesCbcDecrypt
• DesCtrCrypt
• DesCfbEncrypt
• DesCfbDecrypt
• DesOfbEncrypt
• DesOfbDecrypt
• HmacMd5
• HmacSha1
• HmacSha256
• HmacSha512
• Md5String
• Md5File
• Sha1
• Sha256
• Sha512
• GenerateRsaKey
• RsaEncrypt
• RsaDecrypt

6. Datetime package supports date and time format and compare.

import "github.com/duke-git/lancet/v2/datetime"

Function list:

• AddDay
• AddHour
• AddMinute
• BeginOfMinute
• BeginOfHour
• BeginOfDay
• BeginOfWeek
• BeginOfMonth
• BeginOfYear
• EndOfMinute
• EndOfHour
• EndOfDay
• EndOfWeek
• EndOfMonth
• EndOfYear
• GetNowDate
• GetNowTime
• GetNowDateTime
• GetZeroHourTimestamp
• GetNightTimestamp
• FormatTimeToStr
• FormatStrToTime
• NewUnix
• NewUnixNow
• NewFormat
• NewISO8601
• ToUnix
• ToFormat
• ToFormatForTpl
• ToIso8601

7. Datastructure package constains some common data structure. eg. list, linklist, stack, queue, set, tree, graph.

import list "github.com/duke-git/lancet/v2/datastructure/list"
import link "github.com/duke-git/lancet/v2/datastructure/link"
import stack "github.com/duke-git/lancet/v2/datastructure/stack"
import queue "github.com/duke-git/lancet/v2/datastructure/queue"
import set "github.com/duke-git/lancet/v2/datastructure/set"
import tree "github.com/duke-git/lancet/v2/datastructure/tree"
import heap "github.com/duke-git/lancet/v2/datastructure/heap"
import hashmap "github.com/duke-git/lancet/v2/datastructure/hashmap"

Function list:

• List
• Linklist
• Stack
• Queue
• Set
• Tree
• Heap
• HashMap

8. Fileutil package implements some basic functions for file operations.

import "github.com/duke-git/lancet/v2/fileutil"

Function list：

• ClearFile
• CreateFile
• CreateDir
• CopyFile
• FileMode
• MiMeType
• IsExist
• IsLink
• IsDir
• ListFileNames
• RemoveFile
• ReadFileToString
• ReadFileByLine
• Zip
• UnZip

9. Formatter contains some functions for data formatting.

import "github.com/duke-git/lancet/v2/formatter"

Function list:

• Comma

10. Function package can control the flow of function execution and support part of functional programming

import "github.com/duke-git/lancet/v2/function"

Function list:

• After
• Before
• Curry
• Compose
• Debounced
• Delay
• Pipeline
• Watcher

11. Maputil package includes some functions to manipulate map.

import "github.com/duke-git/lancet/v2/maputil"

Function list:

• ForEach
• Filter
• Intersect
• Keys
• Merge
• Minus
• Values
• IsDisjoint

12. Mathutil package implements some functions for math calculation.

import "github.com/duke-git/lancet/v2/mathutil"

Function list:

• Average
• Exponent
• Fibonacci
• Factorial
• Max
• MaxBy
• Min
• MinBy
• Percent
• RoundToFloat
• RoundToString
• TruncRound

13. Netutil package contains functions to get net information and send http request.

import "github.com/duke-git/lancet/v2/netutil"

Function list:

• ConvertMapToQueryString
• EncodeUrl
• GetInternalIp
• GetIps
• GetMacAddrs
• GetPublicIpInfo
• GetRequestPublicIp
• IsPublicIP
• IsInternalIP
• HttpRequest
• HttpClient
• SendRequest
• DecodeResponse
• StructToUrlValues
• HttpGet^deprecated
• HttpDelete^deprecated
• HttpPost^deprecated
• HttpPut^deprecated
• HttpPatch^deprecated
• ParseHttpResponse

14. Random package implements some basic functions to generate random int and string.

import "github.com/duke-git/lancet/v2/random"

Function list:

• RandBytes
• RandInt
• RandString
• RandUpper
• RandLower
• RandNumeral
• RandNumeralOrLetter
• UUIdV4

15. Retry package is for executing a function repeatedly until it was successful or canceled by the context.

import "github.com/duke-git/lancet/v2/retry"

Function list:

• Context
• Retry
• RetryFunc
• RetryDuration
• RetryTimes

16. Slice contains some functions to manipulate slice.

import "github.com/duke-git/lancet/v2/slice"

Function list:

• AppendIfAbsent
• Contain
• ContainSubSlice
• Chunk
• Compact
• Concat
• Count
• CountBy
• Difference
• DifferenceBy
• DifferenceWith
• DeleteAt
• Drop
• Equal
• EqualWith
• Every
• Filter
• Find
• FindLast
• Flatten
• FlattenDeep
• ForEach
• GroupBy
• GroupWith
• IntSlice^deprecated
• InterfaceSlice^deprecated
• Intersection
• InsertAt
• IndexOf
• LastIndexOf
• Map
• Merge
• Reverse
• Reduce
• Replace
• ReplaceAll
• Repeat
• Shuffle
• Sort
• SortBy
• SortByField^deprecated
• Some
• StringSlice^deprecated
• SymmetricDifference
• ToSlice
• ToSlicePointer
• Unique
• UniqueBy
• Union
• UnionBy
• UpdateAt
• Without
• KeyBy

17. Strutil package contains some functions to manipulate string.

import "github.com/duke-git/lancet/v2/strutil"

Function list:

• After : returns the substring after the first occurrence of a specified string in the source string. [doc] [play]
• AfterLast : returns the substring after the last occurrence of a specified string in the source string. [doc] [play]
• Before : returns the substring before the first occurrence of a specified string in the source string. [doc] [play]
• BeforeLast : returns the substring before the last occurrence of a specified string in the source string. [doc] [play]
• CamelCase : coverts source string to its camelCase string. [doc] [play]
• Capitalize : converts the first character of source string to upper case and the remaining to lower case. [doc] [play]
• IsString : checks if the parameter value data type is string or not. [doc] [play]
• KebabCase : coverts string to kebab-case string. [doc] [play]
• UpperKebabCase : coverts string to upper KEBAB-CASE string. [doc] [play]
• LowerFirst : converts the first character of string to lower case. [doc] [play]
• UpperFirst : converts the first character of string to upper case. [doc] [play]
• PadEnd : pads string with given characters on the right side if it's shorter than limit size. Padding characters are truncated if they exceed size. [doc] [play]
• PadStart : pads string with given characters on the left side if it's shorter than limit size. Padding characters are truncated if they exceed size. [doc] [play]
• Reverse : returns string whose char order is reversed to the given string. [doc] [play]
• SnakeCase : coverts string to snake_case string. [doc] [play]
• UpperSnakeCase : coverts string to upper SNAKE_CASE string. [doc] [play]
• SplitEx : split a given string which can control the result slice contains empty string or not. [doc] [play]
• Substring : returns a substring of the specified length starting at the specified offset position. [doc]
• Wrap : wrap a string with given string. [doc] [play]
• Unwrap : unwrap a given string from anther string. will change source string. [doc] [play]

19. System package contain some functions about os, runtime, shell command.

import "github.com/duke-git/lancet/v2/system"

Function list:

• IsWindows
• IsLinux
• IsMac
• GetOsEnv
• SetOsEnv
• RemoveOsEnv
• CompareOsEnv
• ExecCommand
• GetOsBits

19. Validator package contains some functions for data validation.

import "github.com/duke-git/lancet/v2/validator"

Function list:

• ContainChinese
• ContainLetter
• ContainLower
• ContainUpper
• IsAlpha
• IsAllUpper
• IsAllLower
• IsBase64
• IsChineseMobile
• IsChineseIdNum
• IsChinesePhone
• IsCreditCard
• IsDns
• IsEmail
• IsEmptyString
• IsFloatStr
• IsNumberStr
• IsJSON
• IsRegexMatch
• IsIntStr
• IsIp
• IsIpV4
• IsIpV6
• IsStrongPassword
• IsUrl
• IsWeakPassword
• IsZeroValue
• IsGBK

20. xerror package implements helpers for errors.

import "github.com/duke-git/lancet/v2/xerror"

Function list:

• Unwrap

How to Contribute

I really appreciate any code commits which make lancet lib powerful. Please follow the rules below to create your pull request.

1. Fork the repository.
2. Create your feature branch.
3. Commit your changes.
4. Push to the branch
5. Create new pull request.