feat: add example for mysql

Author: Unagi-zoso

example/mysql/README.md

@@ -0,0 +1,15 @@
+# MySQL Example for tqla
+
+This example demonstrates how to use the `tqla` library with MySQL database.
+
+## Set up the environment
+
+### 1. Pull and run MySQL Docker container
+
+```shell
+# Pull the latest MySQL image
+docker pull mysql:latest
+
+# Start MySQL container
+docker run --name mysql_test -e MYSQL_ROOT_PASSWORD=root -e MYSQL_DATABASE=mysql-test-db -p 3306:3306 -d mysql:latest
+```

example/mysql/go.mod

@@ -0,0 +1,12 @@
+module github.com/VauntDev/tqla/example/mysql
+
+go 1.21
+
+replace github.com/VauntDev/tqla => ../../
+
+require (
+	github.com/VauntDev/tqla v0.0.0-00010101000000-000000000000
+	github.com/go-sql-driver/mysql v1.8.1
+)
+
+require filippo.io/edwards25519 v1.1.0 // indirect

example/mysql/go.sum

@@ -0,0 +1,12 @@
+filippo.io/edwards25519 v1.1.0 h1:FNf4tywRC1HmFuKW5xopWpigGjJKiJSV0Cqo0cJWDaA=
+filippo.io/edwards25519 v1.1.0/go.mod h1:BxyFTGdWcka3PhytdK4V28tE5sGfRvvvRV7EaN4VDT4=
+github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
+github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/go-sql-driver/mysql v1.8.1 h1:LedoTUt/eveggdHS9qUFC1EFSa8bU2+1pZjSRpvNJ1Y=
+github.com/go-sql-driver/mysql v1.8.1/go.mod h1:wEBSXgmK//2ZFJyE+qWnIsVGmvmEKlqwuVSjsCm7DZg=
+github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
+github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/stretchr/testify v1.8.4 h1:CcVxjf3Q8PM0mHUKJCdn+eZZtm5yQwehR5yeSVQQcUk=
+github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo=
+gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
+gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=

example/mysql/main.go

@@ -0,0 +1,92 @@
+package main
+
+import (
+	"database/sql"
+	"fmt"
+	"log"
+
+	"github.com/VauntDev/tqla"
+	_ "github.com/go-sql-driver/mysql"
+)
+
+const (
+	host     = "localhost"
+	port     = 3306
+	user     = "root"
+	password = "root"
+	dbname   = "mysql-test-db"
+)
+
+type todo struct {
+	Id          int
+	Title       string
+	Description string
+	Completed   bool
+}
+
+const todoSchema = `CREATE TABLE IF NOT EXISTS todos (
+	id INT PRIMARY KEY,
+	title TEXT NOT NULL,
+	description TEXT NOT NULL,
+	completed BOOLEAN DEFAULT FALSE
+);`
+
+func main() {
+
+	log.Println("connecting to db...")
+	dsn := fmt.Sprintf("%s:%s@tcp(%s:%d)/%s", user, password, host, port, dbname)
+
+	db, err := sql.Open("mysql", dsn)
+	if err != nil {
+		log.Fatal(err)
+	}
+	defer db.Close()
+
+	log.Println("creating table if it does not exist...")
+	if _, err := db.Exec(todoSchema); err != nil {
+		log.Fatal(err)
+	}
+
+	todos := []*todo{
+		{Id: 1, Title: "todo 1", Description: "first todo", Completed: false},
+		{Id: 2, Title: "todo 2", Description: "second todo", Completed: false},
+		{Id: 3, Title: "todo 3", Description: "third todo", Completed: false},
+		{Id: 4, Title: "todo 4", Description: "fourth todo", Completed: false},
+		{Id: 5, Title: "todo 5", Description: "fifth todo", Completed: false},
+	}
+
+	t, err := tqla.New()
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	log.Println("adding todos...")
+	insertStmt, insertArgs, err := t.Compile(`
+	{{ $len := 4 -}}
+	INSERT INTO todos (id, title, description, completed) 
+	VALUES {{ range $i, $v := . }}
+		( {{$v.Id}}, {{$v.Title}}, {{$v.Description}}, {{ $v.Completed }} ){{if lt $i $len}},{{else}};{{end -}}
+	{{end}}
+	`, todos)
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	if _, err := db.Exec(insertStmt, insertArgs...); err != nil {
+		log.Fatal(err)
+	}
+
+	log.Println("looking up todo...")
+	selectStmt, selectArgs, err := t.Compile(`SELECT * FROM todos WHERE id = {{ . }}`, 5)
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	todo := &todo{}
+	row := db.QueryRow(selectStmt, selectArgs...)
+	if err := row.Scan(&todo.Id, &todo.Title, &todo.Description, &todo.Completed); err != nil {
+		log.Fatal(err)
+	}
+
+	log.Println("found: ", todo)
+}

go.work

@@ -4,4 +4,5 @@ use (
         .
         ./example/sqlite
         ./example/postgres
+        ./example/mysql
 )