labnotes 0.0.116__tar.gz → 0.0.118__tar.gz

{labnotes-0.0.116 → labnotes-0.0.118}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: labnotes
-Version: 0.0.116
+Version: 0.0.118
 Summary: Browse experiment designs, notes, and run data from a folder.
 Project-URL: Repository, https://github.com/thekevinscott/labnotes
 Author-email: Kevin Scott <me@thekevinscott.com>

{labnotes-0.0.116 → labnotes-0.0.118}/pyproject.toml

@@ -44,6 +44,12 @@ dev = [
     "types-psutil>=7.2.2.20260906",
 ]
 
+# thekevinscott's own packages skip the user-level uv release cooldown.
+[tool.uv.exclude-newer-package]
+curtaincall = false
+dirsql = false
+posix-tools = false
+
 [tool.hatch.version]
 source = "vcs"
 

{labnotes-0.0.116 → labnotes-0.0.118}/src/labnotes/context.md

@@ -180,4 +180,4 @@ going. Elsewhere, it prints a line per event instead.
   was retried counts as retried, not failed. If it can't
   start or reach the daemon, it prints the cause on one line and exits 1.
 
-`uvx labnotes server` serves the experiments, their markdown files and their runs as a local site, read from the same `.labnotes.toml`. An experiment's page shows its `experiment.toml` on one line, then a Runs tab with a table of its runs and a Notebooks tab with one tab per markdown file. Clicking a run opens its `stdout.log` and `stderr.log` together, followed as they're written until the run ends.
+`uvx labnotes server` serves the experiments, their markdown files and their runs as a local site, read from the same `.labnotes.toml`. An experiment's page shows its `experiment.toml` on one line, then a Runs tab with a table of its runs and a Notebooks tab with one tab per markdown file. For a matrix experiment, the Runs tab also has a grid (`?view=grid`): one cell per combination of the params that vary, with how many runs count toward `repeats`. Clicking a run opens its `stdout.log` and `stderr.log` together, followed as they're written until the run ends.

labnotes-0.0.118/src/labnotes/grid_cell.py

@@ -0,0 +1,21 @@
+from typing import TypedDict
+from urllib.parse import urlencode
+
+from labnotes.format_value import format_value
+
+
+class Cell(TypedDict):
+    values: dict[str, object]
+    runs: object
+    completed: object
+    href: str
+
+
+def grid_cell(values: dict[str, object], counts: dict[str, object]) -> Cell:
+    filters = [(f"f.{key}", format_value(value)) for key, value in values.items()]
+    return {
+        "values": values,
+        "runs": counts.get("runs", 0),
+        "completed": counts.get("completed", 0),
+        "href": f"?{urlencode(filters)}#runs",
+    }

{labnotes-0.0.116 → labnotes-0.0.118}/src/labnotes/load_experiment.py

@@ -17,6 +17,7 @@ from labnotes.list_runs import list_runs
 from labnotes.models import QueryParams
 from labnotes.nests_runs import nests_runs
 from labnotes.parse_run_view import parse_run_view
+from labnotes.pivot_runs import pivot_runs
 from labnotes.python_blocks import python_blocks
 from labnotes.render_markdown import render_markdown
 from labnotes.runs_view_command import runs_view_command
@@ -65,6 +66,19 @@ async def load_experiment(
         if nested
         else None
     )
+    matrix = summary["mode"] == "matrix"
+    gridded = matrix and params.getlist("view")[-1:] == ["grid"]
+    axes = {key: varies[key] for key in choices if len(varies[key]) > 1}
+    grid = (
+        pivot_runs(
+            axes,
+            await count_runs(
+                tables, source, str(summary["completed_run"]), group_by=list(axes)
+            ),
+        )
+        if gridded
+        else None
+    )
     return {
         "name": row["name"],
         "display_name": row["display_name"],
@@ -86,6 +100,7 @@ async def load_experiment(
         "runs_list": runs,
         "runs_live": await daemon_running(root),
         "run_groups": groups,
+        "run_grid": grid,
         "run_columns": shown,
         "run_view": view,
         "run_choices": choices,

labnotes-0.0.118/src/labnotes/pivot_runs.py

@@ -0,0 +1,43 @@
+from itertools import product
+from typing import TypedDict
+
+from labnotes.grid_cell import Cell, grid_cell
+
+
+class Row(TypedDict):
+    labels: list[object]
+    cells: list[Cell]
+
+
+class Grid(TypedDict):
+    row_keys: list[str]
+    column_key: str | None
+    columns: list[object]
+    rows: list[Row]
+
+
+def _key(value: object) -> object:
+    return int(value) if isinstance(value, bool) else value
+
+
+def pivot_runs(axes: dict[str, list[object]], counts: list[dict[str, object]]) -> Grid:
+    by_cell = {tuple(_key(row[key]) for key in axes): row for row in counts}
+    row_keys = [*axes]
+    column_key = row_keys.pop() if row_keys else None
+    columns: list[object] = [None] if column_key is None else axes[column_key]
+    rows: list[Row] = []
+    for labels in product(*(axes[key] for key in row_keys)):
+        cells = []
+        for column in columns:
+            values: dict[str, object] = dict(zip(row_keys, labels))
+            if column_key is not None:
+                values[column_key] = column
+            found = by_cell.get(tuple(_key(values[key]) for key in axes), {})
+            cells.append(grid_cell(values, found))
+        rows.append({"labels": list(labels), "cells": cells})
+    return {
+        "row_keys": row_keys,
+        "column_key": column_key,
+        "columns": columns,
+        "rows": rows,
+    }

{labnotes-0.0.116 → labnotes-0.0.118}/src/labnotes/static/labnotes.css

@@ -217,6 +217,22 @@ h3 {
 .new-note { font: inherit; color: var(--ink-2); background: none; border: 0; padding: 0 0.2rem; cursor: pointer; }
 .new-note:hover { color: var(--ink); }
 
+/* Runs grid: counted runs per combination of the params that vary. */
+.runs-grid { border-collapse: separate; border-spacing: 3px; font-size: 0.86rem; }
+.runs-grid th { font-family: var(--mono); font-size: 0.8rem; font-weight: 500; color: var(--ink-2); text-align: left; white-space: nowrap; padding: 0 0.75rem 0.3rem; }
+.runs-grid thead th { vertical-align: bottom; }
+.runs-grid th.label { color: var(--ink-3); }
+.runs-grid th.axis { font-family: var(--sans); font-size: 0.68rem; font-weight: 600; letter-spacing: 0.08em; text-transform: uppercase; color: var(--ink-3); border-bottom: 1px solid var(--rule); }
+.grid-cell { min-width: 6rem; padding: 0; background: var(--surface); border: 1px solid var(--rule); border-radius: 7px; }
+.grid-cell a { display: block; padding: 0.5rem 0.7rem 0.6rem; color: var(--ink); text-decoration: none; }
+.grid-cell:hover { border-color: var(--rule-strong); }
+.grid-cell .num { display: block; margin-bottom: 0.4rem; }
+.grid-cell .of { color: var(--ink-3); }
+.grid-cell.empty .num { color: var(--ink-3); }
+.grid-cell.done { border-color: color-mix(in srgb, var(--accent) 35%, var(--rule)); }
+.grid-cell .meter { display: block; height: 4px; border-radius: 2px; background: var(--track); overflow: hidden; }
+.grid-cell .meter-fill { display: block; height: 100%; background: var(--accent); }
+
 /* Runs table */
 .narrowed { color: var(--ink-2); font-size: 0.88rem; margin: 0 0 0.75rem; }
 .narrowed .clear { margin-left: 0.8rem; color: var(--ink-3); }
@@ -390,6 +406,12 @@ h3 {
 }
 .view-toggle button + button { border-left: 1px solid var(--rule-strong); }
 .view-toggle button[aria-pressed="true"] { background: var(--accent-soft); color: var(--ink); }
+#runs .view-toggle { display: flex; width: fit-content; float: none; margin: 0 0 0.75rem auto; }
+.view-toggle a { display: flex; padding: 0.3rem 0.55rem; background: var(--surface); color: var(--ink-3); }
+.view-toggle a + a { border-left: 1px solid var(--rule-strong); }
+.view-toggle a:hover { color: var(--ink); }
+.view-toggle a[aria-current="page"] { background: var(--accent-soft); color: var(--ink); }
+.view-toggle svg { width: 16px; height: 16px; fill: none; stroke: currentColor; stroke-width: 1.5; stroke-linecap: round; }
 
 /* Index as cards: the same table, laid out as a grid. */
 .ledger[data-view="cards"] { display: block; background: none; border: 0; border-radius: 0; overflow: visible; }

{labnotes-0.0.116 → labnotes-0.0.118}/src/labnotes/templates/experiment.html

@@ -51,6 +51,45 @@
   {% set nested = e.run_groups is not none %}
   {% set width = e.run_columns | length + (2 if nested else 1) %}
   {% set narrowed = view.status or view.filters or view.picked %}
+  {% set grid = e.run_grid %}
+  {% if e.mode == 'matrix' and e.runs %}
+  <nav class="view-toggle" aria-label="Runs view">
+    <a href="?#runs" title="Table" aria-label="Table"{% if not grid %} aria-current="page"{% endif %}><svg viewBox="0 0 16 16" aria-hidden="true"><path d="M2 3.5h12M2 8h12M2 12.5h12"/></svg></a>
+    <a href="?view=grid#runs" title="Grid" aria-label="Grid"{% if grid %} aria-current="page"{% endif %}><svg viewBox="0 0 16 16" aria-hidden="true"><rect x="2" y="2" width="5" height="5" rx="1"/><rect x="9" y="2" width="5" height="5" rx="1"/><rect x="2" y="9" width="5" height="5" rx="1"/><rect x="9" y="9" width="5" height="5" rx="1"/></svg></a>
+  </nav>
+  {% endif %}
+  {% if grid %}
+  <div class="scroll">
+  <table class="runs-grid">
+    <thead>
+      {% if grid.column_key is not none %}
+      <tr class="axis-row">
+        {% if grid.row_keys %}<td colspan="{{ grid.row_keys | length }}"></td>{% endif %}
+        <th scope="colgroup" colspan="{{ grid.columns | length }}" class="axis">{{ grid.column_key }}</th>
+      </tr>
+      <tr>
+        {% for key in grid.row_keys %}<th scope="col" class="label">{{ key }}</th>{% endfor %}
+        {% for column in grid.columns %}<th scope="col">{{ column | value }}</th>{% endfor %}
+      </tr>
+      {% endif %}
+    </thead>
+    <tbody>
+      {% for row in grid.rows %}
+      <tr>
+        {% for label in row.labels %}<th scope="row">{{ label | value }}</th>{% endfor %}
+        {% for cell in row.cells %}
+        {% set goal = e.runs_per_cell or 1 %}
+        <td class="grid-cell{{ ' done' if cell.completed >= goal }}{{ ' empty' if not cell.runs }}" title="{% for key, value in cell['values'].items() %}{{ key }} = {{ value | value }}{{ ', ' if not loop.last }}{% endfor %}{{ ': ' if cell['values'] }}{{ cell.completed }} complete of {{ cell.runs }} recorded">
+          <a href="{{ cell.href }}"><span class="num">{{ cell.completed }}<span class="of">/{{ goal }}</span></span>
+          <span class="meter"><span class="meter-fill" style="width: {{ [cell.completed / goal * 100, 100] | min }}%"></span></span></a>
+        </td>
+        {% endfor %}
+      </tr>
+      {% endfor %}
+    </tbody>
+  </table>
+  </div>
+  {% else %}
   {% if narrowed %}<p class="narrowed"><span class="num">{{ e.runs_list | length }}</span> of <span class="num">{{ e.runs }}</span> <a class="clear" href="{{ '?sort=' ~ (view.sort | urlencode) ~ ('&order=desc' if view.descending else '') if view.sort else '?' }}#runs">Clear filters</a></p>{% endif %}
   {% if e.runs %}
   <form id="run-filters" method="get" action="#runs">
@@ -117,6 +156,7 @@
   {% else %}
   <p class="empty">No runs recorded yet.</p>
   {% endif %}
+  {% endif %}
 </section>
 {% endif %}
 <script src="{{ asset('experiment.js') }}" defer></script>

{labnotes-0.0.116 → labnotes-0.0.118}/testing-conventions.toml

@@ -13,7 +13,7 @@ reason = "last_stream is always the same str object taken from STREAMS, so is eq
 [[python.exempt]]
 path = "src/labnotes/load_experiment.py"
 rules = ["mutation"]
-lines = [61]
+lines = [61, 69]
 reason = "summarize_config returns mode matrix or adhoc; \"matrix\" <= \"adhoc\" is false like ==, and both are interned literals so is equals =="
 
 [[python.exempt]]