dirsql 0.4.132__tar.gz → 0.4.134__tar.gz

{dirsql-0.4.132 → dirsql-0.4.134}/Cargo.lock

@@ -573,7 +573,7 @@ dependencies = [
 
 [[package]]
 name = "dirsql"
-version = "0.4.132"
+version = "0.4.134"
 dependencies = [
  "assert_cmd",
  "axum",
@@ -625,7 +625,7 @@ dependencies = [
 
 [[package]]
 name = "dirsql-py-ext"
-version = "0.4.132"
+version = "0.4.134"
 dependencies = [
  "dirsql",
  "pyo3",

{dirsql-0.4.132 → dirsql-0.4.134}/Cargo.toml

@@ -18,7 +18,7 @@ dirsql = { path = "packages/rust" }
 serde = { version = "1", features = ["derive"] }
 # `preserve_order`: a serialized row must keep the projection order the SELECT
 # list asked for, which the default BTreeMap-backed object discards.
-serde_json = { version = "1", features = ["preserve_order"] }
+serde_json = { version = "1", features = ["preserve_order", "float_roundtrip"] }
 regex = "1"
 thiserror = "2"
 tokio = { version = "1", features = ["rt", "sync"] }

{dirsql-0.4.132 → dirsql-0.4.134}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dirsql
-Version: 0.4.132
+Version: 0.4.134
 Requires-Dist: bin-shim>=0.1
 Summary: Ephemeral SQL index over a local directory
 Keywords: sql,filesystem,directory,sqlite,index

{dirsql-0.4.132/packages/rust → dirsql-0.4.134}/docs/reference/sdk.md

@@ -212,7 +212,7 @@ await db.query(sql: str, params: Sequence | Mapping | None = None) -> list[dict]
 ```
 
 ```typescript [TypeScript]
-await db.query(sql: string) -> Record<string, unknown>[]
+await db.query(sql: string, params?: unknown[] | Record<string, unknown> | null) -> Record<string, unknown>[]
 // Runs on the libuv threadpool; the JS event loop stays responsive.
 ```
 
@@ -227,8 +227,9 @@ Executes a SQL query and returns rows keyed by column name.
 
 **Bind parameters.** `params` reaches SQLite's own parameter binding; the
 values never enter the SQL text, so text holding quotes needs no escaping.
-A sequence fills `?` placeholders in order; a mapping fills `:name`
-placeholders, keyed by the name without its prefix. It works for path-tables
+A sequence (a TypeScript array) fills `?` placeholders in order; a mapping
+(a TypeScript plain object) fills `:name`, `@name` and `$name` placeholders,
+keyed by the name without its prefix. It works for path-tables
 and declared tables alike:
 
 ::: code-group
@@ -241,6 +242,15 @@ await db.query(
 await db.query("SELECT * FROM notes WHERE author = ? AND year = ?", ("ann", 2024))
 ```
 
+```typescript [TypeScript]
+await db.query(
+  "SELECT path FROM './*.json' WHERE content ->> 'advice' = :advice",
+  { advice: text },
+);
+await db.query("SELECT * FROM notes WHERE author = ? AND year = ?", ["ann", 2024]);
+// queryOrdered takes params the same way.
+```
+
 ```rust [Rust]
 use dirsql::{Params, Value};
 use std::collections::HashMap;
@@ -259,20 +269,23 @@ db.query_with(
 
 :::
 
-TypeScript does not take bind parameters yet.
-
 - Values bind as SQLite's native types. Python accepts `None`, `int`
   (`bool` binds as `0`/`1`), `float`, `str`, `bytes` and `bytearray`;
   anything else raises `TypeError` rather than being stringified, and an
-  `int` outside the signed 64-bit range raises `OverflowError`. Rust binds a
-  `Value`.
+  `int` outside the signed 64-bit range raises `OverflowError`. TypeScript
+  accepts `null`, `number` (an integral value binds as an INTEGER, any other
+  as a REAL, so `1.0` binds as `1`), `bigint`, `boolean` (`0`/`1`), `string`,
+  and `Buffer` / `Uint8Array`; anything else, `undefined` included, rejects
+  with a `TypeError`, and a `bigint` outside the signed 64-bit range with a
+  `RangeError`. Rust binds a `Value`.
 - The params must fit the placeholders exactly, or the query fails with an
   error naming the problem: a wrong count for a sequence, a placeholder name
   the mapping lacks, a mapping key no placeholder uses, or a sequence for
   named placeholders (and a mapping for `?`). Python raises a
   `RuntimeError` for these, and a `TypeError` when `params` is neither a
-  sequence nor a mapping (a `str` counts as neither). Rust returns
-  `DbError::Params`.
+  sequence nor a mapping (a `str` counts as neither). TypeScript rejects
+  with an `Error` for these, and a `TypeError` when `params` is neither an
+  array nor a plain object. Rust returns `DbError::Params`.
 - Without `params`, a statement with placeholders fails the same way: a
   placeholder is never left unbound.
 
@@ -311,11 +324,12 @@ round-trips.
 ::: code-group
 
 ```typescript [TypeScript]
-await db.queryOrdered(sql: string) -> { columns: string[]; rows: Record<string, unknown>[] }
+await db.queryOrdered(sql: string, params?: unknown[] | Record<string, unknown> | null) -> { columns: string[]; rows: Record<string, unknown>[] }
 ```
 
 ```rust [Rust]
 db.query_ordered(sql: &str) -> Result<QueryResult>   // QueryResult { columns, rows }
+db.query_ordered_with(sql: &str, params: &Params) -> Result<QueryResult>
 ```
 
 :::

{dirsql-0.4.132 → dirsql-0.4.134}/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.132"
+version = "0.4.134"
 # 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.134/packages/python/changelog.d/2026-11-04-exact-json-floats.md

@@ -0,0 +1 @@
+**Fixed** JSON numbers from `on-file` hooks and worker functions now parse to the exact double: `123456789.12345679` was stored one ULP off as `123456789.1234568`.

{dirsql-0.4.132 → dirsql-0.4.134}/packages/python/docs/reference/sdk.md

@@ -212,7 +212,7 @@ await db.query(sql: str, params: Sequence | Mapping | None = None) -> list[dict]
 ```
 
 ```typescript [TypeScript]
-await db.query(sql: string) -> Record<string, unknown>[]
+await db.query(sql: string, params?: unknown[] | Record<string, unknown> | null) -> Record<string, unknown>[]
 // Runs on the libuv threadpool; the JS event loop stays responsive.
 ```
 
@@ -227,8 +227,9 @@ Executes a SQL query and returns rows keyed by column name.
 
 **Bind parameters.** `params` reaches SQLite's own parameter binding; the
 values never enter the SQL text, so text holding quotes needs no escaping.
-A sequence fills `?` placeholders in order; a mapping fills `:name`
-placeholders, keyed by the name without its prefix. It works for path-tables
+A sequence (a TypeScript array) fills `?` placeholders in order; a mapping
+(a TypeScript plain object) fills `:name`, `@name` and `$name` placeholders,
+keyed by the name without its prefix. It works for path-tables
 and declared tables alike:
 
 ::: code-group
@@ -241,6 +242,15 @@ await db.query(
 await db.query("SELECT * FROM notes WHERE author = ? AND year = ?", ("ann", 2024))
 ```
 
+```typescript [TypeScript]
+await db.query(
+  "SELECT path FROM './*.json' WHERE content ->> 'advice' = :advice",
+  { advice: text },
+);
+await db.query("SELECT * FROM notes WHERE author = ? AND year = ?", ["ann", 2024]);
+// queryOrdered takes params the same way.
+```
+
 ```rust [Rust]
 use dirsql::{Params, Value};
 use std::collections::HashMap;
@@ -259,20 +269,23 @@ db.query_with(
 
 :::
 
-TypeScript does not take bind parameters yet.
-
 - Values bind as SQLite's native types. Python accepts `None`, `int`
   (`bool` binds as `0`/`1`), `float`, `str`, `bytes` and `bytearray`;
   anything else raises `TypeError` rather than being stringified, and an
-  `int` outside the signed 64-bit range raises `OverflowError`. Rust binds a
-  `Value`.
+  `int` outside the signed 64-bit range raises `OverflowError`. TypeScript
+  accepts `null`, `number` (an integral value binds as an INTEGER, any other
+  as a REAL, so `1.0` binds as `1`), `bigint`, `boolean` (`0`/`1`), `string`,
+  and `Buffer` / `Uint8Array`; anything else, `undefined` included, rejects
+  with a `TypeError`, and a `bigint` outside the signed 64-bit range with a
+  `RangeError`. Rust binds a `Value`.
 - The params must fit the placeholders exactly, or the query fails with an
   error naming the problem: a wrong count for a sequence, a placeholder name
   the mapping lacks, a mapping key no placeholder uses, or a sequence for
   named placeholders (and a mapping for `?`). Python raises a
   `RuntimeError` for these, and a `TypeError` when `params` is neither a
-  sequence nor a mapping (a `str` counts as neither). Rust returns
-  `DbError::Params`.
+  sequence nor a mapping (a `str` counts as neither). TypeScript rejects
+  with an `Error` for these, and a `TypeError` when `params` is neither an
+  array nor a plain object. Rust returns `DbError::Params`.
 - Without `params`, a statement with placeholders fails the same way: a
   placeholder is never left unbound.
 
@@ -311,11 +324,12 @@ round-trips.
 ::: code-group
 
 ```typescript [TypeScript]
-await db.queryOrdered(sql: string) -> { columns: string[]; rows: Record<string, unknown>[] }
+await db.queryOrdered(sql: string, params?: unknown[] | Record<string, unknown> | null) -> { columns: string[]; rows: Record<string, unknown>[] }
 ```
 
 ```rust [Rust]
 db.query_ordered(sql: &str) -> Result<QueryResult>   // QueryResult { columns, rows }
+db.query_ordered_with(sql: &str, params: &Params) -> Result<QueryResult>
 ```
 
 :::

dirsql-0.4.134/packages/python/e2e-attestations/bot-1586-float-roundtrip-1104.json

@@ -0,0 +1,7 @@
+{
+  "command": "uv run python -m pytest tests/e2e/on_file_query_test.py tests/e2e/jsonl_parse_speed_test.py tests/e2e/use_case_transcripts_test.py tests/e2e/query_contract_test.py -x -q",
+  "ran_at": 1793814794,
+  "exit_code": 0,
+  "commit": "4696a76d81c3080df86c416ef418d3d9b2dc0062",
+  "branch": "bot/1586-float-roundtrip-1104"
+}

dirsql-0.4.134/packages/python/migrations.d/2026-11-04-exact-json-floats.md

@@ -0,0 +1,21 @@
+### Exact JSON float parsing
+
+#### Summary
+
+A JSON float an `on-file` hook or worker function prints is stored as the correctly rounded REAL, where some were one ULP off before. No API or configuration changes are required.
+
+#### Required changes
+
+_None._
+
+#### Deprecations removed
+
+_None._
+
+#### Behavior changes without code changes
+
+A REAL column fed from JSON can hold a value one ULP different from before the upgrade: the correct one.
+
+#### Verification
+
+In an empty directory, write `{"v":123456789.12345679}` to `a.ndjson` and run `dirsql query "SELECT v = 123456789.12345679 AS eq FROM './a.ndjson'" --on-file cat --format json`; the output is `[{"eq":1}]`.

{dirsql-0.4.132 → dirsql-0.4.134}/packages/rust/Cargo.toml

@@ -6,7 +6,7 @@ description = "Ephemeral SQL index over a local directory"
 # version stays for the binding crates (publish = false). The literal
 # intentionally lags the published version: putitoutthere rewrites it to
 # the planned release version at build time and never commits it back.
-version = "0.4.132"
+version = "0.4.134"
 edition.workspace = true
 # Literal `license` (not `license.workspace = true`) because
 # putitoutthere's preflight check reads `[package].license` directly

{dirsql-0.4.132 → dirsql-0.4.134/packages/rust}/docs/reference/sdk.md

@@ -212,7 +212,7 @@ await db.query(sql: str, params: Sequence | Mapping | None = None) -> list[dict]
 ```
 
 ```typescript [TypeScript]
-await db.query(sql: string) -> Record<string, unknown>[]
+await db.query(sql: string, params?: unknown[] | Record<string, unknown> | null) -> Record<string, unknown>[]
 // Runs on the libuv threadpool; the JS event loop stays responsive.
 ```
 
@@ -227,8 +227,9 @@ Executes a SQL query and returns rows keyed by column name.
 
 **Bind parameters.** `params` reaches SQLite's own parameter binding; the
 values never enter the SQL text, so text holding quotes needs no escaping.
-A sequence fills `?` placeholders in order; a mapping fills `:name`
-placeholders, keyed by the name without its prefix. It works for path-tables
+A sequence (a TypeScript array) fills `?` placeholders in order; a mapping
+(a TypeScript plain object) fills `:name`, `@name` and `$name` placeholders,
+keyed by the name without its prefix. It works for path-tables
 and declared tables alike:
 
 ::: code-group
@@ -241,6 +242,15 @@ await db.query(
 await db.query("SELECT * FROM notes WHERE author = ? AND year = ?", ("ann", 2024))
 ```
 
+```typescript [TypeScript]
+await db.query(
+  "SELECT path FROM './*.json' WHERE content ->> 'advice' = :advice",
+  { advice: text },
+);
+await db.query("SELECT * FROM notes WHERE author = ? AND year = ?", ["ann", 2024]);
+// queryOrdered takes params the same way.
+```
+
 ```rust [Rust]
 use dirsql::{Params, Value};
 use std::collections::HashMap;
@@ -259,20 +269,23 @@ db.query_with(
 
 :::
 
-TypeScript does not take bind parameters yet.
-
 - Values bind as SQLite's native types. Python accepts `None`, `int`
   (`bool` binds as `0`/`1`), `float`, `str`, `bytes` and `bytearray`;
   anything else raises `TypeError` rather than being stringified, and an
-  `int` outside the signed 64-bit range raises `OverflowError`. Rust binds a
-  `Value`.
+  `int` outside the signed 64-bit range raises `OverflowError`. TypeScript
+  accepts `null`, `number` (an integral value binds as an INTEGER, any other
+  as a REAL, so `1.0` binds as `1`), `bigint`, `boolean` (`0`/`1`), `string`,
+  and `Buffer` / `Uint8Array`; anything else, `undefined` included, rejects
+  with a `TypeError`, and a `bigint` outside the signed 64-bit range with a
+  `RangeError`. Rust binds a `Value`.
 - The params must fit the placeholders exactly, or the query fails with an
   error naming the problem: a wrong count for a sequence, a placeholder name
   the mapping lacks, a mapping key no placeholder uses, or a sequence for
   named placeholders (and a mapping for `?`). Python raises a
   `RuntimeError` for these, and a `TypeError` when `params` is neither a
-  sequence nor a mapping (a `str` counts as neither). Rust returns
-  `DbError::Params`.
+  sequence nor a mapping (a `str` counts as neither). TypeScript rejects
+  with an `Error` for these, and a `TypeError` when `params` is neither an
+  array nor a plain object. Rust returns `DbError::Params`.
 - Without `params`, a statement with placeholders fails the same way: a
   placeholder is never left unbound.
 
@@ -311,11 +324,12 @@ round-trips.
 ::: code-group
 
 ```typescript [TypeScript]
-await db.queryOrdered(sql: string) -> { columns: string[]; rows: Record<string, unknown>[] }
+await db.queryOrdered(sql: string, params?: unknown[] | Record<string, unknown> | null) -> { columns: string[]; rows: Record<string, unknown>[] }
 ```
 
 ```rust [Rust]
 db.query_ordered(sql: &str) -> Result<QueryResult>   // QueryResult { columns, rows }
+db.query_ordered_with(sql: &str, params: &Params) -> Result<QueryResult>
 ```
 
 :::