Files
kjvstudy.org/kjvstudy_org/interlinear_loader.py
T
kennethreitz c03af4ed28 Convert interlinear data from gzipped Python to gzipped JSON
- Move interlinear_data.py.gz to data/interlinear.json.gz
- Simplify loader to read JSON directly (no more Python parsing)
- Reduced file size from 13.51 MB to 12.37 MB
- 31,031 verses of Hebrew/Greek interlinear data

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-26 10:47:16 -05:00

92 lines
2.7 KiB
Python

"""
Lazy loader for compressed interlinear Bible data.
Decompresses and loads the data on first access.
Optimized for fly.io production deployment.
"""
import gzip
import json
import logging
from pathlib import Path
from typing import Optional, Dict, List
logger = logging.getLogger(__name__)
_interlinear_data = None
_load_failed = False
def _load_interlinear_data():
"""Load and decompress interlinear data from gzipped JSON file"""
global _interlinear_data, _load_failed
if _interlinear_data is not None:
return _interlinear_data
# If loading previously failed, return empty dict to avoid repeated errors
if _load_failed:
logger.warning("Interlinear data loading previously failed, returning empty data")
return {}
data_file = Path(__file__).parent / "data" / "interlinear.json.gz"
try:
logger.info(f"Loading interlinear data from {data_file}...")
if not data_file.exists():
raise FileNotFoundError(f"Interlinear data file not found: {data_file}")
with gzip.open(data_file, 'rt', encoding='utf-8') as f:
_interlinear_data = json.load(f)
logger.info(f"Successfully loaded {len(_interlinear_data)} verses")
return _interlinear_data
except Exception as e:
_load_failed = True
logger.error(f"Failed to load interlinear data: {e}", exc_info=True)
_interlinear_data = {}
return _interlinear_data
def get_interlinear_data(book: str, chapter: int, verse: int) -> Optional[List[Dict]]:
"""Get interlinear data for a specific verse"""
data = _load_interlinear_data()
key = f"{book}:{chapter}:{verse}"
return data.get(key)
def has_interlinear_data(book: str, chapter: int, verse: int) -> bool:
"""Check if interlinear data exists for a verse"""
data = _load_interlinear_data()
key = f"{book}:{chapter}:{verse}"
return key in data
def get_all_interlinear_verses() -> List[Dict]:
"""Get list of all verses with interlinear data"""
data = _load_interlinear_data()
verses = []
for key in sorted(data.keys()):
book, chapter, verse = key.split(":")
verses.append({
"book": book,
"chapter": int(chapter),
"verse": int(verse),
"ref": f"{book} {chapter}:{verse}"
})
return verses
def preload_data():
"""
Preload interlinear data at startup to warm the cache.
Call this during application initialization to avoid first-request delays.
"""
logger.info("Preloading interlinear data to warm cache...")
data = _load_interlinear_data()
if data:
logger.info(f"Cache warmed successfully with {len(data)} verses")
else:
logger.warning("Cache warming completed but no data loaded")