Ability to return an iterator on rows

.github/workflows/ci-kotlin.yml

@@ -12,7 +12,7 @@ jobs:
       - uses: actions/checkout@v4
       - uses: actions/setup-go@v5
         with:
-          go-version: '1.21.3'
+          go-version: '1.23.2'
       - name: install ./...
         run: go install ./...
       - uses: actions/checkout@v4

.github/workflows/ci-python.yml

@@ -12,7 +12,7 @@ jobs:
       - uses: actions/checkout@v4
       - uses: actions/setup-go@v5
         with:
-          go-version: '1.21.3'
+          go-version: '1.23.2'
       - name: install ./...
         run: go install ./...
       - uses: actions/checkout@v4

.github/workflows/ci-typescript.yml

@@ -12,7 +12,7 @@ jobs:
       - uses: actions/checkout@v4
       - uses: actions/setup-go@v5
         with:
-          go-version: '1.21.3'
+          go-version: '1.23.2'
       - name: install ./...
         run: go install ./...
       - uses: actions/checkout@v4

.github/workflows/ci.yml

@@ -30,7 +30,7 @@ jobs:
     - uses: actions/checkout@v4
     - uses: actions/setup-go@v5
       with:
-        go-version: '1.22.8'
+        go-version: '1.23.2'
 
     - name: install gotestsum
       run: go install gotest.tools/gotestsum@latest
@@ -78,6 +78,6 @@ jobs:
     - uses: actions/checkout@v4
     - uses: actions/setup-go@v5
       with:
-        go-version: '1.22.8'
+        go-version: '1.23.2'
     - run: go install golang.org/x/vuln/cmd/govulncheck@latest
     - run: govulncheck ./...

docs/overview/install.md

@@ -16,7 +16,7 @@ sudo snap install sqlc
 
 ## go install
 
-Installing recent versions of sqlc requires Go 1.21+.
+Installing recent versions of sqlc requires Go 1.23+.
 
 ```
 go install github.com/sqlc-dev/sqlc/cmd/sqlc@latest

examples/authors/mysql/query.sql

@@ -6,6 +6,10 @@ WHERE id = ? LIMIT 1;
 SELECT * FROM authors
 ORDER BY name;
 
+/* name: IterAuthors :iter */
+SELECT * FROM authors
+ORDER BY name;
+
 /* name: CreateAuthor :execresult */
 INSERT INTO authors (
   name, bio

examples/authors/postgresql/query.sql

@@ -6,6 +6,10 @@ WHERE id = $1 LIMIT 1;
 SELECT * FROM authors
 ORDER BY name;
 
+-- name: IterAuthors :iter
+SELECT * FROM authors
+ORDER BY name;
+
 -- name: CreateAuthor :one
 INSERT INTO authors (
           name, bio

examples/authors/sqlite/query.sql

@@ -6,6 +6,10 @@ WHERE id = ? LIMIT 1;
 SELECT * FROM authors
 ORDER BY name;
 
+/* name: IterAuthors :iter */
+SELECT * FROM authors
+ORDER BY name;
+
 /* name: CreateAuthor :execresult */
 INSERT INTO authors (
   name, bio

examples/booktest/mysql/db_test.go

@@ -5,6 +5,7 @@ package booktest
 import (
 	"context"
 	"database/sql"
+	"slices"
 	"testing"
 	"time"
 
@@ -150,6 +151,25 @@ func TestBooks(t *testing.T) {
 		t.Logf("Book %d author: %s\n", book.BookID, author.Name)
 	}
 
+	// retrieve first book
+	rows := dq.IterBooksByTitleYear(ctx, IterBooksByTitleYearParams{
+		Title: "my book title",
+		Yr:    2016,
+	})
+
+	// We need to collect the iterator elements to avoid panic when we make other db queries in the loop.
+	for _, book := range slices.Collect(rows.Iterate()) {
+		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)
+	}
+	if err = rows.Err(); err != nil {
+		t.Fatal(err)
+	}
+
 	// find a book with either "cool" or "other" tag
 	t.Logf("---------\nTag search results:\n")
 	res, err := dq.BooksByTags(ctx, "cool")

examples/booktest/mysql/query.sql

@@ -14,6 +14,10 @@ WHERE book_id = ?;
 SELECT * FROM books
 WHERE title = ? AND yr = ?;
 
+/* name: IterBooksByTitleYear :iter */
+SELECT * FROM books
+WHERE title = ? AND yr = ?;
+
 /* name: BooksByTags :many */
 SELECT
   book_id,