lql-cli 0.5.0__tar.gz → 0.6.0__tar.gz

{lql_cli-0.5.0 → lql_cli-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lql-cli
-Version: 0.5.0
+Version: 0.6.0
 Summary: lql — CLI for the Liquid DataViewer platform
 Project-URL: Homepage, https://github.com/Liquid4All/lql
 Author: Liquid AI
@@ -189,10 +189,11 @@ and **`p` plays** the current sample's audio via the system player (`afplay`/
 `open`). Images render inline in pager mode (one sample at a time); scroll mode
 shows placeholders to avoid decoding the whole buffer.
 
-**Navigation** — two modes, toggle with `m` / `Tab`:
+**Navigation** — two modes, toggle with `m`:
 
 - **pager** (default): one sample at a time · `←/→` or `n`/`b` switch samples · `↑/↓`/`j`/`k`/PgUp-Dn scroll
 - **scroll**: all samples in one buffer · `n`/`b` jump between samples · arrows scroll
+- **copy**: `Tab`/`Shift+Tab` move a highlight between blocks · `c` copies the focused message/field · `Y` copies the whole sample as JSON (via OSC 52 — reaches your **local** clipboard over SSH where the terminal supports it, e.g. Ghostty/iTerm2; not macOS Terminal)
 - `p` play audio · `q` quits
 
 ```

{lql_cli-0.5.0 → lql_cli-0.6.0}/README.md

@@ -173,10 +173,11 @@ and **`p` plays** the current sample's audio via the system player (`afplay`/
 `open`). Images render inline in pager mode (one sample at a time); scroll mode
 shows placeholders to avoid decoding the whole buffer.
 
-**Navigation** — two modes, toggle with `m` / `Tab`:
+**Navigation** — two modes, toggle with `m`:
 
 - **pager** (default): one sample at a time · `←/→` or `n`/`b` switch samples · `↑/↓`/`j`/`k`/PgUp-Dn scroll
 - **scroll**: all samples in one buffer · `n`/`b` jump between samples · arrows scroll
+- **copy**: `Tab`/`Shift+Tab` move a highlight between blocks · `c` copies the focused message/field · `Y` copies the whole sample as JSON (via OSC 52 — reaches your **local** clipboard over SSH where the terminal supports it, e.g. Ghostty/iTerm2; not macOS Terminal)
 - `p` play audio · `q` quits
 
 ```

{lql_cli-0.5.0 → lql_cli-0.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "lql-cli"
-version = "0.5.0"
+version = "0.6.0"
 description = "lql — CLI for the Liquid DataViewer platform"
 readme = "README.md"
 requires-python = ">=3.12"

lql_cli-0.6.0/src/lql/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.6.0"

{lql_cli-0.5.0 → lql_cli-0.6.0}/src/lql/commands/instructions.py

@@ -103,7 +103,7 @@ Options: -c/--column (field(s) to treat as conversations; default auto-detect,
 repeatable), -n/--limit (page size when paging a platform dataset), --offset
 (start row index), --title, --hf, --split, --workspace, --profile, --api-url.
 
-Navigation: two modes toggled with m/Tab — pager (one sample at a time; ←/→ or
+Navigation: two modes toggled with m — pager (one sample at a time; ←/→ or
 n/b switch samples, ↑/↓/j/k scroll) and scroll (all samples; n/b jump between
 them). q quits. Works over plain SSH with no browser or port-forward.
 
@@ -112,6 +112,11 @@ Sixel; placeholder otherwise) for both multimodal image segments and image-mode
 columns; audio shows a ♪ line and `p` plays the current sample's clip via the
 system player (afplay/open).
 
+Copy: Tab/Shift+Tab move a highlight between blocks, `c` copies the focused
+message/field, `Y` copies the whole sample as JSON — via OSC 52, reaching the
+local clipboard over SSH where the terminal supports it (e.g. Ghostty/iTerm2;
+not macOS Terminal).
+
 ## Evals
 
 Eval datasets (evaluation-run output: each row a sample with a model 'response'

{lql_cli-0.5.0 → lql_cli-0.6.0}/src/lql/commands/tui.py

@@ -375,22 +375,44 @@ def _field(key: str, value: object, inline_images: bool = False) -> Panel:
     return Panel(body, title=f"[dim]{escape(str(key))}[/]", title_align="left", border_style="grey30", box=box.MINIMAL)
 
 
-def render_sample(
+def _field_copy_text(value: object) -> str:
+    return value if isinstance(value, str) else json.dumps(value, ensure_ascii=False, indent=2, default=str)
+
+
+def sample_blocks(
     row: object, forced_cols: Optional[List[str]] = None, width: Optional[int] = None, inline_images: bool = False
-) -> RenderableType:
-    blocks: List[RenderableType] = []
+) -> List[tuple]:
+    """Return [(renderable, copy_text), ...] — one entry per message/field, with
+    the raw text to copy. copy_text is None for non-copyable bits (e.g. a column
+    label). Single source for both render_sample (Group) and the focusable
+    per-block widgets in the viewer."""
+    blocks: List[tuple] = []
+
+    def _conv(raw: list, col: Optional[str]) -> None:
+        if col:
+            blocks.append((Text(col, style="dim"), None))
+        for m in _parse_messages(raw):
+            blocks.append((_message(m, width, inline_images), m.get("content") or ""))
+
     if _is_conversation(row):
-        blocks.extend(_conversation(row, width=width, inline_images=inline_images))
+        _conv(row, None)
     elif isinstance(row, dict):
         for key, val in row.items():
             forced = forced_cols is not None and key in forced_cols
             auto = forced_cols is None and _is_conversation(val)
             if (forced or auto) and _is_conversation(val):
-                blocks.extend(_conversation(val, col=key, width=width, inline_images=inline_images))
+                _conv(val, key)
             else:
-                blocks.append(_field(key, val, inline_images))
+                blocks.append((_field(key, val, inline_images), _field_copy_text(val)))
     else:
-        blocks.append(_field("value", row, inline_images))
+        blocks.append((_field("value", row, inline_images), _field_copy_text(row)))
+    return blocks
+
+
+def render_sample(
+    row: object, forced_cols: Optional[List[str]] = None, width: Optional[int] = None, inline_images: bool = False
+) -> RenderableType:
+    blocks = [r for r, _ in sample_blocks(row, forced_cols, width, inline_images)]
     return Group(*blocks) if blocks else Text("(empty sample)", style="dim")
 
 
@@ -533,16 +555,31 @@ def run(
     except Exception:
         pass
 
+    class CopyBlock(Static):
+        """A focusable block (message/field/sample) that remembers the raw text
+        to copy. Tab/Shift+Tab move focus between blocks; `c` copies the focused
+        one to the clipboard (via OSC 52, so it works over SSH)."""
+
+        can_focus = True
+
+        def __init__(self, renderable, copy_text: str, **kwargs) -> None:
+            super().__init__(renderable, **kwargs)
+            self.copy_text = copy_text
+
     class Viewer(App):
         CSS = """
         Screen { background: $surface; }
         #body { padding: 1 2; }
         #body > Static { margin-bottom: 1; }
+        CopyBlock { margin-bottom: 1; }
+        CopyBlock:focus { background: $boost; }
         """
         BINDINGS = [
             Binding("right,n,l", "next", "Next"),
             Binding("left,b,h", "prev", "Prev"),
-            Binding("m,tab", "toggle_mode", "Mode"),
+            Binding("m", "toggle_mode", "Mode"),
+            Binding("c", "copy", "Copy block"),
+            Binding("Y", "copy_sample", "Copy JSON"),
             Binding("down,j", "scroll_down", "Down", show=False),
             Binding("up,k", "scroll_up", "Up", show=False),
             Binding("pagedown,space", "page_down", "Page", show=False),
@@ -591,19 +628,36 @@ def run(
         def _update_title(self) -> None:
             self.sub_title = self._counter()
 
-        async def _rebuild(self) -> None:
+        async def _rebuild(self, preserve_focus: bool = False) -> None:
             body = self.query_one("#body", VerticalScroll)
+            # Remember which copy-block was focused so a width-driven rebuild
+            # (resize) doesn't silently change what `c` copies.
+            keep_idx = None
+            if preserve_focus and self.mode == "pager" and isinstance(self.focused, CopyBlock):
+                cbs = list(self.query("#body CopyBlock"))
+                if self.focused in cbs:
+                    keep_idx = cbs.index(self.focused)
             await body.remove_children()
             w = self._content_width()
             self._last_width = w
             if self.mode == "pager":
                 row = self.source.get(self.idx)
                 # Inline images only in pager mode (one sample) so we never decode/
-                # fetch images for the whole buffer at once.
-                content = render_sample(row, forced_cols, width=w, inline_images=True) if row is not None else Text("(no data)")
-                await body.mount(Static(content))
+                # fetch images for the whole buffer at once. Each message/field is a
+                # focusable CopyBlock (Tab to move, c to copy).
+                widgets = []
+                if row is None:
+                    widgets.append(Static(Text("(no data)")))
+                else:
+                    for rend, copy_text in sample_blocks(row, forced_cols, width=w, inline_images=True):
+                        widgets.append(Static(rend) if copy_text is None else CopyBlock(rend, copy_text))
+                await body.mount(*widgets)
                 body.scroll_home(animate=False)
                 self._mounted = 1
+                cbs = [wgt for wgt in widgets if isinstance(wgt, CopyBlock)]
+                target = cbs[keep_idx] if (keep_idx is not None and keep_idx < len(cbs)) else (cbs[0] if cbs else None)
+                if target is not None:
+                    target.focus()
             else:
                 n = self.source.count()
                 widgets = []
@@ -611,7 +665,9 @@ def run(
                     row = self.source.get(i)
                     label = f"sample {i + 1 + self.index_base}/{n + self.index_base}{'+' if self.source.has_more else ''}"
                     header = Rule(label, style="grey42")
-                    widgets.append(Static(Group(header, render_sample(row, forced_cols, width=w)), id=f"s{i}"))
+                    # In scroll mode each whole sample is one focusable block (c copies the row JSON).
+                    body_r = Group(header, render_sample(row, forced_cols, width=w))
+                    widgets.append(CopyBlock(body_r, _field_copy_text(row), id=f"s{i}"))
                 if widgets:
                     await body.mount(*widgets)
                 self._mounted = n
@@ -619,16 +675,18 @@ def run(
             self._update_title()
 
         async def on_resize(self, event) -> None:
-            # Re-flow bubble widths when the terminal size changes.
+            # Re-flow bubble widths when the terminal size changes; keep the
+            # focused block so `c` still copies what the user selected.
             if self._loading:
                 return
             if self._content_width() != self._last_width:
-                await self._rebuild()
+                await self._rebuild(preserve_focus=True)
 
         def _scroll_to_current(self) -> None:
             try:
                 target = self.query_one(f"#s{self.idx}")
                 self.query_one("#body", VerticalScroll).scroll_to_widget(target, animate=False, top=True)
+                target.focus()  # so `c` copies the current sample in scroll mode
             except Exception:
                 pass
 
@@ -705,4 +763,18 @@ def run(
             err = _play_audio(clips[0])
             self._set_status(f"⚠ {err}" if err else "▶ playing audio…")
 
+        def action_copy(self) -> None:
+            focused = self.focused
+            if isinstance(focused, CopyBlock):
+                self.copy_to_clipboard(focused.copy_text)
+                n = len(focused.copy_text)
+                self._set_status(f"copied {n} char{'s' if n != 1 else ''} (OSC 52)")
+            else:
+                self._set_status("Tab to focus a block, then c to copy")
+
+        def action_copy_sample(self) -> None:
+            row = self.source.get(self.idx)
+            self.copy_to_clipboard(json.dumps(row, ensure_ascii=False, indent=2, default=str))
+            self._set_status("copied sample JSON ✓")
+
     Viewer().run()

{lql_cli-0.5.0 → lql_cli-0.6.0}/uv.lock

@@ -185,7 +185,7 @@ wheels = [
 
 [[package]]
 name = "lql-cli"
-version = "0.5.0"
+version = "0.6.0"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },

lql_cli-0.5.0/src/lql/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.5.0"