Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/up-zero/gotool

gotool 轻量级的Golang工具库（无第三方库依赖）
https://github.com/up-zero/gotool

go golang

Last synced: 4 months ago
JSON representation

gotool 轻量级的Golang工具库（无第三方库依赖）

Awesome Lists containing this project

README 

          


    






   

      Gotool forks

   

   

      Gotool stars

   

   

      Gotool pull-requests

   




一个轻量级的Go语言工具库，提倡的核心理念为：基于Golang标准库、无第三方依赖。



## 安装



```shell

go get -u github.com/up-zero/gotool

```



## 快速开始



例如 `Md5()` 方法，使用方式如下所示，其它方法参考功能列表及其测试案例。



```go

package main



import "github.com/up-zero/gotool/cryptoutil"

import "log"



func main() {

	data, err := cryptoutil.Md5("123456") // e10adc3949ba59abbe56e057f20f883e

	if err != nil {

		log.Fatalln(err)

	}

	log.Println(data)

}

```



## 方法列表



### 文件（fileutil）



+ **FileCopy** 文件拷贝

+ **FileMove** 文件移动

+ **DirCopy** 绝对目录文件拷贝

+ **CurrentDirCount** 当前文件夹下(不迭代子文件夹)文件或文件夹的个数

+ **MkParentDir** 创建父级文件夹

+ **FileCount** 获取指定目录下的文件个数

+ **FileMainName** 获取指定路径的文件名

+ **FileSave** 保存文件

+ **FileSync** 文件同步

+ **FileRead** 读文件（结构体）

+ **FileReadLine** 按行流式读取文件

+ **Zip** 文件夹压缩

+ **ZipWithNotify** 带通知的文件夹压缩

+ **Unzip** 文件解压

+ **UnzipWithNotify** 带通知的文件解压

+ **FileSize** 获取文件大小

+ **Exist** 判断文件或目录是否存在

+ **IsDir** 判断是否是目录

+ **IsFile** 判断是否是文件



### 加解密（cryptoutil）



+ **Md5** 获取md5值

+ **Md5Iterations** 迭代多次求MD5

+ **Md5File** 获取文件的MD5

+ **HmacSHA256** 计算 SHA256

+ **HmacSHA384** 计算 HmacSHA384

+ **HmacSHA512** 计算 HmacSHA512

+ **Base64Encode** base64 编码

+ **Base64Decode** base64 解码

+ **JWTGenerate** 生成JWT

+ **JWTParse** 解析JWT

+ **Sha1** 获取SHA1值

+ **Sha256** 获取SHA256值

+ **Sha512** 获取SHA512值

+ **Sha1File** 获取文件SHA1值

+ **Sha256File** 获取文件SHA256值

+ **Sha512File** 获取文件SHA512值

+ **AesCbcEncrypt** AES CBC 加密

+ **AesCbcDecrypt** AES CBC 解密

+ **AesGcmEncrypt** AES GCM 加密

+ **AesGcmDecrypt** AES GCM 解密

+ **RsaEncrypt** RSA 公钥加密

+ **RsaDecrypt** RSA 私钥解密

+ **RsaGenerateKey** 生成RSA密钥对，返回PEM格式的私钥和公钥字符串

+ **RsaEncryptFile** 使用 RSA 公钥加密文件

+ **RsaDecryptFile** 使用 RSA 私钥解密文件

+ **GenSelfSignedCert** 生成自签名证书和私钥



### 类型转换（convertutil）



+ **StrToInt** 字符串转换为int

+ **StrToInt8** 字符串转换为int8

+ **StrToInt16** 字符串转换为int16

+ **StrToInt32** 字符串转换为int32

+ **StrToInt64** 字符串转换为int64

+ **StrToUint** 字符串转换为uint

+ **StrToUint8** 字符串转换为uint8

+ **StrToUint16** 字符串转换为uint16

+ **StrToUint32** 字符串转换为uint32

+ **StrToUint64** 字符串转换为uint64

+ **StrToFloat32** 字符串转换为float32

+ **StrToFloat64** 字符串转换为float64

+ **Int64ToStr** int64转换为字符串

+ **Uint64ToStr** uint64转换为字符串

+ **ToStr** 将任意类型的值转换为字符串

+ **Float64ToStr** float64转换为字符串

+ **Int64ToHex** int64转换为十六进制字符串

+ **HexToInt64** 十六进制字符串转换为int64

+ **CopyProperties** 复制结构体的属性

+ **DigitToChinese** 数字逐位转汉字

+ **IntegerToChinese** 整数转中文读法



### 随机数（randomutil）



+ **String** 随机字符串

+ **Digits** 随机数字

+ **Letters** 随机字母

+ **Alphanumeric** 随机字母数字

+ **IntRange** 指定范围内的随机数 [最小值, 最大值)

+ **Bool** 随机布尔值

+ **Choice** 从切片随机选一个元素



### 数学（mathutil）



+ **Abs** 绝对值

+ **Min** 最小值

+ **Max** 最大值

+ **Sum** 求和

+ **Average** 平均值

+ **ConvexHull** 计算凸包

+ **SimplifyPath** 简化路径

+ **OffsetPolygon** 多边形偏移 (内缩/外扩)

+ **TranslatePolygon** 多边形平移，按指定向量移动多边形

+ **PolygonArea** 计算多边形的面积

+ **GetAABB** 计算点集的轴对齐最小外接矩

+ **HammingDistance** 汉明距离



### 媒体（mediautil）



+ **ReadWavHeader** 从文件中读取 WAV 头部

+ **ParseWavHeader** 从字节切片中解析 WAV 头部

+ **WavHeader_GetDuration** 根据头部信息计算音频时长

+ **WriteWav** 将 PCM 数据封装为 WAV 格式写入 io.Writer

+ **SaveWav** 将 PCM 数据保存为本地 WAV 文件

+ **Float32ToPcmBytes** 将标准浮点音频数据转换为指定位深的 PCM 字节流

+ **Float32ToWavBytes** 将标准浮点音频数据转换为完整的 WAV 文件字节流

+ **TextToChinese** 中文文本口语化转换

+ **PcmBytesToFloat32** PCM 字节流转 float32 数组

+ **ReformatWavBytes** WAV 字节流格式转换

+ **PreEmphasis** 预加重滤波器

+ **HammingWindow** 汉明窗

+ **HannWindow** 汉宁窗

+ **FFT** 快速傅里叶变换

+ **MelFilters** 生成 Mel 滤波器组权重矩阵

+ **ApplyCMVN** 倒谱均值方差归一化



### 网络（netutil）



+ **SendMail** 发送邮件

+ **Ipv4sLocal** 获取本地ipv4地址

+ **ShouldBindJson** json入参绑定

+ **ShouldBindQuery** query入参绑定

+ **UrlBase** 获取URL路径的基础名称

+ **HttpGet** http get 请求

+ **HttpPost** http post 请求

+ **HttpPut** http put 请求

+ **HttpDelete** http delete 请求

+ **HttpGetWithTimeout** 带超时时间的 http get 请求

+ **HttpPostWithTimeout** 带超时时间的 http post 请求

+ **HttpPutWithTimeout** 带超时时间的 http put 请求

+ **HttpDeleteWithTimeout** 带超时时间的 http delete 请求

+ **ParseResponse** 解析响应结果

+ **FileDownload** 文件下载

+ **FileDownloadWithNotify** 带通知的文件下载

+ **FileDownloadWithProgress** 带进度的文件下载



### 系统（sysutil）



+ **ExecShell** 运行shell命令或脚本

+ **ExecCommand** 运行命令

+ **ExecShellWithNotify** 带通知的运行shell命令或脚本

+ **ExecCommandWithNotify** 带通知的运行命令

+ **ExecCommandWithOutput** 执行命令并返回合并后的标准输出和标准错误

+ **ExecCommandWithStream** 执行命令并对 stdout 和 stderr 的每一行实时调用回调函数

+ **PsByName** 根据程序名查询进程列表

+ **CPUTemperatures**  获取CPU温度

+ **SysUptime**  系统启动时间



### 日期&时间（timeutil）



+ **TransformLayout** 时间字符串格式转换

+ **FormatRFC3339** 将 RFC3339 格式转换为指定格式

+ **FormatRFC1123** 将 RFC1123 格式转换为指定格式



### 唯一ID（idutil）



+ **UUID** uuid

+ **UUIDGenerate** 生成UUID

+ **SignalSnowflake** 单节点的雪花码

+ **NewObjectID** 生成一个新的 ObjectID



### 切片（sliceutil）



+ **Unique** 切片去重，求并集

+ **Contains** 切片是否包含某个值

+ **Join** 切片拼接成字符串

+ **Concat** 切片拼接

+ **Intersect** 求多个切片的交集，元素存在时会先去重

+ **Filter** 切片过滤

+ **Map** 切片类型转换

+ **GroupBy** 将切片按指定的 Key 进行分组

+ **Chunk** 将切片按指定大小切分为多个小切片

+ **Difference** 求差集 (s1 - s2)，返回在 s1 中但不在 s2 中的元素

+ **Shuffle** 切片洗牌



### 图片（imageutil）



+ **Open** 打开图片

+ **Save** 保存图片

+ **Compression** 图片压缩

+ **Size** 图片尺寸

+ **GenerateCaptcha** 验证码图片生成

+ **Crop** 图片裁剪

+ **CropFile** 图片文件裁剪

+ **Resize** 图片缩放

+ **ResizeFile** 图片文件缩放

+ **Rotate** 旋转图片

+ **RotateFile** 旋转图片文件

+ **Flip** 翻转图片

+ **FlipFile** 翻转图片文件

+ **Overlay** 图片叠加

+ **OverlayFile** 图片文件叠加

+ **Grayscale** 图片灰度化

+ **GrayscaleFile** 图片文件灰度化

+ **GaussianBlur** 图片高斯模糊

+ **GaussianBlurFile** 图片文件高斯模糊

+ **AdjustBrightness** 图片亮度调整

+ **AdjustBrightnessFile** 图片文件亮度调整

+ **Invert** 图片反转颜色

+ **InvertFile** 图片文件反转颜色

+ **Binarize** 图片二值化

+ **BinarizeFile** 图片文件二值化

+ **OtsuThreshold** 基于大津法计算推荐阈值

+ **MedianBlur** 图片中值滤波

+ **MedianBlurFile** 图片文件中值滤波

+ **Sobel** 索贝尔边缘检测

+ **SobelFile** 图片文件索贝尔边缘检测

+ **NewRectKernel** 创建矩形核

+ **NewCrossKernel** 创建十字形核

+ **Erode** 图片腐蚀

+ **ErodeFile** 图片文件腐蚀

+ **Dilate** 图片膨胀

+ **DilateFile** 图片文件膨胀

+ **MorphologyOpen** 开运算

+ **MorphologyOpenFile** 对图片文件进行开运算

+ **MorphologyClose** 闭运算

+ **MorphologyCloseFile** 对图片文件进行闭运算

+ **EqualizeHist** 直方图均衡化

+ **EqualizeHistFile** 图片文件直方图均衡化

+ **DrawFilledCircle** 绘制填充的圆形

+ **DrawThickLine** 绘制粗线

+ **DrawLine** 绘制直线

+ **DrawRectOutline** 绘制矩形边框

+ **DrawFilledRect** 矩形填充

+ **DrawThickRectOutline** 绘制粗矩形边框

+ **DrawPolygonOutline** 绘制多边形边框

+ **DrawThickPolygonOutline** 绘制粗多边形边框

+ **DrawFilledPolygon** 多边形填充

+ **ConvexHull** 计算凸包

+ **SimplifyPath** 简化路径

+ **OffsetPolygon** 多边形偏移 (内缩/外扩)

+ **GenerateSolid** 生成指定宽高的纯色背景图片

+ **FindBlobs** 查找 Mask 图片的连通区域

+ **AHash** 平均哈希

+ **DHash** 差异哈希

+ **PHash** 感知哈希

+ **ToWritable** 将 image.Image 转换为可写的 draw.Image



### 条件判断（conditionutil）



+ **If** 三元运算符

+ **IfLazy** 延迟执行的三元运算

+ **IsZero** 判断一个值是否为零值



### 流（streamutil）



+ **NewStream** 初始化 Stream

+ **Stream_Filter** 数据过滤

+ **Stream_Map** 数据处理

+ **Stream_Extreme** 返回流中的极值

+ **Stream_Max** 数据最大值

+ **Stream_Min** 数据最小值

+ **Stream_ToSlice** 转换为切片

+ **StreamMap** 数据处理与转换



### 结构体（structutil）



+ **SetDefaults** 设置结构体默认值

+ **NewWithDefaults** 初始化带有默认值的结构体

+ **ToMap** 将结构体转换为 map[string]any



### 字符串（stringutil）



+ **Reverse** 字符串反转

+ **TakeFirst** 截取字符串前 n 个 Unicode 字符（rune）

+ **ContainsAny** 判断字符串 s 是否包含 substrs 中的任意一个子串

+ **ContainsAll** 判断字符串 s 是否包含 substrs 中的所有子串

+ **CamelToSnake** 将驼峰式字符串转换为下划线连接

+ **SnakeToCamel** 将下划线连接的字符串转换为小驼峰式

+ **SnakeToPascal** 将下划线连接的字符串转换为大驼峰式（PascalCase）

+ **TrimFirstPrefix** 移除字符串中首个匹配的前缀

+ **TrimFirstSuffix** 移除字符串中首个匹配的后缀

+ **Ellipsis** 截取字符串，并在末尾添加省略号



### 验证器（validator）



+ **IsDigit** 判断字符串是否为数字

+ **IsAlpha** 验证字符串是否为 Unicode 字符

+ **IsAlphaStrict** 验证字符串是否为英文字符 a-z A-Z

+ **IsAlphaNumeric** 验证字符串是否为 Unicode 字符或数字

+ **IsIp** 检查字符串是否为有效的 IPv4 或 IPv6 地址

+ **IsIpv4** 验证字符串是否为 IPv4 地址

+ **IsIpv6** 验证字符串是否为 IPv6 地址

+ **IsEmail** 判断字符串是否为有效的电子邮件地址

+ **IsURL** 验证字符串是否为有效的 URL

+ **ContainChinese** 判断字符串是否包含中文字符



### 测试（testutil）



+ **Equal** 断言两个值相等

+ **EqualFloat** 断言两个值（浮点数或浮点数切片）在误差范围内相等

+ **NotEqual** 断言两个值不相等



### MAP工具（maputil）



+ **NewConcurrentMap** 初始化并发 Map

+ **ConcurrentMap_Set** 设置键值对（写操作）

+ **ConcurrentMap_Get** 获取值（读操作）

+ **ConcurrentMap_GetOrSet** 获取一个键的值（读操作），如果键不存在，则设置并返回新值（写操作）

+ **ConcurrentMap_Delete** 删除键（写操作）

+ **ConcurrentMap_GetAndDelete** 获取键的值并删除（写操作）

+ **ConcurrentMap_Len** 获取 Map 中元素的数量（读操作）

+ **ConcurrentMap_Clear** 清空 Map 中的所有元素（写操作）

+ **ConcurrentMap_Range** 遍历 Map（读操作）