rdt-cli 0.2.0__py3-none-any.whl

rdt_cli/commands/browse.py

@@ -0,0 +1,386 @@
+"""Browse commands: feed, subreddit, popular, all, user, open."""
+
+from __future__ import annotations
+
+import logging
+
+import click
+from rich.panel import Panel
+from rich.table import Table
+
+from ..client import RedditClient
+from ..constants import SORT_OPTIONS, TIME_FILTERS
+from ..index_cache import save_index
+from ._common import (
+    compact_posts,
+    console,
+    format_score,
+    format_time,
+    handle_command,
+    listing_options,
+    maybe_print_structured,
+    open_url,
+    optional_auth,
+    require_auth,
+    save_output_to_file,
+    structured_output_options,
+)
+
+logger = logging.getLogger(__name__)
+
+# Default title truncation length
+_TITLE_MAX = 50
+_FULL_TITLE_MAX = 200
+
+
+# ── Helpers ─────────────────────────────────────────────────────────
+
+
+def _render_post_table(
+    posts: list[dict], title: str,
+    show_subreddit: bool = True, full_text: bool = False,
+) -> None:
+    """Render a list of posts as a Rich table."""
+    if not posts:
+        console.print("[yellow]No posts found[/yellow]")
+        return
+
+    save_index(posts, source=title[:40])
+    max_title = _FULL_TITLE_MAX if full_text else _TITLE_MAX
+
+    table = Table(title=title, show_lines=True)
+    table.add_column("#", style="dim", width=3)
+    table.add_column("Score", style="yellow", width=6, justify="right")
+    if show_subreddit:
+        table.add_column("Subreddit", style="magenta", max_width=15)
+    table.add_column(
+        "Title", style="bold cyan",
+        max_width=max_title if not full_text else None,
+    )
+    table.add_column("Author", style="green", max_width=14)
+    table.add_column("💬", style="dim", width=5, justify="right")
+    table.add_column("Time", style="dim", max_width=10)
+
+    for i, post in enumerate(posts, 1):
+        title_text = post.get("title", "-")
+        if post.get("stickied"):
+            title_text = f"📌 {title_text}"
+        if post.get("over_18"):
+            title_text = f"🔞 {title_text}"
+        if post.get("is_video"):
+            title_text = f"🎬 {title_text}"
+
+        if not full_text:
+            title_text = title_text[:max_title]
+
+        row = [
+            str(i),
+            format_score(post.get("score", 0)),
+        ]
+        if show_subreddit:
+            row.append(f"r/{post.get('subreddit', '?')}")
+        row.extend([
+            title_text,
+            post.get("author", "-")[:14],
+            str(post.get("num_comments", 0)),
+            format_time(post.get("created_utc", 0)),
+        ])
+        table.add_row(*row)
+
+    console.print(table)
+    console.print("\n  [dim]💡 Use [bold]rdt show <#>[/bold] to read a post[/dim]")
+
+
+def _listing_render(
+    data: dict, title: str,
+    show_subreddit: bool = True, next_cmd: str = "",
+    full_text: bool = False,
+) -> None:
+    """Common render for listing endpoints."""
+    posts = RedditClient._extract_posts(data)
+    _render_post_table(posts, title, show_subreddit=show_subreddit, full_text=full_text)
+    cursor = RedditClient._extract_after(data)
+    if cursor and next_cmd:
+        console.print(f"  [dim]▸ More: {next_cmd} --after {cursor}[/dim]")
+
+
+def _handle_listing(
+    cred, *, action, data_title: str, next_cmd: str = "",
+    show_subreddit: bool = True,
+    as_json: bool, as_yaml: bool,
+    output_file: str | None = None,
+    full_text: bool = False,
+    compact: bool = False,
+) -> None:
+    """Unified listing handler with --output/--full-text/--compact support."""
+    from ..exceptions import RedditApiError
+    from ._common import exit_for_error, run_client_action
+
+    try:
+        data = run_client_action(cred, action)
+
+        # --output: save to file
+        if output_file:
+            out_data = data
+            if compact:
+                posts = RedditClient._extract_posts(data)
+                out_data = compact_posts(posts)
+            save_output_to_file(out_data, output_file)
+            return
+
+        # --compact: strip fields for structured output
+        if compact and (as_json or as_yaml):
+            posts = RedditClient._extract_posts(data)
+            data = compact_posts(posts)
+
+        # --json/--yaml: structured output
+        if maybe_print_structured(data, as_json=as_json, as_yaml=as_yaml):
+            return
+
+        # Rich render
+        _listing_render(
+            data, data_title,
+            show_subreddit=show_subreddit,
+            next_cmd=next_cmd,
+            full_text=full_text,
+        )
+    except RedditApiError as exc:
+        exit_for_error(exc, as_json=as_json, as_yaml=as_yaml)
+
+
+# ── feed ────────────────────────────────────────────────────────────
+
+
+@click.command()
+@click.option("-n", "--limit", default=25, type=int, help="Number of posts (default: 25)")
+@click.option("--after", default=None, help="Pagination cursor")
+@listing_options
+def feed(
+    limit: int, after: str | None,
+    as_json: bool, as_yaml: bool,
+    output_file: str | None, full_text: bool, compact: bool,
+) -> None:
+    """Browse your home feed (requires login)"""
+    cred = require_auth()
+    _handle_listing(
+        cred,
+        action=lambda c: c.get_home(limit=limit, after=after),
+        data_title="🏠 Home Feed",
+        next_cmd="rdt feed",
+        as_json=as_json, as_yaml=as_yaml,
+        output_file=output_file, full_text=full_text, compact=compact,
+    )
+
+
+# ── popular ─────────────────────────────────────────────────────────
+
+
+@click.command()
+@click.option("-n", "--limit", default=25, type=int, help="Number of posts")
+@click.option("--after", default=None, help="Pagination cursor")
+@listing_options
+def popular(
+    limit: int, after: str | None,
+    as_json: bool, as_yaml: bool,
+    output_file: str | None, full_text: bool, compact: bool,
+) -> None:
+    """Browse /r/popular"""
+    cred = optional_auth()
+    _handle_listing(
+        cred,
+        action=lambda c: c.get_popular(limit=limit, after=after),
+        data_title="🔥 Popular",
+        next_cmd="rdt popular",
+        as_json=as_json, as_yaml=as_yaml,
+        output_file=output_file, full_text=full_text, compact=compact,
+    )
+
+
+# ── all ─────────────────────────────────────────────────────────────
+
+
+@click.command(name="all")
+@click.option("-n", "--limit", default=25, type=int, help="Number of posts")
+@click.option("--after", default=None, help="Pagination cursor")
+@listing_options
+def all_cmd(
+    limit: int, after: str | None,
+    as_json: bool, as_yaml: bool,
+    output_file: str | None, full_text: bool, compact: bool,
+) -> None:
+    """Browse /r/all"""
+    cred = optional_auth()
+    _handle_listing(
+        cred,
+        action=lambda c: c.get_all(limit=limit, after=after),
+        data_title="🌍 r/all",
+        next_cmd="rdt all",
+        as_json=as_json, as_yaml=as_yaml,
+        output_file=output_file, full_text=full_text, compact=compact,
+    )
+
+
+# ── sub (subreddit) ─────────────────────────────────────────────────
+
+
+@click.command()
+@click.argument("subreddit")
+@click.option("-s", "--sort", type=click.Choice(SORT_OPTIONS), default="hot", help="Sort order")
+@click.option(
+    "-t", "--time", "time_filter",
+    type=click.Choice(TIME_FILTERS), default=None,
+    help="Time filter (for top/controversial)",
+)
+@click.option("-n", "--limit", default=25, type=int, help="Number of posts")
+@click.option("--after", default=None, help="Pagination cursor")
+@listing_options
+def sub(
+    subreddit: str, sort: str, time_filter: str | None, limit: int,
+    after: str | None, as_json: bool, as_yaml: bool,
+    output_file: str | None, full_text: bool, compact: bool,
+) -> None:
+    """Browse a subreddit (e.g., rdt sub python)"""
+    cred = optional_auth()
+    emoji = {"hot": "🔥", "new": "🆕", "top": "🏆", "rising": "📈"}.get(sort, "📋")
+    _handle_listing(
+        cred,
+        action=lambda c: c.get_subreddit(
+            subreddit, sort=sort, limit=limit, after=after, time_filter=time_filter,
+        ),
+        data_title=f"{emoji} r/{subreddit} ({sort})",
+        show_subreddit=False,
+        next_cmd=f"rdt sub {subreddit} -s {sort}",
+        as_json=as_json, as_yaml=as_yaml,
+        output_file=output_file, full_text=full_text, compact=compact,
+    )
+
+
+# ── sub-info ────────────────────────────────────────────────────────
+
+
+@click.command("sub-info")
+@click.argument("subreddit")
+@structured_output_options
+def sub_info(subreddit: str, as_json: bool, as_yaml: bool) -> None:
+    """View subreddit info (subscribers, description)"""
+    cred = optional_auth()
+
+    def _render(data: dict) -> None:
+        name = data.get("display_name_prefixed", f"r/{subreddit}")
+        desc = data.get("public_description", data.get("description", ""))
+        subs = data.get("subscribers", 0)
+        active = data.get("accounts_active", 0)
+        created = data.get("created_utc", 0)
+        nsfw = "🔞 NSFW" if data.get("over18") else ""
+
+        text = (
+            f"[bold cyan]{name}[/bold cyan] {nsfw}\n"
+            f"👥 {subs:,} subscribers · 🟢 {active:,} online\n"
+            f"📅 Created: {format_time(created)}\n"
+        )
+        if desc:
+            text += f"\n{desc[:300]}"
+
+        panel = Panel(text, title=f"📋 {name}", border_style="cyan")
+        console.print(panel)
+
+    handle_command(
+        cred,
+        action=lambda c: c.get_subreddit_about(subreddit),
+        render=_render, as_json=as_json, as_yaml=as_yaml,
+    )
+
+
+# ── user ────────────────────────────────────────────────────────────
+
+
+@click.command()
+@click.argument("username")
+@structured_output_options
+def user(username: str, as_json: bool, as_yaml: bool) -> None:
+    """View a user's profile"""
+    cred = optional_auth()
+
+    def _render(data: dict) -> None:
+        name = data.get("name", username)
+        karma_post = data.get("link_karma", 0)
+        karma_comment = data.get("comment_karma", 0)
+        created = data.get("created_utc", 0)
+        is_gold = "⭐ " if data.get("is_gold") else ""
+
+        text = (
+            f"[bold cyan]u/{name}[/bold cyan] {is_gold}\n"
+            f"📊 Post karma: {karma_post:,} · Comment karma: {karma_comment:,}\n"
+            f"📅 Account age: {format_time(created)}\n"
+        )
+
+        panel = Panel(text, title=f"👤 u/{name}", border_style="green")
+        console.print(panel)
+
+    handle_command(
+        cred, action=lambda c: c.get_user_about(username),
+        render=_render, as_json=as_json, as_yaml=as_yaml,
+    )
+
+
+# ── user-posts ──────────────────────────────────────────────────────
+
+
+@click.command("user-posts")
+@click.argument("username")
+@click.option("-n", "--limit", default=25, type=int, help="Number of posts")
+@click.option("--after", default=None, help="Pagination cursor")
+@listing_options
+def user_posts(
+    username: str, limit: int, after: str | None,
+    as_json: bool, as_yaml: bool,
+    output_file: str | None, full_text: bool, compact: bool,
+) -> None:
+    """View a user's submitted posts"""
+    cred = optional_auth()
+    _handle_listing(
+        cred,
+        action=lambda c: c.get_user_posts(username, limit=limit, after=after),
+        data_title=f"📝 u/{username}'s posts",
+        as_json=as_json, as_yaml=as_yaml,
+        output_file=output_file, full_text=full_text, compact=compact,
+    )
+
+
+# ── open ────────────────────────────────────────────────────────────
+
+
+@click.command(name="open")
+@click.argument("id_or_index")
+def open_post(id_or_index: str) -> None:
+    """Open a post in the browser (by ID or index number)
+
+    Examples:
+      rdt open 3           # open result #3 in browser
+      rdt open 1abc123     # open by post ID
+    """
+    from ..index_cache import get_item_by_index
+
+    # Try as short-index
+    try:
+        idx = int(id_or_index)
+        item = get_item_by_index(idx)
+        if item:
+            permalink = item.get("permalink", "")
+            if permalink:
+                url = f"https://reddit.com{permalink}"
+                console.print(f"[dim]Opening: {url}[/dim]")
+                open_url(url)
+                return
+        console.print(f"[yellow]Index {idx} not found in cache[/yellow]")
+        return
+    except ValueError:
+        pass
+
+    # Bare ID or URL
+    if id_or_index.startswith("http"):
+        open_url(id_or_index)
+    else:
+        url = f"https://reddit.com/comments/{id_or_index}"
+        console.print(f"[dim]Opening: {url}[/dim]")
+        open_url(url)

rdt_cli/commands/post.py

@@ -0,0 +1,183 @@
+"""Post commands: read, show, comments."""
+
+from __future__ import annotations
+
+import logging
+
+import click
+from rich.panel import Panel
+
+from ..index_cache import get_index_info, get_item_by_index
+from ._common import (
+    console,
+    handle_command,
+    optional_auth,
+    structured_output_options,
+)
+
+logger = logging.getLogger(__name__)
+
+
+# ── Helpers ─────────────────────────────────────────────────────────
+
+
+def _render_post_detail(data: list | dict) -> None:
+    """Render a post with its comments."""
+    if isinstance(data, list) and len(data) >= 1:
+        # [post_listing, comments_listing]
+        post_listing = data[0]
+        post_children = post_listing.get("data", {}).get("children", [])
+        post = post_children[0].get("data", {}) if post_children else {}
+
+        comments_listing = data[1] if len(data) > 1 else {}
+        comment_children = comments_listing.get("data", {}).get("children", [])
+    else:
+        post = data if isinstance(data, dict) else {}
+        comment_children = []
+
+    # Render post
+    title = post.get("title", "Untitled")
+    author = post.get("author", "?")
+    subreddit = post.get("subreddit", "?")
+    score = post.get("score", 0)
+    num_comments = post.get("num_comments", 0)
+    selftext = post.get("selftext", "")
+    url = post.get("url", "")
+    is_self = post.get("is_self", True)
+    permalink = post.get("permalink", "")
+
+    post_text = (
+        f"[bold cyan]{title}[/bold cyan]\n"
+        f"[dim]r/{subreddit}[/dim] · [green]u/{author}[/green] · "
+        f"[yellow]⬆ {score}[/yellow] · 💬 {num_comments}\n"
+    )
+
+    if not is_self and url:
+        post_text += f"\n🔗 {url}\n"
+
+    if selftext:
+        # Truncate very long posts
+        if len(selftext) > 1500:
+            selftext = selftext[:1500] + "\n\n... [truncated]"
+        post_text += f"\n{selftext}"
+
+    if permalink:
+        post_text += f"\n\n[dim]https://reddit.com{permalink}[/dim]"
+
+    panel = Panel(post_text, title="📰 Post", border_style="cyan")
+    console.print(panel)
+
+    # Render comments
+    if comment_children:
+        console.print()
+        _render_comments(comment_children, depth=0, max_depth=3)
+
+
+def _render_comments(children: list[dict], depth: int = 0, max_depth: int = 3) -> None:
+    """Recursively render comment tree."""
+    for child in children:
+        if child.get("kind") != "t1":
+            continue
+        comment = child.get("data", {})
+        author = comment.get("author", "[deleted]")
+        body = comment.get("body", "")
+        score = comment.get("score", 0)
+
+        indent = "  " * depth
+        score_color = "yellow" if score > 0 else "red" if score < 0 else "dim"
+
+        # Truncate long comments
+        if len(body) > 300:
+            body = body[:300] + "..."
+
+        console.print(
+            f"{indent}[green]u/{author}[/green] [{score_color}]⬆ {score}[/{score_color}]"
+        )
+        for line in body.split("\n"):
+            console.print(f"{indent}  {line}")
+        console.print()
+
+        # Render replies
+        if depth < max_depth:
+            replies = comment.get("replies", "")
+            if isinstance(replies, dict):
+                reply_children = replies.get("data", {}).get("children", [])
+                if reply_children:
+                    _render_comments(reply_children, depth=depth + 1, max_depth=max_depth)
+
+
+# ── read ────────────────────────────────────────────────────────────
+
+
+@click.command()
+@click.argument("post_id")
+@click.option(
+    "-s", "--sort", default="best",
+    type=click.Choice(["best", "top", "new", "controversial", "old", "qa"]),
+    help="Comment sort",
+)
+@click.option("-n", "--limit", default=25, type=int, help="Number of comments")
+@structured_output_options
+def read(post_id: str, sort: str, limit: int, as_json: bool, as_yaml: bool) -> None:
+    """Read a post and its comments by ID
+
+    Example: rdt read 1abc123
+    """
+    cred = optional_auth()
+    handle_command(
+        cred,
+        action=lambda c: c.get_post_comments(post_id=post_id, sort=sort, limit=limit),
+        render=_render_post_detail,
+        as_json=as_json,
+        as_yaml=as_yaml,
+    )
+
+
+# ── show (short-index) ──────────────────────────────────────────────
+
+
+@click.command()
+@click.argument("index", type=int)
+@click.option(
+    "-s", "--sort", default="best",
+    type=click.Choice(["best", "top", "new", "controversial", "old", "qa"]),
+    help="Comment sort",
+)
+@click.option("-n", "--limit", default=25, type=int, help="Number of comments")
+@structured_output_options
+def show(index: int, sort: str, limit: int, as_json: bool, as_yaml: bool) -> None:
+    """Read a post by its index from last listing (e.g., rdt show 3)
+
+    Use after rdt feed, rdt sub, rdt search, etc.
+    """
+    item = get_item_by_index(index)
+    if not item:
+        info = get_index_info()
+        if not info.get("exists"):
+            console.print("[yellow]No cached results. Run rdt feed, rdt sub, or rdt search first.[/yellow]")
+        else:
+            console.print(f"[yellow]Index {index} out of range (total: {info.get('count', 0)})[/yellow]")
+        return
+
+    post_id = item.get("id", "")
+    if not post_id:
+        console.print("[red]❌ Cached item has no post ID[/red]")
+        return
+
+    # Show brief info from cache
+    console.print(
+        f"  [dim]#{index}[/dim] [cyan]{item.get('title', '-')[:60]}[/cyan] "
+        f"[dim]r/{item.get('subreddit', '?')}[/dim]  "
+        f"[yellow]⬆ {item.get('score', 0)}[/yellow]"
+    )
+    console.print()
+
+    # Fetch full post + comments
+    cred = optional_auth()
+    handle_command(
+        cred,
+        action=lambda c: c.get_post_comments(post_id=post_id, sort=sort, limit=limit),
+        render=_render_post_detail,
+        as_json=as_json,
+        as_yaml=as_yaml,
+    )