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

examples/booktest/sqlite/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/sqlite/db_test.go

@@ -0,0 +1,163 @@
+//go:build examples
+
+package booktest
+
+import (
+	"context"
+	"testing"
+	"time"
+
+	"github.com/sqlc-dev/sqlc/internal/sqltest"
+)
+
+// TODO: Enum is not yet supported
+const (
+	BooksBookTypeFICTION    string = "FICTION"
+	BooksBookTypeNONFICTION string = "NONFICTION"
+)
+
+func TestBooks(t *testing.T) {
+	db, cleanup := sqltest.SQLite(t, []string{"schema.sql"})
+	defer db.Close()
+	defer cleanup()
+
+	ctx := context.Background()
+	dq := New(db)
+
+	// create an author
+	a, err := dq.CreateAuthor(ctx, "Unknown Master")
+	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:  a.AuthorID,
+		Isbn:      "1",
+		Title:     "my book title",
+		BookType:  BooksBookTypeFICTION,
+		Yr:        2016,
+		Available: now,
+		Tag:       "",
+	})
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	// save second book
+	b1, err := tq.CreateBook(ctx, CreateBookParams{
+		AuthorID:  a.AuthorID,
+		Isbn:      "2",
+		Title:     "the second book",
+		BookType:  BooksBookTypeFICTION,
+		Yr:        2016,
+		Available: now,
+		Tag:       "unique",
+	})
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	// update the title and tags
+	err = tq.UpdateBook(ctx, UpdateBookParams{
+		BookID: b1.BookID,
+		Title:  "changed second title",
+		Tag:    "disastor",
+	})
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	// save third book
+	_, err = tq.CreateBook(ctx, CreateBookParams{
+		AuthorID:  a.AuthorID,
+		Isbn:      "3",
+		Title:     "the third book",
+		BookType:  BooksBookTypeFICTION,
+		Yr:        2001,
+		Available: now,
+		Tag:       "cool",
+	})
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	// save fourth book
+	b3, err := tq.CreateBook(ctx, CreateBookParams{
+		AuthorID:  a.AuthorID,
+		Isbn:      "4",
+		Title:     "4th place finisher",
+		BookType:  BooksBookTypeFICTION,
+		Yr:        2011,
+		Available: now,
+		Tag:       "other",
+	})
+	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: b3.BookID,
+		Isbn:   "NEW ISBN",
+		Title:  "never ever gonna finish, a quatrain",
+		Tag:    "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" or "someother" tag
+	t.Logf("---------\nTag search results:\n")
+	res, err := dq.BooksByTags(ctx, []string{"cool", "other", "someother"})
+	if err != nil {
+		t.Fatal(err)
+	}
+	for _, ab := range res {
+		t.Logf("Book %d: '%s', Author: '%s', ISBN: '%s' Tag: '%v'\n", ab.BookID, ab.Title, ab.Name.String, ab.Isbn, ab.Tag)
+	}
+
+	// TODO: call say_hello(varchar)
+
+	// get book 4 and delete
+	b5, err := dq.GetBook(ctx, b3.BookID)
+	if err != nil {
+		t.Fatal(err)
+	}
+	if err := dq.DeleteBook(ctx, b5.BookID); err != nil {
+		t.Fatal(err)
+	}
+
+}

examples/booktest/sqlite/models.go

@@ -0,0 +1,25 @@
+// Code generated by sqlc. DO NOT EDIT.
+// versions:
+//   sqlc v1.31.1
+
+package booktest
+
+import (
+	"time"
+)
+
+type Author struct {
+	AuthorID int64
+	Name     string
+}
+
+type Book struct {
+	BookID    int64
+	AuthorID  int64
+	Isbn      string
+	BookType  string
+	Title     string
+	Yr        int64
+	Available time.Time
+	Tag       string
+}

examples/booktest/sqlite/query.sql

@@ -0,0 +1,64 @@
+/* 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,
+  tag
+FROM books
+LEFT JOIN authors ON books.author_id = authors.author_id
+WHERE tag IN (sqlc.slice(tags));
+
+/* name: CreateAuthor :one */
+INSERT INTO authors (name) VALUES (?)
+RETURNING *;
+
+/* name: CreateBook :one */
+INSERT INTO books (
+    author_id,
+    isbn,
+    book_type,
+    title,
+    yr,
+    available,
+    tag
+) VALUES (
+    ?,
+    ?,
+    ?,
+    ?,
+    ?,
+    ?,
+    ?
+)
+RETURNING *;
+
+/* name: UpdateBook :exec */
+UPDATE books
+SET title = ?1, tag = ?2
+WHERE book_id = ?3;
+
+/* name: UpdateBookISBN :exec */
+UPDATE books
+SET title = ?1, tag = ?2, isbn = ?4
+WHERE book_id = ?3;
+
+/* name: DeleteAuthorBeforeYear :exec */
+DELETE FROM books
+WHERE yr < ? AND author_id = ?;

examples/booktest/sqlite/query.sql.go

@@ -0,0 +1,279 @@
+// Code generated by sqlc. DO NOT EDIT.
+// versions:
+//   sqlc v1.31.1
+// source: query.sql
+
+package booktest
+
+import (
+	"context"
+	"database/sql"
+	"strings"
+	"time"
+)
+
+const booksByTags = `-- name: BooksByTags :many
+SELECT
+  book_id,
+  title,
+  name,
+  isbn,
+  tag
+FROM books
+LEFT JOIN authors ON books.author_id = authors.author_id
+WHERE tag IN (/*SLICE:tags*/?)
+`
+
+type BooksByTagsRow struct {
+	BookID int64
+	Title  string
+	Name   sql.NullString
+	Isbn   string
+	Tag    string
+}
+
+func (q *Queries) BooksByTags(ctx context.Context, tags []string) ([]BooksByTagsRow, error) {
+	query := booksByTags
+	var queryParams []any
+	if len(tags) > 0 {
+		for _, v := range tags {
+			queryParams = append(queryParams, v)
+		}
+		query = strings.Replace(query, "/*SLICE:tags*/?", strings.Repeat(",?", len(tags))[1:], 1)
+	} else {
+		query = strings.Replace(query, "/*SLICE:tags*/?", "NULL", 1)
+	}
+	rows, err := q.db.QueryContext(ctx, query, queryParams...)
+	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.Tag,
+		); 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, tag FROM books
+WHERE title = ? AND yr = ?
+`
+
+type BooksByTitleYearParams struct {
+	Title string
+	Yr    int64
+}
+
+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.Tag,
+		); 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 :one
+INSERT INTO authors (name) VALUES (?)
+RETURNING author_id, name
+`
+
+func (q *Queries) CreateAuthor(ctx context.Context, name string) (Author, error) {
+	row := q.db.QueryRowContext(ctx, createAuthor, name)
+	var i Author
+	err := row.Scan(&i.AuthorID, &i.Name)
+	return i, err
+}
+
+const createBook = `-- name: CreateBook :one
+INSERT INTO books (
+    author_id,
+    isbn,
+    book_type,
+    title,
+    yr,
+    available,
+    tag
+) VALUES (
+    ?,
+    ?,
+    ?,
+    ?,
+    ?,
+    ?,
+    ?
+)
+RETURNING book_id, author_id, isbn, book_type, title, yr, available, tag
+`
+
+type CreateBookParams struct {
+	AuthorID  int64
+	Isbn      string
+	BookType  string
+	Title     string
+	Yr        int64
+	Available time.Time
+	Tag       string
+}
+
+func (q *Queries) CreateBook(ctx context.Context, arg CreateBookParams) (Book, error) {
+	row := q.db.QueryRowContext(ctx, createBook,
+		arg.AuthorID,
+		arg.Isbn,
+		arg.BookType,
+		arg.Title,
+		arg.Yr,
+		arg.Available,
+		arg.Tag,
+	)
+	var i Book
+	err := row.Scan(
+		&i.BookID,
+		&i.AuthorID,
+		&i.Isbn,
+		&i.BookType,
+		&i.Title,
+		&i.Yr,
+		&i.Available,
+		&i.Tag,
+	)
+	return i, err
+}
+
+const deleteAuthorBeforeYear = `-- name: DeleteAuthorBeforeYear :exec
+DELETE FROM books
+WHERE yr < ? AND author_id = ?
+`
+
+type DeleteAuthorBeforeYearParams struct {
+	Yr       int64
+	AuthorID int64
+}
+
+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 int64) 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 int64) (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, tag FROM books
+WHERE book_id = ?
+`
+
+func (q *Queries) GetBook(ctx context.Context, bookID int64) (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.Tag,
+	)
+	return i, err
+}
+
+const updateBook = `-- name: UpdateBook :exec
+UPDATE books
+SET title = ?1, tag = ?2
+WHERE book_id = ?3
+`
+
+type UpdateBookParams struct {
+	Title  string
+	Tag    string
+	BookID int64
+}
+
+func (q *Queries) UpdateBook(ctx context.Context, arg UpdateBookParams) error {
+	_, err := q.db.ExecContext(ctx, updateBook, arg.Title, arg.Tag, arg.BookID)
+	return err
+}
+
+const updateBookISBN = `-- name: UpdateBookISBN :exec
+UPDATE books
+SET title = ?1, tag = ?2, isbn = ?4
+WHERE book_id = ?3
+`
+
+type UpdateBookISBNParams struct {
+	Title  string
+	Tag    string
+	BookID int64
+	Isbn   string
+}
+
+func (q *Queries) UpdateBookISBN(ctx context.Context, arg UpdateBookISBNParams) error {
+	_, err := q.db.ExecContext(ctx, updateBookISBN,
+		arg.Title,
+		arg.Tag,
+		arg.BookID,
+		arg.Isbn,
+	)
+	return err
+}

examples/booktest/sqlite/schema.sql

@@ -0,0 +1,20 @@
+CREATE TABLE authors (
+          author_id integer NOT NULL PRIMARY KEY AUTOINCREMENT,
+          name text NOT NULL
+);
+
+CREATE INDEX authors_name_idx ON authors(name);
+
+CREATE TABLE books (
+          book_id integer NOT NULL PRIMARY KEY AUTOINCREMENT,
+          author_id integer NOT NULL,
+          isbn varchar(255) NOT NULL DEFAULT '' UNIQUE,
+          book_type text NOT NULL DEFAULT 'FICTION',
+          title text NOT NULL,
+          yr integer NOT NULL DEFAULT 2000,
+          available datetime NOT NULL DEFAULT CURRENT_TIMESTAMP,
+          tag text NOT NULL,
+          CHECK (book_type = 'FICTION' OR book_type = 'NONFICTION')
+);
+
+CREATE INDEX books_title_idx ON books(title, yr);