openrssgate 0.1.0__py3-none-any.whl

openrssgate/__init__.py

@@ -0,0 +1,3 @@
+__all__ = ["__version__"]
+
+__version__ = "0.1.0"

openrssgate/client.py

@@ -0,0 +1,49 @@
+from __future__ import annotations
+
+import json
+from typing import Any
+
+import httpx
+
+from openrssgate.config import get_api_base_url
+
+
+class ApiError(RuntimeError):
+    pass
+
+
+class OpenRSSGateClient:
+    def __init__(self, base_url: str | None = None) -> None:
+        self.base_url = (base_url or get_api_base_url()).rstrip("/")
+
+    def _request(self, path: str, *, method: str = "GET", params: dict[str, Any] | None = None, json_body: Any = None) -> Any:
+        try:
+            response = httpx.request(method, f"{self.base_url}{path}", params=params, json=json_body, timeout=10.0)
+            response.raise_for_status()
+        except httpx.HTTPStatusError as exc:
+            payload = exc.response.json() if exc.response.headers.get("content-type", "").startswith("application/json") else {}
+            message = payload.get("error", {}).get("message", exc.response.text)
+            raise ApiError(message) from exc
+        except httpx.HTTPError as exc:
+            raise ApiError(str(exc)) from exc
+        return response.json()
+
+    def list_sources(self, **params: Any) -> dict[str, Any]:
+        return self._request("/sources", params=params)
+
+    def list_feeds(self, **params: Any) -> dict[str, Any]:
+        return self._request("/feeds", params=params)
+
+    def get_feed(self, feed_id: str) -> dict[str, Any]:
+        return self._request(f"/feeds/{feed_id}")
+
+    def get_stats(self) -> dict[str, Any]:
+        return self._request("/stats")
+
+    def validate_source(self, rss_url: str, **params: Any) -> dict[str, Any]:
+        payload = {"rss_url": rss_url, **params}
+        return self._request("/sources/validate", method="POST", json_body=payload)
+
+
+def format_json(payload: Any) -> str:
+    return json.dumps(payload, ensure_ascii=False, indent=2)

openrssgate/commands/__init__.py

@@ -0,0 +1 @@
+

openrssgate/commands/feeds.py

@@ -0,0 +1,70 @@
+from __future__ import annotations
+
+import typer
+
+from openrssgate.client import OpenRSSGateClient, format_json
+
+
+def register(app: typer.Typer) -> None:
+    @app.command("feeds")
+    def feeds(
+        source_id: str | None = typer.Argument(default=None),
+        query: str | None = typer.Option(None, "--q"),
+        lang: str | None = typer.Option(None, "--lang"),
+        source_type: str | None = typer.Option(None, "--type"),
+        category: str | None = typer.Option(default=None),
+        tag: str | None = typer.Option(default=None),
+        since: str | None = typer.Option(default=None),
+        page: int = typer.Option(default=1, min=1),
+        limit: int = typer.Option(default=20, min=1, max=100),
+        json_output: bool = typer.Option(False, "--json"),
+    ) -> None:
+        client = OpenRSSGateClient()
+        payload = client.list_feeds(
+            source_id=source_id,
+            q=query,
+            language=lang,
+            type=source_type,
+            category=category,
+            tag=tag,
+            since=since,
+            page=page,
+            limit=limit,
+        )
+
+        if json_output:
+            typer.echo(format_json(payload))
+            return
+
+        items = payload.get("items", [])
+        if not items:
+            typer.echo("No feeds found.")
+            return
+
+        for item in items:
+            typer.echo(item["title"])
+            typer.echo(f"  id: {item['id']}")
+            typer.echo(f"  source: {item['source_id']}")
+            typer.echo(f"  published: {item.get('published_at') or '-'}")
+            typer.echo(f"  url: {item['feed_url']}")
+
+    @app.command("feed")
+    def feed(
+        feed_id: str = typer.Argument(...),
+        json_output: bool = typer.Option(False, "--json"),
+    ) -> None:
+        client = OpenRSSGateClient()
+        payload = client.get_feed(feed_id)
+
+        if json_output:
+            typer.echo(format_json(payload))
+            return
+
+        source = payload.get("source", {})
+        typer.echo(payload["title"])
+        typer.echo(f"  id: {payload['id']}")
+        typer.echo(f"  source: {source.get('title') or payload.get('source_id')}")
+        typer.echo(f"  source id: {payload['source_id']}")
+        typer.echo(f"  published: {payload.get('published_at') or '-'}")
+        typer.echo(f"  url: {payload['feed_url']}")
+        typer.echo(f"  site: {source.get('site_url') or '-'}")

openrssgate/commands/list.py

@@ -0,0 +1,50 @@
+from __future__ import annotations
+
+import typer
+
+from openrssgate.client import OpenRSSGateClient, format_json
+
+
+def register(app: typer.Typer) -> None:
+    @app.command("list")
+    def list_sources(
+        keyword: str | None = typer.Option(default=None),
+        lang: str | None = typer.Option(None, "--lang"),
+        source_type: str | None = typer.Option(None, "--type"),
+        category: str | None = typer.Option(default=None),
+        tag: str | None = typer.Option(default=None),
+        page: int = typer.Option(default=1, min=1),
+        limit: int = typer.Option(default=20, min=1, max=100),
+        json_output: bool = typer.Option(False, "--json"),
+    ) -> None:
+        client = OpenRSSGateClient()
+        payload = client.list_sources(
+            keyword=keyword,
+            language=lang,
+            type=source_type,
+            category=category,
+            tag=tag,
+            page=page,
+            limit=limit,
+        )
+
+        if json_output:
+            typer.echo(format_json(payload))
+            return
+
+        items = payload.get("items", [])
+        if not items:
+            typer.echo("No sources found.")
+            return
+
+        for item in items:
+            tags = ", ".join(item.get("tags", [])) or "-"
+            categories = ", ".join(item.get("categories", [])) or "-"
+            typer.echo(
+                f"{item['title']} [{item.get('language') or '-'} / {item.get('type') or '-'} / {categories}]"
+            )
+            typer.echo(f"  id: {item['id']}")
+            typer.echo(f"  site: {item['site_url']}")
+            typer.echo(f"  rss: {item['rss_url']}")
+            typer.echo(f"  tags: {tags}")
+            typer.echo(f"  last fetched: {item.get('last_fetched_at') or '-'}")

openrssgate/commands/stats.py

@@ -0,0 +1,21 @@
+from __future__ import annotations
+
+import typer
+
+from openrssgate.client import OpenRSSGateClient, format_json
+
+
+def register(app: typer.Typer) -> None:
+    @app.command("stats")
+    def stats(json_output: bool = typer.Option(False, "--json")) -> None:
+        client = OpenRSSGateClient()
+        payload = client.get_stats()
+
+        if json_output:
+            typer.echo(format_json(payload))
+            return
+
+        typer.echo(f"total sources: {payload['total_sources']}")
+        typer.echo(f"active sources: {payload['active_sources']}")
+        typer.echo(f"total feeds: {payload['total_feeds']}")
+        typer.echo(f"feeds last 24h: {payload['feeds_last_24h']}")

openrssgate/commands/validate.py

@@ -0,0 +1,29 @@
+from __future__ import annotations
+
+import typer
+
+from openrssgate.client import OpenRSSGateClient, format_json
+
+
+def register(app: typer.Typer) -> None:
+    @app.command("validate")
+    def validate(
+        rss_url: str = typer.Argument(...),
+        lang: str | None = typer.Option(None, "--lang"),
+        source_type: str | None = typer.Option(None, "--type"),
+        json_output: bool = typer.Option(False, "--json"),
+    ) -> None:
+        client = OpenRSSGateClient()
+        payload = client.validate_source(rss_url, language=lang, type=source_type, categories=[], tags=[])
+
+        if json_output:
+            typer.echo(format_json(payload))
+            return
+
+        typer.echo(f"valid: {payload['valid']}")
+        typer.echo(f"title: {payload.get('title') or '-'}")
+        typer.echo(f"site: {payload.get('site_url') or '-'}")
+        typer.echo(f"rss: {payload['rss_url']}")
+        typer.echo(f"language: {payload.get('language') or '-'}")
+        typer.echo(f"type: {payload.get('type') or '-'}")
+        typer.echo(f"feed format: {payload.get('feed_format') or '-'}")

openrssgate/config.py

@@ -0,0 +1,7 @@
+from __future__ import annotations
+
+import os
+
+
+def get_api_base_url() -> str:
+    return os.getenv("OPENRSSGATE_API_BASE_URL", "http://127.0.0.1:8000/v1").rstrip("/")

openrssgate/main.py

@@ -0,0 +1,34 @@
+from __future__ import annotations
+
+import typer
+
+from openrssgate.client import ApiError
+from openrssgate.commands import feeds, list as list_command, stats, validate
+
+app = typer.Typer(
+    add_completion=False,
+    no_args_is_help=True,
+    help="Read-only CLI for querying RSS Gateway sources and feeds.",
+)
+
+list_command.register(app)
+feeds.register(app)
+stats.register(app)
+validate.register(app)
+
+
+@app.callback()
+def main() -> None:
+    pass
+
+
+def _run() -> None:
+    try:
+        app()
+    except ApiError as exc:
+        typer.echo(f"Error: {exc}", err=True)
+        raise typer.Exit(code=1) from exc
+
+
+if __name__ == "__main__":
+    _run()

openrssgate-0.1.0.dist-info/METADATA

@@ -0,0 +1,81 @@
+Metadata-Version: 2.4
+Name: openrssgate
+Version: 0.1.0
+Summary: Read-only CLI for querying OpenRSSGate sources and feeds.
+Author: OpenRSSGate
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/windbug99/openrssgate
+Project-URL: Repository, https://github.com/windbug99/openrssgate
+Project-URL: Issues, https://github.com/windbug99/openrssgate/issues
+Keywords: rss,cli,feeds,mcp,openrssgate
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content :: News/Diary
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: httpx==0.28.1
+Requires-Dist: typer==0.16.1
+
+# OpenRSSGate CLI
+
+## Install
+
+Local install with `pipx`:
+
+```bash
+cd /Users/tomato/cursor/openrssgate/cli
+pipx install .
+```
+
+After PyPI release:
+
+```bash
+pipx install openrssgate
+```
+
+or:
+
+```bash
+pip install openrssgate
+```
+
+Install directly from GitHub before the PyPI release:
+
+```bash
+pipx install "git+https://github.com/<owner>/openrssgate.git#subdirectory=cli"
+```
+
+Release steps are documented in [RELEASE.md](/Users/tomato/cursor/openrssgate/cli/RELEASE.md).
+Homebrew tap packaging notes are documented in [homebrew/README.md](/Users/tomato/cursor/openrssgate/cli/homebrew/README.md).
+External service setup steps are documented in [EXTERNAL_SETUP.md](/Users/tomato/cursor/openrssgate/cli/EXTERNAL_SETUP.md).
+
+After Homebrew tap release:
+
+```bash
+brew tap <owner>/tap
+brew install openrssgate
+```
+
+## Run
+
+```bash
+openrssgate list
+openrssgate feeds --since 7d
+openrssgate stats
+openrssgate validate https://example.com/rss.xml
+openrssgate feed <feed_id>
+```
+
+Set `OPENRSSGATE_API_BASE_URL` to the backend base URL if needed.
+
+```bash
+export OPENRSSGATE_API_BASE_URL=https://openrssgate-production.up.railway.app/v1
+openrssgate list
+openrssgate feeds --q openai --tag ai --since 7d
+```

openrssgate-0.1.0.dist-info/RECORD

@@ -0,0 +1,14 @@
+openrssgate/__init__.py,sha256=4t_crzhrLum--oyowUMxtjBTzUtWp7oRTF22ewEvJG4,49
+openrssgate/client.py,sha256=b1Fi1T573HVVL4A6JeBuZ0FV-XvEmrlTit6jnIbxIzA,1780
+openrssgate/config.py,sha256=b1HnCyAzEkvE_Kam_o6xKyiO6i8yeB87_g8iI9xyT30,168
+openrssgate/main.py,sha256=QDnJod3zczx6zrbb3oCNhSAlzmBJui646g1MZO6IHq0,651
+openrssgate/commands/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+openrssgate/commands/feeds.py,sha256=C3NViN8ieNMYNJ0AxQWh3ClNuiMXbqitxzRS1ljmxxU,2404
+openrssgate/commands/list.py,sha256=pBuUe1I26vIV2KsTNg7PK3aOqch9OiRVKPytT6jvBPc,1748
+openrssgate/commands/stats.py,sha256=d9kvk37E7C5vndyaDOJ2vx0C8TIHsKar34aDrX5n-mM,678
+openrssgate/commands/validate.py,sha256=Jnmkg7kBog2lnLqK-IndGJgoMBXXuM6CuTzUyLBPBgI,1090
+openrssgate-0.1.0.dist-info/METADATA,sha256=dRDcT6bMb0tl6MtIFnMXWQJfI36sD-23h-YLXixhutk,2196
+openrssgate-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+openrssgate-0.1.0.dist-info/entry_points.txt,sha256=MT_PBta0sarV-zvWR0YbcJKNGmDKxEyP4MwTnFoM0bw,54
+openrssgate-0.1.0.dist-info/top_level.txt,sha256=JDeXyYvFnu8S6h6loVQ8iN3nlvqUm1bmp-u-OrgTzwQ,12
+openrssgate-0.1.0.dist-info/RECORD,,

openrssgate-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

openrssgate-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+openrssgate = openrssgate.main:_run

openrssgate-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+openrssgate