"""Builds a single self-contained HTML file snapshot of the live Dash dashboard, for
sharing with people who don't have the app running (e.g. via NextCloud/email).
Reuses app.py's data loading and figure-builder functions directly. Converts the Dash
component trees (dbc.Card/Row/Col are just Bootstrap-class wrappers) into plain HTML,
so the same Bootstrap CSS renders them identically. Charts render via Plotly.js from
embedded JSON. A handful of interactive elements (calendar month click, breakdown
dropdowns, content month filter) have every possible state precomputed and swapped
client-side with vanilla JS, everything else is a static snapshot of today's data.
"""
import base64
import html as html_escape_mod
import json
import mimetypes
import os
import re
import app as A
from dash import html, dcc, dash_table
import dash_bootstrap_components as dbc
CHARTS = {} # chart div id -> plotly figure json string
CHART_COUNTER = [0]
ASSETS_DIR = os.path.join(os.path.dirname(os.path.abspath(__file__)), "assets")
_ASSET_CACHE = {}
_reports_render_cache = {}
def esc(s):
return html_escape_mod.escape(str(s), quote=True)
def inline_asset(src):
"""Rewrite /assets/foo.png into a base64 data: URI so the exported file is fully
self-contained (no separate image files needed alongside it)."""
if not src or not src.startswith("/assets/"):
return src
if src in _ASSET_CACHE:
return _ASSET_CACHE[src]
path = os.path.join(ASSETS_DIR, os.path.basename(src))
if not os.path.isfile(path):
return src
mime = mimetypes.guess_type(path)[0] or "application/octet-stream"
with open(path, "rb") as f:
b64 = base64.b64encode(f.read()).decode("ascii")
uri = f"data:{mime};base64,{b64}"
_ASSET_CACHE[src] = uri
return uri
def style_dict_to_css(style):
if not style:
return ""
parts = []
for k, v in style.items():
# camelCase -> kebab-case
css_key = re.sub(r"([A-Z])", r"-\1", k).lower()
# A literal " in a value (e.g. grid-template-areas: '"cm rm ap"') would
# terminate the HTML style="..." attribute this gets concatenated into early,
# silently corrupting everything after it — this exact bug broke the Reports
# tab's grid layout once already. Escape rather than trust every caller to
# remember single-quoting CSS strings.
parts.append(f"{css_key}:{str(v).replace(chr(34), '"')}")
return ";".join(parts)
def conditional_row_bg(conditional, row, idx):
"""Replays a DataTable's style_data_conditional row_index/filter_query rules for one
row, later rules override earlier ones on a match, same as Dash's own precedence, so
the best-engagement/best-CTR highlight still shows up here, not just in the live app.
Only supports the simple "{Col} = value" equality form filter_query uses in this
codebase, not the full Dash query mini-language. Caller applies the result per-
,
not on the
, Bootstrap 5 paints table backgrounds via a CSS variable applied
directly to each cell, which sits on top of and hides a tr-level background-color."""
bg = None
for rule in conditional:
cond = rule.get("if", {})
matched = False
if "row_index" in cond:
ri = cond["row_index"]
if ri == "odd" and idx % 2 == 1:
matched = True
elif ri == "even" and idx % 2 == 0:
matched = True
elif isinstance(ri, int) and idx == ri:
matched = True
elif "filter_query" in cond:
m = re.match(r"\{([^}]+)\}\s*=\s*(.+)", cond["filter_query"])
if m:
col, val = m.group(1), m.group(2)
cell = row.get(col)
try:
matched = float(cell) == float(val)
except (TypeError, ValueError):
matched = str(cell) == val
if matched and "backgroundColor" in rule:
bg = rule["backgroundColor"]
return bg
def next_chart_id():
CHART_COUNTER[0] += 1
return f"chart-{CHART_COUNTER[0]}"
def register_chart(fig, style=None, comp_id=None):
cid = comp_id or next_chart_id()
CHARTS[cid] = json.loads(fig.to_json())
height = "320px"
if style and "height" in style:
height = style["height"]
return f''
def render(comp):
"""Recursively convert a Dash component (or list/str) into an HTML string."""
if comp is None:
return ""
if isinstance(comp, (str, int, float)):
return esc(comp)
if isinstance(comp, (list, tuple)):
return "".join(render(c) for c in comp)
cls = type(comp).__name__
module = type(comp).__module__
# --- Reports tab title/content area: both empty in the live layout (filled by a
# two-output callback), so bake in the one selectable month's rendered output
# directly. Switching months needs the live tool (see the disabled dropdown below),
# same rationale as every other live-only control in this exporter. Cached, since
# this component tree gets visited twice (once per div) and re-calling would
# double-register the follower-growth chart into CHARTS.
if getattr(comp, "id", None) in ("reports-title", "reports-content-area"):
if "result" not in _reports_render_cache:
if A._REPORTS_DEFAULT_MONTH:
# _render_reports_tab returns (title, content, store_value) — the third
# is only for syncing the live reports-selected-month Store, irrelevant
# to a static snapshot.
_reports_render_cache["result"] = A._render_reports_tab(A._REPORTS_DEFAULT_MONTH)[:2]
else:
_reports_render_cache["result"] = (
"", dbc.Alert("No campaign months have been written up yet.", color="info"))
title, content = _reports_render_cache["result"]
return render(title if comp.id == "reports-title" else content)
# --- Plotly graphs ---
if isinstance(comp, dcc.Graph):
return register_chart(comp.figure, getattr(comp, "style", None), getattr(comp, "id", None))
# --- Dropdowns: render as