cli-web-hackernews 0.1.0__py3-none-any.whl

cli_web/hackernews/core/models.py

@@ -0,0 +1,144 @@
+"""Data models for Hacker News CLI."""
+
+from __future__ import annotations
+
+import html
+import re
+import time
+from dataclasses import asdict, dataclass, field
+from datetime import datetime, timezone
+
+
+@dataclass
+class Story:
+    """A Hacker News story."""
+
+    id: int
+    title: str
+    url: str | None = None
+    score: int = 0
+    by: str = ""
+    time: int = 0
+    descendants: int = 0
+    type: str = "story"
+
+    @property
+    def age(self) -> str:
+        """Human-readable age like '2h ago'."""
+        if not self.time:
+            return ""
+        delta = int(time.time()) - self.time
+        if delta < 60:
+            return f"{delta}s ago"
+        if delta < 3600:
+            return f"{delta // 60}m ago"
+        if delta < 86400:
+            return f"{delta // 3600}h ago"
+        return f"{delta // 86400}d ago"
+
+    @property
+    def domain(self) -> str:
+        """Extract domain from URL."""
+        if not self.url:
+            return ""
+        match = re.match(r"https?://(?:www\.)?([^/]+)", self.url)
+        return match.group(1) if match else ""
+
+    def to_dict(self) -> dict:
+        d = asdict(self)
+        d["age"] = self.age
+        d["domain"] = self.domain
+        return d
+
+
+@dataclass
+class Comment:
+    """A Hacker News comment."""
+
+    id: int
+    by: str = ""
+    text: str = ""
+    time: int = 0
+    parent: int = 0
+    kids: list[int] = field(default_factory=list)
+    dead: bool = False
+    deleted: bool = False
+    type: str = "comment"
+
+    @property
+    def text_plain(self) -> str:
+        """Strip HTML tags from comment text."""
+        if not self.text:
+            return ""
+        text = re.sub(r"<[^>]+>", "", self.text)
+        return html.unescape(text)
+
+    @property
+    def age(self) -> str:
+        if not self.time:
+            return ""
+        delta = int(time.time()) - self.time
+        if delta < 60:
+            return f"{delta}s ago"
+        if delta < 3600:
+            return f"{delta // 60}m ago"
+        if delta < 86400:
+            return f"{delta // 3600}h ago"
+        return f"{delta // 86400}d ago"
+
+    def to_dict(self) -> dict:
+        d = asdict(self)
+        d["text_plain"] = self.text_plain
+        d["age"] = self.age
+        return d
+
+
+@dataclass
+class User:
+    """A Hacker News user profile."""
+
+    id: str
+    karma: int = 0
+    created: int = 0
+    about: str = ""
+    submitted: list[int] = field(default_factory=list)
+
+    @property
+    def about_plain(self) -> str:
+        if not self.about:
+            return ""
+        text = re.sub(r"<[^>]+>", "", self.about)
+        return html.unescape(text)
+
+    @property
+    def member_since(self) -> str:
+        if not self.created:
+            return ""
+        dt = datetime.fromtimestamp(self.created, tz=timezone.utc)
+        return dt.strftime("%Y-%m-%d")
+
+    def to_dict(self) -> dict:
+        d = asdict(self)
+        d["about_plain"] = self.about_plain
+        d["member_since"] = self.member_since
+        # Trim submitted to first 20 for readability
+        d["submitted"] = self.submitted[:20]
+        d["total_submissions"] = len(self.submitted)
+        return d
+
+
+@dataclass
+class SearchResult:
+    """A search result from HN Algolia API."""
+
+    objectID: str
+    title: str
+    url: str | None = None
+    author: str = ""
+    points: int | None = None
+    num_comments: int | None = None
+    created_at: str = ""
+    story_id: int | None = None
+
+    def to_dict(self) -> dict:
+        return asdict(self)

cli_web/hackernews/hackernews_cli.py

@@ -0,0 +1,171 @@
+"""cli-web-hackernews — CLI entry point for Hacker News."""
+
+from __future__ import annotations
+
+import sys
+
+if sys.stdout.encoding and sys.stdout.encoding.lower() not in ("utf-8", "utf8"):
+    try:
+        sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+    except AttributeError:
+        pass
+if sys.stderr.encoding and sys.stderr.encoding.lower() not in ("utf-8", "utf8"):
+    try:
+        sys.stderr.reconfigure(encoding="utf-8", errors="replace")
+    except AttributeError:
+        pass
+
+import shlex
+
+import click
+from cli_web.hackernews.commands.actions import (
+    comment_cmd,
+    favorite_cmd,
+    hide_cmd,
+    submit_cmd,
+    upvote_cmd,
+)
+from cli_web.hackernews.commands.auth import auth_group
+from cli_web.hackernews.commands.search import search_group
+from cli_web.hackernews.commands.stories import stories_group
+from cli_web.hackernews.commands.user import user_group
+from cli_web.hackernews.core.exceptions import AppError
+from cli_web.hackernews.utils.repl_skin import ReplSkin
+
+_skin = ReplSkin(app="hackernews", version="0.2.0", display_name="Hacker News")
+
+
+# ---------------------------------------------------------------------------- main CLI
+
+
+@click.group(invoke_without_command=True)
+@click.option("--json", "json_mode", is_flag=True, help="Output as JSON (applies to all commands).")
+@click.version_option("0.2.0", prog_name="cli-web-hackernews")
+@click.pass_context
+def cli(ctx, json_mode):
+    """cli-web-hackernews — Browse and interact with Hacker News from the command line.
+
+    Run without arguments to enter interactive REPL mode.
+    """
+    ctx.ensure_object(dict)
+    ctx.obj["json"] = json_mode
+
+    if ctx.invoked_subcommand is None:
+        _run_repl(ctx)
+
+
+cli.add_command(stories_group)
+cli.add_command(search_group)
+cli.add_command(user_group)
+cli.add_command(auth_group)
+cli.add_command(upvote_cmd)
+cli.add_command(submit_cmd)
+cli.add_command(comment_cmd)
+cli.add_command(favorite_cmd)
+cli.add_command(hide_cmd)
+
+
+# ---------------------------------------------------------------------------- REPL
+
+
+def _print_repl_help() -> None:
+    _skin.info("Available commands:")
+    print()
+    print("  stories top [OPTIONS]         Top stories (front page)")
+    print("  stories new [OPTIONS]         Newest stories")
+    print("  stories best [OPTIONS]        Best stories (all time)")
+    print("  stories ask [OPTIONS]         Ask HN stories")
+    print("  stories show [OPTIONS]        Show HN stories")
+    print("  stories jobs [OPTIONS]        Job listings")
+    print("  stories view ID [OPTIONS]     View story + comments")
+    print("    -n, --limit N               Number of items (default 30/10)")
+    print("    --json                      Output as JSON")
+    print()
+    print("  search stories QUERY          Search stories by keyword")
+    print("  search comments QUERY         Search comments by keyword")
+    print("    --sort-date                 Sort by date instead of relevance")
+    print("    -n, --limit N               Number of results (default 20)")
+    print("    --json                      Output as JSON")
+    print()
+    print("  user view USERNAME            View user profile")
+    print("  user favorites [USERNAME]     View favorite stories (auth)")
+    print("  user submissions [USERNAME]   View submitted stories (auth)")
+    print("  user threads [USERNAME]       View replies to comments (auth)")
+    print("    -n, --limit N               Number of items (default 30)")
+    print("    --json                      Output as JSON")
+    print()
+    print("  upvote ID                     Upvote a story or comment (auth)")
+    print("  submit -t TITLE [-u URL]      Submit a new story (auth)")
+    print("  comment PARENT_ID TEXT        Post a comment or reply (auth)")
+    print("  favorite ID                   Favorite/save a story (auth)")
+    print("  hide ID                       Hide a story from feed (auth)")
+    print("    --json                      Output as JSON")
+    print()
+    print("  auth login                    Login with username/password")
+    print("  auth login-browser            Login via browser window")
+    print("  auth status                   Check login status")
+    print("  auth logout                   Remove credentials")
+    print()
+    print("  help                          Show this help")
+    print("  exit / quit / Ctrl-D          Exit REPL")
+    print()
+
+
+def _run_repl(ctx: click.Context) -> None:
+    _skin.print_banner()
+    _print_repl_help()
+
+    pt_session = _skin.create_prompt_session()
+
+    while True:
+        try:
+            line = _skin.get_input(pt_session)
+        except (EOFError, KeyboardInterrupt):
+            _skin.print_goodbye()
+            break
+
+        line = line.strip()
+        if not line:
+            continue
+        if line.lower() in ("exit", "quit", "q"):
+            _skin.print_goodbye()
+            break
+        if line.lower() in ("help", "?", "h"):
+            _print_repl_help()
+            continue
+
+        try:
+            args = shlex.split(line)
+        except ValueError as exc:
+            _skin.error(f"Parse error: {exc}")
+            continue
+
+        # Preserve --json flag from context
+        if ctx.obj.get("json"):
+            args = ["--json"] + args
+
+        try:
+            cli.main(args=args, standalone_mode=False)
+        except SystemExit:
+            pass
+        except AppError as exc:
+            _skin.error(exc.message)
+        except Exception as exc:
+            _skin.error(str(exc))
+
+
+def main():
+    cli()
+
+
+# MCP server mode — exposes every command as an MCP tool over stdio.
+# Canonical adapter: cli-web-core/cli_web_core/mcp_server.py (vendored copy).
+from cli_web.hackernews.utils.doctor import register_doctor_command  # noqa: E402
+from cli_web.hackernews.utils.mcp_server import register_mcp_command  # noqa: E402
+
+register_mcp_command(cli, app_name="hackernews", version="0.1.0")
+register_doctor_command(cli, app_name="hackernews", pkg="hackernews")
+
+
+if __name__ == "__main__":
+    main()

cli_web/hackernews/tests/TEST.md

@@ -0,0 +1,143 @@
+# TEST.md — cli-web-hackernews Test Plan & Results
+
+
+## Part 1: Test Plan
+
+
+### Test Inventory
+
+| File | Tests | Layer |
+|------|-------|-------|
+| test_core.py | 31 | Unit (mocked) |
+| test_e2e.py | 30 | E2E (live) + Subprocess |
+
+**Total: 61 tests**
+
+
+### test_core.py
+
+**TestStoryModel** (4 tests) — Unit (mocked)
+
+- `test_to_dict_includes_computed` — to dict includes computed
+- `test_domain_extraction` — domain extraction
+- `test_domain_empty_when_no_url` — domain empty when no url
+- `test_age_empty_when_no_time` — age empty when no time
+
+**TestCommentModel** (3 tests) — Unit (mocked)
+
+- `test_text_plain_strips_html` — text plain strips html
+- `test_text_plain_unescapes_entities` — text plain unescapes entities
+- `test_text_plain_empty` — text plain empty
+
+**TestUserModel** (2 tests) — Unit (mocked)
+
+- `test_to_dict_trims_submitted` — to dict trims submitted
+- `test_about_plain` — about plain
+
+**TestSearchResultModel** (1 tests) — Unit (mocked)
+
+- `test_to_dict` — to dict
+
+**TestClientHTTPErrors** (5 tests) — Unit (mocked)
+
+- `test_rate_limit_raises` — rate limit raises
+- `test_server_error_raises` — server error raises
+- `test_404_raises_not_found` — 404 raises not found
+- `test_network_error_raises` — network error raises
+- `test_timeout_raises_network_error` — timeout raises network error
+
+**TestClientParsing** (4 tests) — Unit (mocked)
+
+- `test_get_story_builds_model` — get story builds model
+- `test_get_user_builds_model` — get user builds model
+- `test_get_user_not_found` — get user not found
+- `test_search_builds_results` — search builds results
+
+**TestExceptionsToDicts** (6 tests) — Unit (mocked)
+
+- `test_app_error_to_dict` — app error to dict
+- `test_rate_limit_error_to_dict` — rate limit error to dict
+- `test_server_error_to_dict` — server error to dict
+- `test_not_found_to_dict` — not found to dict
+- `test_auth_error_to_dict` — auth error to dict
+- `test_auth_error_recoverable` — auth error recoverable
+
+**TestAuthModule** (6 tests) — Unit (mocked)
+
+- `test_require_auth_raises_without_cookie` — require auth raises without cookie
+- `test_require_auth_returns_cookie` — require auth returns cookie
+- `test_extract_auth_token_from_html` — extract auth token from html
+- `test_extract_auth_token_missing_raises` — extract auth token missing raises
+- `test_parse_stories_from_html_extracts_ids` — parse stories from html extracts ids
+- `test_authenticated_get_html_403_raises_auth_error` — authenticated get html 403 raises auth error
+
+### test_e2e.py
+
+**TestStoriesFeedE2E** (8 tests) — E2E (live)
+
+- `test_top_stories_returns_list` — top stories returns list
+- `test_new_stories_returns_list` — new stories returns list
+- `test_best_stories_returns_list` — best stories returns list
+- `test_ask_stories_returns_list` — ask stories returns list
+- `test_show_stories_returns_list` — show stories returns list
+- `test_job_stories_returns_list` — job stories returns list
+- `test_story_has_required_fields` — story has required fields
+- `test_story_ids_returns_ints` — story ids returns ints
+
+**TestStoryViewE2E** (2 tests) — E2E (live)
+
+- `test_get_story_by_id` — get story by id
+- `test_get_comments_for_story` — get comments for story
+
+**TestUserE2E** (2 tests) — E2E (live)
+
+- `test_get_user_profile` — get user profile
+- `test_get_nonexistent_user_raises` — get nonexistent user raises
+
+**TestSearchE2E** (3 tests) — E2E (live)
+
+- `test_search_stories` — search stories
+- `test_search_by_date` — search by date
+- `test_search_comments` — search comments
+
+**TestSubprocess** (11 tests) — Subprocess
+
+- `test_version` — version
+- `test_help` — help
+- `test_stories_top_json` — stories top json
+- `test_search_stories_json` — search stories json
+- `test_user_view_json` — user view json
+- `test_stories_view_json` — stories view json
+- `test_auth_status_json` — auth status json
+- `test_auth_help` — auth help
+- `test_upvote_help` — upvote help
+- `test_submit_help` — submit help
+- `test_comment_help` — comment help
+
+**TestAuthActionsE2E** (4 tests) — E2E (live)
+
+- `test_upvote_story` — upvote story
+- `test_get_submissions` — get submissions
+- `test_favorite_and_list` — favorite and list
+- `test_auth_validate` — auth validate
+
+---
+
+## Part 2: Test Results
+
+```
+============================= 31 passed in 0.32s ==============================
+(test_core.py — all unit tests pass)
+
+============================= 30 passed in 159.47s ============================
+(test_e2e.py — all E2E + subprocess + auth tests pass)
+```
+
+**Pass Rate: 61/61 (100%)**
+
+### Notes
+- E2E tests hit live Firebase API, Algolia search API, and HN web endpoints
+- Subprocess tests use `_resolve_cli()` with `CLI_WEB_FORCE_INSTALLED=1`
+- Auth E2E tests require valid `auth.json` (fail, not skip, without it)
+- Auth actions (upvote, favorite) scrape CSRF tokens from page HTML
+- Parallel HTTP fetching via asyncio in client