bioLOLPython 0.1.0__py3-none-any.whl

bioLOLPython/dialects/lolcat.py

@@ -0,0 +1,64 @@
+DIALECT = {
+    "name": "lolcat",
+    "era": "~2005-2012",
+    "description": "I CAN HAS BIOINFORMATICS? Classic lolspeak from the cheezburger era.",
+    "commands": {
+        "init": {
+            "pattern": "HAI GENZOME",
+            "greeting": "🐾 LOADING bioLOLCODE V1... LETZ GOOOO 💥",
+        },
+        "end": {
+            "pattern": "KTHXBYE",
+        },
+        "declare": {
+            "pattern": "DNA GO {name} ITZ {seq}",
+        },
+        "reverse": {
+            "pattern": "REVERSE THAT {name}",
+        },
+        "gc_content": {
+            "pattern": "GC BOMB {name}",
+            "response": "💥 GC content: {value:.2f}% 🧬",
+        },
+        "print": {
+            "pattern": "VISIBLE",
+        },
+        "transcribe": {
+            "pattern": "TRANSCRIBE {name}",
+        },
+        "translate": {
+            "pattern": "TRANSLATE {name}",
+        },
+        "align": {
+            "pattern": "ALIGN {a} WIT {b}",
+            "response": "🌈 ALINE SCOREZ: {score:.2f} 🔥 itz {rating}!!",
+        },
+        "mutate": {
+            "pattern": "I CRAVE VIOLENCE {name}",
+            "response": "💣 mutated {name} at pos {pos}: {old} ➜ {new}",
+        },
+        "length": {
+            "pattern": "HOW LONG {name}",
+            "response": "📏 {name} iz {value} bases long",
+        },
+        "complement": {
+            "pattern": "COMPLEMENT {name}",
+        },
+        "find_orf": {
+            "pattern": "FIND ORF {name}",
+            "orf_found": "🔍 ORF found: {orf} ({length} bp)",
+            "orf_missing": "🔍 No ORF found in {name} (no ATG start codon)",
+        },
+        "motif": {
+            "pattern": "MOTIF HUNT {name} FOR {pattern}",
+            "found": "🎯 Found {count} match(es) for '{pattern}' in {name}:",
+            "position": "   pos {start}-{end}",
+            "not_found": "🎯 No matches for '{pattern}' in {name}",
+        },
+    },
+    "examples": {
+        "GC Content": 'HAI GENZOME 1.0\nDNA GO X ITZ "ATGCATGC"\nGC BOMB X\nKTHXBYE',
+        "Protein Translation": 'HAI GENZOME 1.0\nDNA GO Y ITZ "ATGGAGGAGCC"\nTRANSLATE Y\nVISIBLE "Protein: " + Y\nKTHXBYE',
+        "Alignment": 'HAI GENZOME 1.0\nDNA GO A ITZ "ATGCGTAGG"\nDNA GO B ITZ "ATGCGTACG"\nALIGN A WIT B\nKTHXBYE',
+    },
+}

bioLOLPython/dialects/remote.py

@@ -0,0 +1,91 @@
+"""
+Remote dialect fetching and caching.
+
+Fetches dialect YAML files from a remote registry (GitHub raw URL by default),
+caches them locally in ~/.bioLOL/dialects/, and reloads the dialect registry.
+"""
+import os
+import time
+from pathlib import Path
+from urllib.request import urlopen, Request
+from urllib.error import URLError
+
+from bioLOLPython.dialects.base import USER_DIR
+
+# Default registry: raw GitHub URL pointing to the definitions/ directory
+DEFAULT_REGISTRY_URL = (
+    "https://raw.githubusercontent.com/ChenHsieh/bioLOLPython/master/"
+    "bioLOLPython/dialects/definitions"
+)
+
+# Default index file listing available dialect filenames
+INDEX_FILENAME = "index.txt"
+
+# Cache TTL: 24 hours
+CACHE_TTL_SECONDS = 86400
+
+
+def _ensure_user_dir():
+    USER_DIR.mkdir(parents=True, exist_ok=True)
+
+
+def _is_cache_fresh(path, ttl=CACHE_TTL_SECONDS):
+    """Check if a cached file is fresh enough."""
+    if not path.exists():
+        return False
+    age = time.time() - path.stat().st_mtime
+    return age < ttl
+
+
+def _fetch_url(url, timeout=10):
+    """Fetch content from a URL."""
+    req = Request(url, headers={"User-Agent": "bioLOLPython"})
+    with urlopen(req, timeout=timeout) as resp:
+        return resp.read().decode("utf-8")
+
+
+def fetch_dialect(name, registry_url=DEFAULT_REGISTRY_URL):
+    """Fetch a single dialect YAML from the remote registry and cache it."""
+    _ensure_user_dir()
+    url = f"{registry_url}/{name}.yaml"
+    content = _fetch_url(url)
+    cache_path = USER_DIR / f"{name}.yaml"
+    cache_path.write_text(content)
+    return cache_path
+
+
+def fetch_index(registry_url=DEFAULT_REGISTRY_URL):
+    """Fetch the index of available remote dialects."""
+    url = f"{registry_url}/{INDEX_FILENAME}"
+    content = _fetch_url(url)
+    return [line.strip() for line in content.splitlines() if line.strip()]
+
+
+def update_dialects(registry_url=DEFAULT_REGISTRY_URL, force=False):
+    """Fetch all remote dialects and update local cache.
+
+    Returns a list of (name, status) tuples where status is
+    'updated', 'cached', or 'error: ...'.
+    """
+    _ensure_user_dir()
+    results = []
+
+    # Try to fetch index; if unavailable, fetch known dialect names
+    try:
+        dialect_names = fetch_index(registry_url)
+    except URLError:
+        # Fallback: try common names
+        dialect_names = ["lolcat", "gen_z", "brainrot"]
+
+    for name in dialect_names:
+        cache_path = USER_DIR / f"{name}.yaml"
+        if not force and _is_cache_fresh(cache_path):
+            results.append((name, "cached"))
+            continue
+        try:
+            fetch_dialect(name, registry_url)
+            results.append((name, "updated"))
+        except Exception as e:
+            results.append((name, f"error: {e}"))
+
+    return results