pkg

README

pkg

• golang pkg, common utils
• 集成各种常用 lib, 开箱即用

related:

• https://github.com/better-go/cookiecutter-go
  • go 微服务: 项目创建脚手架.

quickstart:

• install:

# use latest version:
go get -u -v github.com/better-go/pkg

# use specific tag:
go get -u -v github.com/better-go/pkg@v0.1.10

• usage:

import (
	"github.com/better-go/pkg/random"
)

func Example() {
	// snowflake id:
	userID := random.SnowFlakeID()
	fmt.Printf("userID:%v\n", userID)
}

features:

• log: log/log.go 集成 uber.log, 开箱即用.
• sync/async: go func() 优雅异步.
• retry: 通用重试wrap: 支持 backoff
• orm 集成: gorm 扩展
  • mysql 支持
  • 集成 gorm v1, v2 版本
• cache: 集成 redis
• mq:
  • kafka: 集成 kafka
  • rabbitmq: 集成 rabbitmq, 有详细使用示例代码
    • 生产者: mq/rabbitmq/producer.go
    • 消费者: mq/rabbitmq/consumer.go
• net:
  • http: 集成 gin + auth API 路由鉴权
  • websocket: 集成 websocket, 双向通信, 有详细使用示例代码
    • server: net/ws/websocket_server.go
      • usage: net/ws/example/ws_server.go
  • socketIO: 类似 websocket, 双向通信, 有详细使用示例代码
    • server:
      • usage: net/ws/example/socket_io/socket_io_server.go
  • graphql: 集成
    • client: net/graphql/graphql_client.go
    • server: net/graphql/graphql_server.go
• config:
  • toml 格式配置文件读取
• random:
  • uuid: ID 生成器
  • snowflake: twitter 雪花算法: 18位纯数字(有序+递增+唯一)
• text:
  • xss: 预防 xss 校验
• time: 大量时间方法扩展
  • 生成时间戳
• crypto: 密码加密/验证
  • sign: 签名机制: 生成签名/验证签名
• com: 第三方企业 API SDK 接入
  • jpush: 极光推送
  • sendcloud: 搜狐短信服务
• cronjob: 集成 cron job 库, 开箱即用,
  • 使用示例: cronjob/example/example.go
• x: 扩展一些框架
  • gin: 扩展代码
    • 路由 wrap: x/gin/router.go 自动处理 request args binding 和 response
  • go-micro:
  • go-zero:
    • 微服务启动器: x/go-zero/cmd/cmd.go

wiki:

• https://github.com/better-go/pkg/wiki
• go 编程规范

reference:

• uber.log
• 目录结构参考: https://github.com/micro/go-plugins
• 目录风格, 参考 go 标准库, 以及 x 库
  • https://pkg.go.dev/search?q=golang.org/x
• https://github.com/golang/text

go get golang.org/x/text
go get golang.org/x/oauth2
go get golang.org/x/net
go get golang.org/x/crypto

research:

• https://go.libhunt.com/
  • go pkg diff