tool

package

v1.0.11 Latest Latest Go to latest Published: Jun 28, 2026 License: MIT Imports: 38 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/npanel-dev/NPanel-backend

Links

Open Source Insights

Documentation ¶

Index ¶

func AddTime(unit string, quantity int64, baseTime ...time.Time) time.Time
func CalculateNextResetTime(expireTime int64, resetCycle int32) int64
func CloneMapToStruct(input any, output interface{}) error
func Contains[T comparable](slice []T, target T) bool
func ConvertValueToString(value reflect.Value) string
func Curve25519Genkey(StdEncoding bool, inputBase64 string) (public, private string, err error)
func DayDiff(startTime, endTime time.Time) int64
func DaysToMonthDay(t time.Time, targetDay int) int64
func DaysToNextMonth(t time.Time) int64
func DaysToYearDay(t time.Time, month int, day int) int64
func DeepCopy[T, K any](destStruct T, srcStruct K, opts ...CopyOption) T
func EncodeBase36(id int64) string
func EncodePassWord(str string) string
func ExtractVersionNumber(versionStr string) int
func FixedUniqueString(s string, length int, alphabet string) (string, error)
func FormatFloat(num float64, decimal int) string
func FormatStringToFloat(str string) float64
func GenerateCipher(serverKey string, length int) string
func GenerateETag(data []byte) string
func GenerateInviteCode(userID int64) string
func GenerateJWT(secret string, expireSeconds int64, claims map[string]interface{}) (string, error)
func GenerateRandomString(length int) string
func GenerateReferCode(userID int64) string
func GenerateShortID(privateKey string) string
func GenerateSubscribeToken(orderNo string) string
func GenerateTradeNo() string
func GenerateTurnstileIdempotencyKey() string
func GenerateUUID() string
func GetLastDayOfMonth(t time.Time) int64
func GetYearDays(t time.Time, month int, day int) int64
func HourDiff(startTime, endTime time.Time) int64
func Int64SliceToString(intSlice []int64) string
func Int64SliceToStringSlice(slice []int64) []string
func Int64ToStringSlice(intSlice []int64) []string
func IsValidImageSize(base64Str string, maxSizeKB int64) bool
func JSONToStruct(jsonStr string, v interface{}) error
func KeyNew(length int, keyType int) string
func MaskEmail(email string) string
func Md5Encode(str string, isUpper bool) string
func MicrosecondsStr(elapsed time.Duration) string
func MonthDiff(startTime, endTime time.Time) int
func MultiPasswordVerify(algo, salt, passwordText, hash string) bool
func ParseJWT(tokenString string, secret string) (map[string]interface{}, error)
func ParseRedisURI(uri string) (addr, password string, database int, err error)
func RedisPing(addr, password string, database int) error
func RemoveDuplicateElements[T comparable](input ...T) []T
func RemoveElementBySlice[T comparable](slice []T, element T) []T
func RemoveStringElement(arr []string, element ...string) []string
func RenderTemplateToString(tmpl string, data interface{}) (string, error)
func ShallowCopy[T, K interface{}](destStruct T, srcStruct K, opts ...CopyOption) T
func SliceDifferenceInt64(slice1, slice2 []int64) []int64
func SliceIntersectInt64(slice1, slice2 []int64) []int64
func SliceIsExistInt64(slice []int64, value int64) bool
func StrToDashedString(strNum string) string
func StringMergeAndRemoveDuplicates(strs ...string) []string
func StringSliceContains(slice []string, str string) bool
func StringSliceToInt64Slice(slice []string) []int64
func StringSliceToString(stringSlice []string) string
func StringToInt64Slice(s string) []int64
func StringToStringSlice(str string) []string
func StructToJSON(v interface{}) (string, error)
func SystemConfigSliceReflectToStruct(slice []*SystemConfig, structType any)
func Tern[T any](cond bool, a, b T) T
func VerifyPassWord(passwd, EncodePasswd string) bool
func VerifyTurnstile(ctx context.Context, secret, token, ip string) (bool, error)
func VerifyTurnstileWithKey(ctx context.Context, secret, token, ip, idempotencyKey string) (bool, error)
func YearDiff(startTime, endTime time.Time) int
type CopyOption
- func CopyWithIgnoreEmpty(ignoreEmpty bool) CopyOption
type SystemConfig

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func AddTime ¶

func AddTime(unit string, quantity int64, baseTime ...time.Time) time.Time

func CalculateNextResetTime ¶

func CalculateNextResetTime(expireTime int64, resetCycle int32) int64

CalculateNextResetTime 计算下次重置时间与原项目 logic 完全一致

func CloneMapToStruct ¶

func CloneMapToStruct(input any, output interface{}) error

func Contains ¶

func Contains[T comparable](slice []T, target T) bool

func ConvertValueToString ¶

func ConvertValueToString(value reflect.Value) string

ConvertValueToString converts the value to string

func Curve25519Genkey ¶

func Curve25519Genkey(StdEncoding bool, inputBase64 string) (public, private string, err error)

func DayDiff ¶

func DayDiff(startTime, endTime time.Time) int64

func DaysToMonthDay ¶

func DaysToMonthDay(t time.Time, targetDay int) int64

func DaysToNextMonth ¶

func DaysToNextMonth(t time.Time) int64

func DaysToYearDay ¶

func DaysToYearDay(t time.Time, month int, day int) int64

func DeepCopy ¶

func DeepCopy[T, K any](destStruct T, srcStruct K, opts ...CopyOption) T

func EncodeBase36 ¶

func EncodeBase36(id int64) string

EncodeBase36 encodes an int64 to base36 string

func EncodePassWord ¶

func EncodePassWord(str string) string

func ExtractVersionNumber ¶

func ExtractVersionNumber(versionStr string) int

func FixedUniqueString ¶

func FixedUniqueString(s string, length int, alphabet string) (string, error)

FixedUniqueString deterministically derives a short unique string from the input.

func FormatFloat ¶

func FormatFloat(num float64, decimal int) string

func FormatStringToFloat ¶

func FormatStringToFloat(str string) float64

func GenerateCipher ¶

func GenerateCipher(serverKey string, length int) string

GenerateCipher 根据公钥生成固定长度密文

func GenerateETag ¶

func GenerateETag(data []byte) string

func GenerateInviteCode ¶

func GenerateInviteCode(userID int64) string

GenerateInviteCode generates an invite code from user ID

func GenerateJWT ¶

func GenerateJWT(secret string, expireSeconds int64, claims map[string]interface{}) (string, error)

GenerateJWT generates a JWT token

func GenerateRandomString ¶

func GenerateRandomString(length int) string

GenerateRandomString generates a random string with given length

func GenerateReferCode ¶

func GenerateReferCode(userID int64) string

GenerateReferCode generates a refer code from user ID (alias for GenerateInviteCode)

func GenerateShortID ¶

func GenerateShortID(privateKey string) string

func GenerateSubscribeToken ¶

func GenerateSubscribeToken(orderNo string) string

GenerateSubscribeToken generates a subscription token from order number

func GenerateTradeNo ¶

func GenerateTradeNo() string

func GenerateTurnstileIdempotencyKey ¶

func GenerateTurnstileIdempotencyKey() string

func GenerateUUID ¶

func GenerateUUID() string

GenerateUUID generates a UUID v4 string

func GetLastDayOfMonth ¶

func GetLastDayOfMonth(t time.Time) int64

GetLastDayOfMonth 获取指定时间所在月份的最后一天

func GetYearDays ¶

func GetYearDays(t time.Time, month int, day int) int64

func HourDiff ¶

func HourDiff(startTime, endTime time.Time) int64

HourDiff 计算两个时间点之间的小时差

func Int64SliceToString ¶

func Int64SliceToString(intSlice []int64) string

func Int64SliceToStringSlice ¶

func Int64SliceToStringSlice(slice []int64) []string

func Int64ToStringSlice ¶

func Int64ToStringSlice(intSlice []int64) []string

func IsValidImageSize ¶

func IsValidImageSize(base64Str string, maxSizeKB int64) bool

IsValidImageSize 检查base64图片是否有效且未超出大小限制 base64Str: base64编码的图片字符串 maxSizeKB: 最大允许大小（KB），int64类型返回: bool - true表示图片有效且未超限，false表示无效或超限

func JSONToStruct ¶

func JSONToStruct(jsonStr string, v interface{}) error

JSONToStruct converts JSON string to struct

func KeyNew ¶

func KeyNew(length int, keyType int) string

KeyNew generates a random key

func MaskEmail ¶

func MaskEmail(email string) string

func Md5Encode ¶

func Md5Encode(str string, isUpper bool) string

func MicrosecondsStr ¶

func MicrosecondsStr(elapsed time.Duration) string

func MonthDiff ¶

func MonthDiff(startTime, endTime time.Time) int

func MultiPasswordVerify ¶

func MultiPasswordVerify(algo, salt, passwordText, hash string) bool

func ParseJWT ¶

func ParseJWT(tokenString string, secret string) (map[string]interface{}, error)

ParseJWT parses a JWT token with the given secret

func ParseRedisURI ¶

func ParseRedisURI(uri string) (addr, password string, database int, err error)

func RedisPing ¶

func RedisPing(addr, password string, database int) error

func RemoveDuplicateElements ¶

func RemoveDuplicateElements[T comparable](input ...T) []T

func RemoveElementBySlice ¶

func RemoveElementBySlice[T comparable](slice []T, element T) []T

func RemoveStringElement ¶

func RemoveStringElement(arr []string, element ...string) []string

RemoveStringElement 移除指定元素

func RenderTemplateToString ¶

func RenderTemplateToString(tmpl string, data interface{}) (string, error)

func ShallowCopy ¶

func ShallowCopy[T, K interface{}](destStruct T, srcStruct K, opts ...CopyOption) T

func SliceDifferenceInt64 ¶

func SliceDifferenceInt64(slice1, slice2 []int64) []int64

SliceDifferenceInt64 returns the difference of two slices

func SliceIntersectInt64 ¶

func SliceIntersectInt64(slice1, slice2 []int64) []int64

func SliceIsExistInt64 ¶

func SliceIsExistInt64(slice []int64, value int64) bool

SliceIsExistInt64 checks if a value exists in a slice

func StrToDashedString ¶

func StrToDashedString(strNum string) string

StrToDashedString converts a string number to dashed format

func StringMergeAndRemoveDuplicates ¶

func StringMergeAndRemoveDuplicates(strs ...string) []string

StringMergeAndRemoveDuplicates Tool function to convert multiple comma separated strings into [] strings and deduplicate them

func StringSliceContains ¶

func StringSliceContains(slice []string, str string) bool

func StringSliceToInt64Slice ¶

func StringSliceToInt64Slice(slice []string) []int64

func StringSliceToString ¶

func StringSliceToString(stringSlice []string) string

string slice to string

func StringToInt64Slice ¶

func StringToInt64Slice(s string) []int64

func StringToStringSlice ¶

func StringToStringSlice(str string) []string

StringToStringSlice splits a comma-separated string to slice

func StructToJSON ¶

func StructToJSON(v interface{}) (string, error)

StructToJSON converts a struct to JSON string

func SystemConfigSliceReflectToStruct ¶

func SystemConfigSliceReflectToStruct(slice []*SystemConfig, structType any)

func Tern ¶

func Tern[T any](cond bool, a, b T) T

Tern 三目运算

func VerifyPassWord ¶

func VerifyPassWord(passwd, EncodePasswd string) bool

func VerifyTurnstile ¶

func VerifyTurnstile(ctx context.Context, secret, token, ip string) (bool, error)

func VerifyTurnstileWithKey ¶

func VerifyTurnstileWithKey(ctx context.Context, secret, token, ip, idempotencyKey string) (bool, error)

func YearDiff ¶

func YearDiff(startTime, endTime time.Time) int

Types ¶

type CopyOption ¶

type CopyOption func(*copier.Option)

CopyOption 定义复制选项的函数类型

func CopyWithIgnoreEmpty ¶

func CopyWithIgnoreEmpty(ignoreEmpty bool) CopyOption

CopyWithIgnoreEmpty 设置是否忽略空值

type SystemConfig ¶

type SystemConfig struct {
	ID        int64     `json:"id"`
	Category  string    `json:"category"`
	Key       string    `json:"key"`
	Value     string    `json:"value"`
	Type      string    `json:"type"`
	Desc      string    `json:"desc"`
	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
}

SystemConfig represents a system configuration entry This type is used for system configuration management

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