rdt-cli 0.3.2__tar.gz → 0.4.0__tar.gz

{rdt_cli-0.3.2 → rdt_cli-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rdt-cli
-Version: 0.3.2
+Version: 0.4.0
 Summary: A CLI for Reddit — browse feeds, read posts, search, and interact via terminal 📖
 Project-URL: Homepage, https://github.com/jackwener/rdt-cli
 Project-URL: Repository, https://github.com/jackwener/rdt-cli
@@ -42,7 +42,7 @@ A CLI for Reddit — browse feeds, read posts, search, and interact via reverse-
 ## Features
 
 - 🔐 **Auth** — auto-extract browser cookies, status check, whoami
-- 🏠 **Feed** — browse home feed, popular, and /r/all
+- 🏠 **Feed** — browse home feed, popular, /r/all, and subscription-only feed (`--subs-only`)
 - 📋 **Subreddits** — browse any subreddit with sort/time filters, view subreddit info
 - 📰 **Posts** — read posts and comment trees with syntax highlighting
 - 💬 **Expanded comments** — `--expand-more` loads additional `more comments` entries
@@ -95,6 +95,8 @@ rdt logout                            # Clear saved cookies
 
 # ─── Browse ───────────────────────────────────────
 rdt feed                              # Home feed (requires login)
+rdt feed --subs-only                  # Subscriptions-only feed (no algorithm)
+rdt feed --subs-only -n 5 --max-subs 10  # Limit per-sub posts and max subs
 rdt popular                           # Popular posts
 rdt popular --full-text               # Show full titles
 rdt all                               # /r/all
@@ -294,7 +296,7 @@ The built-in Gaussian jitter delay (~1s between requests) is intentional to mimi
 ## 功能特性
 
 - 🔐 **认证** — 自动提取浏览器 Cookie，状态检查，用户信息
-- 🏠 **浏览** — 首页 Feed、Popular、/r/all
+- 🏠 **浏览** — 首页 Feed、Popular、/r/all、纯订阅 Feed（`--subs-only`）
 - 📋 **子版块** — 浏览任意 subreddit（排序/时间过滤），查看子版块信息
 - 📰 **帖子** — 阅读帖子和评论树
 - 💬 **评论展开** — `--expand-more` 可展开额外评论
@@ -343,6 +345,8 @@ rdt logout                            # 清除缓存的 Cookie
 
 # 浏览
 rdt feed                              # 首页 Feed（需要登录）
+rdt feed --subs-only                  # 纯订阅 Feed（无算法推荐）
+rdt feed --subs-only -n 5 --max-subs 10  # 限制每个 sub 帖子数和最大 sub 数
 rdt popular                           # 热门帖子
 rdt all                               # /r/all
 rdt sub python                        # 浏览子版块

{rdt_cli-0.3.2 → rdt_cli-0.4.0}/README.md

@@ -19,7 +19,7 @@ A CLI for Reddit — browse feeds, read posts, search, and interact via reverse-
 ## Features
 
 - 🔐 **Auth** — auto-extract browser cookies, status check, whoami
-- 🏠 **Feed** — browse home feed, popular, and /r/all
+- 🏠 **Feed** — browse home feed, popular, /r/all, and subscription-only feed (`--subs-only`)
 - 📋 **Subreddits** — browse any subreddit with sort/time filters, view subreddit info
 - 📰 **Posts** — read posts and comment trees with syntax highlighting
 - 💬 **Expanded comments** — `--expand-more` loads additional `more comments` entries
@@ -72,6 +72,8 @@ rdt logout                            # Clear saved cookies
 
 # ─── Browse ───────────────────────────────────────
 rdt feed                              # Home feed (requires login)
+rdt feed --subs-only                  # Subscriptions-only feed (no algorithm)
+rdt feed --subs-only -n 5 --max-subs 10  # Limit per-sub posts and max subs
 rdt popular                           # Popular posts
 rdt popular --full-text               # Show full titles
 rdt all                               # /r/all
@@ -271,7 +273,7 @@ The built-in Gaussian jitter delay (~1s between requests) is intentional to mimi
 ## 功能特性
 
 - 🔐 **认证** — 自动提取浏览器 Cookie，状态检查，用户信息
-- 🏠 **浏览** — 首页 Feed、Popular、/r/all
+- 🏠 **浏览** — 首页 Feed、Popular、/r/all、纯订阅 Feed（`--subs-only`）
 - 📋 **子版块** — 浏览任意 subreddit（排序/时间过滤），查看子版块信息
 - 📰 **帖子** — 阅读帖子和评论树
 - 💬 **评论展开** — `--expand-more` 可展开额外评论
@@ -320,6 +322,8 @@ rdt logout                            # 清除缓存的 Cookie
 
 # 浏览
 rdt feed                              # 首页 Feed（需要登录）
+rdt feed --subs-only                  # 纯订阅 Feed（无算法推荐）
+rdt feed --subs-only -n 5 --max-subs 10  # 限制每个 sub 帖子数和最大 sub 数
 rdt popular                           # 热门帖子
 rdt all                               # /r/all
 rdt sub python                        # 浏览子版块

{rdt_cli-0.3.2 → rdt_cli-0.4.0}/SKILL.md

@@ -2,7 +2,7 @@
 name: rdt-cli
 description: Use rdt-cli for ALL Reddit operations — browsing feeds, reading posts, searching, viewing users, upvoting, saving, and subscribing. Invoke whenever the user requests any Reddit interaction.
 author: jackwener
-version: "0.2.0"
+version: "0.4.0"
 tags:
   - reddit
   - rdt
@@ -82,6 +82,7 @@ Payloads live under `.data`.
 | Command | Description | Example |
 |---------|-------------|---------|
 | `rdt feed` | Browse home feed (requires login) | `rdt feed -n 10 --json` |
+| `rdt feed --subs-only` | Subscriptions-only feed (no algorithm, sorted by time) | `rdt feed --subs-only -n 5 --json` |
 | `rdt popular` | Browse /r/popular | `rdt popular -n 5 --json` |
 | `rdt all` | Browse /r/all | `rdt all -n 10 --compact --json` |
 | `rdt sub <name>` | Browse a subreddit | `rdt sub python -s top -t week` |
@@ -146,6 +147,13 @@ All listing commands (feed, popular, all, sub, user-posts, user-comments, saved,
 | `--full-text` | Show full title without truncation |
 | `-c, --compact` | Agent-friendly compact output (fewer fields) |
 
+### Feed-specific Options
+
+| Flag | Description |
+|------|-------------|
+| `--subs-only` | Show only posts from subscribed subreddits (sorted by time, no algorithm) |
+| `--max-subs N` | Max subscriptions to fetch (default: 20) |
+
 ## Agent Workflow Examples
 
 ### Browse → Read → Upvote pipeline
@@ -185,6 +193,13 @@ rdt saved -n 20 --compact --json
 rdt upvoted -n 20 --compact --json
 ```
 
+### Subscriptions-only monitoring
+
+```bash
+rdt feed --subs-only -n 5 --compact --json
+rdt feed --subs-only --max-subs 10 -o subs_feed.json
+```
+
 ### Subreddit discovery
 
 ```bash

{rdt_cli-0.3.2 → rdt_cli-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "rdt-cli"
-version = "0.3.2"
+version = "0.4.0"
 description = "A CLI for Reddit — browse feeds, read posts, search, and interact via terminal 📖"
 readme = "README.md"
 requires-python = ">=3.10"

rdt_cli-0.4.0/rdt_cli/__init__.py

@@ -0,0 +1,3 @@
+"""Reddit CLI."""
+
+__version__ = "0.4.0"

{rdt_cli-0.3.2 → rdt_cli-0.4.0}/rdt_cli/client.py

@@ -20,6 +20,7 @@ from .constants import (
     SUBREDDIT_ABOUT_URL,
     SUBREDDIT_SEARCH_URL,
     SUBSCRIBE_URL,
+    SUBSCRIPTIONS_URL,
     UNSAVE_URL,
     USER_ABOUT_URL,
     USER_COMMENTS_URL,
@@ -349,3 +350,70 @@ class RedditClient:
     def post_comment(self, parent_fullname: str, text: str) -> dict:
         """Post a comment."""
         return self._post(COMMENT_URL, data={"parent": parent_fullname, "text": text})
+
+    # ── Subscription feed ───────────────────────────────────────────
+
+    def get_my_subscriptions(
+        self, limit: int = 100, max_subs: int = 20,
+    ) -> list[str]:
+        """Get names of subscribed subreddits (up to max_subs)."""
+        names: list[str] = []
+        after: str | None = None
+        while len(names) < max_subs:
+            params: dict[str, Any] = {"limit": min(limit, 100), "raw_json": 1}
+            if after:
+                params["after"] = after
+            data = self._get(SUBSCRIPTIONS_URL, params=params)
+            children = data.get("data", {}).get("children", [])
+            if not children:
+                break
+            for child in children:
+                name = child.get("data", {}).get("display_name", "")
+                if name:
+                    names.append(name)
+                if len(names) >= max_subs:
+                    break
+            after = data.get("data", {}).get("after")
+            if not after:
+                break
+        return names
+
+    def get_subs_only_feed(
+        self,
+        limit_per_sub: int = DEFAULT_LIMIT,
+        max_subs: int = 20,
+        on_progress: Any = None,
+    ) -> dict:
+        """Aggregate newest posts from subscribed subreddits.
+
+        Returns a synthetic listing dict compatible with parse_listing().
+        """
+        subs = self.get_my_subscriptions(max_subs=max_subs)
+        if not subs:
+            return {"data": {"children": [], "after": None}}
+
+        all_posts: list[dict] = []
+        seen_ids: set[str] = set()
+
+        for i, sub_name in enumerate(subs):
+            if on_progress:
+                on_progress(i + 1, len(subs), sub_name)
+            try:
+                data = self.get_subreddit(sub_name, sort="new", limit=limit_per_sub)
+                children = data.get("data", {}).get("children", [])
+                for child in children:
+                    post = child.get("data", child)
+                    pid = post.get("id", "")
+                    if pid and pid not in seen_ids:
+                        seen_ids.add(pid)
+                        all_posts.append(child if "data" in child else {"data": child})
+            except RedditApiError as exc:
+                logger.warning("Skipping r/%s: %s", sub_name, exc)
+
+        # Sort by created_utc descending
+        all_posts.sort(
+            key=lambda c: c.get("data", {}).get("created_utc", 0),
+            reverse=True,
+        )
+
+        return {"data": {"children": all_posts, "after": None}}

{rdt_cli-0.3.2 → rdt_cli-0.4.0}/rdt_cli/commands/browse.py

@@ -159,24 +159,46 @@ def _resolve_current_username(client: RedditClient) -> str:
 
 
 @click.command()
+@click.option("--subs-only", is_flag=True, help="Show only posts from subscribed subreddits (sorted by time)")
+@click.option("--max-subs", default=20, type=int, help="Max subscriptions to fetch (default: 20)")
 @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(
+    subs_only: bool, max_subs: int,
     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,
-    )
+    if subs_only:
+        if after:
+            console.print("[yellow]⚠ --after is ignored with --subs-only[/yellow]")
+
+        def _progress(current: int, total: int, name: str) -> None:
+            if not (as_json or as_yaml):
+                console.print(f"  [dim]📡 [{current}/{total}] r/{name}[/dim]")
+
+        _handle_listing(
+            cred,
+            action=lambda c: c.get_subs_only_feed(
+                limit_per_sub=limit, max_subs=max_subs, on_progress=_progress,
+            ),
+            data_title="📡 Subscriptions Feed",
+            next_cmd="",
+            as_json=as_json, as_yaml=as_yaml,
+            output_file=output_file, full_text=full_text, compact=compact,
+        )
+    else:
+        _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 ─────────────────────────────────────────────────────────

{rdt_cli-0.3.2 → rdt_cli-0.4.0}/rdt_cli/constants.py

@@ -49,6 +49,7 @@ SAVE_URL = "/api/save"
 UNSAVE_URL = "/api/unsave"
 SUBSCRIBE_URL = "/api/subscribe"
 COMMENT_URL = "/api/comment"
+SUBSCRIPTIONS_URL = "/subreddits/mine/subscriber.json"
 
 # ── Request Headers (Chrome 133, macOS) ─────────────────────────────
 HEADERS = {

{rdt_cli-0.3.2 → rdt_cli-0.4.0}/tests/test_cli.py

@@ -672,7 +672,7 @@ class TestMockedBrowse:
         from rdt_cli.auth import Credential
 
         cred = Credential(cookies={"reddit_session": "test"}, username="spez")
-        with patch("rdt_cli.auth.get_credential", return_value=cred):
+        with patch("rdt_cli.commands._common.get_credential", return_value=cred):
             with patch("rdt_cli.client.RedditClient.get_me", return_value={"name": "spez"}):
                 with patch("rdt_cli.client.RedditClient.get_user_saved", return_value=self._mock_listing()):
                     result = runner.invoke(cli, ["saved", "--json"])
@@ -682,13 +682,70 @@ class TestMockedBrowse:
         from rdt_cli.auth import Credential
 
         cred = Credential(cookies={"reddit_session": "test"}, username="spez")
-        with patch("rdt_cli.auth.get_credential", return_value=cred):
+        with patch("rdt_cli.commands._common.get_credential", return_value=cred):
             with patch("rdt_cli.client.RedditClient.get_me", return_value={"name": "spez"}):
                 with patch("rdt_cli.client.RedditClient.get_user_upvoted", return_value=self._mock_listing()):
                     result = runner.invoke(cli, ["upvoted", "--json"])
                     assert result.exit_code == 0
 
 
+# ── Mocked subs-only feed ──────────────────────────────────────────
+
+
+class TestSubsOnlyFeed:
+    """Test --subs-only flag on feed command."""
+
+    def _mock_subs_listing(self, names):
+        """Build a mock /subreddits/mine/subscriber response."""
+        return {
+            "data": {
+                "children": [{"data": {"display_name": n}} for n in names],
+                "after": None,
+            }
+        }
+
+    def _mock_sub_posts(self, subreddit, created_utc=1700000000):
+        return {
+            "data": {
+                "children": [
+                    {"data": {"id": f"{subreddit}_1", "title": f"Post from {subreddit}",
+                              "subreddit": subreddit, "author": "bob", "score": 10,
+                              "num_comments": 1, "created_utc": created_utc}},
+                ],
+                "after": None,
+            }
+        }
+
+    def test_feed_subs_only_json(self):
+        from rdt_cli.auth import Credential
+        cred = Credential(cookies={"reddit_session": "test"})
+        with patch("rdt_cli.commands._common.get_credential", return_value=cred):
+            with patch("rdt_cli.client.RedditClient.get_my_subscriptions", return_value=["python", "rust"]):
+                with patch("rdt_cli.client.RedditClient.get_subreddit") as mock_sub:
+                    mock_sub.side_effect = [
+                        self._mock_sub_posts("python", created_utc=1700000200),
+                        self._mock_sub_posts("rust", created_utc=1700000100),
+                    ]
+                    result = runner.invoke(cli, ["feed", "--subs-only", "--json"])
+                    assert result.exit_code == 0
+                    data = json.loads(result.output)
+                    assert data["ok"] is True
+
+    def test_feed_subs_only_empty_subscriptions(self):
+        from rdt_cli.auth import Credential
+        cred = Credential(cookies={"reddit_session": "test"})
+        with patch("rdt_cli.commands._common.get_credential", return_value=cred):
+            with patch("rdt_cli.client.RedditClient.get_my_subscriptions", return_value=[]):
+                result = runner.invoke(cli, ["feed", "--subs-only", "--json"])
+                assert result.exit_code == 0
+
+    def test_feed_help_shows_subs_only(self):
+        result = runner.invoke(cli, ["feed", "--help"])
+        assert result.exit_code == 0
+        assert "--subs-only" in result.output
+        assert "--max-subs" in result.output
+
+
 # ── Mocked search commands ──────────────────────────────────────────
 
 

{rdt_cli-0.3.2 → rdt_cli-0.4.0}/tests/test_smoke.py

@@ -554,6 +554,20 @@ class TestAuthenticatedViews:
         if data:
             assert data["ok"] is True
 
+    def test_feed_subs_only(self):
+        if not _authenticated():
+            pytest.skip("Authentication required for --subs-only")
+        result = _invoke("feed", "--subs-only", "-n", "3", "--max-subs", "3")
+        assert result.exit_code == 0
+
+    def test_feed_subs_only_json(self):
+        if not _authenticated():
+            pytest.skip("Authentication required for --subs-only")
+        result, data = _invoke_json("feed", "--subs-only", "-n", "3", "--max-subs", "3")
+        assert result.exit_code == 0
+        if data:
+            assert data["ok"] is True
+
 
 # ── Pagination ─────────────────────────────────────────────────────
 

{rdt_cli-0.3.2 → rdt_cli-0.4.0}/uv.lock

@@ -382,7 +382,7 @@ wheels = [
 
 [[package]]
 name = "rdt-cli"
-version = "0.3.2"
+version = "0.4.0"
 source = { editable = "." }
 dependencies = [
     { name = "browser-cookie3" },

rdt_cli-0.3.2/rdt_cli/__init__.py

@@ -1,3 +0,0 @@
-"""Reddit CLI."""
-
-__version__ = "0.3.2"