Merge pull request #157 from pashagolub/v3

[!] introduce the new major version v3

.github/workflows/build.yml

@@ -20,7 +20,7 @@ jobs:
     - name: Set up Golang
       uses: actions/setup-go@v4
       with:
-        go-version: '1.20'      
+        go-version: '1.21'      
 
     - name: Get dependencies
       run: |

README.md

@@ -10,18 +10,18 @@ It's based on the well-known [sqlmock](https://github.com/DATA-DOG/go-sqlmock) l
 
 **pgxmock** has one and only purpose - to simulate **pgx** behavior in tests, without needing a real database connection. It helps to maintain correct **TDD** workflow.
 
-- written based on **go1.15** version, however, should be compatible with **go1.11** and above;
+- written based on **go1.21** version;
 - does not require any modifications to your source code;
 - has strict by default expectation order matching;
 - has no third party dependencies except **pgx** packages.
 
 ## Install
 
-    go get github.com/pashagolub/pgxmock/v2
+    go get github.com/pashagolub/pgxmock/v3
 
 ## Documentation and Examples
 
-Visit [godoc](http://pkg.go.dev/github.com/pashagolub/pgxmock/v2) for general examples and public api reference.
+Visit [godoc](http://pkg.go.dev/github.com/pashagolub/pgxmock/v3) for general examples and public api reference.
 
 See implementation examples:
 
@@ -92,7 +92,7 @@ import (
 	"fmt"
 	"testing"
 
-	"github.com/pashagolub/pgxmock/v2"
+	"github.com/pashagolub/pgxmock/v3"
 )
 
 // a successful case
@@ -175,7 +175,7 @@ provide a standard sql parsing matchers.
 ## Matching arguments like time.Time
 
 There may be arguments which are of `struct` type and cannot be compared easily by value like `time.Time`. In this case
-**pgxmock** provides an [Argument](https://pkg.go.dev/github.com/pashagolub/pgxmock/v2#Argument) interface which
+**pgxmock** provides an [Argument](https://pkg.go.dev/github.com/pashagolub/pgxmock/v3#Argument) interface which
 can be used in more sophisticated matching. Here is a simple example of time argument matching:
 
 ``` go

argument.go

@@ -20,3 +20,4 @@ type anyArgument struct{}
 func (a anyArgument) Match(_ interface{}) bool {
 	return true
 }
+

driver.go

@@ -12,37 +12,27 @@ type pgxmockConn struct {
 }
 
 // NewConn creates PgxConnIface database connection and a mock to manage expectations.
-// Accepts options, like ValueConverterOption, to use a ValueConverter from
-// a specific driver.
-// Pings db so that all expectations could be
-// asserted.
+// Accepts options, like QueryMatcherOption, to match SQL query strings in more sophisticated ways.
 func NewConn(options ...func(*pgxmock) error) (PgxConnIface, error) {
 	smock := &pgxmockConn{}
 	smock.ordered = true
 	return smock, smock.open(options)
 }
 
-func (c *pgxmockConn) Close(ctx context.Context) error {
-	return c.close(ctx)
-}
-
 type pgxmockPool struct {
 	pgxmock
 }
 
 // NewPool creates PgxPoolIface pool of database connections and a mock to manage expectations.
-// Accepts options, like ValueConverterOption, to use a ValueConverter from
-// a specific driver.
-// Pings db so that all expectations could be
-// asserted.
+// Accepts options, like QueryMatcherOption, to match SQL query strings in more sophisticated ways.
 func NewPool(options ...func(*pgxmock) error) (PgxPoolIface, error) {
 	smock := &pgxmockPool{}
 	smock.ordered = true
 	return smock, smock.open(options)
 }
 
 func (p *pgxmockPool) Close() {
-	_ = p.close(context.Background())
+	p.pgxmock.Close(context.Background())
 }
 
 func (p *pgxmockPool) Acquire(context.Context) (*pgxpool.Conn, error) {

driver_test.go

@@ -33,6 +33,10 @@ func TestPools(t *testing.T) {
 	if mock == mock2 {
 		t.Errorf("expected not the same mock instance, but it is the same")
 	}
+	conn := mock.AsConn()
+	if conn == nil {
+		t.Error("expected connection strruct, but got nil")
+	}
 	mock.Close()
 	mock2.Close()
 }

examples/basic/basic_test.go

@@ -4,7 +4,7 @@ import (
 	"fmt"
 	"testing"
 
-	"github.com/pashagolub/pgxmock/v2"
+	"github.com/pashagolub/pgxmock/v3"
 )
 
 // a successful case

examples/blog/blog_test.go

@@ -9,7 +9,7 @@ import (
 	"net/http/httptest"
 	"testing"
 
-	"github.com/pashagolub/pgxmock/v2"
+	"github.com/pashagolub/pgxmock/v3"
 )
 
 func (a *api) assertJSON(actual []byte, data interface{}, t *testing.T) {