go-gin-skeleton

使用golang gin框架的应用骨架

包含应用

• api API接口应用
• cli CLI命令行应用
• web web应用

使用的包

• gin框架: gin-gonic/gin
• ini配置：gookit/ini
• 日志记录：go.uber.org/zap
• 日志记录：sirupsen/logrus
  • https://github.com/rifflock/lfshook
• mysql等：go-xorm/xorm
• mongodb: github.com/globalsign/mgo
• cache, redis: garyburd/redigo
• language: gookit/i18n
• 表单数据验证: go-playground/validator
• 高性能的json序列化库: json-iterator/go
• eureka client: PDOK/go-eureka-client 未使用

辅助库

• dep 使用dep来安装管理依赖库
• swagger 文档生成：可以使用go-swagger 或者 swaggo/swag
• stretchr/testify 测试辅助库，方便快速断言 stretchr/testify
  • 常用的是它的断言包 github.com/stretchr/testify/assert

额外组件

• swagger UI: swagger文档渲染
• Dockerfile: 可用于生产环境的docker镜像构建脚本，基于alpine，构建完成一个项目镜像估计大小为：30 M 左右
• makefile: 已经内置一些快速使用的make命令，帮助快速生成文档，构建镜像

开始使用

• 首先，将骨架clone到 GOPATH 的 src下，重命名 go-gin-skeleton 目录为你的项目名
• 进入到项目，将项目中 github.com/inhere/go-gin-skeleton 替换为你的项目名(针对go文件)
• 再搜索将所有的go-gin-skeleton替换为你的项目名（主要是Dockerfile,makefile里）
• 运行 dep ensure 安装依赖库到vendor
• 运行项目：go run main.go

使用帮助

• 运行测试

go test
// 输出覆盖率
go test -cover

• 格式化项目

go fmt ./...

• 运行GoLint检查

需先安装 GoLint

golint ./...

License

MIT