v3

Makefile

@@ -2,9 +2,10 @@
 
 test: fmt
 	GORACE="atexit_sleep_ms=50" go test -timeout=1s -race -covermode=atomic ./...
+	GORACE="atexit_sleep_ms=50" go test -count=1 github.com/smarty/sqldb/integration
 
 fmt:
-	go fmt ./...
+	go mod tidy && go fmt ./...
 
 compile:
 	go build ./...

README.md

@@ -4,3 +4,56 @@
 [![Code Coverage](https://codecov.io/gh/smarty/sqldb/branch/master/graph/badge.svg)](https://codecov.io/gh/smarty/sqldb)
 [![Go Report Card](https://goreportcard.com/badge/github.com/smarty/sqldb)](https://goreportcard.com/report/github.com/smarty/sqldb)
 [![GoDoc](https://godoc.org/github.com/smarty/sqldb?status.svg)](http://godoc.org/github.com/smarty/sqldb)
+
+
+## Upgrading from v2 to v3
+
+Those upgrading from v2 to v3 may be interested in the following code, which can be used to adapt write operations ('Scripts') to v3 while still using a v2-style interface:
+
+```go
+package mysql
+
+import (
+	"context"
+
+	"github.com/smarty/sqldb/v3"
+)
+
+// Deprecated
+type LegacyExecutor interface {
+	Execute(context.Context, string, ...any) (uint64, error)
+}
+
+// Deprecated
+func newLegacyExecutor(handle sqldb.Handle) LegacyExecutor {
+	return &legacyExecutor{handle: handle}
+}
+
+// Deprecated
+type legacyExecutor struct {
+	handle sqldb.Handle
+}
+
+// Deprecated
+func (this *legacyExecutor) Execute(ctx context.Context, statement string, args ...any) (uint64, error) {
+	script := &rowCountScript{
+		BaseScript: sqldb.BaseScript{
+			Text: statement,
+			Args: args,
+		},
+	}
+	err := this.handle.Execute(ctx, script)
+	return script.rowsAffectedCount, err
+}
+
+// Deprecated
+type rowCountScript struct {
+	sqldb.BaseScript
+	rowsAffectedCount uint64
+}
+
+// Deprecated
+func (this *rowCountScript) RowsAffected(rowCount uint64) {
+	this.rowsAffectedCount += rowCount
+}
+```

base.go

@@ -0,0 +1,29 @@
+package sqldb
+
+// BaseScript is a bare-minimum implementation of Script.
+type BaseScript struct {
+	Text string
+	Args []any
+}
+
+func (this BaseScript) Statements() string {
+	return this.Text
+}
+func (this BaseScript) Parameters() []any {
+	return this.Args
+}
+
+// BaseQuery is a bare-minium, partial implementation of Query.
+// Users are invited to embed it on types that define a Scan method,
+// thus completing the Query implementation.
+type BaseQuery struct {
+	Text string
+	Args []any
+}
+
+func (this BaseQuery) Statement() string {
+	return this.Text
+}
+func (this BaseQuery) Parameters() []any {
+	return this.Args
+}