Merge pull request #3 from aryakaul/auto-curated-default

feat: no option default

Author: aryakaul

README.md

@@ -10,23 +10,22 @@
 
 ## Quick Start
 
-Pick an artist list (one name per line). A starter list lives at
-[`arya-curated`](https://raw.githubusercontent.com/aryakaul/tinyjam/main/arya-curated).
+Pick an artist list (one name per line). My list lives at [`arya-curated`](https://raw.githubusercontent.com/aryakaul/tinyjam/main/arya-curated).
+Launch `tinyjam` with no options to have it automatically grab that curated list
+and start streaming it (same as `tinyjam -l arya-curated -n`).
 
 ### macOS (Homebrew)
 ```bash
 brew tap aryakaul/formulae
 brew install tinyjam
-wget https://raw.githubusercontent.com/aryakaul/tinyjam/main/arya-curated
-tinyjam -l ./arya-curated -n  # stream without downloading
+tinyjam 
 ```
 
 ### Any platform (PyPI)
 ```bash
 pip install tinyjam
 # tinyjam expects `mpv` and `yt-dlp` on your PATH
-wget https://raw.githubusercontent.com/aryakaul/tinyjam/main/arya-curated
-tinyjam -l ./arya-curated
+tinyjam 
 ```
 
 ### From source
@@ -35,7 +34,7 @@ git clone https://github.com/aryakaul/tinyjam.git
 cd tinyjam
 pip install --upgrade pip build
 pip install -e .
-tinyjam -l ./arya-curated -n
+tinyjam -l ./arya-curated -o ~/videos/tinydesk
 ```
 
 ---
@@ -58,7 +57,7 @@ tinyjam --help
     -v, --verbose     Extra logging
 ```
 
-Tinyjam keeps a download cache, retries through `yt-dlp`, and can fetch manual subtitles when a Tiny Desk isn’t in your preferred language. Use `--nodownload` to shuffle a curated list straight from YouTube, or let it fill `./jamsesh` and loop locally via mpv. Want deterministic runs? Pass `--playlist-order forward` to honor the jam list top-to-bottom or `--playlist-order reverse` to flip it.
+Tinyjam keeps a download cache, retries through `yt-dlp`, and can fetch manual subtitles when a Tiny Desk isn’t in your preferred language. Use `--nodownload` to shuffle a curated list straight from YouTube, or let it fill `./jamsesh` and loop locally via mpv. Running `tinyjam` with zero flags defaults to streaming my curated list.
 
 Enjoy the desks ✨
 

src/tinyjam/cli.py

@@ -18,13 +18,16 @@
 import shutil
 import subprocess
 import sys
+import tempfile
 import threading
 from dataclasses import dataclass, field
 from pathlib import Path
 from typing import Any, Dict, Iterable, List, Optional, Sequence, Set, Tuple
 
 from loguru import logger
 from tqdm import tqdm
+from urllib.error import HTTPError, URLError
+from urllib.request import urlopen
 
 YT_CHANNEL_ID = "UC4eYXhJI4-7wSWc8UNRwD4A"
 STANDARD_OPS: Sequence[str] = (
@@ -42,6 +45,9 @@
 ENGLISH_PREFIXES = ("en", "eng")
 SUB_LINE_RE = re.compile(r"^([A-Za-z0-9][\w\.-]*)\s")
 PLAYLIST_ORDER_CHOICES = ("shuffle", "forward", "reverse")
+CURATED_JAMLIST_URL = (
+    "https://raw.githubusercontent.com/aryakaul/tinyjam/refs/heads/main/arya-curated"
+)
 
 
 def configure_logging(verbose: bool) -> None:
@@ -159,6 +165,35 @@ def build_subtitle_args(target_language: str) -> List[str]:
     ]
 
 
+def fetch_curated_jamlist() -> Path:
+    try:
+        with urlopen(CURATED_JAMLIST_URL, timeout=30) as response:
+            payload = response.read()
+    except (HTTPError, URLError) as exc:
+        logger.error("failed to download curated jam list | {}", exc)
+        sys.exit(1)
+    except OSError as exc:
+        logger.error("network error loading curated jam list | {}", exc)
+        sys.exit(1)
+
+    if not payload:
+        logger.error("curated jam list download returned no data")
+        sys.exit(1)
+
+    try:
+        with tempfile.NamedTemporaryFile(
+            "wb", delete=False, prefix="tinyjam-curated-", suffix=".txt"
+        ) as handle:
+            handle.write(payload)
+            temp_path = Path(handle.name)
+    except OSError as exc:
+        logger.error("failed to persist curated jam list | {}", exc)
+        sys.exit(1)
+
+    logger.info("using curated jam list from {}", CURATED_JAMLIST_URL)
+    return temp_path
+
+
 @dataclass
 class TinyJamContext:
     jamlist: Path
@@ -820,15 +855,19 @@ def run(self) -> int:
         return 0
 
 
-def parse_args(argv: Optional[Sequence[str]] = None) -> TinyJamContext:
+def parse_args(
+    argv: Optional[Sequence[str]] = None,
+    *,
+    require_list: bool = True,
+) -> TinyJamContext:
     parser = argparse.ArgumentParser(
         description="Jam to tiny desks with tinyjam (Python edition)",
         formatter_class=argparse.ArgumentDefaultsHelpFormatter,
     )
     parser.add_argument(
         "-l",
         "--list",
-        required=True,
+        required=require_list,
         type=Path,
         help="path to artist list file (one per line)",
     )
@@ -917,8 +956,14 @@ def parse_args(argv: Optional[Sequence[str]] = None) -> TinyJamContext:
 
 
 def main(argv: Optional[Sequence[str]] = None) -> int:
-    ctx = parse_args(argv)
+    args_list = list(argv) if argv is not None else sys.argv[1:]
+    use_curated_default = len(args_list) == 0
+    ctx = parse_args(args_list, require_list=not use_curated_default)
     configure_logging(ctx.verbose)
+    if use_curated_default:
+        ctx.jamlist = fetch_curated_jamlist()
+        ctx.nodownload = True
+        logger.info("no options provided | defaulting to streaming mode")
     app = TinyJam(ctx)
     return app.run()