aboutsummaryrefslogtreecommitdiffstats
path: root/claude_sesiones/webpage.py
diff options
context:
space:
mode:
Diffstat (limited to 'claude_sesiones/webpage.py')
-rw-r--r--claude_sesiones/webpage.py64
1 files changed, 64 insertions, 0 deletions
diff --git a/claude_sesiones/webpage.py b/claude_sesiones/webpage.py
new file mode 100644
index 0000000..8291a6b
--- /dev/null
+++ b/claude_sesiones/webpage.py
@@ -0,0 +1,64 @@
+"""Genera la página HTML autocontenida a partir de las sesiones.
+
+El resultado no necesita red ni servidor: los datos y las transcripciones van
+embebidos adentro y se abre con doble clic.
+"""
+
+import json
+from importlib import resources
+
+MARKER = "__DATA__"
+
+TEMPLATE_NAME = "template.html"
+
+
+class TemplateError(Exception):
+ """El template no tiene la forma que espera el generador."""
+
+
+def template_text(path=None):
+ if path:
+ with open(path, encoding="utf-8") as f:
+ return f.read()
+ return (resources.files(__package__) / TEMPLATE_NAME).read_text(encoding="utf-8")
+
+
+def encode_payload(records):
+ """Serializa los registros para meterlos en un <script type=application/json>.
+
+ El parser de HTML corta ese bloque en el primer "</script", y las
+ transcripciones tienen HTML adentro. Escapamos "</" como "<\\/", que es un
+ escape válido de JSON: JSON.parse lo devuelve intacto.
+ """
+ raw = json.dumps(records, ensure_ascii=False, separators=(",", ":"))
+ return raw.replace("</", "<\\/")
+
+
+def render(records, template=None):
+ """Devuelve el HTML completo con los datos ya embebidos."""
+ html = template if template is not None else template_text()
+ # No se puede verificar el resultado buscando el marcador: estas mismas
+ # sesiones incluyen conversaciones sobre este script, así que el payload lo
+ # contiene como texto. Validamos el template antes de sustituir.
+ if html.count(MARKER) != 1:
+ raise TemplateError(
+ f"el template debe tener exactamente un {MARKER} "
+ f"(encontrados: {html.count(MARKER)})")
+ return html.replace(MARKER, encode_payload(records))
+
+
+def write(records, out_path, template=None):
+ """Escribe la página y devuelve un resumen de lo que quedó adentro."""
+ html = render(records, template=template)
+ with open(out_path, "w", encoding="utf-8") as f:
+ f.write(html)
+ return summary(records)
+
+
+def summary(records):
+ return {
+ "sesiones": len(records),
+ "proyectos": len({r["p"] for r in records}),
+ "mensajes": sum(r["u"] for r in records),
+ "bloques": sum(len(r["c"]) for r in records),
+ }