biblia-cli 0.1.0__tar.gz

biblia_cli-0.1.0/.env.example

@@ -0,0 +1,5 @@
+# Copia este archivo como .env y rellena los valores
+# Genera ANN_ENCRYPT_KEY con: python admin_annotations.py genkey
+
+SUPABASE_SERVICE_ROLE_KEY=eyJ...TU_SERVICE_ROLE_KEY...
+ANN_ENCRYPT_KEY=TU_CLAVE_FERNET_BASE64=

biblia_cli-0.1.0/.gitignore

@@ -0,0 +1,32 @@
+# Secretos — NUNCA al repo
+.env
+admin_annotations.py
+cargar_anotaciones.py
+
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Datos locales del usuario
+.biblia-cli/
+
+# Entornos virtuales
+.venv/
+venv/
+env/
+
+# IDEs
+.vscode/
+.idea/
+*.suo
+*.user
+
+# Windows
+Thumbs.db
+desktop.ini

biblia_cli-0.1.0/PKG-INFO

@@ -0,0 +1,69 @@
+Metadata-Version: 2.4
+Name: biblia-cli
+Version: 0.1.0
+Summary: 📖 Lee la Biblia en tu terminal — Castellano & Português
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: supabase>=2.0.0
+Requires-Dist: textual>=0.70.0
+Description-Content-Type: text/markdown
+
+# ⚡ BIBLIA CLI: CRISTO Edition ⚡
+
+> **La Palabra de Dios no solo se lee, se vive. Y ahora, se domina desde la Terminal.**
+
+Bienvenido a **Biblia CLI**, la herramienta definitiva para el guerrero espiritual moderno y el desarrollador que no sacrifica su fe por su productividad. Olvida las interfaces lentas, las distracciones de la web y el ruido visual. Esto es velocidad pura. Esto es **CRISTO** en tu consola.
+
+---
+
+## 🚀 ¿Por qué Biblia CLI?
+
+Biblia CLI no es un simple lector; es un motor de búsqueda y estudio bíblico optimizado para el rendimiento. Diseñado con una estética **Premium**, ofrece una experiencia de usuario que te hará volar la cabeza.
+
+### ✨ Características que rompen moldes:
+
+*   **⚡ Velocidad de Vértigo**: Acceso instantáneo a cualquier libro y capítulo. Navegación fluida diseñada para los que no tienen tiempo que perder.
+*   **📖 Sincronización Litúrgica Real**: Pulsa `D` y conecta directamente con el **calendario litúrgico oficial del Vaticano**. No es una lectura aleatoria, es la Palabra que la Iglesia proclama en todo el mundo, hoy mismo.
+*   **🎨 Estética de Vanguardia**: Temas visuales impecables. Desde el modo **Sepia** para lecturas profundas hasta el **Matrix** para sesiones de código nocturnas, y un **Tema Claro** refinado con alto contraste que se ve simplemente increíble.
+*   **🛰️ Conexión Bolls.life**: Acceso a la API más robusta del mercado para garantizar que los textos siempre estén ahí cuando los necesites con la máxima fidelidad.
+*   **⭐ Gestión de Favoritos y Notas**: Marca tus versículos clave y guarda tus reflexiones directamente en la terminal. Tu estudio bíblico, centralizado y potente.
+*   **🕊️ CRISTO Splash Screen**: Una pantalla de inicio en arte ASCII que impone respeto y te recuerda el propósito de tu estudio desde el segundo uno.
+
+---
+
+## 🛠️ Instalación para Elegidos
+
+Si tienes Python 3.10+, estás a un comando de la gloria:
+
+```powershell
+pip install -e .
+```
+
+Una vez instalado, simplemente escribe:
+```powershell
+biblia
+```
+
+---
+
+## ⌨️ Domina el Arca (Atajos de Teclado)
+
+| Tecla | Acción |
+| :--- | :--- |
+| `D` | **Sincronización Divina**: Abre la lectura litúrgica de HOY. |
+| `/` | **Buscador Ninja**: Encuentra cualquier pasaje en milisegundos. |
+| `T` | **Camaleón**: Cambia entre temas visuales épicos. |
+| `F` | **Favoritos**: Tus versículos para la eternidad. |
+| `N` | **Apostolado**: Añade tus notas personales. |
+| `Q` | **Salir**: Hasta la próxima sesión de gloria. |
+
+---
+
+## 🔥 El Futuro es Ahora
+
+Biblia CLI no es solo software, es una declaración de intenciones. Es la unión de la tecnología más puntera con la sabiduría más antigua. **Rápido. Elegante. Infalible.**
+
+> "Lámpara es a mis pies tu palabra, Y lumbrera a mi camino." — Salmos 119:105
+
+---
+© 2026 - Biblia CLI Project. Built with love for the Glory of Christ, made in Katowice, Poland, born in Basque Country.

biblia_cli-0.1.0/README.md

@@ -0,0 +1,59 @@
+# ⚡ BIBLIA CLI: CRISTO Edition ⚡
+
+> **La Palabra de Dios no solo se lee, se vive. Y ahora, se domina desde la Terminal.**
+
+Bienvenido a **Biblia CLI**, la herramienta definitiva para el guerrero espiritual moderno y el desarrollador que no sacrifica su fe por su productividad. Olvida las interfaces lentas, las distracciones de la web y el ruido visual. Esto es velocidad pura. Esto es **CRISTO** en tu consola.
+
+---
+
+## 🚀 ¿Por qué Biblia CLI?
+
+Biblia CLI no es un simple lector; es un motor de búsqueda y estudio bíblico optimizado para el rendimiento. Diseñado con una estética **Premium**, ofrece una experiencia de usuario que te hará volar la cabeza.
+
+### ✨ Características que rompen moldes:
+
+*   **⚡ Velocidad de Vértigo**: Acceso instantáneo a cualquier libro y capítulo. Navegación fluida diseñada para los que no tienen tiempo que perder.
+*   **📖 Sincronización Litúrgica Real**: Pulsa `D` y conecta directamente con el **calendario litúrgico oficial del Vaticano**. No es una lectura aleatoria, es la Palabra que la Iglesia proclama en todo el mundo, hoy mismo.
+*   **🎨 Estética de Vanguardia**: Temas visuales impecables. Desde el modo **Sepia** para lecturas profundas hasta el **Matrix** para sesiones de código nocturnas, y un **Tema Claro** refinado con alto contraste que se ve simplemente increíble.
+*   **🛰️ Conexión Bolls.life**: Acceso a la API más robusta del mercado para garantizar que los textos siempre estén ahí cuando los necesites con la máxima fidelidad.
+*   **⭐ Gestión de Favoritos y Notas**: Marca tus versículos clave y guarda tus reflexiones directamente en la terminal. Tu estudio bíblico, centralizado y potente.
+*   **🕊️ CRISTO Splash Screen**: Una pantalla de inicio en arte ASCII que impone respeto y te recuerda el propósito de tu estudio desde el segundo uno.
+
+---
+
+## 🛠️ Instalación para Elegidos
+
+Si tienes Python 3.10+, estás a un comando de la gloria:
+
+```powershell
+pip install -e .
+```
+
+Una vez instalado, simplemente escribe:
+```powershell
+biblia
+```
+
+---
+
+## ⌨️ Domina el Arca (Atajos de Teclado)
+
+| Tecla | Acción |
+| :--- | :--- |
+| `D` | **Sincronización Divina**: Abre la lectura litúrgica de HOY. |
+| `/` | **Buscador Ninja**: Encuentra cualquier pasaje en milisegundos. |
+| `T` | **Camaleón**: Cambia entre temas visuales épicos. |
+| `F` | **Favoritos**: Tus versículos para la eternidad. |
+| `N` | **Apostolado**: Añade tus notas personales. |
+| `Q` | **Salir**: Hasta la próxima sesión de gloria. |
+
+---
+
+## 🔥 El Futuro es Ahora
+
+Biblia CLI no es solo software, es una declaración de intenciones. Es la unión de la tecnología más puntera con la sabiduría más antigua. **Rápido. Elegante. Infalible.**
+
+> "Lámpara es a mis pies tu palabra, Y lumbrera a mi camino." — Salmos 119:105
+
+---
+© 2026 - Biblia CLI Project. Built with love for the Glory of Christ, made in Katowice, Poland, born in Basque Country.

biblia_cli-0.1.0/biblia_cli/__init__.py

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

biblia_cli-0.1.0/biblia_cli/annotations.py

@@ -0,0 +1,70 @@
+"""
+Anotaciones del autor — cifradas en Supabase, descifradas en memoria.
+
+Flujo:
+  · En Supabase: texto cifrado con Fernet (ilegible sin la clave)
+  · En la app:   se descifra al vuelo con ANN_ENCRYPT_KEY de settings.py
+  · En disco:    nada se guarda
+"""
+from __future__ import annotations
+import json
+from pathlib import Path
+
+_chapter_cache: dict[str, dict[int, str]] = {}
+_LOCAL_DRAFT = Path.home() / ".biblia-cli" / "ann_drafts.json"
+
+def _prefix(t, b, c): return f"{t}/{b}/{c}"
+def _key(t, b, c, v): return f"{t}/{b}/{c}/{v}"
+
+def _client():
+    from .settings import SUPABASE_URL, SUPABASE_ANON_KEY
+    from supabase import create_client
+    return create_client(SUPABASE_URL, SUPABASE_ANON_KEY)
+
+def _decrypt(text: str) -> str:
+    try:
+        from cryptography.fernet import Fernet
+        from .settings import ANN_ENCRYPT_KEY
+        return Fernet(ANN_ENCRYPT_KEY.encode()).decrypt(text.encode()).decode()
+    except Exception:
+        return text  # si falla el descifrado devuelve el texto tal cual
+
+# ── Supabase (lectura + descifrado) ──────────────────────────────────────────
+async def get_chapter(translation: str, book_id: int, chapter: int) -> dict[int, str]:
+    key = _prefix(translation, book_id, chapter)
+    if key in _chapter_cache: return _chapter_cache[key]
+    try:
+        res = _client().table("annotations") \
+            .select("verse, text") \
+            .eq("translation", translation) \
+            .eq("book_id", book_id) \
+            .eq("chapter", chapter) \
+            .execute()
+        result = {r["verse"]: _decrypt(r["text"]) for r in (res.data or [])}
+    except Exception:
+        result = {}
+    _chapter_cache[key] = result
+    return result
+
+def invalidate(translation, book_id, chapter):
+    _chapter_cache.pop(_prefix(translation, book_id, chapter), None)
+
+# ── Borrador local (modal de escritura in-app) ────────────────────────────────
+def _load_drafts():
+    if _LOCAL_DRAFT.exists():
+        try: return json.loads(_LOCAL_DRAFT.read_text(encoding="utf-8"))
+        except Exception: pass
+    return {}
+
+def _save_drafts(data):
+    _LOCAL_DRAFT.parent.mkdir(parents=True, exist_ok=True)
+    _LOCAL_DRAFT.write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")
+
+def get_note_local(translation, book_id, chapter, verse) -> str | None:
+    return _load_drafts().get(_key(translation, book_id, chapter, verse))
+
+def save_local(translation, book_id, chapter, verse, text):
+    data = _load_drafts(); data[_key(translation, book_id, chapter, verse)] = text; _save_drafts(data)
+
+def delete_local(translation, book_id, chapter, verse):
+    data = _load_drafts(); data.pop(_key(translation, book_id, chapter, verse), None); _save_drafts(data)

biblia_cli-0.1.0/biblia_cli/api/bolls_client.py

@@ -0,0 +1,43 @@
+import re, httpx
+from .. import cache as local_cache
+
+BASE    = "https://bolls.life"
+TIMEOUT = 15.0
+
+TRANSLATIONS = {
+    "Español 🇪🇸":  [("RV1960", "Reina-Valera 1960")],
+    "Português 🇧🇷": [("ARA",   "Almeida Revista e Atualizada")],
+}
+PT_CODES = {"ARA","ARC09","NVIPT","NTLH","NVT","NAA","OL","KJA","CNBB","TB10","ACF11","NTJud","VFL","NBV07","ALM21"}
+
+def _clean(text):
+    text = re.sub(r"<br\s*/?>", "\n", text, flags=re.IGNORECASE)
+    return re.sub(r"<[^>]+>", "", text).strip()
+
+class BollsClient:
+    async def get_books(self, translation):
+        async with httpx.AsyncClient(timeout=TIMEOUT) as c:
+            r = await c.get(f"{BASE}/get-books/{translation}/"); r.raise_for_status()
+            return r.json()
+
+    async def get_chapter(self, translation, book_id, chapter):
+        cached = local_cache.load(translation, book_id, chapter)
+        if cached: return cached
+        async with httpx.AsyncClient(timeout=TIMEOUT) as c:
+            r = await c.get(f"{BASE}/get-text/{translation}/{book_id}/{chapter}/"); r.raise_for_status()
+            verses = r.json()
+        for v in verses: v["text"] = _clean(v["text"])
+        local_cache.save(translation, book_id, chapter, verses)
+        return verses
+
+    async def search(self, translation, query, page=1, limit=50):
+        async with httpx.AsyncClient(timeout=TIMEOUT) as c:
+            r = await c.get(f"{BASE}/v2/find/{translation}", params={"search":query,"page":page,"limit":limit})
+            r.raise_for_status(); data = r.json()
+        for res in data.get("results",[]): res["text"] = _clean(res["text"])
+        return data
+
+    async def get_random_verse(self, translation):
+        async with httpx.AsyncClient(timeout=TIMEOUT) as c:
+            r = await c.get(f"{BASE}/get-random-verse/{translation}/"); r.raise_for_status()
+            v = r.json(); v["text"] = _clean(v["text"]); return v

biblia_cli-0.1.0/biblia_cli/app.py

@@ -0,0 +1,254 @@
+from __future__ import annotations
+from textual import on, work
+import httpx
+from textual.app import App, ComposeResult
+from textual.binding import Binding
+from textual.containers import Horizontal, Vertical, VerticalScroll
+from textual.reactive import reactive
+from textual.screen import ModalScreen
+from textual.widgets import Button, Footer, Header, Input, Label, ListItem, ListView, Static
+from .api.bolls_client import BollsClient
+from .book_names import get_books_for_lang, lang_for_translation
+from .config import Config
+from .favorites import toggle as fav_toggle, is_favorite
+from .notes import get_chapter_notes
+from .annotations import get_chapter as ann_get_chapter
+from .themes import next_theme, LABELS
+from .widgets.annotation_modal import AnnotationReadModal, AnnotationWriteModal
+from .widgets.favorites_modal import FavoritesModal
+from .widgets.note_modal import NoteModal
+from .widgets.search_modal import SearchModal
+from .widgets.splash_screen import SplashScreen
+from .widgets.translation_modal import TranslationModal
+
+class BibliaApp(App):
+    CSS_PATH = "css/app.tcss"
+    ENABLE_COMMAND_PALETTE = False
+    BINDINGS = [
+        Binding("q",      "quit",         "Salir"),
+        Binding("t",      "switch_lang",  "[T] Idioma"),
+        Binding("ctrl+t", "cycle_theme",  "[^T] Tema"),
+        Binding("/",      "open_search",  "[/] Buscar"),
+        Binding("ctrl+f", "toggle_fav",   "[^F] ★"),
+        Binding("f",      "open_favs",    "[F] Marcadores"),
+        Binding("n",      "add_note",     "[N] Nota"),
+        Binding("h",      "read_ann",     "[H] ✦ Leer"),
+        Binding("ctrl+h", "write_ann",    "[^H] ✦ Escribir"),
+        Binding("d",      "daily",        "[D] Lectura hoy"),
+        Binding("escape", "clear_filter", "Limpiar"),
+    ]
+    translation: reactive[str] = reactive("RV1960")
+    biblia_theme: reactive[str] = reactive("dark")
+
+    def __init__(self):
+        super().__init__()
+        self.cfg = Config(); self.client = BollsClient()
+        self.books: list[dict] = []; self.book: dict | None = None
+        self.chapter: int = 1; self._verses_cache: list[dict] = []
+
+    def compose(self) -> ComposeResult:
+        yield Header(show_clock=True)
+        with Horizontal(id="main"):
+            with Vertical(id="books-panel"):
+                yield Label("📚 LIBROS", classes="panel-title")
+                yield Input(placeholder="🔍 Filtrar...", id="books-filter")
+                yield ListView(id="books-list")
+            with Vertical(id="chapters-panel"):
+                yield Label("📖 CAP.", classes="panel-title")
+                yield ListView(id="chapters-list")
+            with VerticalScroll(id="scripture-panel"):
+                yield Label("", id="scripture-title")
+                yield Label("", id="fav-indicator")
+                yield Static("", id="scripture-content", markup=True)
+        yield Footer()
+
+    def on_mount(self):
+        self.push_screen(SplashScreen())
+        self._start()
+
+    def _start(self, _=None):
+        s = self.cfg.load(); self.translation = s["translation"]; self.biblia_theme = s.get("theme","dark")
+        self._set_title()
+        self.load_books(s.get("last_book_id"), s.get("last_chapter",1))
+
+    def _set_title(self):
+        self.title = f"📖 Biblia CLI  ·  {self.translation}  ·  {LABELS[self.biblia_theme]}"
+
+    def watch_biblia_theme(self, t: str):
+        self._apply_theme(t)
+
+    def on_screen_resume(self) -> None:
+        self._apply_theme(self.biblia_theme)
+
+    def _apply_theme(self, t):
+        for o in [self, self.screen]:
+            for c in list(o.classes):
+                if c.startswith("theme-"): o.remove_class(c)
+            o.add_class(f"theme-{t}")
+    @work(exclusive=True)
+    async def load_books(self, restore_id=None, restore_ch=1):
+        bl = self.query_one("#books-list", ListView); bl.clear()
+        try: self.books = await self.client.get_books(self.translation)
+        except Exception:
+            self.books = get_books_for_lang(lang_for_translation(self.translation))
+            self.notify("Sin conexión — lista offline", timeout=3)
+        seen = set()
+        for b in self.books:
+            bid = b["bookid"]
+            if bid in seen: continue
+            seen.add(bid)
+            li = ListItem(Label(b["name"]))
+            li.book_id = bid
+            bl.append(li)
+        if restore_id:
+            tgt = next((b for b in self.books if b["bookid"]==restore_id), None)
+            if tgt: self.book=tgt; self._fill_chapters(tgt["chapters"],restore_ch); self.load_scripture()
+
+    def _fill_chapters(self, total, highlight=1):
+        cl = self.query_one("#chapters-list", ListView); cl.clear()
+        for i in range(1, total+1): cl.append(ListItem(Label(str(i))))
+        if highlight <= total: self.chapter=highlight; cl.index=highlight-1
+
+    @work(exclusive=True)
+    async def load_scripture(self):
+        if not self.book: return
+        tw=self.query_one("#scripture-title",Label); cw=self.query_one("#scripture-content",Static); fw=self.query_one("#fav-indicator",Label)
+        tw.update("⏳ Cargando..."); cw.update(""); fw.update("")
+        try: raw = await self.client.get_chapter(self.translation, self.book["bookid"], self.chapter)
+        except Exception as e: tw.update(f"[red]❌ {e}[/red]"); return
+        self._verses_cache = raw
+        verses = raw
+        notes  = get_chapter_notes(self.translation, self.book["bookid"], self.chapter)
+        ann    = await ann_get_chapter(self.translation, self.book["bookid"], self.chapter)
+        tw.update(f"[bold #d4a017]{self.book['name']}[/bold #d4a017]  [bold cyan]Cap. {self.chapter}[/bold cyan]  [dim]{self.translation}[/dim]")
+        fw.update("[bold #d4a017]⭐ Marcado[/bold #d4a017]" if is_favorite(self.translation,self.book["bookid"],self.chapter) else "")
+        lines=[]
+        for v in verses:
+            vn=v["verse"]
+            note_icon  = " [bold #d4a017]✏[/bold #d4a017]"  if vn in notes else ""
+            ann_marker = "  [bold #aaaaaa]***[/bold #aaaaaa]" if vn in ann   else ""
+            lines.append(f"[bold cyan]{vn:>3}[/bold cyan]{note_icon}  {v['text']}{ann_marker}")
+            if vn in notes:
+                for nl in notes[vn].splitlines(): lines.append(f"     [italic #d4a017]│ {nl}[/italic #d4a017]")
+                lines.append("")
+        cw.update("\n".join(lines))
+        self.cfg.save({"translation":self.translation,"last_book_id":self.book["bookid"],"last_chapter":self.chapter,"theme":self.biblia_theme})
+
+    @on(ListView.Selected,"#books-list")
+    def on_book(self,event):
+        if event.item and hasattr(event.item, "book_id"):
+            bid = event.item.book_id
+            self.book=next((b for b in self.books if b["bookid"]==bid),None)
+            if self.book: self._fill_chapters(self.book["chapters"]); self.chapter=1; self.load_scripture(); self.query_one("#chapters-list",ListView).focus()
+
+    @on(ListView.Selected,"#chapters-list")
+    def on_chapter(self,_):
+        idx=self.query_one("#chapters-list",ListView).index
+        if idx is not None: self.chapter=idx+1; self.load_scripture()
+
+    @on(Input.Changed,"#books-filter")
+    def filter_books(self,event):
+        q=event.value.strip().lower(); bl=self.query_one("#books-list",ListView); bl.clear()
+        seen = set()
+        for b in self.books:
+            bid = b["bookid"]
+            if q in b["name"].lower() and bid not in seen:
+                seen.add(bid)
+                li = ListItem(Label(b["name"]))
+                li.book_id = bid
+                bl.append(li)
+
+    def action_switch_lang(self): self.push_screen(TranslationModal(),self._on_trans)
+    def _on_trans(self,t):
+        if t: self.translation=t; self.cfg.save({"translation":t}); self._set_title(); self.load_books()
+    def action_cycle_theme(self):
+        self.biblia_theme=next_theme(self.biblia_theme); self._set_title(); self.cfg.save({"theme":self.biblia_theme}); self.notify(f"Tema: {LABELS[self.biblia_theme]}",timeout=1.5)
+    def action_open_search(self):
+        if self.books: self.push_screen(SearchModal(self.translation,self.books),self._on_search)
+    def _on_search(self,r):
+        if r:
+            bid,ch=r; b=next((x for x in self.books if x["bookid"]==bid),None)
+            if b: self.book=b; self.chapter=ch; self._fill_chapters(b["chapters"],ch); self.load_scripture()
+    def action_toggle_fav(self):
+        if not self.book: self.notify("Abre un capítulo primero.",timeout=2); return
+        added=fav_toggle(self.translation,self.book["bookid"],self.book["name"],self.chapter)
+        self.notify("⭐ Marcado" if added else "★ Eliminado",timeout=2)
+        self.query_one("#fav-indicator",Label).update("[bold #d4a017]⭐ Marcado[/bold #d4a017]" if added else "")
+    def action_open_favs(self): self.push_screen(FavoritesModal(),self._on_fav)
+    def _on_fav(self,fav):
+        if fav:
+            b=next((x for x in self.books if x["bookid"]==fav["book_id"]),None)
+            if b: self.book=b; self.chapter=fav["chapter"]; self._fill_chapters(b["chapters"],fav["chapter"]); self.load_scripture()
+    def action_add_note(self):
+        if not self.book: self.notify("Abre un capítulo primero.",timeout=2); return
+        self.push_screen(_VP(self.book["name"],self.chapter,"✏️  Nota en"),self._open_note)
+    def _open_note(self,v):
+        if v: self.push_screen(NoteModal(self.translation,self.book["bookid"],self.book["name"],self.chapter,v),lambda c: self.load_scripture() if c else None)
+    def action_read_ann(self):
+        if not self.book: self.notify("Abre un capítulo primero.",timeout=2); return
+        self.push_screen(_VP(self.book["name"],self.chapter,"✦  Ver nota de"),self._open_ann_read)
+    def _open_ann_read(self,verse):
+        if verse: self._do_read_ann(verse)
+    @work
+    async def _do_read_ann(self,verse:int):
+        ann=await ann_get_chapter(self.translation,self.book["bookid"],self.chapter)
+        if verse in ann: self.push_screen(AnnotationReadModal(self.book["name"],self.chapter,verse,ann[verse]))
+        else: self.notify(f"No hay nota ✦ en el versículo {verse}.",timeout=2)
+    def action_write_ann(self):
+        if not self.book: self.notify("Abre un capítulo primero.",timeout=2); return
+        self.push_screen(_VP(self.book["name"],self.chapter,"✦  Nota de autor en"),self._open_ann_write)
+    def _open_ann_write(self,verse):
+        if verse: self.push_screen(AnnotationWriteModal(self.translation,self.book["bookid"],self.book["name"],self.chapter,verse),lambda c: self.load_scripture() if c else None)
+    def action_daily(self): self._do_daily()
+    @work(exclusive=True)
+    async def _do_daily(self):
+        if not self.books: return
+        self.notify("⏳ Obteniendo lectura litúrgica...", timeout=2)
+        try:
+            import json, re
+            async with httpx.AsyncClient(timeout=10, follow_redirects=True) as c:
+                r = await c.get("https://universalis.com/Europe.Spain/jsonpmass.js")
+                r.raise_for_status()
+                txt = r.text
+                mj = re.search(r"universalisCallback\((.*)\);", txt, re.DOTALL)
+                if not mj: raise Exception("Error de formato")
+                data = json.loads(mj.group(1))
+                src = data.get("Mass_R1",{}).get("source","")
+                if not src: src = data.get("Mass_G",{}).get("source","")
+                m = re.search(r"^([1-3]?\s?[a-zA-Z\s]+)\s+(\d+)", src)
+                if not m: raise Exception(f"No parseable: {src}")
+                bname, ch = m.group(1).strip(), int(m.group(2))
+                from .book_names import resolve_book
+                bid = resolve_book(bname)
+                if not bid: raise Exception(f"No reconozco {bname}")
+                tgt = next((b for b in self.books if b["bookid"]==bid),None)
+                if not tgt: raise Exception(f"{bname} no disponible")
+                self.book=tgt; self.chapter=ch; self._fill_chapters(tgt["chapters"],ch); self.load_scripture()
+                self.notify(f"📖 {src}", timeout=3)
+        except Exception as e: self.notify(f"Error lectura: {e}", severity="error")
+    def action_clear_filter(self):
+        f=self.query_one("#books-filter",Input)
+        if f.value: f.value=""; self.filter_books(Input.Changed(f,""))
+        else: self.query_one("#books-list",ListView).focus()
+
+class _VP(ModalScreen):
+    DEFAULT_CSS="""
+    _VP { align: center middle; }
+    #vp-box { width: 46; height: auto; background: $surface; border: thick $primary; padding: 1 2; }
+    #vp-title { text-style: bold; color: $accent; text-align: center; width: 100%; margin-bottom: 1; }
+    #vp-foot  { height: 3; margin-top: 1; align: right middle; }
+    """
+    def __init__(self,book_name,chapter,label): super().__init__(); self._label=f"{label} {book_name} {chapter}"
+    def compose(self) -> ComposeResult:
+        with Vertical(id="vp-box"):
+            yield Label(self._label,id="vp-title"); yield Input(placeholder="Número de versículo...",id="vp-input")
+            with Horizontal(id="vp-foot"): yield Button("Aceptar",id="vp-ok",variant="primary"); yield Button("Cancelar",id="vp-no")
+    def on_mount(self): self.query_one("#vp-input",Input).focus()
+    @on(Button.Pressed,"#vp-ok")
+    @on(Input.Submitted,"#vp-input")
+    def accept(self,_=None):
+        val=self.query_one("#vp-input",Input).value.strip(); self.dismiss(int(val) if val.isdigit() else None)
+    @on(Button.Pressed,"#vp-no")
+    def cancel(self): self.dismiss(None)
+
+def main(): BibliaApp().run()

biblia_cli-0.1.0/biblia_cli/book_names.py

@@ -0,0 +1,86 @@
+import unicodedata
+from .api.bolls_client import PT_CODES
+
+def _n(s):
+    return "".join(c for c in unicodedata.normalize("NFD",s.lower()) if unicodedata.category(c)!="Mn")
+
+BOOKS = [
+    (1,"Génesis","Gênesis",50),(2,"Éxodo","Êxodo",40),(3,"Levítico","Levítico",27),
+    (4,"Números","Números",36),(5,"Deuteronomio","Deuteronômio",34),(6,"Josué","Josué",24),
+    (7,"Jueces","Juízes",21),(8,"Rut","Rute",4),(9,"1 Samuel","1 Samuel",31),
+    (10,"2 Samuel","2 Samuel",24),(11,"1 Reyes","1 Reis",22),(12,"2 Reyes","2 Reis",25),
+    (13,"1 Crónicas","1 Crônicas",29),(14,"2 Crónicas","2 Crônicas",36),
+    (15,"Esdras","Esdras",10),(16,"Nehemías","Neemias",13),(17,"Ester","Ester",10),
+    (18,"Job","Jó",42),(19,"Salmos","Salmos",150),(20,"Proverbios","Provérbios",31),
+    (21,"Eclesiastés","Eclesiastes",12),(22,"Cantares","Cantares",8),
+    (23,"Isaías","Isaías",66),(24,"Jeremías","Jeremias",52),
+    (25,"Lamentaciones","Lamentações",5),(26,"Ezequiel","Ezequiel",48),
+    (27,"Daniel","Daniel",12),(28,"Oseas","Oséias",14),(29,"Joel","Joel",3),
+    (30,"Amós","Amós",9),(31,"Abdías","Obadias",1),(32,"Jonás","Jonas",4),
+    (33,"Miqueas","Miquéias",7),(34,"Nahúm","Naum",3),(35,"Habacuc","Habacuque",3),
+    (36,"Sofonías","Sofonias",3),(37,"Hageo","Ageu",2),(38,"Zacarías","Zacarias",14),
+    (39,"Malaquías","Malaquias",4),(40,"Mateo","Mateus",28),(41,"Marcos","Marcos",16),
+    (42,"Lucas","Lucas",24),(43,"Juan","João",21),(44,"Hechos","Atos",28),
+    (45,"Romanos","Romanos",16),(46,"1 Corintios","1 Coríntios",16),
+    (47,"2 Corintios","2 Coríntios",13),(48,"Gálatas","Gálatas",6),
+    (49,"Efesios","Efésios",6),(50,"Filipenses","Filipenses",4),
+    (51,"Colosenses","Colossenses",4),(52,"1 Tesalonicenses","1 Tessalonicenses",5),
+    (53,"2 Tesalonicenses","2 Tessalonicenses",3),(54,"1 Timoteo","1 Timóteo",6),
+    (55,"2 Timoteo","2 Timóteo",4),(56,"Tito","Tito",3),(57,"Filemón","Filemom",1),
+    (58,"Hebreos","Hebreus",13),(59,"Santiago","Tiago",5),(60,"1 Pedro","1 Pedro",5),
+    (61,"2 Pedro","2 Pedro",3),(62,"1 Juan","1 João",5),(63,"2 Juan","2 João",1),
+    (64,"3 Juan","3 João",1),(65,"Judas","Judas",1),(66,"Apocalipsis","Apocalipse",22),
+]
+
+def get_books_for_lang(lang):
+    return [{"bookid":b,"name":es if lang=="es" else pt,"chapters":ch} for b,es,pt,ch in BOOKS]
+
+def lang_for_translation(code):
+    return "pt" if code in PT_CODES else "es"
+
+_ES, _PT = {}, {}
+for _bid,_nes,_npt,_ in BOOKS:
+    _ES[_n(_nes)]=_bid; _PT[_n(_npt)]=_bid
+
+_ES.update({"gn":1,"gen":1,"ex":2,"lv":3,"lev":3,"nm":4,"num":4,"dt":5,"jos":6,"jue":7,"rt":8,
+    "1sm":9,"1sa":9,"2sm":10,"2sa":10,"1re":11,"2re":12,"1cr":13,"2cr":14,"esd":15,"ne":16,
+    "neh":16,"est":17,"jb":18,"sal":19,"sl":19,"ps":19,"pr":20,"prov":20,"ec":21,"ecl":21,
+    "ct":22,"is":23,"isa":23,"jr":24,"jer":24,"lm":25,"ez":26,"dn":27,"dan":27,"os":28,
+    "jl":29,"am":30,"ab":31,"jon":32,"mi":33,"na":34,"hab":35,"sof":36,"sf":36,"hag":37,
+    "zac":38,"mal":39,"mt":40,"mc":41,"mr":41,"lc":42,"jn":43,"hch":44,"act":44,"ro":45,
+    "rom":45,"1co":46,"2co":47,"gl":48,"ga":48,"ef":49,"fp":50,"col":51,"1ts":52,"2ts":53,
+    "1tm":54,"1ti":54,"2tm":55,"2ti":55,"tt":56,"flm":57,"he":58,"heb":58,"stg":59,"sg":59,
+    "1pe":60,"2pe":61,"1jn":62,"1j":62,"2jn":63,"3jn":64,"jud":65,"ap":66,"apoc":66})
+_PT.update({"gn":1,"ex":2,"lv":3,"nm":4,"dt":5,"js":6,"jz":7,"rt":8,"1sm":9,"2sm":10,
+    "1rs":11,"2rs":12,"1cr":13,"2cr":14,"ed":15,"ne":16,"et":17,"sl":19,"pv":20,"ec":21,
+    "ct":22,"is":23,"jr":24,"lm":25,"ez":26,"dn":27,"os":28,"jl":29,"am":30,"ob":31,
+    "mq":33,"na":34,"hc":35,"sf":36,"ag":37,"zc":38,"ml":39,"mt":40,"mc":41,"lc":42,
+    "jo":43,"at":44,"rm":45,"1co":46,"2co":47,"gl":48,"ef":49,"fp":50,"cl":51,"1ts":52,
+    "2ts":53,"1tm":54,"2tm":55,"tt":56,"fm":57,"hb":58,"tg":59,"1pe":60,"2pe":61,
+    "1jo":62,"2jo":63,"3jo":64,"jd":65,"ap":66})
+
+_EN = {"gn":1,"gen":1,"ex":2,"lv":3,"lev":3,"nm":4,"num":4,"dt":5,"jos":6,"jue":7,"rt":8,
+    "1sm":9,"1sa":9,"2sm":10,"2sa":10,"1re":11,"2re":12,"1cr":13,"2cr":14,"esd":15,"ne":16,
+    "est":17,"jb":18,"sal":19,"sl":19,"ps":19,"pr":20,"prov":20,"ec":21,"ecl":21,
+    "ct":22,"is":23,"isa":23,"jr":24,"jer":24,"lm":25,"ez":26,"dn":27,"dan":27,"os":28,
+    "jl":29,"am":30,"ab":31,"jon":32,"mi":33,"na":34,"hab":35,"sof":36,"sf":36,"hag":37,
+    "zac":38,"mal":39,"mt":40,"mc":41,"mr":41,"lc":42,"jn":43,"hch":44,"act":44,"ro":45,
+    "rom":45,"1co":46,"2co":47,"gl":48,"ga":48,"ef":49,"fp":50,"col":51,"1ts":52,"2ts":53,
+    "1tm":54,"1ti":54,"2tm":55,"2ti":55,"tt":56,"flm":57,"he":58,"heb":58,"stg":59,"sg":59,
+    "1pe":60,"2pe":61,"1jn":62,"1j":62,"2jn":63,"3jn":64,"jud":65,"ap":66,"apoc":66,
+    "genesis":1,"exodus":2,"leviticus":3,"numbers":4,"deuteronomy":5,"joshua":6,"judges":7,"ruth":8,
+    "1 samuel":9,"2 samuel":10,"1 kings":11,"2 kings":12,"1 chronicles":13,"2 chronicles":14,
+    "ezra":15,"nehemiah":16,"esther":17,"job":18,"psalms":19,"proverbs":20,"ecclesiastes":21,
+    "song of songs":22,"isaiah":23,"jeremiah":24,"lamentations":25,"ezekiel":26,"daniel":27,
+    "hosea":28,"joel":29,"amos":30,"obadiah":31,"jonah":32,"micah":33,"nahum":34,"habakkuk":35,
+    "zephaniah":36,"haggai":37,"zechariah":38,"malachi":39,"matthew":40,"mark":41,"luke":42,
+    "john":43,"acts":44,"romans":45,"1 corinthians":46,"2 corinthians":47,"galatians":48,
+    "ephesians":49,"philippians":50,"colossians":51,"1 thessalonians":52,"2 thessalonians":53,
+    "1 timothy":54,"2 timothy":55,"titus":56,"philemon":57,"hebrews":58,"james":59,"1 peter":60,
+    "2 peter":61,"1 john":62,"2 john":63,"3 john":64,"jude":65,"revelation":66}
+
+def resolve_book(name, lang="es"):
+    n = _n(name.strip())
+    if lang == "es": return _ES.get(n) or _EN.get(n)
+    if lang == "pt": return _PT.get(n) or _EN.get(n)
+    return _EN.get(n)

biblia_cli-0.1.0/biblia_cli/cache.py

@@ -0,0 +1,22 @@
+import json
+from pathlib import Path
+
+CACHE_DIR = Path.home() / ".biblia-cli" / "cache"
+
+def _p(t, b, c): return CACHE_DIR / t / f"{b}_{c}.json"
+
+def load(translation, book_id, chapter):
+    p = _p(translation, book_id, chapter)
+    if p.exists():
+        try: return json.loads(p.read_text(encoding="utf-8"))
+        except Exception: pass
+    return None
+
+def save(translation, book_id, chapter, verses):
+    p = _p(translation, book_id, chapter)
+    p.parent.mkdir(parents=True, exist_ok=True)
+    p.write_text(json.dumps(verses, ensure_ascii=False), encoding="utf-8")
+
+def stats():
+    if not CACHE_DIR.exists(): return {}
+    return {d.name: len(list(d.glob("*.json"))) for d in CACHE_DIR.iterdir() if d.is_dir()}