tabalyst 0.5.0__tar.gz → 0.5.1__tar.gz

{tabalyst-0.5.0/src/tabalyst.egg-info → tabalyst-0.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tabalyst
-Version: 0.5.0
+Version: 0.5.1
 Summary: Open-source toolkit for understanding and working with unfamiliar data.
 Author: Gregory Borelli
 License-Expression: MIT
@@ -270,9 +270,10 @@ Inspect is optional: `tabalyst scan` and `tabalyst report` inspect a JSON file
 themselves when it has no Inspect file. When several arrays are equally
 plausible, or none holds objects, they stop with exit code `2` before analyzing
 anything and list the candidates; set `config.structure.dataset_path` in the
-Inspect file, or pass `--collection`. See
-[Inspect JSON and JSONL files](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/how-to/inspect-json-files.md)
-and the [Inspect format](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/reference/inspect-format.md).
+Inspect file, or pass `--collection` (`--collection customers` or
+`--collection '$.customers[]'`). See
+[Inspect JSON and JSONL files](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/inspect/json.md)
+and the [Inspect format](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/inspect/format.md).
 
 ## Tabalyst Scan
 
@@ -328,8 +329,8 @@ tabalyst cache clean customers.csv
 `cache clean` leaves project scans and databases in place. Ordinary scans and
 reports do not create these query caches.
 
-See [Scan CSV and JSON files](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/how-to/scan-files.md)
-and the [scan format](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/reference/scan-format.md).
+See [Scan CSV and JSON files](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/scan/files.md)
+and the [scan format](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/scan/format.md).
 
 ## What the report analyzes
 
@@ -452,7 +453,8 @@ Additional documentation:
 
 - [Architecture](https://github.com/loribel-labs/tabalyst/blob/main/docs/dev/architecture.md)
 - [Configuration](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/reference/configuration.md)
-- [Inspect JSON and JSONL files](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/how-to/inspect-json-files.md)
+- [Inspect JSON and JSONL files](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/inspect/json.md)
+- [Documentation site](https://docs.tabalyst.com/)
 - [Release procedure](https://github.com/loribel-labs/tabalyst/blob/main/RELEASING.md)
 
 Please report defects and feature requests through the

{tabalyst-0.5.0 → tabalyst-0.5.1}/README.md

@@ -234,9 +234,10 @@ Inspect is optional: `tabalyst scan` and `tabalyst report` inspect a JSON file
 themselves when it has no Inspect file. When several arrays are equally
 plausible, or none holds objects, they stop with exit code `2` before analyzing
 anything and list the candidates; set `config.structure.dataset_path` in the
-Inspect file, or pass `--collection`. See
-[Inspect JSON and JSONL files](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/how-to/inspect-json-files.md)
-and the [Inspect format](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/reference/inspect-format.md).
+Inspect file, or pass `--collection` (`--collection customers` or
+`--collection '$.customers[]'`). See
+[Inspect JSON and JSONL files](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/inspect/json.md)
+and the [Inspect format](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/inspect/format.md).
 
 ## Tabalyst Scan
 
@@ -292,8 +293,8 @@ tabalyst cache clean customers.csv
 `cache clean` leaves project scans and databases in place. Ordinary scans and
 reports do not create these query caches.
 
-See [Scan CSV and JSON files](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/how-to/scan-files.md)
-and the [scan format](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/reference/scan-format.md).
+See [Scan CSV and JSON files](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/scan/files.md)
+and the [scan format](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/scan/format.md).
 
 ## What the report analyzes
 
@@ -416,7 +417,8 @@ Additional documentation:
 
 - [Architecture](https://github.com/loribel-labs/tabalyst/blob/main/docs/dev/architecture.md)
 - [Configuration](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/reference/configuration.md)
-- [Inspect JSON and JSONL files](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/how-to/inspect-json-files.md)
+- [Inspect JSON and JSONL files](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/inspect/json.md)
+- [Documentation site](https://docs.tabalyst.com/)
 - [Release procedure](https://github.com/loribel-labs/tabalyst/blob/main/RELEASING.md)
 
 Please report defects and feature requests through the

{tabalyst-0.5.0 → tabalyst-0.5.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tabalyst"
-version = "0.5.0"
+version = "0.5.1"
 description = "Open-source toolkit for understanding and working with unfamiliar data."
 readme = "README.md"
 requires-python = ">=3.11"

{tabalyst-0.5.0 → tabalyst-0.5.1}/src/tabalyst/cli/inspect.py

@@ -40,6 +40,24 @@ def _configured(success: InspectResult) -> str | None:
     return f"Configured collection: {chosen} (kept from the existing file)"
 
 
+def _choices(success: InspectResult) -> list[str]:
+    """Ready-to-run report commands, one per eligible collection, when the
+    detection could not choose between them."""
+    detection = success.document.detection
+    if detection.selection.basis != "ambiguous":
+        return []
+    source = str(success.source)
+    if " " in source:
+        source = f'"{source}"'
+    lines = ["Choose the collection to analyze:"]
+    lines.extend(
+        f"  tabalyst report {source} --collection '{candidate.path}'"
+        for candidate in detection.candidates
+        if candidate.eligible
+    )
+    return lines
+
+
 def _print_success(success: InspectResult, *, verbose: bool) -> None:
     typer.echo(f"Inspect: {success.path.resolve()}", err=True)
     typer.echo(_selection(success), err=True)
@@ -81,6 +99,8 @@ def _print_batch_result(
         for warning in success.document.warnings:
             if warning.level == "warning" or verbose:
                 typer.echo(f"Warning [{success.source}]: {warning.message}", err=True)
+        for line in _choices(success):
+            typer.echo(line, err=True)
     for failure in batch.failures:
         typer.echo(f"Error [{failure.job.source}]: {failure.error}", err=True)
 

{tabalyst-0.5.0 → tabalyst-0.5.1}/src/tabalyst/cli/report.py

@@ -6,7 +6,13 @@ from typing import Annotated
 
 import typer
 
-from tabalyst.cli.terminal import ProgressPrinter, batch_exit_code, error_exit_code
+from tabalyst.cli.terminal import (
+    COLLECTION_HELP,
+    ProgressPrinter,
+    batch_exit_code,
+    collection_paths,
+    error_exit_code,
+)
 from tabalyst.errors import TabalystError
 from tabalyst.report_service import BatchReportResult, ReportSuccess, generate_reports
 
@@ -116,6 +122,10 @@ def report_command(
         Path | None,
         typer.Option("--config", "-c", help="JSON configuration file."),
     ] = None,
+    collection: Annotated[
+        list[str] | None,
+        typer.Option("--collection", help=COLLECTION_HELP),
+    ] = None,
     from_scan: Annotated[
         bool,
         typer.Option(
@@ -178,6 +188,7 @@ def report_command(
             output_dir=output_dir,
             separator=delimiter,
             encoding=encoding,
+            collections=collection_paths(collection),
             config_path=config,
             force=force,
             details=details,

{tabalyst-0.5.0 → tabalyst-0.5.1}/src/tabalyst/cli/scan.py

@@ -6,7 +6,13 @@ from typing import Annotated
 
 import typer
 
-from tabalyst.cli.terminal import ProgressPrinter, batch_exit_code, error_exit_code
+from tabalyst.cli.terminal import (
+    COLLECTION_HELP,
+    ProgressPrinter,
+    batch_exit_code,
+    collection_paths,
+    error_exit_code,
+)
 from tabalyst.errors import TabalystError
 from tabalyst.scan_service import BatchScanResult, ScanSuccess, generate_scans
 
@@ -124,7 +130,7 @@ def scan_command(
         list[str] | None,
         typer.Option(
             "--collection",
-            help="JSON collection path such as '$.customers[]'; repeatable.",
+            help=COLLECTION_HELP,
         ),
     ] = None,
     delimiter: Annotated[
@@ -178,7 +184,7 @@ def scan_command(
             config_path=config,
             delimiter=delimiter,
             encoding=encoding,
-            collections=collection,
+            collections=collection_paths(collection),
             force=force,
             on_progress=progress,
             workers=workers,

{tabalyst-0.5.0 → tabalyst-0.5.1}/src/tabalyst/cli/terminal.py

@@ -7,6 +7,36 @@ import typer
 
 from tabalyst.errors import ConfigurationError, InputError, TabalystError
 from tabalyst.progress import ProgressEvent, ProgressPhase
+from tabalyst.scanner.paths import ITEMS, format_absolute, parse_path
+
+COLLECTION_HELP = (
+    "JSON collection: an array path such as '$.data.items[]', or its short "
+    "form data.items; repeatable."
+)
+
+
+def collection_paths(values: list[str] | None) -> list[str] | None:
+    """``--collection`` values as absolute paths. Without the leading ``$``, the
+    value is the keys leading to the array, so ``data.items`` is
+    ``$.data.items[]``, and ``.`` is the root array, ``$[]``; a collection is always an array, so ``[]`` is implied."""
+    if values is None:
+        return None
+    paths = []
+    for value in values:
+        if value.startswith("$"):
+            paths.append(value)
+            continue
+        if value == ".":
+            paths.append(format_absolute((ITEMS,)))
+            continue
+        try:
+            path = parse_path(value, numeric_keys=True)
+        except ValueError as exc:
+            raise typer.BadParameter(str(exc), param_hint="--collection") from exc
+        if not path or path[-1] != ITEMS:
+            path = (*path, ITEMS)
+        paths.append(format_absolute(path))
+    return paths
 
 
 def error_exit_code(error: TabalystError) -> int:

{tabalyst-0.5.0 → tabalyst-0.5.1}/src/tabalyst/report_service.py

@@ -174,6 +174,7 @@ def generate_reports(
     output_dir: str | Path | None = None,
     separator: str | None = None,
     encoding: str | None = None,
+    collections: Sequence[str] | None = None,
     config_path: ConfigPath | None = None,
     force: bool = False,
     details: bool = False,
@@ -186,7 +187,9 @@ def generate_reports(
     With ``from_scan``, the inputs are scan documents written by
     ``tabalyst scan``: each report is built from its document without reading
     the source again, after the staleness checks of ``tabalyst.scan_reuse``.
-    Otherwise ``workers`` is passed to ``tabalyst.scan()``.
+    Otherwise ``workers`` is passed to ``tabalyst.scan()``, and ``collections``
+    (absolute paths such as ``$.products[]``) choose the JSON collections to
+    analyze, over the Inspect file and the configuration.
     Set ``details=True`` to write a standalone HTML page for each column.
     """
     if from_scan and (separator is not None or encoding is not None):
@@ -199,6 +202,11 @@ def generate_reports(
             "--workers cannot be used with --scan: the report reads the scan "
             "document, not its source."
         )
+    if from_scan and collections:
+        raise ConfigurationError(
+            "--collection cannot be used with --scan: the scan document records "
+            "which collection it analyzed."
+        )
     plan = build_report_plan(
         input_specs,
         output=output,
@@ -265,6 +273,7 @@ def generate_reports(
                     scan_layer=report_scan_layer,
                     separator=separator,
                     encoding=encoding,
+                    collections=collections,
                 )
         except TabalystError as exc:
             failures.append(ReportFailure(job=job, error=exc))

{tabalyst-0.5.0 → tabalyst-0.5.1}/src/tabalyst/scanner/paths.py

@@ -41,6 +41,7 @@ ROOT: FieldPath = ()
 ROOT_DISPLAY = "$"
 
 _IDENTIFIER = re.compile(r"[A-Za-z_][A-Za-z0-9_]*")
+_NUMERIC_KEY = re.compile(r"[A-Za-z0-9_]+")
 _DECODER = json.JSONDecoder()
 
 
@@ -92,19 +93,23 @@ def format_relative(path: FieldPath, separator: str = ".") -> str:
     return _segments_display(path, leading=True, separator=separator)
 
 
-def parse_path(text: str, *, separator: str = ".") -> FieldPath:
+def parse_path(
+    text: str, *, separator: str = ".", numeric_keys: bool = False
+) -> FieldPath:
     """Parse the absolute (``$...``) or relative display syntax into segments.
 
     ``separator`` applies to relative texts only: an absolute path (starting
-    with ``$``) always uses ``.``.
+    with ``$``) always uses ``.``. With ``numeric_keys``, a bare key may start
+    with a digit, such as ``categories.121``.
     """
+    key = _NUMERIC_KEY if numeric_keys else _IDENTIFIER
     position = 0
     segments: list[Segment] = []
     if text.startswith(ROOT_DISPLAY):
         position = 1
         separator = "."
     elif text:
-        identifier = _IDENTIFIER.match(text)
+        identifier = key.match(text)
         if identifier is not None:
             segments.append(Key(identifier.group()))
             position = identifier.end()
@@ -116,7 +121,7 @@ def parse_path(text: str, *, separator: str = ".") -> FieldPath:
     while position < len(text):
         if text.startswith(separator, position):
             start = position + len(separator)
-            identifier = _IDENTIFIER.match(text, start)
+            identifier = key.match(text, start)
             if identifier is None:
                 raise ValueError(
                     f"Invalid path {text!r}: expected a key at position {start}"

{tabalyst-0.5.0 → tabalyst-0.5.1}/src/tabalyst/service.py

@@ -228,6 +228,7 @@ def _analyze_resolved(
     scan_layer: dict | None = None,
     separator: str | None = None,
     encoding: str | None = None,
+    collections: Sequence[str] | None = None,
 ) -> tuple[dict[str, Any], tuple[str, ...]]:
     started = perf_counter()
     json_report, execution_report = _validate_paths(
@@ -251,6 +252,7 @@ def _analyze_resolved(
             interpretation = resolve_interpretation(
                 source,
                 scan_layer=scan_layer,
+                collections=collections,
                 delimiter=separator,
                 encoding=encoding,
             )

{tabalyst-0.5.0 → tabalyst-0.5.1}/src/tabalyst/static/report.js

@@ -4,22 +4,31 @@
   const $ = (s, c = document) => c.querySelector(s);
   const $$ = (s, c = document) => Array.from(c.querySelectorAll(s));
 
-  /* theme */
+  /* theme: auto (system preference) -> light -> dark */
   const themeBtn = $('#theme-toggle');
-  const setTheme = (t) => {
-    root.dataset.theme = t;
+  const modes = ['auto', 'light', 'dark'];
+  const media = window.matchMedia ? window.matchMedia('(prefers-color-scheme: light)') : null;
+  const setMode = (m) => {
+    root.dataset.themeMode = m;
+    root.dataset.theme = m === 'auto' ? (media && media.matches ? 'light' : 'dark') : m;
     if (themeBtn) {
-      const next = t === 'dark' ? 'light' : 'dark';
-      themeBtn.setAttribute('aria-label', 'Switch to ' + next + ' theme');
-      themeBtn.title = 'Switch to ' + next + ' theme';
-      $$('[data-icon]', themeBtn).forEach((el) => { el.toggleAttribute('hidden', el.dataset.icon !== t); });
+      const label = 'Theme: ' + (m === 'auto' ? 'auto (system)' : m) + '. Click to change.';
+      themeBtn.setAttribute('aria-label', label);
+      themeBtn.title = label;
+      $$('[data-icon]', themeBtn).forEach((el) => { el.toggleAttribute('hidden', el.dataset.icon !== m); });
     }
   };
-  setTheme(root.dataset.theme || 'dark');
+  setMode(root.dataset.themeMode || 'auto');
+  media && media.addEventListener && media.addEventListener('change', () => {
+    if (root.dataset.themeMode === 'auto') setMode('auto');
+  });
   themeBtn && themeBtn.addEventListener('click', () => {
-    const t = root.dataset.theme === 'dark' ? 'light' : 'dark';
-    setTheme(t);
-    try { localStorage.setItem('tabalyst-theme', t); } catch (e) { /* storage unavailable */ }
+    const m = modes[(modes.indexOf(root.dataset.themeMode) + 1) % modes.length];
+    setMode(m);
+    try {
+      if (m === 'auto') localStorage.removeItem('tabalyst-theme');
+      else localStorage.setItem('tabalyst-theme', m);
+    } catch (e) { /* storage unavailable */ }
   });
 
   /* print: show every section */

{tabalyst-0.5.0 → tabalyst-0.5.1}/src/tabalyst/templates/column.html

@@ -8,7 +8,7 @@
 <meta name="generator" content="Tabalyst column report">
 <meta name="theme-color" content="#00051A">
 <link rel="icon" type="image/svg+xml" href="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20viewBox='0%200%2064%2064'%3E%3Crect%20width='64'%20height='64'%20rx='14'%20fill='%2300051a'/%3E%3Cpath%20d='M14%2015h36v10H37v25H27V25H14z'%20fill='%23f98510'/%3E%3C/svg%3E">
-<script>(()=>{let t="dark";try{const s=localStorage.getItem("tabalyst-theme");if(s==="light"||s==="dark")t=s}catch(e){}document.documentElement.dataset.theme=t})();</script>
+<script>(()=>{let m="auto";try{const s=localStorage.getItem("tabalyst-theme");if(s==="light"||s==="dark")m=s}catch(e){}const r=document.documentElement;r.dataset.themeMode=m;r.dataset.theme=m==="auto"?(window.matchMedia&&matchMedia("(prefers-color-scheme: light)").matches?"light":"dark"):m})();</script>
 <style>{{ theme_css | safe }}</style>
 </head>
 <body>
@@ -32,7 +32,7 @@
     <p class="side-group">Navigation</p>
     <a class="rep-tab" href="{{ report_href }}"><small>↖</small>Full report</a>
   </nav>
-  <div class="side-foot"><div class="row"><button type="button" id="theme-toggle" class="btn btn-icon" aria-label="Switch to light theme" title="Switch to light theme"><svg data-icon="dark" viewBox="0 0 16 16" aria-hidden="true"><circle cx="8" cy="8" r="3"/><path d="M8 1.5v1.5M8 13v1.5M1.5 8H3M13 8h1.5M3.4 3.4l1 1M11.6 11.6l1 1M3.4 12.6l1-1M11.6 4.4l1-1"/></svg><svg data-icon="light" viewBox="0 0 16 16" aria-hidden="true" hidden><path d="M13.5 9.5A5.5 5.5 0 0 1 6.5 2.5a5.5 5.5 0 1 0 7 7z"/></svg></button><button type="button" class="btn print" data-print style="flex:1">Print / PDF</button></div></div>
+  <div class="side-foot"><div class="row"><button type="button" id="theme-toggle" class="btn btn-icon" aria-label="Theme: auto (system)" title="Theme: auto (system)"><svg data-icon="auto" viewBox="0 0 16 16" aria-hidden="true"><rect x="2" y="2.5" width="12" height="8.5" rx="1"/><path d="M5.5 14h5M8 11v3"/></svg><svg data-icon="light" viewBox="0 0 16 16" aria-hidden="true" hidden><circle cx="8" cy="8" r="3"/><path d="M8 1.5v1.5M8 13v1.5M1.5 8H3M13 8h1.5M3.4 3.4l1 1M11.6 11.6l1 1M3.4 12.6l1-1M11.6 4.4l1-1"/></svg><svg data-icon="dark" viewBox="0 0 16 16" aria-hidden="true" hidden><path d="M13.5 9.5A5.5 5.5 0 0 1 6.5 2.5a5.5 5.5 0 1 0 7 7z"/></svg></button><button type="button" class="btn print" data-print style="flex:1">Print / PDF</button></div></div>
 </aside>
 <div class="main"><div class="ds" data-ds="0">
 <header class="rhead"><div class="wrap"><p class="eyebrow">Column report · {{ report.source.filename }}{% if report.source.format in ('json', 'jsonl') %} · {{ ds.id }}{% endif %}</p><div class="rhead-top"><div><h1>{{ column.name or '(unnamed)' }}</h1><ul class="facts"><li><b>Column {{ column.position }}</b> of {{ ds.summary.column_count }}</li><li><code>{{ column.path }}</code></li><li>{{ ds.summary.row_count | count }} {{ 'records' if report.source.format in ('json', 'jsonl') else 'rows' }}</li></ul></div><a class="btn" href="{{ report_href }}">← Full report</a></div></div></header>

{tabalyst-0.5.0 → tabalyst-0.5.1}/src/tabalyst/templates/report.html

@@ -7,7 +7,7 @@
 <meta name="description" content="Tabalyst profiling report for {{ report.source.filename }}">
 <meta name="theme-color" content="#00051A">
 <link rel="icon" type="image/svg+xml" href="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20viewBox='0%200%2064%2064'%3E%3Crect%20width='64'%20height='64'%20rx='14'%20fill='%2300051a'/%3E%3Cpath%20d='M14%2015h36v10H37v25H27V25H14z'%20fill='%23f98510'/%3E%3C/svg%3E">
-<script>(()=>{let t="dark";try{const s=localStorage.getItem("tabalyst-theme");if(s==="light"||s==="dark")t=s}catch(e){}document.documentElement.dataset.theme=t})();</script>
+<script>(()=>{let m="auto";try{const s=localStorage.getItem("tabalyst-theme");if(s==="light"||s==="dark")m=s}catch(e){}const r=document.documentElement;r.dataset.themeMode=m;r.dataset.theme=m==="auto"?(window.matchMedia&&matchMedia("(prefers-color-scheme: light)").matches?"light":"dark"):m})();</script>
 <style>{{ theme_css | safe }}</style>
 </head>
 <body>
@@ -77,7 +77,7 @@
     {% endfor %}
     <div class="side-foot">
       <button type="button" class="btn reset-all" id="reset-all" hidden><svg viewBox="0 0 16 16" aria-hidden="true"><path d="M3 8a5 5 0 1 0 1.5-3.5M3 2.5V5h2.5"/></svg>Reset all filters<span class="c" id="reset-all-count"></span></button>
-      <div class="row"><button type="button" id="theme-toggle" class="btn btn-icon" aria-label="Switch to light theme" title="Switch to light theme"><svg data-icon="dark" viewBox="0 0 16 16" aria-hidden="true"><circle cx="8" cy="8" r="3"/><path d="M8 1.5v1.5M8 13v1.5M1.5 8H3M13 8h1.5M3.4 3.4l1 1M11.6 11.6l1 1M3.4 12.6l1-1M11.6 4.4l1-1"/></svg><svg data-icon="light" viewBox="0 0 16 16" aria-hidden="true" hidden><path d="M13.5 9.5A5.5 5.5 0 0 1 6.5 2.5a5.5 5.5 0 1 0 7 7z"/></svg></button><button type="button" class="btn print" data-print style="flex:1"><svg viewBox="0 0 16 16" aria-hidden="true"><path d="M4 6V2h8v4M4 12H2.5V6.5h11V12H12M4 10h8v4H4z"/></svg>Print / PDF</button></div>
+      <div class="row"><button type="button" id="theme-toggle" class="btn btn-icon" aria-label="Theme: auto (system)" title="Theme: auto (system)"><svg data-icon="auto" viewBox="0 0 16 16" aria-hidden="true"><rect x="2" y="2.5" width="12" height="8.5" rx="1"/><path d="M5.5 14h5M8 11v3"/></svg><svg data-icon="light" viewBox="0 0 16 16" aria-hidden="true" hidden><circle cx="8" cy="8" r="3"/><path d="M8 1.5v1.5M8 13v1.5M1.5 8H3M13 8h1.5M3.4 3.4l1 1M11.6 11.6l1 1M3.4 12.6l1-1M11.6 4.4l1-1"/></svg><svg data-icon="dark" viewBox="0 0 16 16" aria-hidden="true" hidden><path d="M13.5 9.5A5.5 5.5 0 0 1 6.5 2.5a5.5 5.5 0 1 0 7 7z"/></svg></button><button type="button" class="btn print" data-print style="flex:1"><svg viewBox="0 0 16 16" aria-hidden="true"><path d="M4 6V2h8v4M4 12H2.5V6.5h11V12H12M4 10h8v4H4z"/></svg>Print / PDF</button></div>
     </div>
   </aside>
   <div class="main">

{tabalyst-0.5.0 → tabalyst-0.5.1/src/tabalyst.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tabalyst
-Version: 0.5.0
+Version: 0.5.1
 Summary: Open-source toolkit for understanding and working with unfamiliar data.
 Author: Gregory Borelli
 License-Expression: MIT
@@ -270,9 +270,10 @@ Inspect is optional: `tabalyst scan` and `tabalyst report` inspect a JSON file
 themselves when it has no Inspect file. When several arrays are equally
 plausible, or none holds objects, they stop with exit code `2` before analyzing
 anything and list the candidates; set `config.structure.dataset_path` in the
-Inspect file, or pass `--collection`. See
-[Inspect JSON and JSONL files](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/how-to/inspect-json-files.md)
-and the [Inspect format](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/reference/inspect-format.md).
+Inspect file, or pass `--collection` (`--collection customers` or
+`--collection '$.customers[]'`). See
+[Inspect JSON and JSONL files](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/inspect/json.md)
+and the [Inspect format](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/inspect/format.md).
 
 ## Tabalyst Scan
 
@@ -328,8 +329,8 @@ tabalyst cache clean customers.csv
 `cache clean` leaves project scans and databases in place. Ordinary scans and
 reports do not create these query caches.
 
-See [Scan CSV and JSON files](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/how-to/scan-files.md)
-and the [scan format](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/reference/scan-format.md).
+See [Scan CSV and JSON files](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/scan/files.md)
+and the [scan format](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/scan/format.md).
 
 ## What the report analyzes
 
@@ -452,7 +453,8 @@ Additional documentation:
 
 - [Architecture](https://github.com/loribel-labs/tabalyst/blob/main/docs/dev/architecture.md)
 - [Configuration](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/reference/configuration.md)
-- [Inspect JSON and JSONL files](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/how-to/inspect-json-files.md)
+- [Inspect JSON and JSONL files](https://github.com/loribel-labs/tabalyst/blob/main/docs/en/inspect/json.md)
+- [Documentation site](https://docs.tabalyst.com/)
 - [Release procedure](https://github.com/loribel-labs/tabalyst/blob/main/RELEASING.md)
 
 Please report defects and feature requests through the

{tabalyst-0.5.0 → tabalyst-0.5.1}/tests/test_cli.py

@@ -16,7 +16,7 @@ def _isolated_project_home(tmp_path, monkeypatch):
 
 
 def test_source_checkout_reports_pyproject_version():
-    assert tabalyst_version() == "0.5.0"
+    assert tabalyst_version() == "0.5.1"
 
 
 def test_root_help_and_version_describe_the_toolkit():
@@ -27,7 +27,7 @@ def test_root_help_and_version_describe_the_toolkit():
 
     version_result = runner.invoke(app, ["--version"])
     assert version_result.exit_code == 0
-    assert version_result.output.strip() == "0.5.0"
+    assert version_result.output.strip() == "0.5.1"
 
 
 def test_report_generates_html_json_and_history(tmp_path):