# [yiigo](https://github.com/iiinsomnia/yiigo)
A simple and light library which makes Golang development easier !
## Features
- Support [MySQL](https://github.com/go-sql-driver/mysql)
- Support [PostgreSQL](https://github.com/lib/pq)
- Support [MongoDB](https://github.com/mongodb/mongo-go-driver)
- Support [Redis](https://github.com/gomodule/redigo)
- Support [Zipkin](https://github.com/openzipkin/zipkin-go)
- Use [gomail](https://github.com/go-gomail/gomail) for email sending
- Use [toml](https://github.com/pelletier/go-toml) for configuration
- Use [sqlx](https://github.com/jmoiron/sqlx) for SQL executing
- Use [zap](https://github.com/uber-go/zap) for logging
## Requirements
`Go1.11+`
## Installation
```shell
go get github.com/iiinsomnia/yiigo/v3
```
## Usage
#### MySQL
```go
// default db
yiigo.RegisterDB(yiigo.AsDefault, yiigo.MySQL, "root:root@tcp(localhost:3306)/test")
yiigo.DB.Get(&User{}, "SELECT * FROM `user` WHERE `id` = ?", 1)
// other db
yiigo.RegisterDB("foo", yiigo.MySQL, "root:root@tcp(localhost:3306)/foo")
yiigo.UseDB("foo").Get(&User{}, "SELECT * FROM `user` WHERE `id` = ?", 1)
```
#### MongoDB
```go
// default mongodb
yiigo.RegisterMongoDB(yiigo.AsDefault, "mongodb://localhost:27017")
ctx, _ := context.WithTimeout(context.Background(), 5*time.Second)
yiigo.Mongo.Database("test").Collection("numbers").InsertOne(ctx, bson.M{"name": "pi", "value": 3.14159})
// other mongodb
yiigo.RegisterMongoDB("foo", "mongodb://localhost:27017")
ctx, _ := context.WithTimeout(context.Background(), 5*time.Second)
yiigo.UseMongo("foo").Database("test").Collection("numbers").InsertOne(ctx, bson.M{"name": "pi", "value": 3.14159})
```
#### Redis
```go
// default redis
yiigo.RegisterRedis(yiigo.AsDefault, "localhost:6379")
conn, err := yiigo.Redis.Get()
if err != nil {
log.Fatal(err)
}
defer yiigo.Redis.Put(conn)
conn.Do("SET", "test_key", "hello world")
// other redis
yiigo.RegisterRedis("foo", "localhost:6379")
foo := yiigo.UseRedis("foo")
conn, err := foo.Get()
if err != nil {
log.Fatal(err)
}
defer foo.Put(conn)
conn.Do("SET", "test_key", "hello world")
```
#### Config
```go
// env.toml
//
// [app]
// env = "dev"
// debug = true
// port = 50001
yiigo.UseEnv("env.toml")
yiigo.Env.Bool("app.debug", true)
yiigo.Env.Int("app.port", 12345)
yiigo.Env.String("app.env", "dev")
```
#### Zipkin
```go
tracer, err := yiigo.NewZipkinTracer("http://localhost:9411/api/v2/spans",
yiigo.WithZipkinTracerEndpoint("zipkin-test", "localhost"),
yiigo.WithZipkinTracerSharedSpans(false),
yiigo.WithZipkinTracerSamplerMod(1),
)
if err != nil {
log.Fatal(err)
}
client, err := yiigo.NewZipkinClient(tracer)
if err != nil {
log.Fatal(err)
}
b, err := client.Get(context.Background(), "url...",
yiigo.WithRequestHeader("Content-Type", "application/json; charset=utf-8"),
yiigo.WithRequestTimeout(5*time.Second),
)
if err != nil {
log.Fatal(err)
}
fmt.Println(string(b))
```
#### Logger
```go
// default logger
yiigo.RegisterLogger(yiigo.AsDefault, "app.log")
yiigo.Logger.Info("hello world")
// other logger
yiigo.RegisterLogger("foo", "foo.log")
yiigo.UseLogger("foo").Info("hello world")
```
## Documentation
- [API Reference](https://godoc.org/github.com/iiinsomnia/yiigo)
- [TOML](https://github.com/toml-lang/toml)
- [Example](https://github.com/iiinsomnia/yiigo-example)
**Enjoy ????**
有疑问加站长微信联系（非本文作者））
