Merge branch 'sqlc-dev:main' into engine-plugin

Author: asmyasnikov

.github/workflows/buf.yml

@@ -8,6 +8,6 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
       - uses: bufbuild/buf-setup-action@v1
       - uses: bufbuild/buf-lint-action@v1

.github/workflows/build.yml

@@ -9,7 +9,7 @@ jobs:
     name: build ${{ matrix.os }}
     runs-on: ${{ matrix.os }}
     steps:
-    - uses: actions/checkout@v6
+    - uses: actions/checkout@v7
     - uses: actions/setup-go@v6
       with:
         go-version: '1.26.4'

.github/workflows/ci-kotlin.yml

@@ -16,13 +16,13 @@ jobs:
     name: test
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
       - uses: actions/setup-go@v6
         with:
           go-version: '1.26.4'
       - name: install ./...
         run: go install ./...
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
         with:
           repository: sqlc-dev/sqlc-gen-kotlin
           path: kotlin

.github/workflows/ci-python.yml

@@ -16,13 +16,13 @@ jobs:
     name: test
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
       - uses: actions/setup-go@v6
         with:
           go-version: '1.26.4'
       - name: install ./...
         run: go install ./...
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
         with:
           repository: sqlc-dev/sqlc-gen-python
           path: python

.github/workflows/ci-typescript.yml

@@ -16,13 +16,13 @@ jobs:
     name: test
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
       - uses: actions/setup-go@v6
         with:
           go-version: '1.26.4'
       - name: install ./...
         run: go install ./...
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
         with:
           repository: sqlc-dev/sqlc-gen-typescript
           path: typescript

.github/workflows/ci.yml

@@ -13,7 +13,7 @@ jobs:
     name: build ${{ matrix.goos }}/${{ matrix.goarch }}
     runs-on: ubuntu-24.04
     steps:
-    - uses: actions/checkout@v6
+    - uses: actions/checkout@v7
     - uses: actions/setup-go@v6
       with:
         go-version: '1.26.4'
@@ -25,7 +25,7 @@ jobs:
   test:
     runs-on: ubuntu-24.04
     steps:
-    - uses: actions/checkout@v6
+    - uses: actions/checkout@v7
     - uses: actions/setup-go@v6
       with:
         go-version: '1.26.4'

.github/workflows/gen.yml

@@ -17,7 +17,7 @@ jobs:
         # needed because the postgres container does not provide a healthcheck
         options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 5
     steps:
-    - uses: actions/checkout@v6
+    - uses: actions/checkout@v7
     - uses: actions/setup-go@v6
       with:
         go-version-file: go.mod

Dockerfile

@@ -1,5 +1,5 @@
 # STEP 1: Build sqlc
-FROM golang:1.26.4 AS builder
+FROM golang:1.26.5 AS builder
 
 COPY . /workspace
 WORKDIR /workspace

docs/howto/analyze.md

@@ -0,0 +1,97 @@
+# `analyze` - Analyzing query result types
+
+`sqlc analyze` analyzes a query against a schema and prints the inferred result
+columns and parameters as a single JSON document.
+
+Unlike [`generate`](generate.md), this command does not require a configuration
+file and does not connect to a database. It uses sqlc's native static analysis
+to infer types directly from the provided schema.
+
+## Usage
+
+```sh
+sqlc analyze --dialect <dialect> --schema <schema-file> [query-file]
+```
+
+The query is read from the given file, or from standard input when no file is
+provided. The schema is always read from the `--schema` file.
+
+## Flags
+
+- `--dialect`, `-d` - The SQL dialect to use. One of `postgresql`, `mysql`, or
+  `sqlite`. Required.
+- `--schema`, `-s` - Path to the schema (DDL) file. Required.
+- `--ast` - Include each statement's AST in the output. Defaults to `false`.
+
+## Examples
+
+Given a schema in `schema.sql`:
+
+```sql
+CREATE TABLE authors (
+  id   BIGSERIAL PRIMARY KEY,
+  name text      NOT NULL,
+  bio  text
+);
+```
+
+and a query in `query.sql`:
+
+```sql
+-- name: GetAuthor :one
+SELECT * FROM authors WHERE id = $1;
+```
+
+Running:
+
+```sh
+sqlc analyze --dialect postgresql --schema schema.sql query.sql
+```
+
+reports the result columns and parameters:
+
+```json
+[
+  {
+    "name": "GetAuthor",
+    "cmd": ":one",
+    "columns": [
+      {
+        "name": "id",
+        "data_type": "bigserial",
+        "not_null": true,
+        "is_array": false,
+        "table": "authors"
+      },
+      {
+        "name": "name",
+        "data_type": "text",
+        "not_null": true,
+        "is_array": false,
+        "table": "authors"
+      },
+      {
+        "name": "bio",
+        "data_type": "text",
+        "not_null": false,
+        "is_array": false,
+        "table": "authors"
+      }
+    ],
+    "params": [
+      {
+        "number": 1,
+        "column": {
+          "name": "id",
+          "data_type": "bigserial",
+          "not_null": true,
+          "is_array": false,
+          "table": "authors"
+        }
+      }
+    ]
+  }
+]
+```
+
+Pass `--ast` to also include each statement's parsed AST under an `ast` key.

docs/howto/parse.md

@@ -0,0 +1,58 @@
+# `parse` - Parsing SQL into an AST
+
+`sqlc parse` parses SQL from a file or standard input and prints the abstract
+syntax tree (AST) as a single JSON document. It does not require a configuration
+file or a database connection.
+
+Each statement is reported with its sqlc query name and command (when the
+statement carries a [`-- name:`](../reference/query-annotations.md) annotation)
+alongside its AST.
+
+## Usage
+
+```sh
+sqlc parse --dialect <dialect> [file]
+```
+
+The SQL is read from the given file, or from standard input when no file is
+provided.
+
+## Flags
+
+- `--dialect`, `-d` - The SQL dialect to use. One of `postgresql`, `mysql`,
+  `sqlite`, or `clickhouse`. Required.
+
+## Examples
+
+Parse a query file:
+
+```sh
+sqlc parse --dialect postgresql query.sql
+```
+
+Parse SQL piped via standard input:
+
+```sh
+echo "SELECT 1;" | sqlc parse --dialect mysql
+```
+
+The output is a JSON array with one object per statement:
+
+```json
+[
+  {
+    "name": "GetAuthor",
+    "cmd": ":one",
+    "ast": {
+      "Stmt": {
+        "...": "..."
+      },
+      "StmtLocation": 0,
+      "StmtLen": 42
+    }
+  }
+]
+```
+
+Statements without a `-- name:` annotation (for example schema DDL) omit the
+`name` and `cmd` fields.