snapshot of https://github.com/sqlc-dev/sqlc.git (main, 2026-09-16; blobs > 131072B omitted)

examples/booktest/mysql/db.go

@@ -0,0 +1,31 @@
+// Code generated by sqlc. DO NOT EDIT.
+// versions:
+//   sqlc v1.31.1
+
+package booktest
+
+import (
+	"context"
+	"database/sql"
+)
+
+type DBTX interface {
+	ExecContext(context.Context, string, ...any) (sql.Result, error)
+	PrepareContext(context.Context, string) (*sql.Stmt, error)
+	QueryContext(context.Context, string, ...any) (*sql.Rows, error)
+	QueryRowContext(context.Context, string, ...any) *sql.Row
+}
+
+func New(db DBTX) *Queries {
+	return &Queries{db: db}
+}
+
+type Queries struct {
+	db DBTX
+}
+
+func (q *Queries) WithTx(tx *sql.Tx) *Queries {
+	return &Queries{
+		db: tx,
+	}
+}

examples/booktest/mysql/db_test.go

@@ -0,0 +1,174 @@
+//go:build examples
+
+package booktest
+
+import (
+	"context"
+	"database/sql"
+	"testing"
+	"time"
+
+	_ "github.com/go-sql-driver/mysql"
+
+	"github.com/sqlc-dev/sqlc/internal/sqltest/local"
+)
+
+func TestBooks(t *testing.T) {
+	ctx := context.Background()
+	uri := local.MySQL(t, []string{"schema.sql"})
+	db, err := sql.Open("mysql", uri)
+	if err != nil {
+		t.Fatal(err)
+	}
+	defer db.Close()
+
+	dq := New(db)
+
+	// create an author
+	result, err := dq.CreateAuthor(ctx, "Unknown Master")
+	if err != nil {
+		t.Fatal(err)
+	}
+	authorID, err := result.LastInsertId()
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	// create transaction
+	tx, err := db.Begin()
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	tq := dq.WithTx(tx)
+
+	// save first book
+	now := time.Now()
+	_, err = tq.CreateBook(ctx, CreateBookParams{
+		AuthorID:  int32(authorID),
+		Isbn:      "1",
+		Title:     "my book title",
+		BookType:  BooksBookTypeFICTION,
+		Yr:        2016,
+		Available: now,
+	})
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	// save second book
+	result, err = tq.CreateBook(ctx, CreateBookParams{
+		AuthorID:  int32(authorID),
+		Isbn:      "2",
+		Title:     "the second book",
+		BookType:  BooksBookTypeFICTION,
+		Yr:        2016,
+		Available: now,
+		Tags:      "cool,unique",
+	})
+	if err != nil {
+		t.Fatal(err)
+	}
+	bookOneID, err := result.LastInsertId()
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	// update the title and tags
+	err = tq.UpdateBook(ctx, UpdateBookParams{
+		BookID: int32(bookOneID),
+		Title:  "changed second title",
+		Tags:   "cool,disastor",
+	})
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	// save third book
+	_, err = tq.CreateBook(ctx, CreateBookParams{
+		AuthorID:  int32(authorID),
+		Isbn:      "3",
+		Title:     "the third book",
+		BookType:  BooksBookTypeFICTION,
+		Yr:        2001,
+		Available: now,
+		Tags:      "cool",
+	})
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	// save fourth book
+	result, err = tq.CreateBook(ctx, CreateBookParams{
+		AuthorID:  int32(authorID),
+		Isbn:      "4",
+		Title:     "4th place finisher",
+		BookType:  BooksBookTypeNONFICTION,
+		Yr:        2011,
+		Available: now,
+		Tags:      "other",
+	})
+	if err != nil {
+		t.Fatal(err)
+	}
+	bookThreeID, err := result.LastInsertId()
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	// tx commit
+	err = tx.Commit()
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	// upsert, changing ISBN and title
+	err = dq.UpdateBookISBN(ctx, UpdateBookISBNParams{
+		BookID: int32(bookThreeID),
+		Isbn:   "NEW ISBN",
+		Title:  "never ever gonna finish, a quatrain",
+		Tags:   "someother",
+	})
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	// retrieve first book
+	books0, err := dq.BooksByTitleYear(ctx, BooksByTitleYearParams{
+		Title: "my book title",
+		Yr:    2016,
+	})
+	if err != nil {
+		t.Fatal(err)
+	}
+	for _, book := range books0 {
+		t.Logf("Book %d (%s): %s available: %s\n", book.BookID, book.BookType, book.Title, book.Available.Format(time.RFC822Z))
+		author, err := dq.GetAuthor(ctx, book.AuthorID)
+		if err != nil {
+			t.Fatal(err)
+		}
+		t.Logf("Book %d author: %s\n", book.BookID, author.Name)
+	}
+
+	// find a book with either "cool" or "other" tag
+	t.Logf("---------\nTag search results:\n")
+	res, err := dq.BooksByTags(ctx, "cool")
+	if err != nil {
+		t.Fatal(err)
+	}
+	for _, ab := range res {
+		t.Logf("Book %d: '%s', Author: '%s', ISBN: '%s' Tags: '%v'\n", ab.BookID, ab.Title, ab.Name.String, ab.Isbn, ab.Tags)
+	}
+
+	// TODO: call say_hello(varchar)
+
+	// get book 4 and delete
+	b5, err := dq.GetBook(ctx, int32(bookThreeID))
+	if err != nil {
+		t.Fatal(err)
+	}
+	if err := dq.DeleteBook(ctx, b5.BookID); err != nil {
+		t.Fatal(err)
+	}
+
+}

examples/booktest/mysql/models.go

@@ -0,0 +1,69 @@
+// Code generated by sqlc. DO NOT EDIT.
+// versions:
+//   sqlc v1.31.1
+
+package booktest
+
+import (
+	"database/sql/driver"
+	"fmt"
+	"time"
+)
+
+type BooksBookType string
+
+const (
+	BooksBookTypeFICTION    BooksBookType = "FICTION"
+	BooksBookTypeNONFICTION BooksBookType = "NONFICTION"
+)
+
+func (e *BooksBookType) Scan(src any) error {
+	switch s := src.(type) {
+	case []byte:
+		*e = BooksBookType(s)
+	case string:
+		*e = BooksBookType(s)
+	default:
+		return fmt.Errorf("unsupported scan type for BooksBookType: %T", src)
+	}
+	return nil
+}
+
+type NullBooksBookType struct {
+	BooksBookType BooksBookType
+	Valid         bool // Valid is true if BooksBookType is not NULL
+}
+
+// Scan implements the Scanner interface.
+func (ns *NullBooksBookType) Scan(value any) error {
+	if value == nil {
+		ns.BooksBookType, ns.Valid = "", false
+		return nil
+	}
+	ns.Valid = true
+	return ns.BooksBookType.Scan(value)
+}
+
+// Value implements the driver Valuer interface.
+func (ns NullBooksBookType) Value() (driver.Value, error) {
+	if !ns.Valid {
+		return nil, nil
+	}
+	return string(ns.BooksBookType), nil
+}
+
+type Author struct {
+	AuthorID int32
+	Name     string
+}
+
+type Book struct {
+	BookID    int32
+	AuthorID  int32
+	Isbn      string
+	BookType  BooksBookType
+	Title     string
+	Yr        int32
+	Available time.Time
+	Tags      string
+}

examples/booktest/mysql/query.sql

@@ -0,0 +1,63 @@
+/* name: GetAuthor :one */
+SELECT * FROM authors
+WHERE author_id = ?;
+
+/* name: GetBook :one */
+SELECT * FROM books
+WHERE book_id = ?;
+
+/* name: DeleteBook :exec */
+DELETE FROM books
+WHERE book_id = ?;
+
+/* name: BooksByTitleYear :many */
+SELECT * FROM books
+WHERE title = ? AND yr = ?;
+
+/* name: BooksByTags :many */
+SELECT
+  book_id,
+  title,
+  name,
+  isbn,
+  tags
+FROM books
+LEFT JOIN authors ON books.author_id = authors.author_id
+WHERE tags = ?;
+
+/* name: CreateAuthor :execresult */
+INSERT INTO authors (name) VALUES (?);
+
+/* name: CreateBook :execresult */
+INSERT INTO books (
+    author_id,
+    isbn,
+    book_type,
+    title,
+    yr,
+    available,
+    tags
+) VALUES (
+    ?,
+    ?,
+    ?,
+    ?,
+    ?,
+    ?,
+    ?
+);
+
+/* name: UpdateBook :exec */
+UPDATE books
+SET title = ?, tags = ?
+WHERE book_id = ?;
+
+/* name: UpdateBookISBN :exec */
+UPDATE books
+SET title = ?, tags = ?, isbn = ?
+WHERE book_id = ?;
+
+/* name: DeleteAuthorBeforeYear :exec */
+DELETE FROM books
+WHERE yr < ? AND author_id = ?;
+-- WHERE yr < sqlc.arg(min_publish_year) AND author_id = ?;

examples/booktest/mysql/query.sql.go

@@ -0,0 +1,251 @@
+// Code generated by sqlc. DO NOT EDIT.
+// versions:
+//   sqlc v1.31.1
+// source: query.sql
+
+package booktest
+
+import (
+	"context"
+	"database/sql"
+	"time"
+)
+
+const booksByTags = `-- name: BooksByTags :many
+SELECT
+  book_id,
+  title,
+  name,
+  isbn,
+  tags
+FROM books
+LEFT JOIN authors ON books.author_id = authors.author_id
+WHERE tags = ?
+`
+
+type BooksByTagsRow struct {
+	BookID int32
+	Title  string
+	Name   sql.NullString
+	Isbn   string
+	Tags   string
+}
+
+func (q *Queries) BooksByTags(ctx context.Context, tags string) ([]BooksByTagsRow, error) {
+	rows, err := q.db.QueryContext(ctx, booksByTags, tags)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+	var items []BooksByTagsRow
+	for rows.Next() {
+		var i BooksByTagsRow
+		if err := rows.Scan(
+			&i.BookID,
+			&i.Title,
+			&i.Name,
+			&i.Isbn,
+			&i.Tags,
+		); err != nil {
+			return nil, err
+		}
+		items = append(items, i)
+	}
+	if err := rows.Close(); err != nil {
+		return nil, err
+	}
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+	return items, nil
+}
+
+const booksByTitleYear = `-- name: BooksByTitleYear :many
+SELECT book_id, author_id, isbn, book_type, title, yr, available, tags FROM books
+WHERE title = ? AND yr = ?
+`
+
+type BooksByTitleYearParams struct {
+	Title string
+	Yr    int32
+}
+
+func (q *Queries) BooksByTitleYear(ctx context.Context, arg BooksByTitleYearParams) ([]Book, error) {
+	rows, err := q.db.QueryContext(ctx, booksByTitleYear, arg.Title, arg.Yr)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+	var items []Book
+	for rows.Next() {
+		var i Book
+		if err := rows.Scan(
+			&i.BookID,
+			&i.AuthorID,
+			&i.Isbn,
+			&i.BookType,
+			&i.Title,
+			&i.Yr,
+			&i.Available,
+			&i.Tags,
+		); err != nil {
+			return nil, err
+		}
+		items = append(items, i)
+	}
+	if err := rows.Close(); err != nil {
+		return nil, err
+	}
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+	return items, nil
+}
+
+const createAuthor = `-- name: CreateAuthor :execresult
+INSERT INTO authors (name) VALUES (?)
+`
+
+func (q *Queries) CreateAuthor(ctx context.Context, name string) (sql.Result, error) {
+	return q.db.ExecContext(ctx, createAuthor, name)
+}
+
+const createBook = `-- name: CreateBook :execresult
+INSERT INTO books (
+    author_id,
+    isbn,
+    book_type,
+    title,
+    yr,
+    available,
+    tags
+) VALUES (
+    ?,
+    ?,
+    ?,
+    ?,
+    ?,
+    ?,
+    ?
+)
+`
+
+type CreateBookParams struct {
+	AuthorID  int32
+	Isbn      string
+	BookType  BooksBookType
+	Title     string
+	Yr        int32
+	Available time.Time
+	Tags      string
+}
+
+func (q *Queries) CreateBook(ctx context.Context, arg CreateBookParams) (sql.Result, error) {
+	return q.db.ExecContext(ctx, createBook,
+		arg.AuthorID,
+		arg.Isbn,
+		arg.BookType,
+		arg.Title,
+		arg.Yr,
+		arg.Available,
+		arg.Tags,
+	)
+}
+
+const deleteAuthorBeforeYear = `-- name: DeleteAuthorBeforeYear :exec
+DELETE FROM books
+WHERE yr < ? AND author_id = ?
+`
+
+type DeleteAuthorBeforeYearParams struct {
+	Yr       int32
+	AuthorID int32
+}
+
+func (q *Queries) DeleteAuthorBeforeYear(ctx context.Context, arg DeleteAuthorBeforeYearParams) error {
+	_, err := q.db.ExecContext(ctx, deleteAuthorBeforeYear, arg.Yr, arg.AuthorID)
+	return err
+}
+
+const deleteBook = `-- name: DeleteBook :exec
+DELETE FROM books
+WHERE book_id = ?
+`
+
+func (q *Queries) DeleteBook(ctx context.Context, bookID int32) error {
+	_, err := q.db.ExecContext(ctx, deleteBook, bookID)
+	return err
+}
+
+const getAuthor = `-- name: GetAuthor :one
+SELECT author_id, name FROM authors
+WHERE author_id = ?
+`
+
+func (q *Queries) GetAuthor(ctx context.Context, authorID int32) (Author, error) {
+	row := q.db.QueryRowContext(ctx, getAuthor, authorID)
+	var i Author
+	err := row.Scan(&i.AuthorID, &i.Name)
+	return i, err
+}
+
+const getBook = `-- name: GetBook :one
+SELECT book_id, author_id, isbn, book_type, title, yr, available, tags FROM books
+WHERE book_id = ?
+`
+
+func (q *Queries) GetBook(ctx context.Context, bookID int32) (Book, error) {
+	row := q.db.QueryRowContext(ctx, getBook, bookID)
+	var i Book
+	err := row.Scan(
+		&i.BookID,
+		&i.AuthorID,
+		&i.Isbn,
+		&i.BookType,
+		&i.Title,
+		&i.Yr,
+		&i.Available,
+		&i.Tags,
+	)
+	return i, err
+}
+
+const updateBook = `-- name: UpdateBook :exec
+UPDATE books
+SET title = ?, tags = ?
+WHERE book_id = ?
+`
+
+type UpdateBookParams struct {
+	Title  string
+	Tags   string
+	BookID int32
+}
+
+func (q *Queries) UpdateBook(ctx context.Context, arg UpdateBookParams) error {
+	_, err := q.db.ExecContext(ctx, updateBook, arg.Title, arg.Tags, arg.BookID)
+	return err
+}
+
+const updateBookISBN = `-- name: UpdateBookISBN :exec
+UPDATE books
+SET title = ?, tags = ?, isbn = ?
+WHERE book_id = ?
+`
+
+type UpdateBookISBNParams struct {
+	Title  string
+	Tags   string
+	Isbn   string
+	BookID int32
+}
+
+func (q *Queries) UpdateBookISBN(ctx context.Context, arg UpdateBookISBNParams) error {
+	_, err := q.db.ExecContext(ctx, updateBookISBN,
+		arg.Title,
+		arg.Tags,
+		arg.Isbn,
+		arg.BookID,
+	)
+	return err
+}

examples/booktest/mysql/schema.sql

@@ -0,0 +1,26 @@
+CREATE TABLE authors (
+          author_id integer NOT NULL AUTO_INCREMENT PRIMARY KEY,
+          name text NOT NULL
+) ENGINE=InnoDB;
+
+CREATE INDEX authors_name_idx ON authors(name(255));
+
+CREATE TABLE books (
+          book_id integer NOT NULL AUTO_INCREMENT PRIMARY KEY,
+          author_id integer NOT NULL,
+          isbn varchar(255) NOT NULL DEFAULT '' UNIQUE,
+          book_type ENUM('FICTION', 'NONFICTION') NOT NULL DEFAULT 'FICTION',
+          title text NOT NULL,
+          yr integer NOT NULL DEFAULT 2000,
+          available datetime NOT NULL DEFAULT NOW(),
+          tags text NOT NULL
+          -- CONSTRAINT FOREIGN KEY (author_id) REFERENCES authors(author_id)
+) ENGINE=InnoDB;
+
+CREATE INDEX books_title_idx ON books(title(255), yr);
+
+/*
+CREATE FUNCTION say_hello(s text) RETURNS text
+  DETERMINISTIC
+  RETURN CONCAT('hello ', s);
+*/