sqlc-dev · aimestereo · Sep 16, 2026
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -15,7 +15,7 @@ jobs:
         go-version: '1.23.5'
     - uses: sqlc-dev/setup-sqlc@v4
       with:
-        sqlc-version: '1.28.0'
+        sqlc-version: '1.30.0'
     - run: make
     - run: make test
     - run: sqlc diff

diff --git a/README.md b/README.md
@@ -76,3 +76,9 @@ class Status(str, enum.Enum):
     OPEN = "op!en"
     CLOSED = "clo@sed"
 ```
+
+### Omit unused table and enum structs
+
+Option: `omit_unused_structs`
+
+If `true`, sqlc won't generate table and enum structs that aren't used in queries for a given package.
diff --git a/examples/src/authors/models.py b/examples/src/authors/models.py
@@ -1,6 +1,6 @@
 # Code generated by sqlc. DO NOT EDIT.
 # versions:
-#   sqlc v1.28.0
+#   sqlc v1.30.0
 import dataclasses
 from typing import Optional
 

diff --git a/examples/src/authors/query.py b/examples/src/authors/query.py
@@ -1,6 +1,6 @@
 # Code generated by sqlc. DO NOT EDIT.
 # versions:
-#   sqlc v1.28.0
+#   sqlc v1.30.0
 # source: query.sql
 from typing import AsyncIterator, Iterator, Optional
 

diff --git a/examples/src/booktest/models.py b/examples/src/booktest/models.py
@@ -1,6 +1,6 @@
 # Code generated by sqlc. DO NOT EDIT.
 # versions:
-#   sqlc v1.28.0
+#   sqlc v1.30.0
 import dataclasses
 import datetime
 import enum

diff --git a/examples/src/booktest/query.py b/examples/src/booktest/query.py
@@ -1,6 +1,6 @@
 # Code generated by sqlc. DO NOT EDIT.
 # versions:
-#   sqlc v1.28.0
+#   sqlc v1.30.0
 # source: query.sql
 import dataclasses
 import datetime

diff --git a/examples/src/jets/models.py b/examples/src/jets/models.py
@@ -1,6 +1,6 @@
 # Code generated by sqlc. DO NOT EDIT.
 # versions:
-#   sqlc v1.28.0
+#   sqlc v1.30.0
 import dataclasses
 
 

diff --git a/examples/src/jets/query-building.py b/examples/src/jets/query-building.py
@@ -1,6 +1,6 @@
 # Code generated by sqlc. DO NOT EDIT.
 # versions:
-#   sqlc v1.28.0
+#   sqlc v1.30.0
 # source: query-building.sql
 from typing import AsyncIterator, Optional
 

diff --git a/examples/src/ondeck/city.py b/examples/src/ondeck/city.py
@@ -1,6 +1,6 @@
 # Code generated by sqlc. DO NOT EDIT.
 # versions:
-#   sqlc v1.28.0
+#   sqlc v1.30.0
 # source: city.sql
 from typing import AsyncIterator, Optional
 

diff --git a/examples/src/ondeck/models.py b/examples/src/ondeck/models.py
@@ -1,6 +1,6 @@
 # Code generated by sqlc. DO NOT EDIT.
 # versions:
-#   sqlc v1.28.0
+#   sqlc v1.30.0
 import dataclasses
 import datetime
 import enum

diff --git a/examples/src/ondeck/venue.py b/examples/src/ondeck/venue.py
@@ -1,6 +1,6 @@
 # Code generated by sqlc. DO NOT EDIT.
 # versions:
-#   sqlc v1.28.0
+#   sqlc v1.30.0
 # source: venue.sql
 import dataclasses
 from typing import AsyncIterator, List, Optional

diff --git a/internal/config.go b/internal/config.go
@@ -8,6 +8,7 @@ type Config struct {
 	Out                         string   `json:"out"`
 	EmitPydanticModels          bool     `json:"emit_pydantic_models"`
 	EmitStrEnum                 bool     `json:"emit_str_enum"`
+	OmitUnusedStructs           bool     `json:"omit_unused_structs,omitempty"`
 	QueryParameterLimit         *int32   `json:"query_parameter_limit"`
 	InflectionExcludeTableNames []string `json:"inflection_exclude_table_names"`
 }
diff --git a/internal/endtoend/testdata/emit_pydantic_models/db/models.py b/internal/endtoend/testdata/emit_pydantic_models/db/models.py
@@ -1,6 +1,6 @@
 # Code generated by sqlc. DO NOT EDIT.
 # versions:
-#   sqlc v1.28.0
+#   sqlc v1.30.0
 import pydantic
 from typing import Optional
 

diff --git a/internal/endtoend/testdata/emit_pydantic_models/db/query.py b/internal/endtoend/testdata/emit_pydantic_models/db/query.py
@@ -1,6 +1,6 @@
 # Code generated by sqlc. DO NOT EDIT.
 # versions:
-#   sqlc v1.28.0
+#   sqlc v1.30.0
 # source: query.sql
 from typing import AsyncIterator, Iterator, Optional
 

diff --git a/internal/endtoend/testdata/emit_pydantic_models/sqlc.yaml b/internal/endtoend/testdata/emit_pydantic_models/sqlc.yaml
@@ -3,7 +3,7 @@ plugins:
 - name: py
   wasm:
     url: file://../../../../bin/sqlc-gen-python.wasm
-    sha256: "d6846ffad948181e611e883cedd2d2be66e091edc1273a0abc6c9da18399e0ca"
+    sha256: "35db40d0d3e1f8e62575e9954f2f83f29b65bb01ac245703899c672fd5dec208"
 sql:
 - schema: schema.sql
   queries: query.sql

diff --git a/internal/endtoend/testdata/emit_str_enum/db/models.py b/internal/endtoend/testdata/emit_str_enum/db/models.py
@@ -1,6 +1,6 @@
 # Code generated by sqlc. DO NOT EDIT.
 # versions:
-#   sqlc v1.28.0
+#   sqlc v1.30.0
 import dataclasses
 import enum
 from typing import Optional

diff --git a/internal/endtoend/testdata/emit_str_enum/db/query.py b/internal/endtoend/testdata/emit_str_enum/db/query.py
@@ -1,6 +1,6 @@
 # Code generated by sqlc. DO NOT EDIT.
 # versions:
-#   sqlc v1.28.0
+#   sqlc v1.30.0
 # source: query.sql
 from typing import AsyncIterator, Iterator, Optional
 

diff --git a/internal/endtoend/testdata/emit_str_enum/sqlc.yaml b/internal/endtoend/testdata/emit_str_enum/sqlc.yaml
@@ -3,7 +3,7 @@ plugins:
   - name: py
     wasm:
       url: file://../../../../bin/sqlc-gen-python.wasm
-      sha256: "d6846ffad948181e611e883cedd2d2be66e091edc1273a0abc6c9da18399e0ca"
+      sha256: "35db40d0d3e1f8e62575e9954f2f83f29b65bb01ac245703899c672fd5dec208"
 sql:
   - schema: schema.sql
     queries: query.sql

diff --git a/internal/endtoend/testdata/exec_result/python/models.py b/internal/endtoend/testdata/exec_result/python/models.py
@@ -1,6 +1,6 @@
 # Code generated by sqlc. DO NOT EDIT.
 # versions:
-#   sqlc v1.28.0
+#   sqlc v1.30.0
 import dataclasses
 
 

diff --git a/internal/endtoend/testdata/exec_result/python/query.py b/internal/endtoend/testdata/exec_result/python/query.py
@@ -1,6 +1,6 @@
 # Code generated by sqlc. DO NOT EDIT.
 # versions:
-#   sqlc v1.28.0
+#   sqlc v1.30.0
 # source: query.sql
 import sqlalchemy
 import sqlalchemy.ext.asyncio

diff --git a/internal/endtoend/testdata/exec_result/sqlc.yaml b/internal/endtoend/testdata/exec_result/sqlc.yaml
@@ -3,7 +3,7 @@ plugins:
 - name: py
   wasm:
     url: file://../../../../bin/sqlc-gen-python.wasm
-    sha256: "d6846ffad948181e611e883cedd2d2be66e091edc1273a0abc6c9da18399e0ca"
+    sha256: "35db40d0d3e1f8e62575e9954f2f83f29b65bb01ac245703899c672fd5dec208"
 sql:
 - schema: schema.sql
   queries: query.sql

diff --git a/internal/endtoend/testdata/exec_rows/python/models.py b/internal/endtoend/testdata/exec_rows/python/models.py
@@ -1,6 +1,6 @@
 # Code generated by sqlc. DO NOT EDIT.
 # versions:
-#   sqlc v1.28.0
+#   sqlc v1.30.0
 import dataclasses
 
 

diff --git a/internal/endtoend/testdata/exec_rows/python/query.py b/internal/endtoend/testdata/exec_rows/python/query.py
@@ -1,6 +1,6 @@
 # Code generated by sqlc. DO NOT EDIT.
 # versions:
-#   sqlc v1.28.0
+#   sqlc v1.30.0
 # source: query.sql
 import sqlalchemy
 import sqlalchemy.ext.asyncio

diff --git a/internal/endtoend/testdata/exec_rows/sqlc.yaml b/internal/endtoend/testdata/exec_rows/sqlc.yaml
@@ -3,7 +3,7 @@ plugins:
 - name: py
   wasm:
     url: file://../../../../bin/sqlc-gen-python.wasm
-    sha256: "d6846ffad948181e611e883cedd2d2be66e091edc1273a0abc6c9da18399e0ca"
+    sha256: "35db40d0d3e1f8e62575e9954f2f83f29b65bb01ac245703899c672fd5dec208"
 sql:
 - schema: schema.sql
   queries: query.sql

diff --git a/internal/endtoend/testdata/inflection_exclude_table_names/python/models.py b/internal/endtoend/testdata/inflection_exclude_table_names/python/models.py
@@ -1,6 +1,6 @@
 # Code generated by sqlc. DO NOT EDIT.
 # versions:
-#   sqlc v1.28.0
+#   sqlc v1.30.0
 import dataclasses
 
 

diff --git a/internal/endtoend/testdata/inflection_exclude_table_names/python/query.py b/internal/endtoend/testdata/inflection_exclude_table_names/python/query.py
@@ -1,6 +1,6 @@
 # Code generated by sqlc. DO NOT EDIT.
 # versions:
-#   sqlc v1.28.0
+#   sqlc v1.30.0
 # source: query.sql
 from typing import Optional
 

diff --git a/internal/endtoend/testdata/inflection_exclude_table_names/sqlc.yaml b/internal/endtoend/testdata/inflection_exclude_table_names/sqlc.yaml
@@ -3,7 +3,7 @@ plugins:
 - name: py
   wasm:
     url: file://../../../../bin/sqlc-gen-python.wasm
-    sha256: "d6846ffad948181e611e883cedd2d2be66e091edc1273a0abc6c9da18399e0ca"
+    sha256: "35db40d0d3e1f8e62575e9954f2f83f29b65bb01ac245703899c672fd5dec208"
 sql:
 - schema: schema.sql
   queries: query.sql

diff --git a/internal/endtoend/testdata/omit_unused_structs/db/models.py b/internal/endtoend/testdata/omit_unused_structs/db/models.py
@@ -0,0 +1,66 @@
+# Code generated by sqlc. DO NOT EDIT.
+# versions:
+#   sqlc v1.30.0
+import dataclasses
+import enum
+from typing import List, Optional
+
+
+class ArrayEnum(enum.StrEnum):
+    O = "o"
+    P = "p"
+
+
+class QueryParamEnumTableEnum(enum.StrEnum):
+    G = "g"
+    H = "h"
+
+
+class QueryParamStructEnumTableEnum(enum.StrEnum):
+    I = "i"
+    J = "j"
+
+
+class QueryReturnEnumTableEnum(enum.StrEnum):
+    K = "k"
+    L = "l"
+
+
+class QueryReturnFullTableEnum(enum.StrEnum):
+    E = "e"
+    F = "f"
+
+
+class QueryReturnStructEnumTableEnum(enum.StrEnum):
+    K = "k"
+    L = "l"
+
+
+class QuerySqlcEmbedEnum(enum.StrEnum):
+    M = "m"
+    N = "n"
+
+
+@dataclasses.dataclass()
+class ArrayEnumTable:
+    id: int
+    value: Optional[List[ArrayEnum]]
+
+
+@dataclasses.dataclass()
+class QueryParamEnumTable:
+    id: int
+    other: QueryParamEnumTableEnum
+    value: Optional[QueryParamEnumTableEnum]
+
+
+@dataclasses.dataclass()
+class QueryReturnFullTable:
+    id: int
+    value: Optional[QueryReturnFullTableEnum]
+
+
+@dataclasses.dataclass()
+class QuerySqlcEmbedTable:
+    id: int
+    value: Optional[QuerySqlcEmbedEnum]