一套 Go 工具包。

https://gkit.dianjiu.org.cn/

🌎 English Documentation

📚 简介

GoKit是一个小而全的Go工具类库，通过静态方法封装，降低相关API的学习成本，提高工作效率，使Go拥有Java语言Hutool般地体验。

GoKit中的工具方法来自每个用户的精雕细琢，它涵盖了Go开发底层代码中的方方面面，它既是大型项目开发中解决小问题的利器，也是小型项目中的效率担当；

GoKit是项目中“util”包友好的替代，它节省了开发人员对项目中公用类和公用工具方法的封装时间，使开发专注于业务，同时可以最大限度的避免封装不完善带来的bug。

🎁 GoKit名称的由来

GoKit = Go + Kit，是由点九开源团队创建的Go语言工具集，“Go”是golang的表示，Kit表示工具包。

🍺 GoKit改变coding方式

GoKit的目标是使用一个工具方法代替一段复杂代码，从而最大限度的避免“复制粘贴”代码的问题，彻底改变我们写代码的方式。

以计算MD5为例：

• 【以前】打开搜索引擎 -> 搜“Go MD5加密” -> 打开某篇博客-> 复制粘贴 -> 改改使用
• 【现在】引入GoKit -> md5:=security.MD5("Hello World")

GoKit的存在就是为了减少代码搜索成本，避免网络上参差不齐的代码出现导致的bug。

📦 使用

在Go项目的dependencies中加入以下内容:

go get github.com/dianjiu/gokit

以引入ip包下组件为例，调用GetLocalIPv4()方方法获取本地IP作为演示

package main

import (
	"github.com/dianjiu/gokit/ip"
	"log"
)

func main() {
	ip := ip.GetLocalIPv4()
	log.Printf("本机IP: %v\n", ip)
}

运行结果

2021/07/30 15:49:03 本机IP: 192.168.56.1

🛠️ 组件

一个Go基础工具类，对文件、流、加密解密、转码、正则、JSON、UUID等方法进行封装，组成各种Go工具类，同时提供以下组件：

可以根据需求对每个模块单独引入使用，如下：

import (
	"github.com/dianjiu/gokit/hello"
)

也可以通过引入GoKit所有模块使用，如下：

import (
	"github.com/dianjiu/gokit"
)

📝文档

📘 快速上手

📙 更新日志

🏗️ 贡献

🎋 分支说明

GoKit的源码分为两个分支，功能如下：

🐞 提供bug反馈或建议

提交问题反馈请说明正在使用的Go版本、GoKit版本和相关依赖库版本。

• Gitee issue
• Github issue
• Gitlab issue

🧬 贡献代码的步骤

邮件联系 dianjiu@dianjiu.cc 获取开发者账号

📐 PR遵照的原则

GoKit欢迎任何人为GoKit贡献代码，需要提交的pr（pull request）符合一些规范，规范如下：

1. 注释完备，尤其每个新增的方法应按照Go文档规范标明方法说明、参数说明、返回值说明等信息，如果愿意，也可以加上你的大名。
2. GoKit项目建议Go程序员使用vscode开发，请pull request到dev分支。
3. 新加的方法不要使用第三方库的方法，GoKit遵循无依赖原则（除非在extra模块中加方法工具）。
4. GoKit在1.x版本后将使用新的分支：master是主分支，表示已经发布中央库的版本，这个分支不允许pr，也不允许修改。

⭐ Star GoKit

📌 交流

🧡 公众号

🧡 交流群