dirsql 0.4.105 → 0.4.107

package/docs/howto/query-without-config.md

@@ -65,7 +65,7 @@ why indexes belong to only one of them, are in
   `config` nor `tables` and call `query("SELECT * FROM './'")`
   ([SDK reference](../reference/sdk.md)).
 - Paths outside the root resolve too — `'/var/log/*.log'`, `'../notes'`,
-  `'~/notes/*.md'` — reporting absolute paths
+  `'~/notes/*.md'` — reporting paths as you wrote them
   ([path-tables reference](../reference/path-tables.md#paths-outside-the-index-root)).
 - `.git/` is skipped by default, and a git repo's `.gitignore` hides what it
   lists, so a bare `'./**'` does not drown in machinery

package/docs/reference/columns.md

@@ -31,7 +31,7 @@ lazily-read hidden [`content`](./path-tables.md#columns) column.
 
 | Column | Type | Value |
 |---|---|---|
-| `path` | TEXT | The file's path relative to the scan root (e.g. `posts/hello.md`); absolute for a `/`, `../` or `~/` path-table. |
+| `path` | TEXT | The file's path relative to the scan root (e.g. `posts/hello.md`); as written for a `../` path-table, absolute for a `/` or `~/` one. |
 | `basename` | TEXT | The filename, including extension (`hello.md`). |
 | `dir` | TEXT | The parent directory relative to the root (`posts`); the empty string for files directly under the root. |
 | `ext` | TEXT | The file extension without the leading dot (`md`). Original case is preserved — `Photo.JPG` yields `JPG`; use `LOWER(ext)` for case-insensitive matching. `NULL` when the file has no extension. |

package/docs/reference/glob.md

@@ -49,6 +49,13 @@ docs/nested/deep.md
 docs/nested/.cache/x.md
 node_modules/pkg/index.js
 real/r.md
+uni/1.md
+uni/a.md
+uni/é.md
+uni/É.md
+uni/中.md
+uni/٣.md
+uni/¡.md
 linkdir -> real
 link.md -> top.md
 broken -> nowhere
@@ -69,13 +76,21 @@ A test runs every row against dirsql as a path-table and, with the leading
 | Pattern | Rows | Divergence |
 | --- | --- | --- |
 | `./*.md` | `1.md`, `2.md`, `3.md`, `4.md`, `[a].md`, `[z.md`, `a.md`, `b.md`, `c.md`, `link.md`, `my file.md`, `top.md`, `{q}.md` |  |
-| `./**/*.md` | `1.md`, `2.md`, `3.md`, `4.md`, `[a].md`, `[z.md`, `a.md`, `b.md`, `c.md`, `docs/api.md`, `docs/guide.md`, `docs/nested/deep.md`, `link.md`, `linkdir/r.md`, `my file.md`, `real/r.md`, `top.md`, `{q}.md` |  |
-| `./**` | `1.md`, `2.md`, `3.md`, `4.md`, `[a].md`, `[z.md`, `a.md`, `b.md`, `c.md`, `docs/api.md`, `docs/guide.md`, `docs/nested/deep.md`, `link.md`, `my file.md`, `node_modules/pkg/index.js`, `real/r.md`, `top.md`, `x.txt`, `{q}.md` |  |
+| `./**/*.md` | `1.md`, `2.md`, `3.md`, `4.md`, `[a].md`, `[z.md`, `a.md`, `b.md`, `c.md`, `docs/api.md`, `docs/guide.md`, `docs/nested/deep.md`, `link.md`, `linkdir/r.md`, `my file.md`, `real/r.md`, `top.md`, `uni/1.md`, `uni/a.md`, `uni/¡.md`, `uni/É.md`, `uni/é.md`, `uni/٣.md`, `uni/中.md`, `{q}.md` |  |
+| `./**` | `1.md`, `2.md`, `3.md`, `4.md`, `[a].md`, `[z.md`, `a.md`, `b.md`, `c.md`, `docs/api.md`, `docs/guide.md`, `docs/nested/deep.md`, `link.md`, `my file.md`, `node_modules/pkg/index.js`, `real/r.md`, `top.md`, `uni/1.md`, `uni/a.md`, `uni/¡.md`, `uni/É.md`, `uni/é.md`, `uni/٣.md`, `uni/中.md`, `x.txt`, `{q}.md` |  |
 | `./?.md` | `1.md`, `2.md`, `3.md`, `4.md`, `a.md`, `b.md`, `c.md` |  |
 | `./[ab].md` | `a.md`, `b.md` |  |
 | `./[!a].md` | `1.md`, `2.md`, `3.md`, `4.md`, `b.md`, `c.md` |  |
 | `./\[a\].md` | `[a].md` |  |
 | `./[z.md` | `[z.md` |  |
+| `./uni/[[:alpha:]].md` | `uni/a.md`, `uni/É.md`, `uni/é.md`, `uni/٣.md`, `uni/中.md` |  |
+| `./uni/[[:alnum:]].md` | `uni/1.md`, `uni/a.md`, `uni/É.md`, `uni/é.md`, `uni/٣.md`, `uni/中.md` |  |
+| `./uni/[[:lower:]].md` | `uni/a.md`, `uni/é.md` |  |
+| `./uni/[[:upper:]].md` | `uni/É.md` |  |
+| `./uni/[[:digit:]].md` | `uni/1.md` |  |
+| `./uni/[[:punct:]].md` | `uni/¡.md` |  |
+| `./uni/[[:word:]].md` | `uni/1.md`, `uni/a.md`, `uni/É.md`, `uni/é.md`, `uni/٣.md`, `uni/中.md` |  |
+| `./uni/[![:alpha:]].md` | `uni/1.md`, `uni/¡.md` |  |
 | `./[d/x]ocs/api.md` | none |  |
 | `./docs[/]api.md` | none |  |
 | `./[!/]*/api.md` | none |  |
@@ -106,7 +121,7 @@ A test runs every row against dirsql as a path-table and, with the leading
 | `./docs/*/../api.md` | `docs/nested/../api.md` |  |
 | `./docs` | `docs/api.md`, `docs/guide.md` | directory-name |
 | `./docs/` | `docs/api.md`, `docs/guide.md` | directory-name |
-| `./*/` | `docs/api.md`, `docs/guide.md`, `linkdir/r.md`, `real/r.md` | directory-name |
+| `./*/` | `docs/api.md`, `docs/guide.md`, `linkdir/r.md`, `real/r.md`, `uni/1.md`, `uni/a.md`, `uni/¡.md`, `uni/É.md`, `uni/é.md`, `uni/٣.md`, `uni/中.md` | directory-name |
 | `./d*` | none | files-only |
 | `./*.log` | none | gitignore |
 | `./ignored.log` | `ignored.log` |  |
@@ -115,9 +130,12 @@ A test runs every row against dirsql as a path-table and, with the leading
 | `./node_modules/*/index.js` | `node_modules/pkg/index.js` |  |
 | `./docs/**/*.md` | `docs/api.md`, `docs/guide.md`, `docs/nested/deep.md` |  |
 | `./docs/*.md` | `docs/api.md`, `docs/guide.md` |  |
-| `$ROOT/docs/*.md` | `$ROOT/docs/api.md`, `$ROOT/docs/guide.md` | absolute |
-| `~/docs/*.md` | `$ROOT/docs/api.md`, `$ROOT/docs/guide.md` | absolute |
-| `../proj/docs/*.md` | `$BASE/proj/docs/api.md`, `$BASE/proj/docs/guide.md` | absolute |
+| `$ROOT/docs/*.md` | `$ROOT/docs/api.md`, `$ROOT/docs/guide.md` |  |
+| `~/docs/*.md` | `$ROOT/docs/api.md`, `$ROOT/docs/guide.md` |  |
+| `../proj/docs/*.md` | `../proj/docs/api.md`, `../proj/docs/guide.md` |  |
+| `../*/top.md` | `../proj/top.md` |  |
+| `../proj/**/deep.md` | `../proj/docs/nested/deep.md` |  |
+| `../proj/docs` | `../proj/docs/api.md`, `../proj/docs/guide.md` | directory-name |
 
 ## Divergences from bash
 
@@ -126,10 +144,17 @@ A test runs every row against dirsql as a path-table and, with the leading
 | `gitignore` | Inside a git repo, `.gitignore` files hide files and directories a wildcard matches, never one the pattern spells out. `--no-ignore` turns it off. | A query over a repo should not drown in build output. |
 | `directory-name` | A pattern's last component that names a directory lists the files directly inside it, like `ls docs`. A trailing `/` is `*` appended. | A table is rows of files, and `ls` is the shell habit. |
 | `files-only` | A pattern that matches a directory but no file returns nothing. | Every row is a file. |
-| `absolute` | `/`, `~/` and `../` patterns report absolute `path` values, with `..` folded out textually. | The scanned root is derived from the pattern, so there is no relative base. |
 
 `.git` needs no rule of its own: the dotfile rule hides it.
 
+## Syntax, not behavior
+
+A path-table starts with `./`, `/`, `~/` or `../`. That is how `FROM` tells a
+path from a table name, so `FROM './**/*.md'` is a glob and `FROM docs` is a
+table. A config `glob` has no such need and is written without the `./`.
+Bash accepts a bare `**/*.md`; dirsql does not in a path-table. This is syntax,
+not a divergence: past the prefix, the glob behaves as bash does.
+
 ## Where the glob is anchored
 
 A path-table pattern is relative to the index root and starts with `./`. A config `[[table]] glob`
@@ -146,6 +171,9 @@ stderr; the exit code is unchanged. Path-tables never warn.
   `{a..c}` expand, as do zero-padded
   `{01..10}` and stepped `{1..10..2}` ranges. Groups nest.
 - `\[` is a literal bracket.
+- POSIX classes (`[[:alpha:]]`) match Unicode characters, as bash does in a UTF-8
+  locale: `[[:alpha:]]` matches `é` and `中`. `[[:digit:]]`, `[[:xdigit:]]` and
+  `[[:ascii:]]` stay ASCII.
 - A dot-named file or directory is listed only where a component spells the
   dot at that depth: `./**/.*` finds `docs/.draft.md` but does not enter
   `.config/`.

package/docs/reference/path-tables.md

@@ -109,19 +109,15 @@ Three other prefixes resolve, with their usual shell meanings:
 | You write | dirsql scans |
 | --- | --- |
 | `'/var/log/*.log'` | an absolute path |
-| `'../notes'` | relative to the index root's parent |
+| `'../notes'` | relative to the index root's parent, as written |
 | `'~/notes/*.md'` | relative to your home directory |
 
 A directory named this way is one level too; `'../notes/**'` descends. The
 trailing-`/` rule holds here as well: `'~/*/'` is `'~/*/*'`.
-`..` is folded out textually, not followed through symlinks, so the directory
-scanned is a function of the string you wrote.
-
-**These report absolute `path` values.** A `./` path-table reports paths
-relative to the index root, matching every other dirsql table; a `/`, `../` or
-`~/` path-table has no meaningful relative base — the root it scans is derived
-from the pattern, not named by you — so it reports the full path instead. The
-value you get back is one you can paste into another command:
+**A `../` path-table reports `path` as written**, relative to the directory
+dirsql runs in, as bash prints it: `'../notes/*.md'` gives `../notes/a.md`. A
+`/` or `~/` path-table is absolute already, so it reports the full path. Either
+value is one you can paste into another command:
 
 ```sql
 SELECT path FROM '/var/log/*.log';
@@ -144,7 +140,7 @@ table:
 
 | Column | Type | Meaning |
 | --- | --- | --- |
-| `path` | TEXT | path relative to the index root (absolute for `/`, `../`, `~/` tables) |
+| `path` | TEXT | path relative to the index root (as written for `../` tables, absolute for `/` and `~/` tables) |
 | `basename` | TEXT | filename with extension |
 | `dir` | TEXT | parent directory, relative to the index root |
 | `ext` | TEXT | extension without the dot |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dirsql",
-  "version": "0.4.105",
+  "version": "0.4.107",
   "description": "Ephemeral SQL index over a local directory",
   "license": "MIT",
   "repository": "https://github.com/thekevinscott/dirsql",
@@ -221,10 +221,10 @@
     ]
   },
   "optionalDependencies": {
-    "@dirsql/lib-linux-x64-gnu": "0.4.105",
-    "@dirsql/lib-linux-arm64-gnu": "0.4.105",
-    "@dirsql/lib-darwin-x64": "0.4.105",
-    "@dirsql/lib-darwin-arm64": "0.4.105",
-    "@dirsql/lib-win32-x64-msvc": "0.4.105"
+    "@dirsql/lib-linux-x64-gnu": "0.4.107",
+    "@dirsql/lib-linux-arm64-gnu": "0.4.107",
+    "@dirsql/lib-darwin-x64": "0.4.107",
+    "@dirsql/lib-darwin-arm64": "0.4.107",
+    "@dirsql/lib-win32-x64-msvc": "0.4.107"
   }
 }