Merge branch 'master' into master

Author: atercattus

CHANGELOG.md

@@ -1,3 +1,23 @@
+### Tag v1.2.1 (2021.05.27)
+* Prevent panic on malformed auth data. [#557](https://github.com/go-mysql-org/go-mysql/pull/557) ([timvaillancourt](https://github.com/timvaillancourt))
+
+### Tag v1.2.0 (2021.05.16)
+* Fix a rare bug in Conn.readResultStreaming. [#573](https://github.com/go-mysql-org/go-mysql/pull/573) ([atercattus](https://github.com/atercattus))
+* Fix tag. [#575](https://github.com/go-mysql-org/go-mysql/pull/575) ([atercattus](https://github.com/atercattus))
+* Update dependency. [#576](https://github.com/go-mysql-org/go-mysql/pull/576) ([Ehco1996](https://github.com/Ehco1996))
+
+### Tag v1.1.2 (2021.04.20)
+* Fix canal test in readme. [#516](https://github.com/go-mysql-org/go-mysql/pull/516) ([gaojijun](https://github.com/gaojijun))
+* UUID clone. [#522](https://github.com/go-mysql-org/go-mysql/pull/522) ([lance6716](https://github.com/lance6716))
+* Sort mariadb gtid set. [#545](https://github.com/go-mysql-org/go-mysql/pull/545) ([zeminzhou](https://github.com/zeminzhou))
+* Mysql: use numeric comparison for binlog filename. [#547](https://github.com/go-mysql-org/go-mysql/pull/547) ([lance6716](https://github.com/lance6716))
+* Fix MySQL spell. [#549](https://github.com/go-mysql-org/go-mysql/pull/549) ([igoso](https://github.com/igoso))
+* Update README.md and CHANGELOG.md. [#564](https://github.com/go-mysql-org/go-mysql/pull/564) ([atercattus](https://github.com/atercattus))
+* Update method now may receive strings with GTID sets. [#569](https://github.com/go-mysql-org/go-mysql/pull/569) ([mialinx](https://github.com/mialinx))
+* Change module name from siddontang/go-mysql to go-mysql-org/go-mysql. [#571](https://github.com/go-mysql-org/go-mysql/pull/571) ([lance6716](https://github.com/lance6716))
+* Fix a bug that not cloned to original memory. [#572](https://github.com/go-mysql-org/go-mysql/pull/572) ([lance6716](https://github.com/lance6716))
+* Update README.md for a new tag. [#574](https://github.com/go-mysql-org/go-mysql/pull/574) ([atercattus](https://github.com/atercattus))
+
 ### Tag v1.1.1 (2021.04.08)
 * Restructured dump/ tests. [#563](https://github.com/go-mysql-org/go-mysql/pull/563) ([atercattus](https://github.com/atercattus))
 * Replace magic numbers in canal/canal_test.go by constants. [#562](https://github.com/go-mysql-org/go-mysql/pull/562) ([atercattus](https://github.com/atercattus))

README.md

@@ -9,10 +9,10 @@ A pure go library to handle MySQL network protocol and replication.
 ## How to migrate to this repo
 To change the used package in your repo it's enough to add this `replace` directive to your `go.mod`:
 ```
-replace github.com/siddontang/go-mysql => github.com/go-mysql-org/go-mysql v1.1.2
+replace github.com/siddontang/go-mysql => github.com/go-mysql-org/go-mysql v1.2.1
 ```
 
-v1.1.2 - is the last tag in repo, feel free to choose what you want.
+v1.2.1 - is the last tag in repo, feel free to choose what you want.
 
 ## Changelog
 This repo uses [Changelog](CHANGELOG.md).
@@ -222,7 +222,7 @@ Tested MySQL versions for the client include:
 - 5.7.x
 - 8.0.x
 
-### Example for SELECT streaming (v.1.1.1)
+### Example for SELECT streaming (v1.1.1)
 You can use also streaming for large SELECT responses.
 The callback function will be called for every result row without storing the whole resultset in memory.
 `result.Fields` will be filled before the first callback call.
@@ -243,6 +243,21 @@ err := conn.ExecuteSelectStreaming(`select id, name from table LIMIT 100500`, &r
 // ...
 ```
 
+### Example for connection pool (v1.3.0)
+
+```go
+import (
+    "github.com/go-mysql-org/go-mysql/client"
+)
+
+pool := client.NewPool(log.Debugf, 100, 400, 5, "127.0.0.1:3306", `root`, ``, `test`)
+// ...
+conn, _ := pool.GetConn(ctx)
+defer pool.PutConn(conn)
+
+conn.Execute() / conn.Begin() / etc...
+```
+
 ## Server
 
 Server package supplies a framework to implement a simple MySQL server which can handle the packets from the MySQL client.