openrssgate 0.1.0__tar.gz

openrssgate-0.1.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,57 @@
+# 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/openrssgate/__init__.py

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

openrssgate-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-0.1.0/openrssgate/commands/__init__.py

@@ -0,0 +1 @@
+

openrssgate-0.1.0/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-0.1.0/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-0.1.0/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-0.1.0/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-0.1.0/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-0.1.0/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/openrssgate.egg-info/PKG-INFO

@@ -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/openrssgate.egg-info/SOURCES.txt

@@ -0,0 +1,19 @@
+README.md
+pyproject.toml
+setup.py
+openrssgate/__init__.py
+openrssgate/client.py
+openrssgate/config.py
+openrssgate/main.py
+openrssgate.egg-info/PKG-INFO
+openrssgate.egg-info/SOURCES.txt
+openrssgate.egg-info/dependency_links.txt
+openrssgate.egg-info/entry_points.txt
+openrssgate.egg-info/requires.txt
+openrssgate.egg-info/top_level.txt
+openrssgate/commands/__init__.py
+openrssgate/commands/feeds.py
+openrssgate/commands/list.py
+openrssgate/commands/stats.py
+openrssgate/commands/validate.py
+tests/test_client.py

openrssgate-0.1.0/openrssgate.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

openrssgate-0.1.0/openrssgate.egg-info/entry_points.txt

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

openrssgate-0.1.0/openrssgate.egg-info/requires.txt

@@ -0,0 +1,2 @@
+httpx==0.28.1
+typer==0.16.1

openrssgate-0.1.0/openrssgate.egg-info/top_level.txt

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

openrssgate-0.1.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["setuptools>=69", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "openrssgate"
+version = "0.1.0"
+description = "Read-only CLI for querying OpenRSSGate sources and feeds."
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+authors = [
+  { name = "OpenRSSGate" }
+]
+keywords = ["rss", "cli", "feeds", "mcp", "openrssgate"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Internet :: WWW/HTTP :: Dynamic Content :: News/Diary",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+  "httpx==0.28.1",
+  "typer==0.16.1",
+]
+
+[project.urls]
+Homepage = "https://github.com/windbug99/openrssgate"
+Repository = "https://github.com/windbug99/openrssgate"
+Issues = "https://github.com/windbug99/openrssgate/issues"
+
+[project.scripts]
+openrssgate = "openrssgate.main:_run"
+
+[tool.setuptools.packages.find]
+include = ["openrssgate*"]

openrssgate-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

openrssgate-0.1.0/setup.py

@@ -0,0 +1,17 @@
+from setuptools import find_packages, setup
+
+
+setup(
+    name="openrssgate",
+    version="0.1.0",
+    packages=find_packages(),
+    install_requires=[
+        "typer==0.16.1",
+        "httpx==0.28.1",
+    ],
+    entry_points={
+        "console_scripts": [
+            "openrssgate=openrssgate.main:_run",
+        ]
+    },
+)

openrssgate-0.1.0/tests/test_client.py

@@ -0,0 +1,123 @@
+from __future__ import annotations
+
+import json
+
+import httpx
+
+from openrssgate.client import OpenRSSGateClient, format_json
+
+
+def test_format_json_outputs_indented_unicode() -> None:
+    payload = {"title": "테스트"}
+    assert json.loads(format_json(payload)) == payload
+
+
+def test_list_sources_builds_expected_request(monkeypatch) -> None:
+    captured: dict[str, object] = {}
+
+    def fake_request(
+        method: str,
+        url: str,
+        params: dict[str, object] | None = None,
+        json: object | None = None,
+        timeout: float | None = None,
+    ) -> httpx.Response:
+        captured["method"] = method
+        captured["url"] = url
+        captured["params"] = params
+        captured["json"] = json
+        request = httpx.Request("GET", url, params=params)
+        return httpx.Response(200, json={"items": [], "page": 1, "limit": 20, "total": 0}, request=request)
+
+    monkeypatch.setattr(httpx, "request", fake_request)
+
+    client = OpenRSSGateClient("http://127.0.0.1:8000/v1")
+    client.list_sources(language="ko", limit=10)
+
+    assert captured["method"] == "GET"
+    assert captured["url"] == "http://127.0.0.1:8000/v1/sources"
+    assert captured["params"] == {"language": "ko", "limit": 10}
+
+
+def test_get_stats_builds_expected_request(monkeypatch) -> None:
+    captured: dict[str, object] = {}
+
+    def fake_request(
+        method: str,
+        url: str,
+        params: dict[str, object] | None = None,
+        json: object | None = None,
+        timeout: float | None = None,
+    ) -> httpx.Response:
+        captured["method"] = method
+        captured["url"] = url
+        captured["params"] = params
+        captured["json"] = json
+        request = httpx.Request(method, url, params=params)
+        return httpx.Response(200, json={"total_sources": 1, "active_sources": 1, "total_feeds": 1, "feeds_last_24h": 1}, request=request)
+
+    monkeypatch.setattr(httpx, "request", fake_request)
+
+    client = OpenRSSGateClient("http://127.0.0.1:8000/v1")
+    client.get_stats()
+
+    assert captured["method"] == "GET"
+    assert captured["url"] == "http://127.0.0.1:8000/v1/stats"
+    assert captured["params"] is None
+
+
+def test_validate_source_builds_expected_request(monkeypatch) -> None:
+    captured: dict[str, object] = {}
+
+    def fake_request(
+        method: str,
+        url: str,
+        params: dict[str, object] | None = None,
+        json: object | None = None,
+        timeout: float | None = None,
+    ) -> httpx.Response:
+        captured["method"] = method
+        captured["url"] = url
+        captured["params"] = params
+        captured["json"] = json
+        request = httpx.Request(method, url, params=params)
+        return httpx.Response(200, json={"valid": True, "rss_url": "https://example.com/rss.xml"}, request=request)
+
+    monkeypatch.setattr(httpx, "request", fake_request)
+
+    client = OpenRSSGateClient("http://127.0.0.1:8000/v1")
+    client.validate_source("https://example.com/rss.xml", language="ko", type="blog", categories=[], tags=[])
+
+    assert captured["method"] == "POST"
+    assert captured["url"] == "http://127.0.0.1:8000/v1/sources/validate"
+    assert captured["json"] == {
+        "rss_url": "https://example.com/rss.xml",
+        "language": "ko",
+        "type": "blog",
+        "categories": [],
+        "tags": [],
+    }
+
+
+def test_get_feed_builds_expected_request(monkeypatch) -> None:
+    captured: dict[str, object] = {}
+
+    def fake_request(
+        method: str,
+        url: str,
+        params: dict[str, object] | None = None,
+        json: object | None = None,
+        timeout: float | None = None,
+    ) -> httpx.Response:
+        captured["method"] = method
+        captured["url"] = url
+        request = httpx.Request(method, url, params=params)
+        return httpx.Response(200, json={"id": "feed-1"}, request=request)
+
+    monkeypatch.setattr(httpx, "request", fake_request)
+
+    client = OpenRSSGateClient("http://127.0.0.1:8000/v1")
+    client.get_feed("feed-1")
+
+    assert captured["method"] == "GET"
+    assert captured["url"] == "http://127.0.0.1:8000/v1/feeds/feed-1"