dirsql 0.4.24__tar.gz → 0.4.26__tar.gz

{dirsql-0.4.24 → dirsql-0.4.26}/Cargo.lock

@@ -499,7 +499,7 @@ dependencies = [
 
 [[package]]
 name = "dirsql-py-ext"
-version = "0.4.24"
+version = "0.4.26"
 dependencies = [
  "dirsql",
  "pyo3",

{dirsql-0.4.24 → dirsql-0.4.26}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dirsql
-Version: 0.4.24
+Version: 0.4.26
 Requires-Dist: tomli>=2 ; python_full_version < '3.11'
 Requires-Dist: bin-shim>=0.1
 Summary: Ephemeral SQL index over a local directory

{dirsql-0.4.24 → dirsql-0.4.26}/dirsql/_dirsql.pyi

@@ -30,6 +30,7 @@ class ExtensionSpec(TypedDict):
 class Table:
     """A table definition. Construct via keyword arguments only."""
 
+    name: str
     ddl: str
     glob: str
     strict: bool
@@ -37,6 +38,7 @@ class Table:
     def __init__(
         self,
         *,
+        name: str,
         ddl: str,
         glob: str,
         on_file: Callable[[str], list[Row]],

{dirsql-0.4.24 → dirsql-0.4.26}/docs/getting-started.md

@@ -164,6 +164,7 @@ Now create a `.dirsql.toml` that points a table at it:
 ```bash
 cat > .dirsql.toml <<'EOF'
 [[table]]
+name = "notes"
 ddl     = "CREATE TABLE notes (title TEXT, author TEXT)"
 glob    = "notes/**/*.md"
 on-file = "sh note.sh {path}"

{dirsql-0.4.24 → dirsql-0.4.26}/docs/howto/columns-from-paths.md

@@ -33,6 +33,7 @@ Point a table at it in `.dirsql.toml`:
 
 ```toml
 [[table]]
+name = "photos"
 ddl     = "CREATE TABLE photos (year TEXT, month TEXT, basename TEXT)"
 glob    = "photos/*/*/*.jpg"
 on-file = "python3 pathcols.py {path}"

{dirsql-0.4.24/packages/python → dirsql-0.4.26}/docs/howto/define-tables.md

@@ -26,6 +26,7 @@ Then declare the table in `.dirsql.toml`:
 
 ```toml
 [[table]]
+name = "posts"
 ddl     = "CREATE TABLE posts (title TEXT, slug TEXT)"
 glob    = "posts/**/*.md"
 on-file = "python3 extract.py {path}"

{dirsql-0.4.24/packages/python → dirsql-0.4.26}/docs/howto/embed.md

@@ -60,6 +60,7 @@ async def main() -> None:
         "./comments-root",
         tables=[
             Table(
+                name="comments",
                 ddl="CREATE TABLE comments (thread TEXT, author TEXT, body TEXT)",
                 glob="comments/*/*.json",
                 on_file=on_file,
@@ -83,6 +84,7 @@ const db = new DirSQL({
   root: "./comments-root",
   tables: [
     {
+      name: "comments",
       ddl: "CREATE TABLE comments (thread TEXT, author TEXT, body TEXT)",
       glob: "comments/*/*.json",
       onFile: (path) => [
@@ -129,6 +131,7 @@ fn main() -> Result<(), Box<dyn std::error::Error>> {
     let db = DirSQL::builder()
         .root("./comments-root")
         .table(Table::new(
+            "comments",
             "CREATE TABLE comments (thread TEXT, author TEXT, body TEXT)",
             "comments/*/*.json",
             on_file,

{dirsql-0.4.24/packages/rust → dirsql-0.4.26}/docs/howto/extract-from-contents.md

@@ -18,6 +18,7 @@ stdout works. With [`jq`](https://jqlang.org/):
 
 ```toml
 [[table]]
+name = "books"
 ddl     = "CREATE TABLE books (title TEXT, author TEXT, year INTEGER)"
 glob    = "books/*.json"
 on-file = "jq -c '[{title, author, year}]' {path}"
@@ -53,6 +54,7 @@ row per line, slurp it:
 
 ```toml
 [[table]]
+name = "events"
 ddl     = "CREATE TABLE events (event TEXT, user TEXT)"
 glob    = "logs/*.jsonl"
 on-file = "jq -c -s '.' {path}"

{dirsql-0.4.24 → dirsql-0.4.26}/docs/howto/parse-files-into-columns.md

@@ -84,6 +84,7 @@ command in verbatim:
 
 ```toml
 [[table]]
+name = "posts"
 ddl     = "CREATE TABLE posts (title TEXT, author TEXT)"
 glob    = "posts/*.md"
 on-file = "python3 extract.py {path}"

{dirsql-0.4.24/packages/python → dirsql-0.4.26}/docs/howto/react-to-changes.md

@@ -14,6 +14,7 @@ prints each file's basename:
 ```toml
 # .dirsql.toml
 [[table]]
+name = "files"
 ddl     = "CREATE TABLE files (basename TEXT)"
 glob    = "**/*"
 on-file = '''sh -c 'printf "[{\"basename\":\"%s\"}]" "${1##*/}"' sh {path}'''

{dirsql-0.4.24 → dirsql-0.4.26}/docs/howto/skip-files.md

@@ -22,6 +22,7 @@ Exclude the noise in `.dirsql.toml`:
 ignore = ["notes/drafts/**", "**/*.tmp"]
 
 [[table]]
+name = "notes"
 ddl     = "CREATE TABLE notes (basename TEXT)"
 glob    = "notes/**/*"
 on-file = '''sh -c 'printf "[{\"basename\":\"%s\"}]" "${1##*/}"' sh {path}'''

{dirsql-0.4.24/packages/rust → dirsql-0.4.26}/docs/howto/write-a-plugin.md

@@ -108,6 +108,7 @@ path       = "sqlite_vec"
 entrypoint = "sqlite3_vec_init"
 
 [[table]]
+name = "notes"
 ddl     = "CREATE TABLE notes (path TEXT, text TEXT, embedding TEXT)"
 glob    = "notes/*.md"
 on-file = "uv run --with model2vec python embed.py {path} {root}"

{dirsql-0.4.24/packages/rust → dirsql-0.4.26}/docs/index.md

@@ -34,6 +34,7 @@ db = DirSQL(
     "./my-project",
     tables=[
         Table(
+            name="records",
             ddl="CREATE TABLE records (name TEXT, size INTEGER, type TEXT)",
             glob="data/*.json",
             on_file=lambda path: [json.loads(open(path, encoding="utf-8").read())],
@@ -52,6 +53,7 @@ let db = DirSQL::new(
     "./my-project",
     vec![
         Table::new(
+            "records",
             "CREATE TABLE records (name TEXT, size INTEGER, type TEXT)",
             "data/*.json",
             |path| vec![serde_json::from_str(&std::fs::read_to_string(path).unwrap()).unwrap()],
@@ -70,6 +72,7 @@ const db = new DirSQL({
   root: './my-project',
   tables: [
     new Table({
+      name: 'records',
       ddl: 'CREATE TABLE records (name TEXT, size INTEGER, type TEXT)',
       glob: 'data/*.json',
       onFile: (path) => [JSON.parse(readFileSync(path, 'utf8'))],

{dirsql-0.4.24/packages/rust → dirsql-0.4.26}/docs/reference/config.md

@@ -166,7 +166,8 @@ what its required `on-file` command emits — dirsql injects nothing (see
 
 | Key | Required | Description |
 |---|---|---|
-| `ddl` | yes | A SQLite `CREATE TABLE` statement. The table name is parsed from it. Only the columns declared here are kept; keys the `on-file` command emits that are not declared are dropped. |
+| `name` | yes | The table's SQL name — the name you query it by. Declared, never derived from `ddl`: dirsql does not read the DDL text. The `ddl` must create a table by this name; if it doesn't, loading fails. |
+| `ddl` | yes | A SQLite `CREATE TABLE` statement, run verbatim. Only the columns declared here are kept; keys the `on-file` command emits that are not declared are dropped. |
 | `glob` | yes | Glob pattern matched against root-relative paths. Every table whose glob matches a file receives that file's rows — a file can populate multiple tables. A `{name}` segment is rewritten to `*` (it matches one path segment but captures nothing). |
 | `on-file` | **yes** | A command run once per matched file; its stdout (a JSON array of row objects) becomes the file's rows. Must be non-empty. A `[[table]]` with no `on-file` is a load error (see [parse errors](#parse-errors)). See [Command hooks](./hooks.md#on-file). |
 | `strict` | no (default `false`) | When `true`, rows whose keys do not exactly match the declared columns are rejected with an error: extra keys error, and every declared column must be supplied by the `on-file` output. When `false`, extra keys are dropped and missing columns become `NULL`. |
@@ -180,11 +181,13 @@ instead of declaring a table.
 
 ```toml
 [[table]]
+name = "comments"
 ddl     = "CREATE TABLE comments (path TEXT, author TEXT, body TEXT)"
 glob    = "_comments/*/*.jsonl"
 on-file = "jq -c -s '.' {path}"
 
 [[table]]
+name = "papers"
 ddl     = "CREATE TABLE papers (paper_id TEXT, title TEXT)"
 glob    = "**/meta.json"
 on-file = "uv run python extract_papers.py {path}"
@@ -241,7 +244,16 @@ SDKs raise/reject) when:
 - The TOML is malformed.
 - Any table contains an unknown key (top level, `[dirsql]`, `[[table]]`, or
   `[[dirsql.extension]]`). The error names the offending key.
-- A `[[table]]` entry omits `ddl` or `glob`.
+- A `[[table]]` entry omits `name`, `ddl`, or `glob` (or `name` is
+  empty/whitespace).
+- A `[[table]]` entry's `ddl` runs but creates no table by its `name`. The
+  error carries the entry's name and points at the fix:
+
+  > `table 'messages': its `ddl` ran but created no table called 'messages'. Set `name` to the table the `ddl` creates.`
+
+  dirsql asks SQLite's catalog rather than interpreting the DDL, so quoted
+  (`CREATE TABLE "messages"`), schema-qualified (`main.messages`) and
+  `IF NOT EXISTS` forms all match a plain `name = "messages"`.
 - A `[[table]]` entry omits `on-file` (or it is empty/whitespace). The error
   names the offending glob and points at the fix:
 
@@ -275,11 +287,13 @@ deterministic = true
 timeout       = "600s"
 
 [[table]]
+name = "comments"
 ddl     = "CREATE TABLE comments (author TEXT, body TEXT)"
 glob    = "_comments/*/*.jsonl"
 on-file = "jq -c -s '.' {path}"
 
 [[table]]
+name = "documents"
 ddl     = "CREATE TABLE documents (title TEXT, summary TEXT)"
 glob    = "**/index.md"
 on-file = "uv run python extract_doc.py {path}"

{dirsql-0.4.24 → dirsql-0.4.26}/docs/reference/sdk.md

@@ -317,27 +317,30 @@ rather than waiting — an intentional, language-idiomatic difference.
 ::: code-group
 
 ```python [Python]
-Table(*, ddl: str, glob: str, on_file: Callable[[str], list[dict]], strict: bool = False)
+Table(*, name: str, ddl: str, glob: str, on_file: Callable[[str], list[dict]], strict: bool = False)
 ```
 
 ```typescript [TypeScript]
-new Table({ ddl, glob, onFile, strict? })
+new Table({ name, ddl, glob, onFile, strict? })
 // or a plain object — TableDef and Table are interchangeable:
-{ ddl: string, glob: string, onFile: (path: string) => Record<string, unknown>[], strict?: boolean }
+{ name: string, ddl: string, glob: string, onFile: (path: string) => Record<string, unknown>[], strict?: boolean }
 ```
 
 ```rust [Rust]
-Table::new(ddl, glob, on_file)      // on_file: Fn(&str) -> Vec<Row>, infallible
-Table::try_new(ddl, glob, on_file)  // on_file: Fn(&str) -> Result<Vec<Row>, _>
-Table::strict(ddl, glob, on_file)   // Table::new with strict = true
+Table::new(name, ddl, glob, on_file)      // on_file: Fn(&str) -> Vec<Row>, infallible
+Table::try_new(name, ddl, glob, on_file)  // on_file: Fn(&str) -> Result<Vec<Row>, _>
+Table::strict(name, ddl, glob, on_file)   // Table::new with strict = true
 ```
 
 :::
 
 Maps files to table rows.
 
-- `ddl` — A SQLite `CREATE TABLE` statement; the table name is parsed from
-  it. Table names must be unique across all tables.
+- `name` — The table's SQL name, declared rather than derived from `ddl`.
+  Must be unique across all tables. Building fails if the `ddl` creates no
+  table by this name (checked against SQLite's catalog, before any file is
+  indexed).
+- `ddl` — A SQLite `CREATE TABLE` statement, run verbatim.
 - `glob` — Glob pattern matched against root-relative paths. Every table whose
   glob matches a file receives that file's rows — a file can populate multiple
   tables. A `{name}` segment is rewritten to `*` (it matches one path segment

{dirsql-0.4.24 → dirsql-0.4.26}/packages/python/Cargo.toml

@@ -4,7 +4,7 @@ name = "dirsql-py-ext"
 # pypi/maturin handler can rewrite it via `write-version` before
 # `maturin build`. `pyproject.toml` declares `dynamic = ["version"]`
 # and maturin reads this field. Mirrors `packages/rust/Cargo.toml`.
-version = "0.4.24"
+version = "0.4.26"
 # abi3 note: the `abi3-py310` pyo3 feature (below) builds ONE stable-ABI
 # `cp310-abi3` wheel per platform that loads on every CPython >= 3.10
 # (matching `pyproject.toml`'s `requires-python = ">=3.10"`), instead of

dirsql-0.4.26/packages/python/changelog.d/2026-08-20-declared-table-name.md

@@ -0,0 +1,3 @@
+**Changed**
+
+- **A table's name is now declared, not derived from `ddl`.** `Table` takes a required keyword-only `name` (`Table(name=..., ddl=..., glob=..., on_file=...)`), and a `[[table]]` entry in a `.dirsql.toml` requires a `name` key. The core no longer parses the DDL text to find the name; a `name` its `ddl` does not create fails at load with an error naming the entry. `Table.name` is now the declared `str` rather than an `Optional[str]` parsed from the DDL. (#962)

{dirsql-0.4.24/packages/rust → dirsql-0.4.26/packages/python}/docs/getting-started.md

@@ -164,6 +164,7 @@ Now create a `.dirsql.toml` that points a table at it:
 ```bash
 cat > .dirsql.toml <<'EOF'
 [[table]]
+name = "notes"
 ddl     = "CREATE TABLE notes (title TEXT, author TEXT)"
 glob    = "notes/**/*.md"
 on-file = "sh note.sh {path}"

{dirsql-0.4.24/packages/rust → dirsql-0.4.26/packages/python}/docs/howto/columns-from-paths.md

@@ -33,6 +33,7 @@ Point a table at it in `.dirsql.toml`:
 
 ```toml
 [[table]]
+name = "photos"
 ddl     = "CREATE TABLE photos (year TEXT, month TEXT, basename TEXT)"
 glob    = "photos/*/*/*.jpg"
 on-file = "python3 pathcols.py {path}"

{dirsql-0.4.24 → dirsql-0.4.26/packages/python}/docs/howto/define-tables.md

@@ -26,6 +26,7 @@ Then declare the table in `.dirsql.toml`:
 
 ```toml
 [[table]]
+name = "posts"
 ddl     = "CREATE TABLE posts (title TEXT, slug TEXT)"
 glob    = "posts/**/*.md"
 on-file = "python3 extract.py {path}"

{dirsql-0.4.24 → dirsql-0.4.26/packages/python}/docs/howto/embed.md

@@ -60,6 +60,7 @@ async def main() -> None:
         "./comments-root",
         tables=[
             Table(
+                name="comments",
                 ddl="CREATE TABLE comments (thread TEXT, author TEXT, body TEXT)",
                 glob="comments/*/*.json",
                 on_file=on_file,
@@ -83,6 +84,7 @@ const db = new DirSQL({
   root: "./comments-root",
   tables: [
     {
+      name: "comments",
       ddl: "CREATE TABLE comments (thread TEXT, author TEXT, body TEXT)",
       glob: "comments/*/*.json",
       onFile: (path) => [
@@ -129,6 +131,7 @@ fn main() -> Result<(), Box<dyn std::error::Error>> {
     let db = DirSQL::builder()
         .root("./comments-root")
         .table(Table::new(
+            "comments",
             "CREATE TABLE comments (thread TEXT, author TEXT, body TEXT)",
             "comments/*/*.json",
             on_file,

{dirsql-0.4.24 → dirsql-0.4.26}/packages/python/docs/howto/extract-from-contents.md

@@ -18,6 +18,7 @@ stdout works. With [`jq`](https://jqlang.org/):
 
 ```toml
 [[table]]
+name = "books"
 ddl     = "CREATE TABLE books (title TEXT, author TEXT, year INTEGER)"
 glob    = "books/*.json"
 on-file = "jq -c '[{title, author, year}]' {path}"
@@ -53,6 +54,7 @@ row per line, slurp it:
 
 ```toml
 [[table]]
+name = "events"
 ddl     = "CREATE TABLE events (event TEXT, user TEXT)"
 glob    = "logs/*.jsonl"
 on-file = "jq -c -s '.' {path}"

{dirsql-0.4.24/packages/rust → dirsql-0.4.26/packages/python}/docs/howto/parse-files-into-columns.md

@@ -84,6 +84,7 @@ command in verbatim:
 
 ```toml
 [[table]]
+name = "posts"
 ddl     = "CREATE TABLE posts (title TEXT, author TEXT)"
 glob    = "posts/*.md"
 on-file = "python3 extract.py {path}"

{dirsql-0.4.24/packages/rust → dirsql-0.4.26/packages/python}/docs/howto/react-to-changes.md

@@ -14,6 +14,7 @@ prints each file's basename:
 ```toml
 # .dirsql.toml
 [[table]]
+name = "files"
 ddl     = "CREATE TABLE files (basename TEXT)"
 glob    = "**/*"
 on-file = '''sh -c 'printf "[{\"basename\":\"%s\"}]" "${1##*/}"' sh {path}'''

{dirsql-0.4.24/packages/rust → dirsql-0.4.26/packages/python}/docs/howto/skip-files.md

@@ -22,6 +22,7 @@ Exclude the noise in `.dirsql.toml`:
 ignore = ["notes/drafts/**", "**/*.tmp"]
 
 [[table]]
+name = "notes"
 ddl     = "CREATE TABLE notes (basename TEXT)"
 glob    = "notes/**/*"
 on-file = '''sh -c 'printf "[{\"basename\":\"%s\"}]" "${1##*/}"' sh {path}'''

{dirsql-0.4.24 → dirsql-0.4.26}/packages/python/docs/howto/write-a-plugin.md

@@ -108,6 +108,7 @@ path       = "sqlite_vec"
 entrypoint = "sqlite3_vec_init"
 
 [[table]]
+name = "notes"
 ddl     = "CREATE TABLE notes (path TEXT, text TEXT, embedding TEXT)"
 glob    = "notes/*.md"
 on-file = "uv run --with model2vec python embed.py {path} {root}"

{dirsql-0.4.24 → dirsql-0.4.26/packages/python}/docs/index.md

@@ -34,6 +34,7 @@ db = DirSQL(
     "./my-project",
     tables=[
         Table(
+            name="records",
             ddl="CREATE TABLE records (name TEXT, size INTEGER, type TEXT)",
             glob="data/*.json",
             on_file=lambda path: [json.loads(open(path, encoding="utf-8").read())],
@@ -52,6 +53,7 @@ let db = DirSQL::new(
     "./my-project",
     vec![
         Table::new(
+            "records",
             "CREATE TABLE records (name TEXT, size INTEGER, type TEXT)",
             "data/*.json",
             |path| vec![serde_json::from_str(&std::fs::read_to_string(path).unwrap()).unwrap()],
@@ -70,6 +72,7 @@ const db = new DirSQL({
   root: './my-project',
   tables: [
     new Table({
+      name: 'records',
       ddl: 'CREATE TABLE records (name TEXT, size INTEGER, type TEXT)',
       glob: 'data/*.json',
       onFile: (path) => [JSON.parse(readFileSync(path, 'utf8'))],

{dirsql-0.4.24 → dirsql-0.4.26}/packages/python/docs/reference/config.md

@@ -166,7 +166,8 @@ what its required `on-file` command emits — dirsql injects nothing (see
 
 | Key | Required | Description |
 |---|---|---|
-| `ddl` | yes | A SQLite `CREATE TABLE` statement. The table name is parsed from it. Only the columns declared here are kept; keys the `on-file` command emits that are not declared are dropped. |
+| `name` | yes | The table's SQL name — the name you query it by. Declared, never derived from `ddl`: dirsql does not read the DDL text. The `ddl` must create a table by this name; if it doesn't, loading fails. |
+| `ddl` | yes | A SQLite `CREATE TABLE` statement, run verbatim. Only the columns declared here are kept; keys the `on-file` command emits that are not declared are dropped. |
 | `glob` | yes | Glob pattern matched against root-relative paths. Every table whose glob matches a file receives that file's rows — a file can populate multiple tables. A `{name}` segment is rewritten to `*` (it matches one path segment but captures nothing). |
 | `on-file` | **yes** | A command run once per matched file; its stdout (a JSON array of row objects) becomes the file's rows. Must be non-empty. A `[[table]]` with no `on-file` is a load error (see [parse errors](#parse-errors)). See [Command hooks](./hooks.md#on-file). |
 | `strict` | no (default `false`) | When `true`, rows whose keys do not exactly match the declared columns are rejected with an error: extra keys error, and every declared column must be supplied by the `on-file` output. When `false`, extra keys are dropped and missing columns become `NULL`. |
@@ -180,11 +181,13 @@ instead of declaring a table.
 
 ```toml
 [[table]]
+name = "comments"
 ddl     = "CREATE TABLE comments (path TEXT, author TEXT, body TEXT)"
 glob    = "_comments/*/*.jsonl"
 on-file = "jq -c -s '.' {path}"
 
 [[table]]
+name = "papers"
 ddl     = "CREATE TABLE papers (paper_id TEXT, title TEXT)"
 glob    = "**/meta.json"
 on-file = "uv run python extract_papers.py {path}"
@@ -241,7 +244,16 @@ SDKs raise/reject) when:
 - The TOML is malformed.
 - Any table contains an unknown key (top level, `[dirsql]`, `[[table]]`, or
   `[[dirsql.extension]]`). The error names the offending key.
-- A `[[table]]` entry omits `ddl` or `glob`.
+- A `[[table]]` entry omits `name`, `ddl`, or `glob` (or `name` is
+  empty/whitespace).
+- A `[[table]]` entry's `ddl` runs but creates no table by its `name`. The
+  error carries the entry's name and points at the fix:
+
+  > `table 'messages': its `ddl` ran but created no table called 'messages'. Set `name` to the table the `ddl` creates.`
+
+  dirsql asks SQLite's catalog rather than interpreting the DDL, so quoted
+  (`CREATE TABLE "messages"`), schema-qualified (`main.messages`) and
+  `IF NOT EXISTS` forms all match a plain `name = "messages"`.
 - A `[[table]]` entry omits `on-file` (or it is empty/whitespace). The error
   names the offending glob and points at the fix:
 
@@ -275,11 +287,13 @@ deterministic = true
 timeout       = "600s"
 
 [[table]]
+name = "comments"
 ddl     = "CREATE TABLE comments (author TEXT, body TEXT)"
 glob    = "_comments/*/*.jsonl"
 on-file = "jq -c -s '.' {path}"
 
 [[table]]
+name = "documents"
 ddl     = "CREATE TABLE documents (title TEXT, summary TEXT)"
 glob    = "**/index.md"
 on-file = "uv run python extract_doc.py {path}"

{dirsql-0.4.24/packages/rust → dirsql-0.4.26/packages/python}/docs/reference/sdk.md

@@ -317,27 +317,30 @@ rather than waiting — an intentional, language-idiomatic difference.
 ::: code-group
 
 ```python [Python]
-Table(*, ddl: str, glob: str, on_file: Callable[[str], list[dict]], strict: bool = False)
+Table(*, name: str, ddl: str, glob: str, on_file: Callable[[str], list[dict]], strict: bool = False)
 ```
 
 ```typescript [TypeScript]
-new Table({ ddl, glob, onFile, strict? })
+new Table({ name, ddl, glob, onFile, strict? })
 // or a plain object — TableDef and Table are interchangeable:
-{ ddl: string, glob: string, onFile: (path: string) => Record<string, unknown>[], strict?: boolean }
+{ name: string, ddl: string, glob: string, onFile: (path: string) => Record<string, unknown>[], strict?: boolean }
 ```
 
 ```rust [Rust]
-Table::new(ddl, glob, on_file)      // on_file: Fn(&str) -> Vec<Row>, infallible
-Table::try_new(ddl, glob, on_file)  // on_file: Fn(&str) -> Result<Vec<Row>, _>
-Table::strict(ddl, glob, on_file)   // Table::new with strict = true
+Table::new(name, ddl, glob, on_file)      // on_file: Fn(&str) -> Vec<Row>, infallible
+Table::try_new(name, ddl, glob, on_file)  // on_file: Fn(&str) -> Result<Vec<Row>, _>
+Table::strict(name, ddl, glob, on_file)   // Table::new with strict = true
 ```
 
 :::
 
 Maps files to table rows.
 
-- `ddl` — A SQLite `CREATE TABLE` statement; the table name is parsed from
-  it. Table names must be unique across all tables.
+- `name` — The table's SQL name, declared rather than derived from `ddl`.
+  Must be unique across all tables. Building fails if the `ddl` creates no
+  table by this name (checked against SQLite's catalog, before any file is
+  indexed).
+- `ddl` — A SQLite `CREATE TABLE` statement, run verbatim.
 - `glob` — Glob pattern matched against root-relative paths. Every table whose
   glob matches a file receives that file's rows — a file can populate multiple
   tables. A `{name}` segment is rewritten to `*` (it matches one path segment

dirsql-0.4.26/packages/python/e2e-attestations/claude-issue-962-0jjrfv.json

@@ -0,0 +1,7 @@
+{
+  "command": "uv run python -m pytest tests/e2e/ -x -q",
+  "ran_at": 1787251467,
+  "exit_code": 0,
+  "commit": "706ed098a4e0bfabb3d498b8669fe194051940dd",
+  "branch": "claude/issue-962-0jjrfv"
+}

dirsql-0.4.26/packages/python/migrations.d/2026-08-20-declared-table-name.md

@@ -0,0 +1,52 @@
+### `Table` and `[[table]]` require an explicit `name` (#962)
+
+#### Summary
+
+`Table` previously derived its SQL name by parsing the `CREATE TABLE` head of
+`ddl`, exposing the result as an `Optional[str]` attribute. The name is now
+**declared**: `Table` takes a required keyword-only `name`, and a `[[table]]`
+entry in a `.dirsql.toml` requires a `name` key. Whether the `ddl` creates a
+table by that name is checked against SQLite's catalog at load time.
+
+#### Required changes
+
+| Before | After | Fix |
+| ------ | ----- | --- |
+| `Table(ddl=..., glob=..., on_file=...)` | `TypeError: Table.__new__() missing 1 required keyword argument: 'name'` | Pass `name="<table>"`, matching the table the `ddl` creates. |
+| `[[table]]` with `ddl` + `glob` + `on-file` | `await db.ready()` raises: `Missing required field 'name' in [[table]] entry` | Add `name = "<table>"` to the entry. |
+| `table.name` may be `None` | `table.name` is the declared `str` | Drop any `if table.name is None` handling. |
+
+#### Deprecations removed
+
+_None._
+
+#### Behavior changes without code changes
+
+- A `[[table]]` whose `ddl` creates a table under a different name than its
+  `name` now raises at `ready()` with an error naming the entry
+  (`table 'messages': …`), before any file is ingested.
+- Quoted (`CREATE TABLE "messages"`), schema-qualified and `IF NOT EXISTS` DDL
+  keep working unchanged: SQLite records the bare identifier, so a plain
+  `name="messages"` matches.
+
+#### Verification
+
+```python
+import asyncio, json
+from dirsql import DirSQL, Table
+
+db = DirSQL(
+    "./data-root",
+    tables=[
+        Table(
+            name="records",
+            ddl="CREATE TABLE records (id TEXT)",
+            glob="data/*.json",
+            on_file=lambda path: json.load(open(path, encoding="utf-8")),
+        )
+    ],
+)
+asyncio.run(db.ready())
+# -> builds; `SELECT id FROM records` returns the file's rows.
+# Omitting `name=` raises TypeError; a `name` the ddl never creates raises at ready().
+```

{dirsql-0.4.24 → dirsql-0.4.26}/packages/python/src/lib.rs

@@ -12,7 +12,7 @@
 
 #[cfg(feature = "extension-module")]
 mod python {
-    use ::dirsql::{DirSQL, Extension, Row, RowEvent, Table, Value, db::parse_table_name};
+    use ::dirsql::{DirSQL, Extension, Row, RowEvent, Table, Value};
     use pyo3::exceptions::{PyOverflowError, PyRuntimeError};
     use pyo3::prelude::*;
     use pyo3::types::{PyBool, PyByteArray, PyBytes, PyDict, PyInt, PyList};
@@ -24,6 +24,9 @@ mod python {
     /// callable for `on_file`.
     #[pyclass(name = "Table", frozen)]
     struct PyTable {
+        /// The table's SQL name, declared rather than derived from `ddl`.
+        #[pyo3(get)]
+        name: String,
         #[pyo3(get)]
         ddl: String,
         #[pyo3(get)]
@@ -32,27 +35,19 @@ mod python {
         on_file: Py<PyAny>,
         #[pyo3(get)]
         strict: bool,
-        /// Parsed table name (from `ddl`) via `dirsql::db::parse_table_name`,
-        /// or `None` if the DDL doesn't match `CREATE TABLE <name> (...)`.
-        /// `None` rather than a construction error so `DirSQL.ready()` keeps
-        /// surfacing malformed DDLs as the loud failure path (the core's
-        /// `DirSqlError::Ddl`).
-        #[pyo3(get)]
-        name: Option<String>,
     }
 
     #[pymethods]
     impl PyTable {
         #[new]
-        #[pyo3(signature = (*, ddl, glob, on_file, strict=false))]
-        fn new(ddl: String, glob: String, on_file: Py<PyAny>, strict: bool) -> Self {
-            let name = parse_table_name(&ddl);
+        #[pyo3(signature = (*, name, ddl, glob, on_file, strict=false))]
+        fn new(name: String, ddl: String, glob: String, on_file: Py<PyAny>, strict: bool) -> Self {
             PyTable {
+                name,
                 ddl,
                 glob,
                 on_file,
                 strict,
-                name,
             }
         }
     }
@@ -235,6 +230,7 @@ mod python {
     fn build_table(py: Python<'_>, t: &PyTable) -> Table {
         let on_file_ref = t.on_file.clone_ref(py);
         let mut table = Table::try_new(
+            t.name.clone(),
             t.ddl.clone(),
             t.glob.clone(),
             make_on_file_closure(on_file_ref),

{dirsql-0.4.24 → dirsql-0.4.26}/packages/python/tests/e2e/fixtures/dirsql_plugin_fixture/dirsql.toml

@@ -3,6 +3,7 @@
 # injected by the launcher as an ordinary `-c` flag. Adds one table so an
 # installed plugin is observable ("installed = active") with zero config edits.
 [[table]]
+name = "notes"
 ddl = "CREATE TABLE notes (path TEXT, basename TEXT)"
 glob = "*.md"
 on-file = '''sh -c 'rel=${1#"$2"/}; base=${1##*/}; printf "[{\"path\":\"%s\",\"basename\":\"%s\"}]" "$rel" "$base"' sh {path} {root}'''