ripple-sql 0.1.4__tar.gz → 0.1.5__tar.gz

{ripple_sql-0.1.4 → ripple_sql-0.1.5}/CHANGELOG.md

@@ -6,6 +6,11 @@ Notable changes to Ripple. The format follows
 
 ## [Unreleased]
 
+## [0.1.5] - 2026-09-09
+
+### Added
+- Every column under a model on the page carries the number of models that read it directly, the same number a model chip carries, so the cost of a change shows before the question is asked. A column no link touches (a constant, or one the engine could not trace) is drawn loose, dashed and faint, with "no link found" in the key; r/dataengineering asked for "a clear view of mapped vs unmapped fields (with some kind of legend)", and a traced-looking constant would have been a lie.
+
 ## [0.1.4] - 2026-09-09
 
 ### Changed
@@ -249,7 +254,8 @@ First public release.
 ### Removed
 - The dark whole-graph canvas that `ripple serve` used to open (`static/index.html`). Every surface now draws one answer.
 
-[Unreleased]: https://github.com/bteh/ripple/compare/v0.1.4...HEAD
+[Unreleased]: https://github.com/bteh/ripple/compare/v0.1.5...HEAD
+[0.1.5]: https://github.com/bteh/ripple/releases/tag/v0.1.5
 [0.1.4]: https://github.com/bteh/ripple/releases/tag/v0.1.4
 [0.1.3]: https://github.com/bteh/ripple/releases/tag/v0.1.3
 [0.1.2]: https://github.com/bteh/ripple/releases/tag/v0.1.2

{ripple_sql-0.1.4 → ripple_sql-0.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ripple-sql
-Version: 0.1.4
+Version: 0.1.5
 Summary: Offline column-level SQL lineage. See what breaks before you merge.
 Project-URL: Homepage, https://github.com/bteh/ripple
 Project-URL: Repository, https://github.com/bteh/ripple

{ripple_sql-0.1.4 → ripple_sql-0.1.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ripple-sql"
-version = "0.1.4"
+version = "0.1.5"
 description = "Offline column-level SQL lineage. See what breaks before you merge."
 readme = "README.md"
 requires-python = ">=3.10"

{ripple_sql-0.1.4 → ripple_sql-0.1.5}/src/ripple/home.py

@@ -130,10 +130,19 @@ def model_map(nodes: list[dict], edges) -> dict:
         }
     fed = {e.dst_model for e in edges}
     seen: dict[str, dict[str, None]] = {}
+    readers: dict[tuple[str, str], set[str]] = {}
+    linked: set[tuple[str, str]] = set()
     for e in edges:
         for model, column in ((e.src_model, e.src_column), (e.dst_model, e.dst_column)):
             if _is_column(column):
                 seen.setdefault(model, {})[column] = None
+        if e.kind != "value" or not (_is_column(e.src_column) and _is_column(e.dst_column)):
+            continue
+        linked.add((e.src_model, e.src_column))
+        linked.add((e.dst_model, e.dst_column))
+        # a dashboard number is not a reader; only models count (as in starters)
+        if not e.dst_model.startswith(DASHBOARD_PREFIXES):
+            readers.setdefault((e.src_model, e.src_column), set()).add(e.dst_model)
     for name in sorted({e.src_model for e in edges} | fed):
         if name in members:
             known = members[name]["columns"]
@@ -151,6 +160,14 @@ def model_map(nodes: list[dict], edges) -> dict:
             "status": None,
             "path": None,
         }
+    for m in members.values():
+        # per column, aligned with `columns`: how many models read it directly;
+        # -1 when no link touches it at all (a constant, or one the engine
+        # could not trace), so the page never draws such a column as traced
+        m["reads"] = [
+            len(readers.get((m["id"], c), ())) if (m["id"], c) in linked else -1
+            for c in m["columns"]
+        ]
     links = _links(edges)
     layers = _layers(members, links)
     models = [{**m, "layer": layers[m["id"]]} for m in members.values()]

{ripple_sql-0.1.4 → ripple_sql-0.1.5}/src/ripple/static/answer.css

@@ -77,6 +77,7 @@ h1 code{font:500 24px/1 var(--mono); letter-spacing:0}
 .key i.r{border-top-style:dashed; border-color:var(--review)}
 .key s{display:inline-block; width:11px; height:11px; border-radius:2px; background:var(--ink); border:1px solid var(--ink); text-decoration:none}
 .key s.src{background:var(--well); border:1px dashed var(--line-strong)}
+.key s.unk{background:transparent; border:1px dashed var(--faint)}
 .key small.n{font:400 11.5px/1 var(--sans); color:var(--faint); border:1px solid var(--line-strong); border-radius:var(--r); padding:2px 5px; background:var(--surface)}
 .hint{margin-left:auto; font-size:12.5px; color:var(--faint)}
 .rows{padding:0 22px 14px; font-size:13.5px; color:var(--muted)}
@@ -110,6 +111,9 @@ pre{margin:0; padding:16px 22px 18px; overflow-x:auto; font:400 13px/1.65 var(--
 .cols{display:flex; flex-direction:column; gap:5px; margin:0 0 6px 10px; padding-left:10px; border-left:1px solid var(--line)}
 .cols .gname{max-width:36ch; white-space:normal; line-height:1.45; padding-top:2px}
 .cols .node{cursor:pointer}
+.cols .node small{font:400 11px/1 var(--sans); color:var(--faint); margin-left:5px}
+.cols .node.unk{color:var(--muted)}
+.cols .node.unk:hover{border-color:var(--accent)}
 .cols .node:hover{border-color:var(--accent); color:var(--accent-strong)}
 .more-chips{font:500 12.5px var(--sans); color:var(--accent); background:none; border:0; padding:4px 0; cursor:pointer; text-align:left}
 .more-chips:hover{text-decoration:underline}

{ripple_sql-0.1.4 → ripple_sql-0.1.5}/src/ripple/static/answer.html

@@ -35,6 +35,7 @@
       <span class="key"><i class="r"></i> needs review</span>
       <span class="key" id="key-chain" hidden><s class="up"></s> feeds it <s class="sel"></s> chosen <s class="down"></s> reads it</span>
       <span class="key"><small class="n">3</small> models that read it</span>
+      <span class="key"><s class="unk"></s> no link found</span>
       <span class="hidden-note" id="maphidden" hidden></span>
       <span class="hint" id="maphint">Hover lights the chain. Click a model for its columns, a column to ask.</span>
     </div>

{ripple_sql-0.1.4 → ripple_sql-0.1.5}/src/ripple/static/explore.js

@@ -8,6 +8,32 @@
 // nothing here fetches.
 var COMPACT_AT = 40, MAP_COLUMNS = 60, INDEX_PEEK = 6, INDEX_UNFOLD = 60, INDEX_GROUPS = 24;
 
+// a model's columns as chips: each with the number of models that read it
+// directly, and a column no link touches (a constant, or one the engine could
+// not trace) drawn loose so nobody reads it as traced. Used under a model on
+// the small map and under the chosen model in focus.
+function columnChips(m, opts){
+  var esc = opts.esc, cap = opts.cap || MAP_COLUMNS, cols = document.createElement('div');
+  cols.className = 'cols';
+  m.columns.slice(0, cap).forEach(function(c, i){
+    // reads[i] is the model count, or -1 when no link touches the column
+    var n = m.reads ? m.reads[i] : 0, loose = n < 0, s = document.createElement('button');
+    s.type = 'button'; s.className = 'node in' + (loose ? ' unk' : '');
+    s.innerHTML = esc(c) + (n > 0 ? ' <small>' + n + '</small>' : '');
+    s.title = (loose ? 'no link found: a constant, or one Ripple could not trace' :
+      n ? 'read by ' + n + ' model' + (n === 1 ? '' : 's') + ' directly' : 'nothing reads it directly') + ' · click to ask about ' + m.id + '.' + c;
+    s.addEventListener('click', function(){ opts.onAsk(m.id + '.' + c); });
+    cols.appendChild(s);
+  });
+  var note = null;
+  if (m.columns.length > cap) note = '+ ' + (m.columns.length - cap) + ' more, ask by name';
+  else if (!m.declared && m.kind === 'source') note = (m.columns.length ? 'only the columns this project names; the full list is' : 'no column list; it is') +
+    ' not declared in the project (a select * reads it unnamed). Coverage below adds it.';
+  else if (!m.columns.length) note = 'no columns known';
+  if (note){ var g = document.createElement('span'); g.className = 'gname'; g.textContent = note; cols.appendChild(g); }
+  return cols;
+}
+
 function renderMap(root, map, opts){
   var inner = root.querySelector('.board-inner'), svg = root.querySelector('.wires'), head = root.querySelector('.map-head');
   var esc = opts.esc, compact = map.models.length > COMPACT_AT;
@@ -77,19 +103,7 @@ function renderMap(root, map, opts){
       if (pinned === m.id){ pinned = null; unlight(); }
       draw(); return;
     }
-    var cols = el('div', 'cols');
-    m.columns.slice(0, MAP_COLUMNS).forEach(function(c){
-      var s = el('button', 'node in'); s.type = 'button'; s.textContent = c;
-      s.title = 'ask about ' + m.id + '.' + c;
-      s.addEventListener('click', function(){ opts.onAsk(m.id + '.' + c); });
-      cols.appendChild(s);
-    });
-    var note = null;
-    if (m.columns.length > MAP_COLUMNS) note = '+ ' + (m.columns.length - MAP_COLUMNS) + ' more, ask by name';
-    else if (!m.declared && m.kind === 'source') note = (m.columns.length ? 'only the columns this project names; the full list is' : 'no column list; it is') +
-      ' not declared in the project (a select * reads it unnamed). Coverage below adds it.';
-    else if (!m.columns.length) note = 'no columns known';
-    if (note){ var n = el('span', 'gname'); n.textContent = note; cols.appendChild(n); }
+    var cols = columnChips(m, {esc: esc, onAsk: opts.onAsk, cap: MAP_COLUMNS});
     g.appendChild(cols); g.classList.add('open'); b.setAttribute('aria-expanded', 'true');
     // a click keeps the chain lit so the mouse can travel to the columns
     if (pinned && pinned !== m.id){ var was = groups[pinned].querySelector('.cols'); if (was){ was.remove(); groups[pinned].classList.remove('open'); chips[pinned].setAttribute('aria-expanded', 'false'); } }

{ripple_sql-0.1.4 → ripple_sql-0.1.5}/src/ripple/static/focus.js

@@ -81,20 +81,7 @@ function renderFocus(inner, svg, map, idx, id, opts){
     b.classList.add('sel', 'anchor'); b.setAttribute('aria-current', 'true');
     dist[id] = 0;
     g.appendChild(b);
-    var cols = el('div', 'cols');
-    m.columns.slice(0, FOCUS_COLUMNS).forEach(function(c){
-      var s = el('button', 'node in'); s.type = 'button'; s.textContent = c;
-      s.title = 'ask about ' + m.id + '.' + c;
-      s.addEventListener('click', function(){ opts.onAsk(m.id + '.' + c); });
-      cols.appendChild(s);
-    });
-    var note = null;
-    if (m.columns.length > FOCUS_COLUMNS) note = '+ ' + (m.columns.length - FOCUS_COLUMNS) + ' more, ask by name';
-    else if (!m.declared && m.kind === 'source') note = (m.columns.length ? 'only the columns this project names; the full list is' : 'no column list; it is') +
-      ' not declared in the project (a select * reads it unnamed). Coverage below adds it.';
-    else if (!m.columns.length) note = 'no columns known';
-    if (note){ var n = el('span', 'gname'); n.textContent = note; cols.appendChild(n); }
-    g.appendChild(cols); lvl.appendChild(g);
+    g.appendChild(columnChips(m, {esc: esc, onAsk: opts.onAsk, cap: FOCUS_COLUMNS})); lvl.appendChild(g);
     return lvl;
   }
   function render(){