feat: add module crud method

Author: RivenZoo

init_sqlagent.go

@@ -0,0 +1 @@
+package sqlagent

module_sqlagent.go

@@ -0,0 +1,62 @@
+package sqlagent
+
+import (
+	"github.com/jmoiron/sqlx"
+	"database/sql"
+	"context"
+	sq "gopkg.in/Masterminds/squirrel.v1"
+)
+
+var (
+	defaultAgent *SqlAgent
+)
+
+// Close SqlAgent inited by module init method.
+func Close() error {
+	return defaultAgent.Close()
+}
+
+// DB return sqlx.DB held by module SqlAgent.
+func DB() *sqlx.DB {
+	return defaultAgent.DB()
+}
+
+func Transaction(ctx context.Context, opt *sql.TxOptions, fn func(tx *sqlx.Tx) error) error {
+	return defaultAgent.Transaction(ctx, opt, fn)
+}
+
+// InsertBuilder return squirrel.InsertBuilder for table into
+// into: insert table name
+func InsertBuilder(into string) sq.InsertBuilder {
+	return defaultAgent.InsertBuilder(into)
+}
+
+func UpdateBuilder(table string) sq.UpdateBuilder {
+	return defaultAgent.UpdateBuilder(table)
+}
+
+func DeleteBuilder(table string) sq.DeleteBuilder {
+	return defaultAgent.DeleteBuilder(table)
+}
+
+func SelectBuilder(columns ...string) sq.SelectBuilder {
+	return defaultAgent.SelectBuilder(columns...)
+}
+
+// ExecContext exec sql built by sq.InsertBuilder/sq.UpdateBuilder/sq.DeleteBuilder and return result.
+// builder: sq.InsertBuilder, sq.UpdateBuilder or sq.DeleteBuilder
+func ExecContext(ctx context.Context, builder sq.Sqlizer) (sql.Result, error) {
+	return defaultAgent.ExecContext(ctx, builder)
+}
+
+// GetContext get one record by sql built by sq.SelectBuilder and scan to dest.
+// builder: sq.SelectBuilder
+func GetContext(ctx context.Context, builder sq.Sqlizer, dest interface{}) error {
+	return defaultAgent.GetContext(ctx, builder, dest)
+}
+
+// SelectContext get one or multi records by sql built by sq.SelectBuilder and scan to dest.
+// builder: sq.SelectBuilder
+func SelectContext(ctx context.Context, builder sq.Sqlizer, dest interface{}) error {
+	return defaultAgent.SelectContext(ctx, builder, dest)
+}