dirsql 0.4.113__tar.gz → 0.4.115__tar.gz

{dirsql-0.4.113 → dirsql-0.4.115}/Cargo.lock

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

{dirsql-0.4.113 → dirsql-0.4.115}/PKG-INFO

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

{dirsql-0.4.113 → dirsql-0.4.115}/docs/.vitepress/config.ts

@@ -79,7 +79,8 @@ export default defineConfig({
             { text: 'Path-tables', link: '/reference/path-tables' },
             { text: 'Globs', link: '/reference/glob' },
             { text: 'HTTP API', link: '/reference/http-api' },
-            { text: 'SDK', link: '/reference/sdk' }
+            { text: 'SDK', link: '/reference/sdk' },
+            { text: 'Speed', link: '/speed' }
           ]
         },
         {

{dirsql-0.4.113 → dirsql-0.4.115}/docs/context/usage.md

@@ -46,6 +46,10 @@ Every row has `path`, `basename`, `dir`, `ext` (no dot, `NULL` when absent), `si
 3. One row per record inside each file, inline: `--on-file <command>` attaches a parser to every path-table in the query. The parser prints one JSON object per line (NDJSON, never an array), and its output replaces the stat columns. See [hooks](https://dirsql.dev/reference/hooks).
 4. Search by meaning: `uvx --with dirsql-plugin-embeddings dirsql "<sql>" --format json` adds `embed()` and `vec_distance_cosine()`. See [search by meaning](https://dirsql.dev/howto/search-by-meaning).
 
+### Browser
+
+When a person wants to explore the tree by hand, `uvx dirsql server --frontend` serves a SQL explorer and prints its URL (`Frontend at http://localhost:7117/`); add `-c .dirsql.toml` to list declared tables. The page runs nothing until **Run** is pressed; press it again to refresh. A config that fails to load shows its diagnostic in the page. It runs until Ctrl-C.
+
 ### Read-only
 
 dirsql never writes to, moves or changes the files it scans, and it rejects mutating SQL. Do not pass `--persist`: it writes a cache database into the directory.

{dirsql-0.4.113/packages/rust → dirsql-0.4.115}/docs/reference/cli.md

@@ -264,9 +264,20 @@ and declared tables reflect the server's index. The page does not use
 
 ```bash
 dirsql server --frontend
+# Frontend at http://localhost:7117/
+# Running at localhost:7117
 dirsql server --frontend -c .dirsql.toml
 ```
 
+Every distribution embeds the same page and script in its binary, so
+`npx dirsql server --frontend`, `uvx dirsql server --frontend`, and the
+`cargo install`ed `dirsql server --frontend` serve the identical UI offline,
+with no separate frontend runtime. In the page, a path-table query such as
+`SELECT basename, size FROM './posts' ORDER BY basename` runs with or
+without `-c`; a declared table such as `SELECT title, author FROM posts`
+needs the config that declares it, passed with `-c`. The frontend stops like
+the API-only server: `SIGINT` or `SIGTERM` exits `0`.
+
 The shell reads `GET /frontend/state`. When the index is ready it returns
 HTTP `200`: