goutils

README

goutils

Common utilities for golang

Documentation

Index

• Constants
• func Between(s, from, to string) string
• func Contains(obj interface{}, v ...interface{}) bool
• func DeepContains(obj interface{}, v ...interface{}) bool
• func Download(url string, dest string) (err error)
• func FileSize(s uint64) string
• func FilterBlankString(vs []string) []string
• func FilterEmptyString(vs []string) []string
• func FilterInt(vs []int, f func(int) bool) []int
• func FilterString(vs []string, f func(string) bool) []string
• func HumanReadableDuration(diffSeconds int64) string
• func Index(s, substr string) int
• func IsBlank(s string) bool
• func IsDir(path string) bool
• func IsEmpty(s string) bool
• func IsExist(path string) bool
• func IsFile(path string) bool
• func IsIPv4(s string) bool
• func IsNotBlank(s string) bool
• func IsNotEmpty(s string) bool
• func LeftPad(s string, padStr string, length int) string
• func Len(s string) int
• func Map(vs []string, f func(string) string) []string
• func RightPad(s string, padStr string, length int) string
• func ToBool(s string) bool
• func ToBoolDv(s string, dv bool) bool
• func ToInt(s string) int
• func ToIntDv(s string, dv int) int
• func Trim(str string) string
• func TrimLeft(str string) string
• func TrimRight(str string) string
• func UUID() string
• func WildcardMatch(pattern, name string) (matched bool)
• func WildcardMatchSimple(pattern, name string) bool
• func ZeroFill(s string, length int) string
• type SysStatus
  • func GetSysStatus() *SysStatus

Constants

const EmptyStr = ""

EmptyStr is the empty string const

const RegIPv4 = "(([2][5][0-5]|[2][0-4][0-9]|[1][0-9]{2}|[1-9][0-9]|[0-9])[.]){3}([2][5][0-5]|[2][0-4][0-9]|[1][0-9]{2}|[1-9][0-9]|[0-9])"

RegIPv4 is the IPv4 Regexp

Functions

func Between

func Between(s, from, to string) string

Between return the middle part of a string from string "from" to string "to"

func Contains

func Contains(obj interface{}, v ...interface{}) bool

Contains tells an object is in a list or not

func DeepContains

func DeepContains(obj interface{}, v ...interface{}) bool

DeepContains tells an object is in a list or not, but uses reflect.DeepEqual to determine the equality

func Download

func Download(url string, dest string) (err error)

Download is used to conveniently download a file to the certain path

func FileSize

func FileSize(s uint64) string

FileSize translate bytes number into human-readable size

func FilterBlankString

func FilterBlankString(vs []string) []string

FilterBlankString removes blank strings in a string slice

func FilterEmptyString

func FilterEmptyString(vs []string) []string

FilterEmptyString removes empty strings in a string slice

func FilterInt

func FilterInt(vs []int, f func(int) bool) []int

FilterInt filters an int slice with the function returns false

func FilterString

func FilterString(vs []string, f func(string) bool) []string

FilterString filters a string slice with the function returns false

func HumanReadableDuration

func HumanReadableDuration(diffSeconds int64) string

HumanReadableDuration translates seconds into human-readable text

func Index

func Index(s, substr string) int

Index return the location of a string in another long string, if it doesn't exist, returns -1 this function supports CJK characters

func IsBlank

func IsBlank(s string) bool

IsBlank tells a string is blank or not, a string with all white blanks would be considered as true

func IsDir

func IsDir(path string) bool

IsDir tells a path is a directory or not

func IsEmpty

func IsEmpty(s string) bool

IsEmpty tells a string is empty or not

func IsExist

func IsExist(path string) bool

IsExist is used to determine whether a path exists or not

func IsFile

func IsFile(path string) bool

IsFile tells a path is a file or not

func IsIPv4

func IsIPv4(s string) bool

IsIPv4 tells a string matches IPv4 form or not

func IsNotBlank

func IsNotBlank(s string) bool

IsNotBlank tells a string is not blank or is

func IsNotEmpty

func IsNotEmpty(s string) bool

IsNotEmpty tells a string is not empty or is

func LeftPad

func LeftPad(s string, padStr string, length int) string

LeftPad pad a string with specified character to the left side

func Len

func Len(s string) int

Len returns the length of a string using rune, it's useful when getting the length of a string including CJK characters

func Map

func Map(vs []string, f func(string) string) []string

Map maps a string slice with a function

func RightPad

func RightPad(s string, padStr string, length int) string

RightPad pad a string with specified character to the right side

func ToBool

func ToBool(s string) bool

ToBool returns the boolean value represented by the string, default: false

func ToBoolDv

func ToBoolDv(s string, dv bool) bool

ToBoolDv returns the boolean value represented by the string with a default bool value

func ToInt

func ToInt(s string) int

ToInt safely parse a string to a integer with a default value 0 when parse fails

func ToIntDv

func ToIntDv(s string, dv int) int

ToIntDv safely parse a string to a integer with a specified default value

func Trim

func Trim(str string) string

Trim cuts the blanks of a string, the beginning and the end

func TrimLeft

func TrimLeft(str string) string

TrimLeft cuts the left side blanks of a string

func TrimRight

func TrimRight(str string) string

TrimRight cuts the right side blanks of a string

func UUID

func UUID() string

UUID returns a random generated UUID string

func WildcardMatch

func WildcardMatch(pattern, name string) (matched bool)

WildcardMatch - finds whether the text matches/satisfies the pattern string. supports '*' and '?' wildcards in the pattern string. unlike path.Match(), considers a path as a flat name space while matching the pattern. The difference is illustrated in the example here https://play.golang.org/p/Ega9qgD4Qz .

func WildcardMatchSimple

func WildcardMatchSimple(pattern, name string) bool

WildcardMatchSimple - finds whether the text matches/satisfies the pattern string. supports only '*' wildcard in the pattern. considers a file system path as a flat name space.

func ZeroFill

func ZeroFill(s string, length int) string

ZeroFill pad a string(usually a number string) with "0" to the left

Types

type SysStatus

type SysStatus struct {
	Uptime       string
	NumGoroutine int

	// General statistics.
	MemAllocated string // bytes allocated and still in use
	MemTotal     string // bytes allocated (even if freed)
	MemSys       string // bytes obtained from system (sum of XxxSys below)
	Lookups      uint64 // number of pointer lookups
	MemMallocs   uint64 // number of mallocs
	MemFrees     uint64 // number of frees

	// Main allocation heap statistics.
	HeapAlloc    string // bytes allocated and still in use
	HeapSys      string // bytes obtained from system
	HeapIdle     string // bytes in idle spans
	HeapInuse    string // bytes in non-idle span
	HeapReleased string // bytes released to the OS
	HeapObjects  uint64 // total number of allocated objects

	// Low-level fixed-size structure allocator statistics.
	//	Inuse is bytes used now.
	//	Sys is bytes obtained from system.
	StackInuse  string // bootstrap stacks
	StackSys    string
	MSpanInuse  string // mspan structures
	MSpanSys    string
	MCacheInuse string // mcache structures
	MCacheSys   string
	BuckHashSys string // profiling bucket hash table
	GCSys       string // GC metadata
	OtherSys    string // other system allocations

	// Garbage collector statistics.
	NextGC       string // next run in HeapAlloc time (bytes)
	LastGC       string // last run in absolute time (ns)
	PauseTotalNs string
	PauseNs      string // circular buffer of recent GC pause times, most recent at [(NumGC+255)%256]
	NumGC        uint32
}

SysStatus describes system runtime environment

func GetSysStatus

func GetSysStatus() *SysStatus

GetSysStatus returns runtime information