dirsql 0.2.2__tar.gz → 0.2.4__tar.gz

{dirsql-0.2.2 → dirsql-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dirsql
-Version: 0.2.2
+Version: 0.2.4
 Requires-Dist: pytest>=8 ; extra == 'dev'
 Requires-Dist: pytest-describe>=2 ; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.23 ; extra == 'dev'
@@ -167,13 +167,16 @@ Defines how files map to a SQL table.
 - **`glob`** (`str`): A glob pattern matched against file paths relative to root.
 - **`extract`** (`Callable[[str, str], list[dict]]`): A function receiving `(relative_path, file_content)` and returning a list of row dicts. Each dict's keys must match the DDL column names.
 
-### `DirSQL(root, *, tables, ignore=None)`
+### `DirSQL(root=None, *, tables=None, ignore=None, config=None)`
 
 Creates an in-memory SQLite database indexed from the directory at `root`. The constructor is sync and returns immediately; scanning runs in a background thread.
 
-- **`root`** (`str`): Path to the directory to index.
-- **`tables`** (`list[Table]`): Table definitions.
-- **`ignore`** (`list[str] | None`): Glob patterns for paths to skip.
+At least one of `root` or `config` must be supplied. When both `root` and `config` are passed (or `config` declares `[dirsql].root`), the explicit `root` wins and a warning is emitted on stderr.
+
+- **`root`** (`str | None`): Path to the directory to index. Optional when `config` supplies one.
+- **`tables`** (`list[Table] | None`): Programmatic table definitions. Appended to any tables in the config file.
+- **`ignore`** (`list[str] | None`): Glob patterns for paths to skip. Appended to any `[dirsql].ignore` patterns in the config file.
+- **`config`** (`str | None`): Optional path to a `.dirsql.toml` file. Its `[[table]]` entries, `[dirsql].ignore`, and optional `[dirsql].root` are merged into the constructor's inputs.
 
 #### `await DirSQL.ready()`
 
@@ -187,10 +190,6 @@ Execute a SQL query. Returns a list of dicts keyed by column name. Internal trac
 
 Returns an async iterator that yields `RowEvent` objects as files change on disk. Starts the filesystem watcher on first iteration.
 
-#### `DirSQL.from_config(path) -> DirSQL`
-
-Create a `DirSQL` instance from a `.dirsql.toml` config file. Returns immediately; scanning runs in the background. Call `await db.ready()` before querying.
-
 ### `RowEvent`
 
 Emitted by `watch()` when a file change produces row-level diffs.

{dirsql-0.2.2/packages/python → dirsql-0.2.4}/README.md

@@ -150,13 +150,16 @@ Defines how files map to a SQL table.
 - **`glob`** (`str`): A glob pattern matched against file paths relative to root.
 - **`extract`** (`Callable[[str, str], list[dict]]`): A function receiving `(relative_path, file_content)` and returning a list of row dicts. Each dict's keys must match the DDL column names.
 
-### `DirSQL(root, *, tables, ignore=None)`
+### `DirSQL(root=None, *, tables=None, ignore=None, config=None)`
 
 Creates an in-memory SQLite database indexed from the directory at `root`. The constructor is sync and returns immediately; scanning runs in a background thread.
 
-- **`root`** (`str`): Path to the directory to index.
-- **`tables`** (`list[Table]`): Table definitions.
-- **`ignore`** (`list[str] | None`): Glob patterns for paths to skip.
+At least one of `root` or `config` must be supplied. When both `root` and `config` are passed (or `config` declares `[dirsql].root`), the explicit `root` wins and a warning is emitted on stderr.
+
+- **`root`** (`str | None`): Path to the directory to index. Optional when `config` supplies one.
+- **`tables`** (`list[Table] | None`): Programmatic table definitions. Appended to any tables in the config file.
+- **`ignore`** (`list[str] | None`): Glob patterns for paths to skip. Appended to any `[dirsql].ignore` patterns in the config file.
+- **`config`** (`str | None`): Optional path to a `.dirsql.toml` file. Its `[[table]]` entries, `[dirsql].ignore`, and optional `[dirsql].root` are merged into the constructor's inputs.
 
 #### `await DirSQL.ready()`
 
@@ -170,10 +173,6 @@ Execute a SQL query. Returns a list of dicts keyed by column name. Internal trac
 
 Returns an async iterator that yields `RowEvent` objects as files change on disk. Starts the filesystem watcher on first iteration.
 
-#### `DirSQL.from_config(path) -> DirSQL`
-
-Create a `DirSQL` instance from a `.dirsql.toml` config file. Returns immediately; scanning runs in the background. Call `await db.ready()` before querying.
-
 ### `RowEvent`
 
 Emitted by `watch()` when a file change produces row-level diffs.

{dirsql-0.2.2 → dirsql-0.2.4/packages/python}/README.md

@@ -150,13 +150,16 @@ Defines how files map to a SQL table.
 - **`glob`** (`str`): A glob pattern matched against file paths relative to root.
 - **`extract`** (`Callable[[str, str], list[dict]]`): A function receiving `(relative_path, file_content)` and returning a list of row dicts. Each dict's keys must match the DDL column names.
 
-### `DirSQL(root, *, tables, ignore=None)`
+### `DirSQL(root=None, *, tables=None, ignore=None, config=None)`
 
 Creates an in-memory SQLite database indexed from the directory at `root`. The constructor is sync and returns immediately; scanning runs in a background thread.
 
-- **`root`** (`str`): Path to the directory to index.
-- **`tables`** (`list[Table]`): Table definitions.
-- **`ignore`** (`list[str] | None`): Glob patterns for paths to skip.
+At least one of `root` or `config` must be supplied. When both `root` and `config` are passed (or `config` declares `[dirsql].root`), the explicit `root` wins and a warning is emitted on stderr.
+
+- **`root`** (`str | None`): Path to the directory to index. Optional when `config` supplies one.
+- **`tables`** (`list[Table] | None`): Programmatic table definitions. Appended to any tables in the config file.
+- **`ignore`** (`list[str] | None`): Glob patterns for paths to skip. Appended to any `[dirsql].ignore` patterns in the config file.
+- **`config`** (`str | None`): Optional path to a `.dirsql.toml` file. Its `[[table]]` entries, `[dirsql].ignore`, and optional `[dirsql].root` are merged into the constructor's inputs.
 
 #### `await DirSQL.ready()`
 
@@ -170,10 +173,6 @@ Execute a SQL query. Returns a list of dicts keyed by column name. Internal trac
 
 Returns an async iterator that yields `RowEvent` objects as files change on disk. Starts the filesystem watcher on first iteration.
 
-#### `DirSQL.from_config(path) -> DirSQL`
-
-Create a `DirSQL` instance from a `.dirsql.toml` config file. Returns immediately; scanning runs in the background. Call `await db.ready()` before querying.
-
 ### `RowEvent`
 
 Emitted by `watch()` when a file change produces row-level diffs.

{dirsql-0.2.2 → dirsql-0.2.4}/packages/python/src/lib.rs

@@ -4,8 +4,8 @@
 //! - wraps a Python `extract` callable in a Rust closure (acquiring the GIL as
 //!   needed) so it can be handed to [`dirsql::Table`]
 //! - converts row dicts, values, and events between Python and Rust
-//! - forwards `new` / `from_config` / `query` / `_start_watcher` /
-//!   `_poll_events` to the corresponding `DirSQL` methods
+//! - forwards `new` / `query` / `_start_watcher` / `_poll_events` to the
+//!   corresponding `DirSQL` methods
 //!
 //! The Python-side async wrapper (`dirsql._async.DirSQL`) drives this binding
 //! via `asyncio.to_thread`.
@@ -86,37 +86,41 @@ mod python {
     #[pymethods]
     impl PyDirSQL {
         #[new]
-        #[pyo3(signature = (root, *, tables, ignore=None))]
+        #[pyo3(signature = (root=None, *, tables=None, ignore=None, config=None))]
         fn new(
             py: Python<'_>,
-            root: String,
-            tables: Vec<PyRef<'_, PyTable>>,
+            root: Option<String>,
+            tables: Option<Vec<PyRef<'_, PyTable>>>,
             ignore: Option<Vec<String>>,
+            config: Option<String>,
         ) -> PyResult<Self> {
-            let rust_tables: Vec<Table> = tables.iter().map(|t| build_table(py, t)).collect();
+            let rust_tables: Vec<Table> = tables
+                .as_deref()
+                .map(|ts| ts.iter().map(|t| build_table(py, t)).collect())
+                .unwrap_or_default();
 
             let inner = py
-                .detach(move || match ignore {
-                    Some(ig) => DirSQL::with_ignore(root, rust_tables, ig),
-                    None => DirSQL::new(root, rust_tables),
+                .detach(move || {
+                    let mut builder = DirSQL::builder();
+                    if let Some(r) = root {
+                        builder = builder.root(r);
+                    }
+                    if !rust_tables.is_empty() {
+                        builder = builder.tables(rust_tables);
+                    }
+                    if let Some(ig) = ignore {
+                        builder = builder.ignore(ig);
+                    }
+                    if let Some(c) = config {
+                        builder = builder.config(c);
+                    }
+                    builder.build()
                 })
                 .map_err(to_py_err)?;
 
             Ok(Self { inner })
         }
 
-        #[classmethod]
-        fn from_config(
-            _cls: &Bound<'_, pyo3::types::PyType>,
-            py: Python<'_>,
-            path: String,
-        ) -> PyResult<Self> {
-            let inner = py
-                .detach(move || DirSQL::from_config_path(&path))
-                .map_err(to_py_err)?;
-            Ok(Self { inner })
-        }
-
         fn query(&self, py: Python<'_>, sql: String) -> PyResult<Py<PyList>> {
             let db = self.inner.clone();
             let rows = py.detach(move || db.query(&sql)).map_err(to_py_err)?;

{dirsql-0.2.2 → dirsql-0.2.4}/packages/python/tests/integration/test_binding.py

@@ -1,11 +1,11 @@
 """Integration tests for the Python SDK binding layer.
 
 These tests exercise the async Python wrapper in ``dirsql._async`` in
-isolation by mocking the Rust core (``dirsql._dirsql.DirSQL`` / its
-``from_config`` classmethod). They verify the SDK's binding glue --
-offloading to threads, ready()/error propagation, lazy watcher startup,
-event iteration, config-based construction, and kwarg forwarding --
-without touching the real PyO3-backed engine.
+isolation by mocking the Rust core (``dirsql._dirsql.DirSQL``). They
+verify the SDK's binding glue -- offloading to threads, ready()/error
+propagation, lazy watcher startup, event iteration, config-based
+construction, and kwarg forwarding -- without touching the real
+PyO3-backed engine.
 
 Core behaviour (SQL semantics, scanning, diffing, watching) is covered
 by the Rust core's own unit tests and by the local-only e2e suite.
@@ -27,35 +27,21 @@ class _FakeRustDirSQL:
 
     instances: list = []
 
-    def __init__(self, root, *, tables, ignore=None):
+    def __init__(self, root=None, *, tables=None, ignore=None, config=None):
         self.root = root
         self.tables = tables
         self.ignore = ignore
+        self.config = config
         self.queries: list[str] = []
-        self.query_results: list = [{"ok": 1}]
+        self.query_results: list = (
+            [{"from_config": config}] if config is not None else [{"ok": 1}]
+        )
         self.started = False
         self.poll_calls: list[int] = []
         # Scripted event batches; each poll returns the next batch.
         self.poll_batches: list[list] = []
         _FakeRustDirSQL.instances.append(self)
 
-    # Class-level from_config so we can swap it with a callable that
-    # returns a fresh instance (mirrors the real classmethod shape).
-    @classmethod
-    def from_config(cls, path):
-        inst = object.__new__(cls)
-        inst.root = None
-        inst.tables = None
-        inst.ignore = None
-        inst.queries = []
-        inst.query_results = [{"from_config": path}]
-        inst.started = False
-        inst.poll_calls = []
-        inst.poll_batches = []
-        inst.config_path = path
-        cls.instances.append(inst)
-        return inst
-
     def query(self, sql):
         self.queries.append(sql)
         return self.query_results
@@ -219,16 +205,17 @@ def describe_binding_layer():
             assert event == "late"
             assert len(fake.poll_calls) == 3
 
-    def describe_from_config():
-        # Feature: DirSQL.from_config(path) classmethod. See
+    def describe_config_kwarg():
+        # Feature: DirSQL(config=path) forwards to the Rust core. See
         # docs/guide/config.md and packages/python/README.md.
         @pytest.mark.asyncio
-        async def it_delegates_to_rust_from_config(mock_core):
-            db = async_mod.DirSQL.from_config("/some/.dirsql.toml")
+        async def it_forwards_config_path_to_core(mock_core):
+            db = async_mod.DirSQL(config="/some/.dirsql.toml")
             await db.ready()
 
             inst = _FakeRustDirSQL.instances[-1]
-            assert inst.config_path == "/some/.dirsql.toml"
+            assert inst.config == "/some/.dirsql.toml"
+            assert inst.root is None
 
             result = await db.query("SELECT 1")
             assert result == [{"from_config": "/some/.dirsql.toml"}]
@@ -236,15 +223,18 @@ def describe_binding_layer():
         @pytest.mark.asyncio
         async def it_surfaces_config_load_errors(monkeypatch):
             class Boom(_FakeRustDirSQL):
-                @classmethod
-                def from_config(cls, path):
-                    raise FileNotFoundError(path)
+                def __init__(self, root=None, **kwargs):
+                    raise FileNotFoundError(kwargs.get("config") or root)
 
             monkeypatch.setattr(async_mod, "_RustDirSQL", Boom)
-            db = async_mod.DirSQL.from_config("/missing.toml")
+            db = async_mod.DirSQL(config="/missing.toml")
             with pytest.raises(FileNotFoundError):
                 await db.ready()
 
+        def it_rejects_construction_without_root_or_config():
+            with pytest.raises(TypeError):
+                async_mod.DirSQL()
+
     def describe_ignore_kwarg():
         # Feature: ignore patterns. See docs/guide/tables.md and
         # packages/python/README.md (ignore= kwarg on DirSQL).

{dirsql-0.2.2 → dirsql-0.2.4}/packages/python/tests/integration/test_docs_gaps.py

@@ -84,7 +84,7 @@ ddl = "CREATE TABLE produce (name TEXT, count TEXT)"
 glob = "*.tsv"
 """,
         )
-        db = DirSQL.from_config(os.path.join(config_dir, ".dirsql.toml"))
+        db = DirSQL(config=os.path.join(config_dir, ".dirsql.toml"))
         await db.ready()
         results = await db.query("SELECT * FROM produce ORDER BY name")
         assert len(results) == 2
@@ -110,7 +110,7 @@ ddl = "CREATE TABLE events (type TEXT, count INTEGER)"
 glob = "*.ndjson"
 """,
         )
-        db = DirSQL.from_config(os.path.join(config_dir, ".dirsql.toml"))
+        db = DirSQL(config=os.path.join(config_dir, ".dirsql.toml"))
         await db.ready()
         results = await db.query("SELECT * FROM events ORDER BY type")
         assert len(results) == 2
@@ -132,7 +132,7 @@ ddl = "CREATE TABLE app (name TEXT, version TEXT)"
 glob = "config/*.toml"
 """,
         )
-        db = DirSQL.from_config(os.path.join(config_dir, ".dirsql.toml"))
+        db = DirSQL(config=os.path.join(config_dir, ".dirsql.toml"))
         await db.ready()
         results = await db.query("SELECT * FROM app")
         assert len(results) == 1
@@ -155,7 +155,7 @@ ddl = "CREATE TABLE items (name TEXT, price REAL)"
 glob = "*.{ext}"
 """,
         )
-        db = DirSQL.from_config(os.path.join(config_dir, ".dirsql.toml"))
+        db = DirSQL(config=os.path.join(config_dir, ".dirsql.toml"))
         await db.ready()
         results = await db.query("SELECT * FROM items")
         assert len(results) == 1
@@ -177,7 +177,7 @@ ddl = "CREATE TABLE posts (title TEXT, author TEXT, body TEXT)"
 glob = "posts/*.md"
 """,
         )
-        db = DirSQL.from_config(os.path.join(config_dir, ".dirsql.toml"))
+        db = DirSQL(config=os.path.join(config_dir, ".dirsql.toml"))
         await db.ready()
         results = await db.query("SELECT * FROM posts")
         assert len(results) == 1
@@ -203,7 +203,7 @@ glob = "items/*.json"
 strict = true
 """,
         )
-        db = DirSQL.from_config(os.path.join(config_dir, ".dirsql.toml"))
+        db = DirSQL(config=os.path.join(config_dir, ".dirsql.toml"))
         with pytest.raises(Exception):
             await db.ready()
 
@@ -223,7 +223,7 @@ glob = "items/*.json"
 strict = true
 """,
         )
-        db = DirSQL.from_config(os.path.join(config_dir, ".dirsql.toml"))
+        db = DirSQL(config=os.path.join(config_dir, ".dirsql.toml"))
         await db.ready()
         results = await db.query("SELECT * FROM items")
         assert len(results) == 1

{dirsql-0.2.2 → dirsql-0.2.4}/packages/python/tests/integration/test_from_config.py

@@ -1,4 +1,4 @@
-"""Integration tests for DirSQL.from_config()."""
+"""Integration tests for DirSQL(config=)."""
 
 import json
 import os
@@ -44,7 +44,7 @@ glob = "items/*.json"
 """,
             )
 
-            db = DirSQL.from_config(os.path.join(config_dir, ".dirsql.toml"))
+            db = DirSQL(config=os.path.join(config_dir, ".dirsql.toml"))
             await db.ready()
             results = await db.query("SELECT * FROM items ORDER BY name")
             assert len(results) == 2
@@ -68,7 +68,7 @@ glob = "*.csv"
 """,
             )
 
-            db = DirSQL.from_config(os.path.join(config_dir, ".dirsql.toml"))
+            db = DirSQL(config=os.path.join(config_dir, ".dirsql.toml"))
             await db.ready()
             results = await db.query("SELECT * FROM produce ORDER BY name")
             assert len(results) == 2
@@ -93,7 +93,7 @@ glob = "*.jsonl"
 """,
             )
 
-            db = DirSQL.from_config(os.path.join(config_dir, ".dirsql.toml"))
+            db = DirSQL(config=os.path.join(config_dir, ".dirsql.toml"))
             await db.ready()
             results = await db.query("SELECT * FROM events ORDER BY type")
             assert len(results) == 2
@@ -121,7 +121,7 @@ glob = "comments/{thread_id}/index.jsonl"
 """,
             )
 
-            db = DirSQL.from_config(os.path.join(config_dir, ".dirsql.toml"))
+            db = DirSQL(config=os.path.join(config_dir, ".dirsql.toml"))
             await db.ready()
             results = await db.query("SELECT * FROM comments ORDER BY thread_id")
             assert len(results) == 2
@@ -150,7 +150,7 @@ age = "age"
 """,
             )
 
-            db = DirSQL.from_config(os.path.join(config_dir, ".dirsql.toml"))
+            db = DirSQL(config=os.path.join(config_dir, ".dirsql.toml"))
             await db.ready()
             results = await db.query("SELECT * FROM people")
             assert len(results) == 1
@@ -184,7 +184,7 @@ each = "data.items"
 """,
             )
 
-            db = DirSQL.from_config(os.path.join(config_dir, ".dirsql.toml"))
+            db = DirSQL(config=os.path.join(config_dir, ".dirsql.toml"))
             await db.ready()
             results = await db.query("SELECT * FROM items ORDER BY name")
             assert len(results) == 2
@@ -215,7 +215,7 @@ glob = "data/**/*.json"
 """,
             )
 
-            db = DirSQL.from_config(os.path.join(config_dir, ".dirsql.toml"))
+            db = DirSQL(config=os.path.join(config_dir, ".dirsql.toml"))
             await db.ready()
             results = await db.query("SELECT * FROM items")
             assert len(results) == 1
@@ -246,7 +246,7 @@ glob = "authors/*.json"
 """,
             )
 
-            db = DirSQL.from_config(os.path.join(config_dir, ".dirsql.toml"))
+            db = DirSQL(config=os.path.join(config_dir, ".dirsql.toml"))
             await db.ready()
             posts = await db.query("SELECT * FROM posts")
             authors = await db.query("SELECT * FROM authors")
@@ -259,7 +259,7 @@ glob = "authors/*.json"
         @pytest.mark.asyncio
         async def it_raises_on_missing_config_file(config_dir):
             """from_config raises when the config file doesn't exist."""
-            db = DirSQL.from_config(os.path.join(config_dir, "nonexistent.toml"))
+            db = DirSQL(config=os.path.join(config_dir, "nonexistent.toml"))
             with pytest.raises(Exception):
                 await db.ready()
 
@@ -270,7 +270,7 @@ glob = "authors/*.json"
                 os.path.join(config_dir, ".dirsql.toml"),
                 "this is not valid [[[",
             )
-            db = DirSQL.from_config(os.path.join(config_dir, ".dirsql.toml"))
+            db = DirSQL(config=os.path.join(config_dir, ".dirsql.toml"))
             with pytest.raises(Exception):
                 await db.ready()
 
@@ -284,7 +284,7 @@ glob = "authors/*.json"
 glob = "*.json"
 """,
             )
-            db = DirSQL.from_config(os.path.join(config_dir, ".dirsql.toml"))
+            db = DirSQL(config=os.path.join(config_dir, ".dirsql.toml"))
             with pytest.raises(Exception):
                 await db.ready()
 
@@ -303,7 +303,7 @@ ddl = "CREATE TABLE t (x TEXT)"
 glob = "*.dat"
 """,
             )
-            db = DirSQL.from_config(os.path.join(config_dir, ".dirsql.toml"))
+            db = DirSQL(config=os.path.join(config_dir, ".dirsql.toml"))
             with pytest.raises(Exception, match="[Ff]ormat|[Uu]nsupported"):
                 await db.ready()
 
@@ -326,7 +326,7 @@ format = "csv"
 """,
             )
 
-            db = DirSQL.from_config(os.path.join(config_dir, ".dirsql.toml"))
+            db = DirSQL(config=os.path.join(config_dir, ".dirsql.toml"))
             await db.ready()
             results = await db.query("SELECT * FROM t")
             assert len(results) == 1
@@ -349,7 +349,7 @@ glob = "items/*.json"
 """,
             )
 
-            db = DirSQL.from_config(os.path.join(config_dir, ".dirsql.toml"))
+            db = DirSQL(config=os.path.join(config_dir, ".dirsql.toml"))
             await db.ready()
             results = await db.query("SELECT name FROM items WHERE price > 1.0")
             assert len(results) == 1

{dirsql-0.2.2 → dirsql-0.2.4}/packages/rust/src/config.rs

@@ -1,5 +1,5 @@
 use std::collections::HashMap;
-use std::path::Path;
+use std::path::{Path, PathBuf};
 
 use serde::Deserialize;
 
@@ -26,6 +26,11 @@ pub type Result<T> = std::result::Result<T, ConfigError>;
 /// Parsed configuration from a `.dirsql.toml` file.
 #[derive(Debug, Clone)]
 pub struct Config {
+    /// Optional root directory override. When absent, callers derive the
+    /// root from the config file's own location. When present, it is taken
+    /// relative to the config file's parent (so a config at
+    /// `/proj/.dirsql.toml` with `root = "docs"` scans `/proj/docs`).
+    pub root: Option<PathBuf>,
     pub ignore: Vec<String>,
     pub tables: Vec<TableConfig>,
 }
@@ -51,6 +56,7 @@ struct RawConfig {
 
 #[derive(Deserialize)]
 struct RawDirsql {
+    root: Option<PathBuf>,
     ignore: Option<Vec<String>>,
 }
 
@@ -87,7 +93,10 @@ pub fn load_config(path: &Path) -> Result<Config> {
 pub fn load_config_str(content: &str) -> Result<Config> {
     let raw: RawConfig = toml::from_str(content)?;
 
-    let ignore = raw.dirsql.and_then(|d| d.ignore).unwrap_or_default();
+    let (root, ignore) = match raw.dirsql {
+        Some(d) => (d.root, d.ignore.unwrap_or_default()),
+        None => (None, Vec::new()),
+    };
 
     let raw_tables = raw.table.unwrap_or_default();
     let mut tables = Vec::with_capacity(raw_tables.len());
@@ -111,7 +120,11 @@ pub fn load_config_str(content: &str) -> Result<Config> {
         });
     }
 
-    Ok(Config { ignore, tables })
+    Ok(Config {
+        root,
+        ignore,
+        tables,
+    })
 }
 
 #[cfg(test)]
@@ -367,6 +380,45 @@ glob = "*.dat"
         assert_eq!(config.tables[0].format, None);
     }
 
+    #[test]
+    fn optional_root_parses_when_present() {
+        let toml = r#"
+[dirsql]
+root = "docs"
+
+[[table]]
+ddl = "CREATE TABLE t (x TEXT)"
+glob = "*.json"
+"#;
+        let config = load_config_str(toml).unwrap();
+        assert_eq!(config.root.as_deref(), Some(Path::new("docs")));
+    }
+
+    #[test]
+    fn root_absent_by_default() {
+        let toml = r#"
+[[table]]
+ddl = "CREATE TABLE t (x TEXT)"
+glob = "*.json"
+"#;
+        let config = load_config_str(toml).unwrap();
+        assert!(config.root.is_none());
+    }
+
+    #[test]
+    fn root_can_be_absolute() {
+        let toml = r#"
+[dirsql]
+root = "/tmp/data"
+
+[[table]]
+ddl = "CREATE TABLE t (x TEXT)"
+glob = "*.json"
+"#;
+        let config = load_config_str(toml).unwrap();
+        assert_eq!(config.root.as_deref(), Some(Path::new("/tmp/data")));
+    }
+
     #[test]
     fn multiple_tables_preserve_order() {
         let toml = r#"

{dirsql-0.2.2 → dirsql-0.2.4}/packages/rust/src/db.rs

@@ -541,11 +541,11 @@ mod tests {
 
     #[test]
     fn value_to_sql_real() {
-        let v = Value::Real(3.14);
+        let v = Value::Real(1.5);
         let result = v.to_sql().unwrap();
         match result {
             rusqlite::types::ToSqlOutput::Owned(rusqlite::types::Value::Real(f)) => {
-                assert!((f - 3.14).abs() < f64::EPSILON);
+                assert!((f - 1.5).abs() < f64::EPSILON);
             }
             _ => panic!("expected Real"),
         }
@@ -587,8 +587,8 @@ mod tests {
 
     #[test]
     fn value_from_sqlite_real() {
-        let v = Value::from(rusqlite::types::Value::Real(2.718));
-        assert_eq!(v, Value::Real(2.718));
+        let v = Value::from(rusqlite::types::Value::Real(1.25));
+        assert_eq!(v, Value::Real(1.25));
     }
 
     #[test]