SunsetLog 0.0.1__py3-none-any.whl

SunsetLog/__init__.py

@@ -0,0 +1,12 @@
+from SunsetLog.client import SunsetLogAPIError, SunsetLogClient
+from SunsetLog.models import ChannelMeta, ChannelsResponse, LogHit, SearchResponse
+
+__version__ = "0.1.0"
+__all__ = [
+    "SunsetLogClient",
+    "SunsetLogAPIError",
+    "SearchResponse",
+    "ChannelsResponse",
+    "LogHit",
+    "ChannelMeta",
+]

SunsetLog/client.py

@@ -0,0 +1,121 @@
+from typing import Any
+
+import httpx
+
+from SunsetLog.models import ChannelsResponse, SearchResponse
+
+
+class SunsetLogAPIError(Exception):
+    """Raised when the API returns an error or unexpected response."""
+
+    def __init__(self, message: str, status_code: int | None = None, body: str | None = None):
+        super().__init__(message)
+        self.status_code = status_code
+        self.body = body
+
+
+class SunsetLogClient:
+    """
+    Async client for log-api.vmp.ir.
+    Use as async context manager or call close() when done.
+    """
+
+    def __init__(
+        self,
+        token: str,
+        *,
+        base_url: str = "https://log-api.vmp.ir",
+        timeout: float = 30.0,
+        headers: dict[str, str] | None = None,
+    ):
+        self._base_url = base_url.rstrip("/")
+        self._token = token
+        self._timeout = timeout
+        self._headers = {
+            "Accept": "*/*",
+            "Authorization": f"Bearer {token}",
+            "User-Agent": "SunsetLog/1.0 (httpx)",
+            **(headers or {}),
+        }
+        self._client: httpx.AsyncClient | None = None
+
+    def _get_client(self) -> httpx.AsyncClient:
+        if self._client is None or self._client.is_closed:
+            self._client = httpx.AsyncClient(
+                base_url=self._base_url,
+                headers=self._headers,
+                timeout=self._timeout,
+            )
+        return self._client
+
+    async def close(self) -> None:
+        """Close the underlying HTTP client."""
+        if self._client and not self._client.is_closed:
+            await self._client.aclose()
+            self._client = None
+
+    async def __aenter__(self) -> "SunsetLogClient":
+        self._get_client()
+        return self
+
+    async def __aexit__(self, *args: Any) -> None:
+        await self.close()
+
+    async def get_channels(self, gang: int = 1) -> ChannelsResponse:
+        """
+        Fetch latest message id/ts per channel for a gang.
+        GET /channels/latest?gang={gang}
+        """
+        client = self._get_client()
+        r = await client.get("/channels/latest", params={"gang": gang})
+        if r.status_code != 200:
+            raise SunsetLogAPIError(
+                f"channels/latest failed: {r.status_code}",
+                status_code=r.status_code,
+                body=r.text,
+            )
+        data = r.json()
+        if not isinstance(data, dict):
+            raise SunsetLogAPIError("channels/latest returned non-object", body=r.text)
+        return data
+
+    async def search(
+        self,
+        *,
+        channels: str | list[str] | None = None,
+        gang: int = 1,
+        q: str = "",
+        from_offset: int = 0,
+        mode: str = "exact",
+        operator: str = "and",
+    ) -> SearchResponse:
+        """
+        Search logs. GET /search.
+        channels: single channel name or comma-separated list.
+        """
+        if channels is None:
+            channels_list = await self.get_channels(gang=gang)
+            channels = ",".join(channels_list.keys()) if channels_list else "gang_glitch_locker1"
+        elif isinstance(channels, list):
+            channels = ",".join(channels)
+
+        client = self._get_client()
+        params: dict[str, Any] = {
+            "q": q,
+            "from": from_offset,
+            "mode": mode,
+            "operator": operator,
+            "channels": channels,
+            "gang": gang,
+        }
+        r = await client.get("/search", params=params)
+        if r.status_code != 200:
+            raise SunsetLogAPIError(
+                f"search failed: {r.status_code}",
+                status_code=r.status_code,
+                body=r.text,
+            )
+        data = r.json()
+        if not isinstance(data, dict) or "hits" not in data:
+            raise SunsetLogAPIError("search returned invalid shape", body=r.text)
+        return data

SunsetLog/models.py

@@ -0,0 +1,28 @@
+from typing import Any, TypedDict
+
+
+class ChannelMeta(TypedDict):
+    """Latest message meta per channel."""
+
+    id: str
+    ts: int
+
+
+class LogHit(TypedDict, total=False):
+    """Single log entry from search."""
+
+    id: str
+    index: str
+    content: str
+    ts: int
+    reactions: list[dict[str, Any]]
+
+
+class SearchResponse(TypedDict):
+    """Search API response."""
+
+    hits: list[LogHit]
+    total: int
+
+
+ChannelsResponse = dict[str, ChannelMeta]

sunsetlog-0.0.1.dist-info/METADATA

@@ -0,0 +1,10 @@
+Metadata-Version: 2.4
+Name: SunsetLog
+Version: 0.0.1
+Summary: Add your description here
+Requires-Python: <3.15,>=3.10
+Requires-Dist: httpx>=0.28.1
+Description-Content-Type: text/markdown
+
+# SunsetLog
+

sunsetlog-0.0.1.dist-info/RECORD

@@ -0,0 +1,6 @@
+SunsetLog/__init__.py,sha256=ld2wjZCI6TYb4erdvS9s07Wkpahzu3aQZrksnZhSl08,311
+SunsetLog/client.py,sha256=_cqjGuJbAmr7CTBPQr9ci9nYtRgmEbW2DYcoQ5oAXP4,3845
+SunsetLog/models.py,sha256=K0VYPiKMoKGNMMqWr7Vhz2SAa6gKLyPGRRYypteMv4o,456
+sunsetlog-0.0.1.dist-info/METADATA,sha256=yuFWn7m1noVbMUHKXyEZaEX-pt6Z27GmzO82dYJDuMg,201
+sunsetlog-0.0.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+sunsetlog-0.0.1.dist-info/RECORD,,

sunsetlog-0.0.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any