cli-web-reddit 0.1.0__tar.gz

cli_web_reddit-0.1.0/PKG-INFO

@@ -0,0 +1,15 @@
+Metadata-Version: 2.4
+Name: cli-web-reddit
+Version: 0.1.0
+Summary: CLI for Reddit browsing, search, and interaction
+Requires-Python: >=3.10
+Requires-Dist: click>=8.0
+Requires-Dist: curl_cffi
+Requires-Dist: rich>=13.0
+Requires-Dist: prompt_toolkit>=3.0
+Provides-Extra: browser
+Requires-Dist: playwright>=1.40.0; extra == "browser"
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

cli_web_reddit-0.1.0/cli_web/reddit/README.md

@@ -0,0 +1,68 @@
+# cli-web-reddit
+
+CLI for Reddit browsing and search. Browse feeds, subreddits, search posts, view user profiles, and read comments — all from the command line.
+
+## Installation
+
+```bash
+cd reddit/agent-harness
+pip install -e .
+```
+
+## Quick Start
+
+```bash
+# Hot posts on the front page
+cli-web-reddit feed hot --limit 10
+
+# Top posts this week
+cli-web-reddit feed top --time week --json
+
+# Browse a subreddit
+cli-web-reddit sub hot python --limit 10
+
+# Subreddit info
+cli-web-reddit sub info programming --json
+
+# Search posts
+cli-web-reddit search posts "machine learning" --sort top --json
+
+# Search subreddits
+cli-web-reddit search subs "python" --json
+
+# User profile
+cli-web-reddit user info spez --json
+
+# Post detail with comments (auto-expands deeply nested threads)
+cli-web-reddit post get https://www.reddit.com/r/python/comments/abc123/my_post/ --json
+
+# Interactive REPL mode
+cli-web-reddit
+```
+
+## Commands
+
+| Group | Command | Description |
+|-------|---------|-------------|
+| `feed` | `hot`, `new`, `top`, `rising`, `popular` | Global Reddit feeds |
+| `sub` | `hot`, `new`, `top`, `info`, `rules`, `search` | Subreddit operations |
+| `search` | `posts`, `subs` | Search posts and subreddits |
+| `user` | `info`, `posts`, `comments` | User profiles and activity |
+| `post` | `get` | Post detail with comments (auto-expands deep threads) |
+| `vote` | `up`, `down`, `unvote` | Vote on posts/comments (auth required) |
+| `submit` | `text`, `link` | Submit new posts (auth required) |
+| `comment` | `add`, `edit`, `delete` | Comment on posts (auth required) |
+| `saved` | `save`, `unsave` | Save/unsave items (auth required) |
+| `me` | `profile`, `saved`, `upvoted`, `subscriptions`, `inbox` | Authenticated user data (auth required) |
+| `auth` | `login`, `logout`, `status` | OAuth authentication management |
+
+All commands support `--json` for structured output and `--limit N` for pagination.
+
+## Notes
+
+- **Reading is public** — feeds, subreddits, search, and user profiles work without auth
+- **Writing requires auth** — vote, comment, submit, save, and inbox commands need OAuth login (`cli-web-reddit auth login`)
+- **Token auto-refresh** — the `token_v2` session cookie expires every ~15-30 min, but the CLI silently refreshes it using a headless browser with the saved profile. No manual re-login needed.
+- Uses `curl_cffi` with Chrome impersonation (Reddit blocks plain HTTP clients)
+- Pagination via `--after` cursor (shown in output)
+- Time filters: `hour`, `day`, `week`, `month`, `year`, `all`

cli_web_reddit-0.1.0/cli_web/reddit/__init__.py

@@ -0,0 +1,3 @@
+"""cli-web-reddit — CLI for Reddit browsing and search."""
+
+__version__ = "0.1.0"

cli_web_reddit-0.1.0/cli_web/reddit/__main__.py

@@ -0,0 +1,6 @@
+"""Allow running as: python -m cli_web.reddit"""
+
+from .reddit_cli import main
+
+if __name__ == "__main__":
+    main()

cli_web_reddit-0.1.0/cli_web/reddit/commands/actions.py

@@ -0,0 +1,268 @@
+"""Action commands for cli-web-reddit — vote, save, hide, comment, submit, edit, delete."""
+
+from __future__ import annotations
+
+import click
+
+from ..core.client import RedditClient
+from ..core.exceptions import SubmitError
+from ..utils.helpers import handle_errors, print_json, resolve_json_mode
+
+# ── Vote ──────────────────────────────────────────────────────
+
+
+@click.group("vote")
+def vote():
+    """Vote on posts and comments (requires login)."""
+
+
+@vote.command("up")
+@click.argument("thing_id")
+@click.option("--json", "use_json", is_flag=True, help="Output as JSON.")
+def up(thing_id, use_json):
+    """Upvote a post or comment. Pass the fullname (t3_xxx or t1_xxx)."""
+    use_json = resolve_json_mode(use_json)
+    with handle_errors(json_mode=use_json):
+        client = RedditClient()
+        client.vote(thing_id, 1)
+        if use_json:
+            print_json({"success": True, "action": "upvote", "id": thing_id})
+        else:
+            click.echo(f"  Upvoted {thing_id}")
+
+
+@vote.command("down")
+@click.argument("thing_id")
+@click.option("--json", "use_json", is_flag=True, help="Output as JSON.")
+def down(thing_id, use_json):
+    """Downvote a post or comment."""
+    use_json = resolve_json_mode(use_json)
+    with handle_errors(json_mode=use_json):
+        client = RedditClient()
+        client.vote(thing_id, -1)
+        if use_json:
+            print_json({"success": True, "action": "downvote", "id": thing_id})
+        else:
+            click.echo(f"  Downvoted {thing_id}")
+
+
+@vote.command("unvote")
+@click.argument("thing_id")
+@click.option("--json", "use_json", is_flag=True, help="Output as JSON.")
+def unvote(thing_id, use_json):
+    """Remove vote from a post or comment."""
+    use_json = resolve_json_mode(use_json)
+    with handle_errors(json_mode=use_json):
+        client = RedditClient()
+        client.vote(thing_id, 0)
+        if use_json:
+            print_json({"success": True, "action": "unvote", "id": thing_id})
+        else:
+            click.echo(f"  Removed vote on {thing_id}")
+
+
+# ── Submit ────────────────────────────────────────────────────
+
+
+@click.group("submit")
+def submit():
+    """Submit posts to subreddits (requires login)."""
+
+
+@submit.command("flairs")
+@click.argument("subreddit")
+@click.option("--json", "use_json", is_flag=True, help="Output as JSON.")
+def submit_flairs(subreddit, use_json):
+    """List available post flairs for a subreddit.
+
+    Example: submit flairs ClaudeCode
+    """
+    use_json = resolve_json_mode(use_json)
+    with handle_errors(json_mode=use_json):
+        client = RedditClient()
+        flairs = client.get_subreddit_flairs(subreddit)
+        if use_json:
+            print_json({"success": True, "subreddit": subreddit, "flairs": flairs})
+        else:
+            if not flairs:
+                click.echo(f"  No flairs available for r/{subreddit}")
+            else:
+                click.echo(f"  Flairs for r/{subreddit}:")
+                for f in flairs:
+                    click.echo(f"    {f['id']}  {f['text']}")
+
+
+@submit.command("text")
+@click.argument("subreddit")
+@click.argument("title")
+@click.argument("body")
+@click.option(
+    "--flair", "flair_id", default=None, help="Flair ID (use 'submit flairs <sub>' to list)."
+)
+@click.option("--json", "use_json", is_flag=True, help="Output as JSON.")
+def submit_text(subreddit, title, body, flair_id, use_json):
+    """Submit a text (self) post.
+
+    Example: submit text python "My Title" "Post body here"
+    Example with flair: submit text ClaudeCode "Title" "Body" --flair abc123
+    """
+    use_json = resolve_json_mode(use_json)
+    # Decode escape sequences so \n from CLI becomes actual newlines
+    body = body.encode("utf-8").decode("unicode_escape") if "\\n" in body else body
+    with handle_errors(json_mode=use_json):
+        client = RedditClient()
+        result = client.submit_text(subreddit, title, body, flair_id=flair_id)
+        data = result.get("json", {}).get("data", {})
+        errors = result.get("json", {}).get("errors", [])
+        if errors:
+            msg = "; ".join(str(e) for e in errors)
+            raise SubmitError(f"Submit failed: {msg}")
+        if use_json:
+            print_json(
+                {
+                    "success": True,
+                    "id": data.get("name", ""),
+                    "url": data.get("url", ""),
+                }
+            )
+        else:
+            click.echo(f"  Posted to r/{subreddit}: {data.get('url', '')}")
+
+
+@submit.command("link")
+@click.argument("subreddit")
+@click.argument("title")
+@click.argument("url")
+@click.option(
+    "--flair", "flair_id", default=None, help="Flair ID (use 'submit flairs <sub>' to list)."
+)
+@click.option("--json", "use_json", is_flag=True, help="Output as JSON.")
+def submit_link(subreddit, title, url, flair_id, use_json):
+    """Submit a link post.
+
+    Example: submit link python "Check this out" "https://example.com"
+    Example with flair: submit link ClaudeCode "Title" "https://..." --flair abc123
+    """
+    use_json = resolve_json_mode(use_json)
+    with handle_errors(json_mode=use_json):
+        client = RedditClient()
+        result = client.submit_link(subreddit, title, url, flair_id=flair_id)
+        data = result.get("json", {}).get("data", {})
+        errors = result.get("json", {}).get("errors", [])
+        if errors:
+            msg = "; ".join(str(e) for e in errors)
+            raise SubmitError(f"Submit failed: {msg}")
+        if use_json:
+            print_json(
+                {
+                    "success": True,
+                    "id": data.get("name", ""),
+                    "url": data.get("url", ""),
+                }
+            )
+        else:
+            click.echo(f"  Posted to r/{subreddit}: {data.get('url', '')}")
+
+
+# ── Comment ───────────────────────────────────────────────────
+
+
+@click.group("comment")
+def comment_group():
+    """Comment on posts and reply to comments (requires login)."""
+
+
+@comment_group.command("add")
+@click.argument("thing_id")
+@click.argument("text")
+@click.option("--json", "use_json", is_flag=True, help="Output as JSON.")
+def add_comment(thing_id, text, use_json):
+    """Add a comment to a post or reply to a comment.
+
+    thing_id: fullname of the post (t3_xxx) or comment (t1_xxx) to reply to.
+    """
+    use_json = resolve_json_mode(use_json)
+    # Decode escape sequences so \n from CLI becomes actual newlines
+    text = text.encode("utf-8").decode("unicode_escape") if "\\n" in text else text
+    with handle_errors(json_mode=use_json):
+        client = RedditClient()
+        result = client.comment(thing_id, text)
+        things = result.get("json", {}).get("data", {}).get("things", [])
+        comment_id = things[0].get("data", {}).get("name", "") if things else ""
+        errors = result.get("json", {}).get("errors", [])
+        if errors:
+            msg = "; ".join(str(e) for e in errors)
+            raise SubmitError(f"Comment failed: {msg}")
+        if use_json:
+            print_json({"success": True, "comment_id": comment_id})
+        else:
+            click.echo(f"  Comment posted: {comment_id}")
+
+
+@comment_group.command("edit")
+@click.argument("thing_id")
+@click.argument("text")
+@click.option("--json", "use_json", is_flag=True, help="Output as JSON.")
+def edit_comment(thing_id, text, use_json):
+    """Edit your own post or comment text."""
+    use_json = resolve_json_mode(use_json)
+    with handle_errors(json_mode=use_json):
+        client = RedditClient()
+        client.edit(thing_id, text)
+        if use_json:
+            print_json({"success": True, "action": "edit", "id": thing_id})
+        else:
+            click.echo(f"  Edited {thing_id}")
+
+
+@comment_group.command("delete")
+@click.argument("thing_id")
+@click.option("--json", "use_json", is_flag=True, help="Output as JSON.")
+def delete_thing(thing_id, use_json):
+    """Delete your own post or comment."""
+    use_json = resolve_json_mode(use_json)
+    with handle_errors(json_mode=use_json):
+        client = RedditClient()
+        client.delete(thing_id)
+        if use_json:
+            print_json({"success": True, "action": "delete", "id": thing_id})
+        else:
+            click.echo(f"  Deleted {thing_id}")
+
+
+# ── Save ──────────────────────────────────────────────────────
+
+
+@click.group("saved")
+def saved_group():
+    """Save and unsave posts (requires login)."""
+
+
+@saved_group.command("save")
+@click.argument("thing_id")
+@click.option("--json", "use_json", is_flag=True, help="Output as JSON.")
+def save_thing(thing_id, use_json):
+    """Save a post or comment."""
+    use_json = resolve_json_mode(use_json)
+    with handle_errors(json_mode=use_json):
+        client = RedditClient()
+        client.save(thing_id)
+        if use_json:
+            print_json({"success": True, "action": "save", "id": thing_id})
+        else:
+            click.echo(f"  Saved {thing_id}")
+
+
+@saved_group.command("unsave")
+@click.argument("thing_id")
+@click.option("--json", "use_json", is_flag=True, help="Output as JSON.")
+def unsave_thing(thing_id, use_json):
+    """Unsave a post or comment."""
+    use_json = resolve_json_mode(use_json)
+    with handle_errors(json_mode=use_json):
+        client = RedditClient()
+        client.unsave(thing_id)
+        if use_json:
+            print_json({"success": True, "action": "unsave", "id": thing_id})
+        else:
+            click.echo(f"  Unsaved {thing_id}")

cli_web_reddit-0.1.0/cli_web/reddit/commands/auth_cmd.py

@@ -0,0 +1,73 @@
+"""Auth commands for cli-web-reddit."""
+
+from __future__ import annotations
+
+import click
+
+from ..core.auth import clear_auth, load_auth, login_browser
+from ..core.client import RedditClient
+from ..utils.helpers import handle_errors, print_json, resolve_json_mode
+
+
+@click.group("auth")
+def auth():
+    """Login, logout, and check authentication status."""
+
+
+@auth.command("login")
+@click.option("--json", "use_json", is_flag=True, help="Output as JSON.")
+def login(use_json):
+    """Login to Reddit via browser (opens Playwright)."""
+    use_json = resolve_json_mode(use_json)
+    with handle_errors(json_mode=use_json):
+        login_browser()
+        if use_json:
+            print_json({"success": True, "message": "Logged in successfully"})
+        else:
+            click.echo("  Logged in successfully. Token saved.")
+
+
+@auth.command("logout")
+@click.option("--json", "use_json", is_flag=True, help="Output as JSON.")
+def logout(use_json):
+    """Remove saved authentication."""
+    use_json = resolve_json_mode(use_json)
+    with handle_errors(json_mode=use_json):
+        clear_auth()
+        if use_json:
+            print_json({"success": True, "message": "Logged out"})
+        else:
+            click.echo("  Logged out. Auth data removed.")
+
+
+@auth.command("status")
+@click.option("--json", "use_json", is_flag=True, help="Output as JSON.")
+def status(use_json):
+    """Check current authentication status."""
+    use_json = resolve_json_mode(use_json)
+    with handle_errors(json_mode=use_json):
+        auth_data = load_auth()
+        if not auth_data or not auth_data.get("token"):
+            if use_json:
+                print_json({"authenticated": False, "message": "Not logged in"})
+            else:
+                click.echo("  Not logged in. Run: cli-web-reddit auth login")
+            return
+
+        # Verify token works by calling /api/v1/me
+        client = RedditClient()
+        me = client.me()
+        username = me.get("name", "unknown")
+        karma = me.get("total_karma", 0)
+
+        if use_json:
+            print_json(
+                {
+                    "authenticated": True,
+                    "username": username,
+                    "total_karma": karma,
+                }
+            )
+        else:
+            click.echo(f"  Logged in as: u/{username}")
+            click.echo(f"  Total karma: {karma:,}")

cli_web_reddit-0.1.0/cli_web/reddit/commands/feed.py

@@ -0,0 +1,115 @@
+"""Feed commands for cli-web-reddit — global feeds (hot, new, top, rising, popular)."""
+
+from __future__ import annotations
+
+import click
+
+from ..core.client import RedditClient
+from ..core.models import extract_listing_posts
+from ..utils.helpers import handle_errors, print_json, resolve_json_mode
+from ..utils.output import post_table
+
+TIME_CHOICES = ["hour", "day", "week", "month", "year", "all"]
+
+
+@click.group("feed")
+def feed():
+    """Browse global Reddit feeds."""
+
+
+@feed.command("hot")
+@click.option("--limit", type=int, default=25, help="Number of posts (max 100).")
+@click.option("--after", default=None, help="Pagination cursor.")
+@click.option("--json", "use_json", is_flag=True, help="Output as JSON.")
+def hot(limit, after, use_json):
+    """Hot posts from the front page."""
+    use_json = resolve_json_mode(use_json)
+    with handle_errors(json_mode=use_json):
+        client = RedditClient()
+        data = client.feed_hot(limit=limit, after=after)
+        posts, next_after = extract_listing_posts(data)
+        if use_json:
+            print_json({"posts": posts, "after": next_after})
+        else:
+            post_table(posts, title="Hot Posts")
+            if next_after:
+                click.echo(f"  Next page: feed hot --after {next_after}")
+
+
+@feed.command("new")
+@click.option("--limit", type=int, default=25, help="Number of posts (max 100).")
+@click.option("--after", default=None, help="Pagination cursor.")
+@click.option("--json", "use_json", is_flag=True, help="Output as JSON.")
+def new(limit, after, use_json):
+    """Newest posts from the front page."""
+    use_json = resolve_json_mode(use_json)
+    with handle_errors(json_mode=use_json):
+        client = RedditClient()
+        data = client.feed_new(limit=limit, after=after)
+        posts, next_after = extract_listing_posts(data)
+        if use_json:
+            print_json({"posts": posts, "after": next_after})
+        else:
+            post_table(posts, title="New Posts")
+            if next_after:
+                click.echo(f"  Next page: feed new --after {next_after}")
+
+
+@feed.command("top")
+@click.option(
+    "--time", "time_filter", type=click.Choice(TIME_CHOICES), default="day", help="Time period."
+)
+@click.option("--limit", type=int, default=25, help="Number of posts (max 100).")
+@click.option("--after", default=None, help="Pagination cursor.")
+@click.option("--json", "use_json", is_flag=True, help="Output as JSON.")
+def top(time_filter, limit, after, use_json):
+    """Top posts by time period."""
+    use_json = resolve_json_mode(use_json)
+    with handle_errors(json_mode=use_json):
+        client = RedditClient()
+        data = client.feed_top(limit=limit, after=after, time=time_filter)
+        posts, next_after = extract_listing_posts(data)
+        if use_json:
+            print_json({"posts": posts, "after": next_after})
+        else:
+            post_table(posts, title=f"Top Posts ({time_filter})")
+            if next_after:
+                click.echo(f"  Next page: feed top --time {time_filter} --after {next_after}")
+
+
+@feed.command("rising")
+@click.option("--limit", type=int, default=25, help="Number of posts (max 100).")
+@click.option("--after", default=None, help="Pagination cursor.")
+@click.option("--json", "use_json", is_flag=True, help="Output as JSON.")
+def rising(limit, after, use_json):
+    """Rising posts."""
+    use_json = resolve_json_mode(use_json)
+    with handle_errors(json_mode=use_json):
+        client = RedditClient()
+        data = client.feed_rising(limit=limit, after=after)
+        posts, next_after = extract_listing_posts(data)
+        if use_json:
+            print_json({"posts": posts, "after": next_after})
+        else:
+            post_table(posts, title="Rising Posts")
+            if next_after:
+                click.echo(f"  Next page: feed rising --after {next_after}")
+
+
+@feed.command("popular")
+@click.option("--limit", type=int, default=25, help="Number of posts (max 100).")
+@click.option("--after", default=None, help="Pagination cursor.")
+@click.option("--json", "use_json", is_flag=True, help="Output as JSON.")
+def popular(limit, after, use_json):
+    """Popular posts from r/popular."""
+    use_json = resolve_json_mode(use_json)
+    with handle_errors(json_mode=use_json):
+        client = RedditClient()
+        data = client.feed_popular(limit=limit, after=after)
+        posts, next_after = extract_listing_posts(data)
+        if use_json:
+            print_json({"posts": posts, "after": next_after})
+        else:
+            post_table(posts, title="Popular Posts")
+            if next_after:
+                click.echo(f"  Next page: feed popular --after {next_after}")