stophy 0.1.0__tar.gz

stophy-0.1.0/.gitignore

@@ -0,0 +1,18 @@
+# JavaScript / TypeScript
+node_modules
+dist
+*.tsbuildinfo
+
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+build/
+*.egg-info/
+.pytest_cache/
+
+# Lockfiles for the publishable packages are committed; root has none.
+
+# Misc
+*.log
+.DS_Store

stophy-0.1.0/PKG-INFO

@@ -0,0 +1,100 @@
+Metadata-Version: 2.4
+Name: stophy
+Version: 0.1.0
+Summary: Official Python SDK for Stophy - YouTube context API for AI agents.
+Project-URL: Homepage, https://stophy.dev
+Project-URL: Repository, https://github.com/stophy/stophy-sdk
+Author: Stophy
+License: MIT
+Keywords: ai-agents,sdk,stophy,transcript,youtube
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.27
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# stophy
+
+Official Python SDK for [Stophy](https://stophy.dev) **YouTube context API for AI agents**. Search videos, fetch transcripts, read comments and live chat, inspect channels and playlists, and get autocomplete suggestions, all returned as structured JSON.
+
+
+## Install
+
+```bash
+uv install stophy
+```
+
+Get an API key from your [Stophy dashboard](https://stophy.dev). The SDK sends it as `Authorization: Bearer <key>` on every request.
+
+## Quick start
+
+```python
+import os
+from stophy import Stophy
+
+stophy = Stophy(os.environ["STOPHY_API_KEY"])
+
+result = stophy.video(type="transcript", video_url="https://www.youtube.com/watch?v=D7liwdjvhWc")
+print(result["data"]["text"])
+```
+
+## Methods
+
+| Method | Description |
+| --- | --- |
+| `stophy.video(...)` | Details, transcript, comments, replies, or live chat (set `type`) |
+| `stophy.search(...)` | Search with filters for type, sort, date, duration, features |
+| `stophy.channel(...)` | Channel metadata + content by `tab` |
+| `stophy.playlist(...)` | Playlist items, paginated |
+| `stophy.suggest(...)` | Search autocomplete suggestions |
+| `stophy.credits()` | Current credit balance |
+| `stophy.logs(...)` | Recent request logs |
+| `stophy.usage(...)` | Daily credit/request counts |
+
+Arguments are keyword-only and snake_case; the SDK maps them to the API's field names for you. `video()` is overloaded on `type`, so the returned `data` is typed for the variant you asked for (transcript, comments, details, …).
+
+```python
+# Search
+results = stophy.search(q="typescript tutorial", sort_by="popularity", duration="long")
+
+# Comments, then replies to a comment
+comments = stophy.video(type="comments", video_url=url, sort_by="top")
+token = comments["data"]["items"][0].get("repliesToken")
+if token:
+    replies = stophy.video(type="replies", continuation_token=token)
+
+# Autocomplete and account
+print(stophy.suggest(q="react")["data"]["suggestions"])
+print(stophy.credits()["data"]["credits"])
+```
+
+### Pagination
+
+```python
+token = None
+while True:
+    page = stophy.search(q="lofi", continuation_token=token)
+    ...  # handle page["data"]["items"]
+    token = page["data"].get("continuationToken")
+    if not token:
+        break
+```
+
+## Errors
+
+Non-2xx responses raise `StophyError`:
+
+```python
+from stophy import Stophy, StophyError
+
+try:
+    stophy.credits()
+except StophyError as err:
+    print(err.status, err.code, err, err.request_id)
+    # err.code: "UNAUTHORIZED" | "INSUFFICIENT_CREDITS" | "BAD_REQUEST" |
+    #           "INVALID_INPUT" | "NOT_FOUND" | "CONCURRENCY_LIMITED" | "INTERNAL_ERROR"
+```
+
+## License
+
+MIT

stophy-0.1.0/README.md

@@ -0,0 +1,85 @@
+# stophy
+
+Official Python SDK for [Stophy](https://stophy.dev) **YouTube context API for AI agents**. Search videos, fetch transcripts, read comments and live chat, inspect channels and playlists, and get autocomplete suggestions, all returned as structured JSON.
+
+
+## Install
+
+```bash
+uv install stophy
+```
+
+Get an API key from your [Stophy dashboard](https://stophy.dev). The SDK sends it as `Authorization: Bearer <key>` on every request.
+
+## Quick start
+
+```python
+import os
+from stophy import Stophy
+
+stophy = Stophy(os.environ["STOPHY_API_KEY"])
+
+result = stophy.video(type="transcript", video_url="https://www.youtube.com/watch?v=D7liwdjvhWc")
+print(result["data"]["text"])
+```
+
+## Methods
+
+| Method | Description |
+| --- | --- |
+| `stophy.video(...)` | Details, transcript, comments, replies, or live chat (set `type`) |
+| `stophy.search(...)` | Search with filters for type, sort, date, duration, features |
+| `stophy.channel(...)` | Channel metadata + content by `tab` |
+| `stophy.playlist(...)` | Playlist items, paginated |
+| `stophy.suggest(...)` | Search autocomplete suggestions |
+| `stophy.credits()` | Current credit balance |
+| `stophy.logs(...)` | Recent request logs |
+| `stophy.usage(...)` | Daily credit/request counts |
+
+Arguments are keyword-only and snake_case; the SDK maps them to the API's field names for you. `video()` is overloaded on `type`, so the returned `data` is typed for the variant you asked for (transcript, comments, details, …).
+
+```python
+# Search
+results = stophy.search(q="typescript tutorial", sort_by="popularity", duration="long")
+
+# Comments, then replies to a comment
+comments = stophy.video(type="comments", video_url=url, sort_by="top")
+token = comments["data"]["items"][0].get("repliesToken")
+if token:
+    replies = stophy.video(type="replies", continuation_token=token)
+
+# Autocomplete and account
+print(stophy.suggest(q="react")["data"]["suggestions"])
+print(stophy.credits()["data"]["credits"])
+```
+
+### Pagination
+
+```python
+token = None
+while True:
+    page = stophy.search(q="lofi", continuation_token=token)
+    ...  # handle page["data"]["items"]
+    token = page["data"].get("continuationToken")
+    if not token:
+        break
+```
+
+## Errors
+
+Non-2xx responses raise `StophyError`:
+
+```python
+from stophy import Stophy, StophyError
+
+try:
+    stophy.credits()
+except StophyError as err:
+    print(err.status, err.code, err, err.request_id)
+    # err.code: "UNAUTHORIZED" | "INSUFFICIENT_CREDITS" | "BAD_REQUEST" |
+    #           "INVALID_INPUT" | "NOT_FOUND" | "CONCURRENCY_LIMITED" | "INTERNAL_ERROR"
+```
+
+## License
+
+MIT

stophy-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[project]
+name = "stophy"
+version = "0.1.0"
+description = "Official Python SDK for Stophy - YouTube context API for AI agents."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [{ name = "Stophy" }]
+keywords = ["stophy", "youtube", "transcript", "sdk", "ai-agents"]
+dependencies = ["httpx>=0.27"]
+
+[project.urls]
+Homepage = "https://stophy.dev"
+Repository = "https://github.com/stophy/stophy-sdk"
+
+[project.optional-dependencies]
+dev = ["pytest>=8"]
+
+[dependency-groups]
+dev = ["pytest>=8"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/stophy"]

stophy-0.1.0/src/stophy/__init__.py

@@ -0,0 +1,6 @@
+from . import types
+from .client import Stophy
+from .errors import StophyError
+
+__all__ = ["Stophy", "StophyError", "types"]
+__version__ = "0.1.0"

stophy-0.1.0/src/stophy/client.py

@@ -0,0 +1,298 @@
+from __future__ import annotations
+
+import random
+import time
+from email.utils import parsedate_to_datetime
+from typing import Any, Dict, List, Literal, Mapping, Optional, overload
+
+import httpx
+
+from .errors import StophyError
+from .types import (
+    ChannelResponse,
+    CommentsResponse,
+    CreditsResponse,
+    LiveChatResponse,
+    LogsResponse,
+    PlaylistResponse,
+    SearchResponse,
+    SuggestResponse,
+    TranscriptResponse,
+    UsageResponse,
+    VideoDetailsResponse,
+    VideoResponse,
+)
+
+DEFAULT_BASE_URL = "https://api.stophy.dev"
+RETRYABLE_STATUS = {429, 500, 502, 503, 504}
+
+
+def _compact(params: Mapping[str, Any]) -> Dict[str, Any]:
+    """Drop keys whose value is None so we only send what the caller set."""
+    return {k: v for k, v in params.items() if v is not None}
+
+
+class Stophy:
+    """Client for Stophy — YouTube context API for AI agents.
+
+    >>> stophy = Stophy(os.environ["STOPHY_API_KEY"])
+    >>> result = stophy.video(type="transcript", video_url=url)
+    >>> print(result["data"]["text"])
+    """
+
+    def __init__(
+        self,
+        api_key: str,
+        *,
+        base_url: str = DEFAULT_BASE_URL,
+        headers: Optional[Mapping[str, str]] = None,
+        timeout: float = 30.0,
+        max_retries: int = 2,
+        retry_initial_delay: float = 0.5,
+        transport: Optional[httpx.BaseTransport] = None,
+    ) -> None:
+        if not api_key:
+            raise ValueError("Stophy: api_key is required.")
+        self._max_retries = max_retries
+        self._retry_base = retry_initial_delay
+        self.client = httpx.Client(
+            base_url=base_url,
+            headers={"Authorization": f"Bearer {api_key}", **(headers or {})},
+            timeout=timeout,
+            transport=transport,
+        )
+
+    # --- endpoints ---------------------------------------------------------
+
+    @overload
+    def video(
+        self,
+        *,
+        type: Literal["details"],
+        video_url: Optional[str] = None,
+        sort_by: Optional[str] = None,
+        chat_type: Optional[str] = None,
+        continuation_token: Optional[str] = None,
+    ) -> VideoDetailsResponse: ...
+
+    @overload
+    def video(
+        self,
+        *,
+        type: Literal["transcript"],
+        video_url: Optional[str] = None,
+        sort_by: Optional[str] = None,
+        chat_type: Optional[str] = None,
+        continuation_token: Optional[str] = None,
+    ) -> TranscriptResponse: ...
+
+    @overload
+    def video(
+        self,
+        *,
+        type: Literal["comments", "replies"],
+        video_url: Optional[str] = None,
+        sort_by: Optional[str] = None,
+        chat_type: Optional[str] = None,
+        continuation_token: Optional[str] = None,
+    ) -> CommentsResponse: ...
+
+    @overload
+    def video(
+        self,
+        *,
+        type: Literal["livechat"],
+        video_url: Optional[str] = None,
+        sort_by: Optional[str] = None,
+        chat_type: Optional[str] = None,
+        continuation_token: Optional[str] = None,
+    ) -> LiveChatResponse: ...
+
+    def video(
+        self,
+        *,
+        type: str,
+        video_url: Optional[str] = None,
+        sort_by: Optional[str] = None,
+        chat_type: Optional[str] = None,
+        continuation_token: Optional[str] = None,
+    ) -> VideoResponse:
+        """Video details, transcript, comments, replies, or live chat — pick with ``type``.
+
+        The shape of ``data`` depends on ``type`` (details / transcript /
+        comments / replies / livechat).
+        """
+        return self._post(
+            "/v1/video",
+            {
+                "type": type,
+                "videoUrl": video_url,
+                "sortBy": sort_by,
+                "chatType": chat_type,
+                "continuationToken": continuation_token,
+            },
+        )
+
+    def search(
+        self,
+        *,
+        q: str,
+        type: Optional[str] = None,
+        sort_by: Optional[str] = None,
+        upload_date: Optional[str] = None,
+        duration: Optional[str] = None,
+        features: Optional[List[str]] = None,
+        continuation_token: Optional[str] = None,
+    ) -> SearchResponse:
+        """Search YouTube, optionally filtered by type, sort, date, duration, and features."""
+        return self._post(
+            "/v1/search",
+            {
+                "q": q,
+                "type": type,
+                "sortBy": sort_by,
+                "uploadDate": upload_date,
+                "duration": duration,
+                "features": features,
+                "continuationToken": continuation_token,
+            },
+        )
+
+    def channel(
+        self,
+        *,
+        channel_url: str,
+        tab: Optional[str] = None,
+        sort_by: Optional[str] = None,
+        continuation_token: Optional[str] = None,
+    ) -> ChannelResponse:
+        """Channel metadata and content. Switch sections with ``tab``."""
+        return self._post(
+            "/v1/channel",
+            {
+                "channelUrl": channel_url,
+                "tab": tab,
+                "sortBy": sort_by,
+                "continuationToken": continuation_token,
+            },
+        )
+
+    def playlist(
+        self,
+        *,
+        playlist_url: str,
+        continuation_token: Optional[str] = None,
+    ) -> PlaylistResponse:
+        """Playlist items. Page through long playlists with ``continuation_token``."""
+        return self._post(
+            "/v1/playlist",
+            {"playlistUrl": playlist_url, "continuationToken": continuation_token},
+        )
+
+    def suggest(
+        self,
+        *,
+        q: str,
+        hl: Optional[str] = None,
+        gl: Optional[str] = None,
+    ) -> SuggestResponse:
+        """Search autocomplete suggestions."""
+        return self._get("/v1/suggest", {"q": q, "hl": hl, "gl": gl})
+
+    def credits(self) -> CreditsResponse:
+        """Your current credit balance."""
+        return self._get("/v1/credits")
+
+    def logs(
+        self,
+        *,
+        days: Optional[str] = None,
+        endpoint: Optional[str] = None,
+        page: Optional[int] = None,
+    ) -> LogsResponse:
+        """Recent API request logs."""
+        return self._get("/v1/logs", {"days": days, "endpoint": endpoint, "page": page})
+
+    def usage(
+        self,
+        *,
+        days: Optional[str] = None,
+        tz: Optional[str] = None,
+    ) -> UsageResponse:
+        """Daily credit and request counts."""
+        return self._get("/v1/usage", {"days": days, "tz": tz})
+
+    # --- plumbing ----------------------------------------------------------
+
+    def _get(self, path: str, params: Optional[Mapping[str, Any]] = None) -> Any:
+        return self._handle(self._send("GET", path, params=_compact(params or {})))
+
+    def _post(self, path: str, body: Mapping[str, Any]) -> Any:
+        return self._handle(self._send("POST", path, json=_compact(body)))
+
+    def _send(self, method: str, path: str, **kwargs: Any) -> httpx.Response:
+        """Send a request, retrying transient failures with backoff + jitter.
+
+        Every Stophy endpoint is a read, so retrying is always safe.
+        """
+        attempt = 0
+        while True:
+            try:
+                resp = self.client.request(method, path, **kwargs)
+            except httpx.TransportError:
+                if attempt >= self._max_retries:
+                    raise
+                time.sleep(self._backoff(attempt))
+                attempt += 1
+                continue
+            if attempt < self._max_retries and resp.status_code in RETRYABLE_STATUS:
+                time.sleep(self._retry_after(resp, attempt))
+                attempt += 1
+                continue
+            return resp
+
+    def _backoff(self, attempt: int) -> float:
+        window = self._retry_base * (2**attempt)
+        return window / 2 + random.random() * (window / 2)
+
+    def _retry_after(self, resp: httpx.Response, attempt: int) -> float:
+        header = resp.headers.get("retry-after")
+        if header:
+            try:
+                return float(header)
+            except ValueError:
+                try:
+                    delay = parsedate_to_datetime(header).timestamp() - time.time()
+                    return max(0.0, delay)
+                except (TypeError, ValueError):
+                    pass
+        return self._backoff(attempt)
+
+    def _handle(self, resp: httpx.Response) -> Dict[str, Any]:
+        try:
+            payload = resp.json()
+        except ValueError:
+            payload = None
+
+        if resp.is_success and isinstance(payload, dict):
+            return payload
+
+        err = payload if isinstance(payload, dict) else {}
+        raise StophyError(
+            err.get("error") or f"Stophy request failed with status {resp.status_code}",
+            status=resp.status_code,
+            code=err.get("code"),
+            request_id=resp.headers.get("x-request-id"),
+            details=err.get("details"),
+        )
+
+    # --- lifecycle ---------------------------------------------------------
+
+    def close(self) -> None:
+        self.client.close()
+
+    def __enter__(self) -> "Stophy":
+        return self
+
+    def __exit__(self, *exc: Any) -> None:
+        self.close()

stophy-0.1.0/src/stophy/errors.py

@@ -0,0 +1,22 @@
+from __future__ import annotations
+
+from typing import Any, Optional
+
+
+class StophyError(Exception):
+    """Raised when the Stophy API responds with a non-2xx status."""
+
+    def __init__(
+        self,
+        message: str,
+        *,
+        status: int,
+        code: Optional[str] = None,
+        request_id: Optional[str] = None,
+        details: Any = None,
+    ) -> None:
+        super().__init__(message)
+        self.status = status
+        self.code = code
+        self.request_id = request_id
+        self.details = details

stophy-0.1.0/src/stophy/types.py

@@ -0,0 +1,423 @@
+"""Response types mirroring the Stophy OpenAPI schemas.
+
+These are ``TypedDict``s with ``total=False`` — they describe the shape of the
+JSON the API returns so editors and type checkers can help, without forcing
+every optional/nullable field to be present.
+"""
+
+from __future__ import annotations
+
+from typing import List, Literal, Optional, TypedDict, Union
+
+CacheState = Literal["hit", "miss"]
+ErrorCode = Literal[
+    "UNAUTHORIZED",
+    "INSUFFICIENT_CREDITS",
+    "BAD_REQUEST",
+    "INVALID_INPUT",
+    "NOT_FOUND",
+    "CONCURRENCY_LIMITED",
+    "INTERNAL_ERROR",
+]
+
+
+class Thumbnail(TypedDict, total=False):
+    url: str
+    width: int
+    height: int
+
+
+class EmptyState(TypedDict, total=False):
+    code: str
+    message: str
+
+
+# --- transcript -----------------------------------------------------------
+class TranscriptLanguage(TypedDict, total=False):
+    code: Optional[str]
+    name: Optional[str]
+    isAutoGenerated: bool
+
+
+class TranscriptSegment(TypedDict, total=False):
+    start: float
+    duration: float
+    text: str
+
+
+class TranscriptResult(TypedDict, total=False):
+    language: TranscriptLanguage
+    segments: List[TranscriptSegment]
+    text: str
+    empty: EmptyState
+
+
+# --- video details --------------------------------------------------------
+class VideoDetails(TypedDict, total=False):
+    id: str
+    type: Literal["video"]
+    videoUrl: str
+    title: Optional[str]
+    author: Optional[str]
+    authorId: Optional[str]
+    category: Optional[str]
+    description: Optional[str]
+    durationSec: Optional[float]
+    durationText: Optional[str]
+    isLive: bool
+    likeCount: Optional[float]
+    likeCountText: Optional[str]
+    publishedAt: Optional[str]
+    tags: List[str]
+    viewCount: Optional[float]
+    viewCountText: Optional[str]
+    thumbnails: List[Thumbnail]
+
+
+class RelatedVideo(TypedDict, total=False):
+    id: str
+    type: Literal["video"]
+    videoUrl: str
+    title: Optional[str]
+    author: Optional[str]
+    authorId: Optional[str]
+    durationSec: Optional[float]
+    durationText: Optional[str]
+    publishedAt: Optional[str]
+    publishedAtText: Optional[str]
+    viewCount: Optional[float]
+    viewCountText: Optional[str]
+    thumbnails: List[Thumbnail]
+
+
+class VideoDetailsData(TypedDict, total=False):
+    video: VideoDetails
+    related: List[RelatedVideo]
+
+
+# --- comments / replies ---------------------------------------------------
+class Comment(TypedDict, total=False):
+    id: Optional[str]
+    text: Optional[str]
+    author: Optional[str]
+    authorId: Optional[str]
+    authorThumbnail: Optional[str]
+    hasChannelOwnerReplied: bool
+    isChannelOwner: bool
+    isHearted: bool
+    isPinned: bool
+    isVerified: bool
+    publishedAt: Optional[str]
+    publishedAtText: Optional[str]
+    likeCount: Optional[float]
+    likeCountText: Optional[str]
+    replyCount: Optional[float]
+    replyCountText: Optional[str]
+    repliesToken: Optional[str]
+
+
+class CommentsData(TypedDict, total=False):
+    items: List[Comment]
+    continuationToken: Optional[str]
+    empty: EmptyState
+
+
+# --- live chat ------------------------------------------------------------
+class LiveChatMessage(TypedDict, total=False):
+    id: str
+    text: str
+    author: Optional[str]
+    authorId: Optional[str]
+    timestampUsec: Optional[str]
+    isOwner: bool
+    isModerator: bool
+    isVerified: bool
+    superChatAmount: Optional[str]
+    superChatCurrency: Optional[str]
+
+
+class LiveChatData(TypedDict, total=False):
+    status: str
+    isLive: bool
+    concurrentViewers: Optional[float]
+    pollIntervalMs: Optional[float]
+    messages: List[LiveChatMessage]
+    continuationToken: Optional[str]
+
+
+VideoData = Union[VideoDetailsData, TranscriptResult, CommentsData, LiveChatData]
+
+
+# --- search ---------------------------------------------------------------
+class SearchVideo(TypedDict, total=False):
+    type: Literal["video"]
+    id: str
+    videoUrl: str
+    title: str
+    author: Optional[str]
+    authorId: Optional[str]
+    description: Optional[str]
+    duration: Optional[str]
+    durationSec: Optional[float]
+    durationText: Optional[str]
+    isLive: bool
+    isUpcoming: bool
+    isVerified: bool
+    viewCount: Optional[float]
+    viewCountText: Optional[str]
+    publishedAt: Optional[str]
+    publishedAtText: Optional[str]
+    thumbnails: List[Thumbnail]
+
+
+class SearchShort(TypedDict, total=False):
+    type: Literal["short"]
+    id: str
+    shortUrl: str
+    title: str
+    author: Optional[str]
+    authorId: Optional[str]
+    description: Optional[str]
+    duration: Optional[str]
+    durationSec: Optional[float]
+    durationText: Optional[str]
+    viewCount: Optional[float]
+    viewCountText: Optional[str]
+    publishedAt: Optional[str]
+    publishedAtText: Optional[str]
+    thumbnails: List[Thumbnail]
+
+
+class SearchPlaylist(TypedDict, total=False):
+    type: Literal["playlist"]
+    id: str
+    playlistUrl: str
+    title: str
+    author: Optional[str]
+    authorId: Optional[str]
+    videoCount: Optional[float]
+    videoCountText: Optional[str]
+    thumbnails: List[Thumbnail]
+
+
+class SearchChannel(TypedDict, total=False):
+    type: Literal["channel"]
+    id: str
+    channelUrl: str
+    name: str
+    handle: Optional[str]
+    description: Optional[str]
+    subscriberCount: Optional[float]
+    subscriberCountText: Optional[str]
+    isVerified: bool
+    thumbnails: List[Thumbnail]
+
+
+SearchItem = Union[SearchVideo, SearchShort, SearchPlaylist, SearchChannel]
+
+
+class SearchData(TypedDict, total=False):
+    items: List[SearchItem]
+    continuationToken: Optional[str]
+    estimatedResults: int
+    empty: EmptyState
+
+
+# --- channel --------------------------------------------------------------
+class ChannelLink(TypedDict, total=False):
+    title: str
+    url: str
+
+
+class ChannelProfile(TypedDict, total=False):
+    id: Optional[str]
+    name: Optional[str]
+    handle: Optional[str]
+    channelUrl: Optional[str]
+    description: Optional[str]
+    subscriberCount: Optional[float]
+    subscriberCountText: Optional[str]
+    videoCount: Optional[float]
+    videoCountText: Optional[str]
+    viewCount: Optional[float]
+    viewCountText: Optional[str]
+    isVerified: bool
+    country: Optional[str]
+    joinedDate: Optional[str]
+    thumbnails: List[Thumbnail]
+    banners: List[Thumbnail]
+    links: Optional[List[ChannelLink]]
+
+
+class ContentItem(TypedDict, total=False):
+    id: str
+    type: str
+    title: Optional[str]
+    videoUrl: str
+    shortUrl: str
+    playlistUrl: str
+    author: Optional[str]
+    authorId: Optional[str]
+    durationSec: Optional[float]
+    durationText: Optional[str]
+    viewCount: Optional[float]
+    viewCountText: Optional[str]
+    publishedAt: Optional[str]
+    publishedAtText: Optional[str]
+    thumbnails: List[Thumbnail]
+
+
+class ChannelData(TypedDict, total=False):
+    channel: Optional[ChannelProfile]
+    tab: Optional[str]
+    items: List[ContentItem]
+    continuationToken: Optional[str]
+    empty: EmptyState
+
+
+# --- playlist -------------------------------------------------------------
+class PlaylistMeta(TypedDict, total=False):
+    id: str
+    type: Literal["playlist"]
+    playlistUrl: str
+    title: Optional[str]
+    author: Optional[str]
+    authorId: Optional[str]
+    description: Optional[str]
+    videoCount: Optional[str]
+    thumbnails: List[Thumbnail]
+
+
+class PlaylistItem(TypedDict, total=False):
+    id: str
+    type: Literal["video"]
+    videoUrl: str
+    title: Optional[str]
+    author: Optional[str]
+    authorId: Optional[str]
+    durationSec: Optional[float]
+    durationText: Optional[str]
+    index: Optional[float]
+    isLive: bool
+    isPlayable: bool
+    isUpcoming: bool
+    upcomingAt: Optional[str]
+    viewCount: Optional[float]
+    viewCountText: Optional[str]
+    publishedAt: Optional[str]
+    publishedAtText: Optional[str]
+    thumbnails: List[Thumbnail]
+
+
+class PlaylistData(TypedDict, total=False):
+    playlist: Optional[PlaylistMeta]
+    items: List[PlaylistItem]
+    continuationToken: Optional[str]
+    empty: EmptyState
+
+
+# --- suggest / account ----------------------------------------------------
+class SuggestData(TypedDict, total=False):
+    q: str
+    hl: str
+    gl: str
+    suggestions: List[str]
+
+
+class CreditsData(TypedDict, total=False):
+    credits: int
+
+
+class LogEntry(TypedDict, total=False):
+    id: str
+    userId: str
+    apiKeyId: Optional[str]
+    apiKeyName: Optional[str]
+    endpoint: str
+    method: str
+    status: int
+    credits: int
+    durationMs: Optional[float]
+    response: Optional[str]
+    createdAt: str
+
+
+class LogsData(TypedDict, total=False):
+    logs: List[LogEntry]
+    total: int
+    page: int
+    pageSize: int
+    totalPages: int
+    endpoints: List[str]
+
+
+class UsageItem(TypedDict, total=False):
+    date: str
+    credits: int
+    requests: int
+
+
+class UsageData(TypedDict, total=False):
+    items: List[UsageItem]
+
+
+# --- response envelopes ---------------------------------------------------
+class _Envelope(TypedDict, total=False):
+    success: bool
+    requestId: str
+    cacheState: CacheState
+    creditsUsed: int
+    creditsRemaining: int
+
+
+class _AccountEnvelope(TypedDict, total=False):
+    success: bool
+    requestId: str
+
+
+class VideoResponse(_Envelope, total=False):
+    data: VideoData
+
+
+class VideoDetailsResponse(_Envelope, total=False):
+    data: VideoDetailsData
+
+
+class TranscriptResponse(_Envelope, total=False):
+    data: TranscriptResult
+
+
+class CommentsResponse(_Envelope, total=False):
+    data: CommentsData
+
+
+class LiveChatResponse(_Envelope, total=False):
+    data: LiveChatData
+
+
+class SearchResponse(_Envelope, total=False):
+    data: SearchData
+
+
+class ChannelResponse(_Envelope, total=False):
+    data: ChannelData
+
+
+class PlaylistResponse(_Envelope, total=False):
+    data: PlaylistData
+
+
+class SuggestResponse(_Envelope, total=False):
+    data: SuggestData
+
+
+class CreditsResponse(_AccountEnvelope, total=False):
+    data: CreditsData
+
+
+class LogsResponse(_AccountEnvelope, total=False):
+    data: LogsData
+
+
+class UsageResponse(_AccountEnvelope, total=False):
+    data: UsageData

stophy-0.1.0/uv.lock

@@ -0,0 +1,304 @@
+version = 1
+revision = 3
+requires-python = ">=3.9"
+resolution-markers = [
+    "python_full_version >= '3.10'",
+    "python_full_version < '3.10'",
+]
+
+[[package]]
+name = "anyio"
+version = "4.12.1"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version < '3.10'",
+]
+dependencies = [
+    { name = "exceptiongroup", marker = "python_full_version < '3.10'" },
+    { name = "idna", marker = "python_full_version < '3.10'" },
+    { name = "typing-extensions", marker = "python_full_version < '3.10'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/96/f0/5eb65b2bb0d09ac6776f2eb54adee6abe8228ea05b20a5ad0e4945de8aac/anyio-4.12.1.tar.gz", hash = "sha256:41cfcc3a4c85d3f05c932da7c26d0201ac36f72abd4435ba90d0464a3ffed703", size = 228685, upload-time = "2026-01-06T11:45:21.246Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/38/0e/27be9fdef66e72d64c0cdc3cc2823101b80585f8119b5c112c2e8f5f7dab/anyio-4.12.1-py3-none-any.whl", hash = "sha256:d405828884fc140aa80a3c667b8beed277f1dfedec42ba031bd6ac3db606ab6c", size = 113592, upload-time = "2026-01-06T11:45:19.497Z" },
+]
+
+[[package]]
+name = "anyio"
+version = "4.14.1"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version >= '3.10'",
+]
+dependencies = [
+    { name = "exceptiongroup", marker = "python_full_version == '3.10.*'" },
+    { name = "idna", marker = "python_full_version >= '3.10'" },
+    { name = "typing-extensions", marker = "python_full_version >= '3.10' and python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/3b/72/5562aabb8dd7181e8e860622a38bea08d17842b99ecd4c91f84ac95251b0/anyio-4.14.1.tar.gz", hash = "sha256:8d648a3544c1a700e3ff78615cd679e4c5c3f149904287e73687b2596963629e", size = 254831, upload-time = "2026-06-24T20:56:06.017Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b0/7b/90df4a0a816d98d6ea26f559d87836d494a2cf1fcf063be67df50a7bcc30/anyio-4.14.1-py3-none-any.whl", hash = "sha256:4e5533c5b8ff0a24f5d7a176cbe6877129cd183893f66b537f8f227d10527d72", size = 124875, upload-time = "2026-06-24T20:56:04.413Z" },
+]
+
+[[package]]
+name = "certifi"
+version = "2026.6.17"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/c9/c7/424b75da314c1045981bd9777432fad05a9e0c69daa4ed7e308bbaffe405/certifi-2026.6.17.tar.gz", hash = "sha256:024c88eeec92ca068db80f02b8b07c9cef7b9fe261d1d535abfd5abd6f6af432", size = 134594, upload-time = "2026-06-17T10:31:07.894Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/ef/2f/c5464532e965badff2f4c4c1a3a83f5697f0d7c407ed0cda44aaa99bb451/certifi-2026.6.17-py3-none-any.whl", hash = "sha256:2227dcbaafe0d2f59279d1762ddddc37783ed4354594f194ffc31d20f41fc3db", size = 133289, upload-time = "2026-06-17T10:31:06.348Z" },
+]
+
+[[package]]
+name = "colorama"
+version = "0.4.6"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
+]
+
+[[package]]
+name = "exceptiongroup"
+version = "1.3.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/50/79/66800aadf48771f6b62f7eb014e352e5d06856655206165d775e675a02c9/exceptiongroup-1.3.1.tar.gz", hash = "sha256:8b412432c6055b0b7d14c310000ae93352ed6754f70fa8f7c34141f91c4e3219", size = 30371, upload-time = "2025-11-21T23:01:54.787Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/8a/0e/97c33bf5009bdbac74fd2beace167cab3f978feb69cc36f1ef79360d6c4e/exceptiongroup-1.3.1-py3-none-any.whl", hash = "sha256:a7a39a3bd276781e98394987d3a5701d0c4edffb633bb7a5144577f82c773598", size = 16740, upload-time = "2025-11-21T23:01:53.443Z" },
+]
+
+[[package]]
+name = "h11"
+version = "0.16.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/01/ee/02a2c011bdab74c6fb3c75474d40b3052059d95df7e73351460c8588d963/h11-0.16.0.tar.gz", hash = "sha256:4e35b956cf45792e4caa5885e69fba00bdbc6ffafbfa020300e549b208ee5ff1", size = 101250, upload-time = "2025-04-24T03:35:25.427Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/04/4b/29cac41a4d98d144bf5f6d33995617b185d14b22401f75ca86f384e87ff1/h11-0.16.0-py3-none-any.whl", hash = "sha256:63cf8bbe7522de3bf65932fda1d9c2772064ffb3dae62d55932da54b31cb6c86", size = 37515, upload-time = "2025-04-24T03:35:24.344Z" },
+]
+
+[[package]]
+name = "httpcore"
+version = "1.0.9"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "certifi" },
+    { name = "h11" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/06/94/82699a10bca87a5556c9c59b5963f2d039dbd239f25bc2a63907a05a14cb/httpcore-1.0.9.tar.gz", hash = "sha256:6e34463af53fd2ab5d807f399a9b45ea31c3dfa2276f15a2c3f00afff6e176e8", size = 85484, upload-time = "2025-04-24T22:06:22.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/7e/f5/f66802a942d491edb555dd61e3a9961140fd64c90bce1eafd741609d334d/httpcore-1.0.9-py3-none-any.whl", hash = "sha256:2d400746a40668fc9dec9810239072b40b4484b640a8c38fd654a024c7a1bf55", size = 78784, upload-time = "2025-04-24T22:06:20.566Z" },
+]
+
+[[package]]
+name = "httpx"
+version = "0.28.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "anyio", version = "4.12.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.10'" },
+    { name = "anyio", version = "4.14.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.10'" },
+    { name = "certifi" },
+    { name = "httpcore" },
+    { name = "idna" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b1/df/48c586a5fe32a0f01324ee087459e112ebb7224f646c0b5023f5e79e9956/httpx-0.28.1.tar.gz", hash = "sha256:75e98c5f16b0f35b567856f597f06ff2270a374470a5c2392242528e3e3e42fc", size = 141406, upload-time = "2024-12-06T15:37:23.222Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2a/39/e50c7c3a983047577ee07d2a9e53faf5a69493943ec3f6a384bdc792deb2/httpx-0.28.1-py3-none-any.whl", hash = "sha256:d909fcccc110f8c7faf814ca82a9a4d816bc5a6dbfea25d6591d6985b8ba59ad", size = 73517, upload-time = "2024-12-06T15:37:21.509Z" },
+]
+
+[[package]]
+name = "idna"
+version = "3.18"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/cd/63/9496c57188a2ee585e0f1db071d75089a11e98aa86eb99d9d7618fc1edce/idna-3.18.tar.gz", hash = "sha256:ffb385a7e039654cef1ab9ef32c6fafe283c0c0467bba1d9029738ce4a14a848", size = 196711, upload-time = "2026-06-02T14:34:07.794Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1e/5e/d4e9f1a599fb8e573b7b87160658329fbf28d19eac2718f51fc3def3aa5a/idna-3.18-py3-none-any.whl", hash = "sha256:7f952cbe720b688055e3f87de14f5c3e5fdaa8bc3928985c4077ca689de849a2", size = 65455, upload-time = "2026-06-02T14:34:06.319Z" },
+]
+
+[[package]]
+name = "iniconfig"
+version = "2.1.0"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version < '3.10'",
+]
+sdist = { url = "https://files.pythonhosted.org/packages/f2/97/ebf4da567aa6827c909642694d71c9fcf53e5b504f2d96afea02718862f3/iniconfig-2.1.0.tar.gz", hash = "sha256:3abbd2e30b36733fee78f9c7f7308f2d0050e88f0087fd25c2645f63c773e1c7", size = 4793, upload-time = "2025-03-19T20:09:59.721Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2c/e1/e6716421ea10d38022b952c159d5161ca1193197fb744506875fbb87ea7b/iniconfig-2.1.0-py3-none-any.whl", hash = "sha256:9deba5723312380e77435581c6bf4935c94cbfab9b1ed33ef8d238ea168eb760", size = 6050, upload-time = "2025-03-19T20:10:01.071Z" },
+]
+
+[[package]]
+name = "iniconfig"
+version = "2.3.0"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version >= '3.10'",
+]
+sdist = { url = "https://files.pythonhosted.org/packages/72/34/14ca021ce8e5dfedc35312d08ba8bf51fdd999c576889fc2c24cb97f4f10/iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730", size = 20503, upload-time = "2025-10-18T21:55:43.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/cb/b1/3846dd7f199d53cb17f49cba7e651e9ce294d8497c8c150530ed11865bb8/iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12", size = 7484, upload-time = "2025-10-18T21:55:41.639Z" },
+]
+
+[[package]]
+name = "packaging"
+version = "26.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d7/f1/e7a6dd94a8d4a5626c03e4e99c87f241ba9e350cd9e6d75123f992427270/packaging-26.2.tar.gz", hash = "sha256:ff452ff5a3e828ce110190feff1178bb1f2ea2281fa2075aadb987c2fb221661", size = 228134, upload-time = "2026-04-24T20:15:23.917Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/df/b2/87e62e8c3e2f4b32e5fe99e0b86d576da1312593b39f47d8ceef365e95ed/packaging-26.2-py3-none-any.whl", hash = "sha256:5fc45236b9446107ff2415ce77c807cee2862cb6fac22b8a73826d0693b0980e", size = 100195, upload-time = "2026-04-24T20:15:22.081Z" },
+]
+
+[[package]]
+name = "pluggy"
+version = "1.6.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f9/e2/3e91f31a7d2b083fe6ef3fa267035b518369d9511ffab804f839851d2779/pluggy-1.6.0.tar.gz", hash = "sha256:7dcc130b76258d33b90f61b658791dede3486c3e6bfb003ee5c9bfb396dd22f3", size = 69412, upload-time = "2025-05-15T12:30:07.975Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06.134Z" },
+]
+
+[[package]]
+name = "pygments"
+version = "2.20.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/c3/b2/bc9c9196916376152d655522fdcebac55e66de6603a76a02bca1b6414f6c/pygments-2.20.0.tar.gz", hash = "sha256:6757cd03768053ff99f3039c1a36d6c0aa0b263438fcab17520b30a303a82b5f", size = 4955991, upload-time = "2026-03-29T13:29:33.898Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f4/7e/a72dd26f3b0f4f2bf1dd8923c85f7ceb43172af56d63c7383eb62b332364/pygments-2.20.0-py3-none-any.whl", hash = "sha256:81a9e26dd42fd28a23a2d169d86d7ac03b46e2f8b59ed4698fb4785f946d0176", size = 1231151, upload-time = "2026-03-29T13:29:30.038Z" },
+]
+
+[[package]]
+name = "pytest"
+version = "8.4.2"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version < '3.10'",
+]
+dependencies = [
+    { name = "colorama", marker = "python_full_version < '3.10' and sys_platform == 'win32'" },
+    { name = "exceptiongroup", marker = "python_full_version < '3.10'" },
+    { name = "iniconfig", version = "2.1.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.10'" },
+    { name = "packaging", marker = "python_full_version < '3.10'" },
+    { name = "pluggy", marker = "python_full_version < '3.10'" },
+    { name = "pygments", marker = "python_full_version < '3.10'" },
+    { name = "tomli", marker = "python_full_version < '3.10'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/a3/5c/00a0e072241553e1a7496d638deababa67c5058571567b92a7eaa258397c/pytest-8.4.2.tar.gz", hash = "sha256:86c0d0b93306b961d58d62a4db4879f27fe25513d4b969df351abdddb3c30e01", size = 1519618, upload-time = "2025-09-04T14:34:22.711Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a8/a4/20da314d277121d6534b3a980b29035dcd51e6744bd79075a6ce8fa4eb8d/pytest-8.4.2-py3-none-any.whl", hash = "sha256:872f880de3fc3a5bdc88a11b39c9710c3497a547cfa9320bc3c5e62fbf272e79", size = 365750, upload-time = "2025-09-04T14:34:20.226Z" },
+]
+
+[[package]]
+name = "pytest"
+version = "9.1.1"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version >= '3.10'",
+]
+dependencies = [
+    { name = "colorama", marker = "python_full_version >= '3.10' and sys_platform == 'win32'" },
+    { name = "exceptiongroup", marker = "python_full_version == '3.10.*'" },
+    { name = "iniconfig", version = "2.3.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.10'" },
+    { name = "packaging", marker = "python_full_version >= '3.10'" },
+    { name = "pluggy", marker = "python_full_version >= '3.10'" },
+    { name = "pygments", marker = "python_full_version >= '3.10'" },
+    { name = "tomli", marker = "python_full_version == '3.10.*'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/e4/47/b9efed96c114afcfa3c9d3fe98a76a1d14c74a9e266d397cf6eb64be5e01/pytest-9.1.1.tar.gz", hash = "sha256:1088fbde8f2b49d95a549a195707afa7a76a3ce9bcadc26b6d71f0ffda5fe313", size = 1636369, upload-time = "2026-06-19T10:58:32.857Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/24/25/1de2678b631f5a49215c6c96fff41ba892b0a34df68d6d80292b1b48aa7f/pytest-9.1.1-py3-none-any.whl", hash = "sha256:37a86b45efb9a47a61a36449063e8e18d0cab3161329fc099eb21783169c4f0c", size = 386536, upload-time = "2026-06-19T10:58:31.347Z" },
+]
+
+[[package]]
+name = "stophy"
+version = "0.1.0"
+source = { editable = "." }
+dependencies = [
+    { name = "httpx" },
+]
+
+[package.optional-dependencies]
+dev = [
+    { name = "pytest", version = "8.4.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.10'" },
+    { name = "pytest", version = "9.1.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.10'" },
+]
+
+[package.dev-dependencies]
+dev = [
+    { name = "pytest", version = "8.4.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.10'" },
+    { name = "pytest", version = "9.1.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.10'" },
+]
+
+[package.metadata]
+requires-dist = [
+    { name = "httpx", specifier = ">=0.27" },
+    { name = "pytest", marker = "extra == 'dev'", specifier = ">=8" },
+]
+provides-extras = ["dev"]
+
+[package.metadata.requires-dev]
+dev = [{ name = "pytest", specifier = ">=8" }]
+
+[[package]]
+name = "tomli"
+version = "2.4.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/22/de/48c59722572767841493b26183a0d1cc411d54fd759c5607c4590b6563a6/tomli-2.4.1.tar.gz", hash = "sha256:7c7e1a961a0b2f2472c1ac5b69affa0ae1132c39adcb67aba98568702b9cc23f", size = 17543, upload-time = "2026-03-25T20:22:03.828Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f4/11/db3d5885d8528263d8adc260bb2d28ebf1270b96e98f0e0268d32b8d9900/tomli-2.4.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:f8f0fc26ec2cc2b965b7a3b87cd19c5c6b8c5e5f436b984e85f486d652285c30", size = 154704, upload-time = "2026-03-25T20:21:10.473Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/f7/675db52c7e46064a9aa928885a9b20f4124ecb9bc2e1ce74c9106648d202/tomli-2.4.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:4ab97e64ccda8756376892c53a72bd1f964e519c77236368527f758fbc36a53a", size = 149454, upload-time = "2026-03-25T20:21:12.036Z" },
+    { url = "https://files.pythonhosted.org/packages/61/71/81c50943cf953efa35bce7646caab3cf457a7d8c030b27cfb40d7235f9ee/tomli-2.4.1-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:96481a5786729fd470164b47cdb3e0e58062a496f455ee41b4403be77cb5a076", size = 237561, upload-time = "2026-03-25T20:21:13.098Z" },
+    { url = "https://files.pythonhosted.org/packages/48/c1/f41d9cb618acccca7df82aaf682f9b49013c9397212cb9f53219e3abac37/tomli-2.4.1-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:5a881ab208c0baf688221f8cecc5401bd291d67e38a1ac884d6736cbcd8247e9", size = 243824, upload-time = "2026-03-25T20:21:14.569Z" },
+    { url = "https://files.pythonhosted.org/packages/22/e4/5a816ecdd1f8ca51fb756ef684b90f2780afc52fc67f987e3c61d800a46d/tomli-2.4.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:47149d5bd38761ac8be13a84864bf0b7b70bc051806bc3669ab1cbc56216b23c", size = 242227, upload-time = "2026-03-25T20:21:15.712Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/49/2b2a0ef529aa6eec245d25f0c703e020a73955ad7edf73e7f54ddc608aa5/tomli-2.4.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:ec9bfaf3ad2df51ace80688143a6a4ebc09a248f6ff781a9945e51937008fcbc", size = 247859, upload-time = "2026-03-25T20:21:17.001Z" },
+    { url = "https://files.pythonhosted.org/packages/83/bd/6c1a630eaca337e1e78c5903104f831bda934c426f9231429396ce3c3467/tomli-2.4.1-cp311-cp311-win32.whl", hash = "sha256:ff2983983d34813c1aeb0fa89091e76c3a22889ee83ab27c5eeb45100560c049", size = 97204, upload-time = "2026-03-25T20:21:18.079Z" },
+    { url = "https://files.pythonhosted.org/packages/42/59/71461df1a885647e10b6bb7802d0b8e66480c61f3f43079e0dcd315b3954/tomli-2.4.1-cp311-cp311-win_amd64.whl", hash = "sha256:5ee18d9ebdb417e384b58fe414e8d6af9f4e7a0ae761519fb50f721de398dd4e", size = 108084, upload-time = "2026-03-25T20:21:18.978Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/83/dceca96142499c069475b790e7913b1044c1a4337e700751f48ed723f883/tomli-2.4.1-cp311-cp311-win_arm64.whl", hash = "sha256:c2541745709bad0264b7d4705ad453b76ccd191e64aa6f0fc66b69a293a45ece", size = 95285, upload-time = "2026-03-25T20:21:20.309Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/ba/42f134a3fe2b370f555f44b1d72feebb94debcab01676bf918d0cb70e9aa/tomli-2.4.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:c742f741d58a28940ce01d58f0ab2ea3ced8b12402f162f4d534dfe18ba1cd6a", size = 155924, upload-time = "2026-03-25T20:21:21.626Z" },
+    { url = "https://files.pythonhosted.org/packages/dc/c7/62d7a17c26487ade21c5422b646110f2162f1fcc95980ef7f63e73c68f14/tomli-2.4.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:7f86fd587c4ed9dd76f318225e7d9b29cfc5a9d43de44e5754db8d1128487085", size = 150018, upload-time = "2026-03-25T20:21:23.002Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/05/79d13d7c15f13bdef410bdd49a6485b1c37d28968314eabee452c22a7fda/tomli-2.4.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ff18e6a727ee0ab0388507b89d1bc6a22b138d1e2fa56d1ad494586d61d2eae9", size = 244948, upload-time = "2026-03-25T20:21:24.04Z" },
+    { url = "https://files.pythonhosted.org/packages/10/90/d62ce007a1c80d0b2c93e02cab211224756240884751b94ca72df8a875ca/tomli-2.4.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:136443dbd7e1dee43c68ac2694fde36b2849865fa258d39bf822c10e8068eac5", size = 253341, upload-time = "2026-03-25T20:21:25.177Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/7e/caf6496d60152ad4ed09282c1885cca4eea150bfd007da84aea07bcc0a3e/tomli-2.4.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:5e262d41726bc187e69af7825504c933b6794dc3fbd5945e41a79bb14c31f585", size = 248159, upload-time = "2026-03-25T20:21:26.364Z" },
+    { url = "https://files.pythonhosted.org/packages/99/e7/c6f69c3120de34bbd882c6fba7975f3d7a746e9218e56ab46a1bc4b42552/tomli-2.4.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:5cb41aa38891e073ee49d55fbc7839cfdb2bc0e600add13874d048c94aadddd1", size = 253290, upload-time = "2026-03-25T20:21:27.46Z" },
+    { url = "https://files.pythonhosted.org/packages/d6/2f/4a3c322f22c5c66c4b836ec58211641a4067364f5dcdd7b974b4c5da300c/tomli-2.4.1-cp312-cp312-win32.whl", hash = "sha256:da25dc3563bff5965356133435b757a795a17b17d01dbc0f42fb32447ddfd917", size = 98141, upload-time = "2026-03-25T20:21:28.492Z" },
+    { url = "https://files.pythonhosted.org/packages/24/22/4daacd05391b92c55759d55eaee21e1dfaea86ce5c571f10083360adf534/tomli-2.4.1-cp312-cp312-win_amd64.whl", hash = "sha256:52c8ef851d9a240f11a88c003eacb03c31fc1c9c4ec64a99a0f922b93874fda9", size = 108847, upload-time = "2026-03-25T20:21:29.386Z" },
+    { url = "https://files.pythonhosted.org/packages/68/fd/70e768887666ddd9e9f5d85129e84910f2db2796f9096aa02b721a53098d/tomli-2.4.1-cp312-cp312-win_arm64.whl", hash = "sha256:f758f1b9299d059cc3f6546ae2af89670cb1c4d48ea29c3cacc4fe7de3058257", size = 95088, upload-time = "2026-03-25T20:21:30.677Z" },
+    { url = "https://files.pythonhosted.org/packages/07/06/b823a7e818c756d9a7123ba2cda7d07bc2dd32835648d1a7b7b7a05d848d/tomli-2.4.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:36d2bd2ad5fb9eaddba5226aa02c8ec3fa4f192631e347b3ed28186d43be6b54", size = 155866, upload-time = "2026-03-25T20:21:31.65Z" },
+    { url = "https://files.pythonhosted.org/packages/14/6f/12645cf7f08e1a20c7eb8c297c6f11d31c1b50f316a7e7e1e1de6e2e7b7e/tomli-2.4.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:eb0dc4e38e6a1fd579e5d50369aa2e10acfc9cace504579b2faabb478e76941a", size = 149887, upload-time = "2026-03-25T20:21:33.028Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/e0/90637574e5e7212c09099c67ad349b04ec4d6020324539297b634a0192b0/tomli-2.4.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c7f2c7f2b9ca6bdeef8f0fa897f8e05085923eb091721675170254cbc5b02897", size = 243704, upload-time = "2026-03-25T20:21:34.51Z" },
+    { url = "https://files.pythonhosted.org/packages/10/8f/d3ddb16c5a4befdf31a23307f72828686ab2096f068eaf56631e136c1fdd/tomli-2.4.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f3c6818a1a86dd6dca7ddcaaf76947d5ba31aecc28cb1b67009a5877c9a64f3f", size = 251628, upload-time = "2026-03-25T20:21:36.012Z" },
+    { url = "https://files.pythonhosted.org/packages/e3/f1/dbeeb9116715abee2485bf0a12d07a8f31af94d71608c171c45f64c0469d/tomli-2.4.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:d312ef37c91508b0ab2cee7da26ec0b3ed2f03ce12bd87a588d771ae15dcf82d", size = 247180, upload-time = "2026-03-25T20:21:37.136Z" },
+    { url = "https://files.pythonhosted.org/packages/d3/74/16336ffd19ed4da28a70959f92f506233bd7cfc2332b20bdb01591e8b1d1/tomli-2.4.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:51529d40e3ca50046d7606fa99ce3956a617f9b36380da3b7f0dd3dd28e68cb5", size = 251674, upload-time = "2026-03-25T20:21:38.298Z" },
+    { url = "https://files.pythonhosted.org/packages/16/f9/229fa3434c590ddf6c0aa9af64d3af4b752540686cace29e6281e3458469/tomli-2.4.1-cp313-cp313-win32.whl", hash = "sha256:2190f2e9dd7508d2a90ded5ed369255980a1bcdd58e52f7fe24b8162bf9fedbd", size = 97976, upload-time = "2026-03-25T20:21:39.316Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/1e/71dfd96bcc1c775420cb8befe7a9d35f2e5b1309798f009dca17b7708c1e/tomli-2.4.1-cp313-cp313-win_amd64.whl", hash = "sha256:8d65a2fbf9d2f8352685bc1364177ee3923d6baf5e7f43ea4959d7d8bc326a36", size = 108755, upload-time = "2026-03-25T20:21:40.248Z" },
+    { url = "https://files.pythonhosted.org/packages/83/7a/d34f422a021d62420b78f5c538e5b102f62bea616d1d75a13f0a88acb04a/tomli-2.4.1-cp313-cp313-win_arm64.whl", hash = "sha256:4b605484e43cdc43f0954ddae319fb75f04cc10dd80d830540060ee7cd0243cd", size = 95265, upload-time = "2026-03-25T20:21:41.219Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/fb/9a5c8d27dbab540869f7c1f8eb0abb3244189ce780ba9cd73f3770662072/tomli-2.4.1-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:fd0409a3653af6c147209d267a0e4243f0ae46b011aa978b1080359fddc9b6cf", size = 155726, upload-time = "2026-03-25T20:21:42.23Z" },
+    { url = "https://files.pythonhosted.org/packages/62/05/d2f816630cc771ad836af54f5001f47a6f611d2d39535364f148b6a92d6b/tomli-2.4.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:a120733b01c45e9a0c34aeef92bf0cf1d56cfe81ed9d47d562f9ed591a9828ac", size = 149859, upload-time = "2026-03-25T20:21:43.386Z" },
+    { url = "https://files.pythonhosted.org/packages/ce/48/66341bdb858ad9bd0ceab5a86f90eddab127cf8b046418009f2125630ecb/tomli-2.4.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:559db847dc486944896521f68d8190be1c9e719fced785720d2216fe7022b662", size = 244713, upload-time = "2026-03-25T20:21:44.474Z" },
+    { url = "https://files.pythonhosted.org/packages/df/6d/c5fad00d82b3c7a3ab6189bd4b10e60466f22cfe8a08a9394185c8a8111c/tomli-2.4.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:01f520d4f53ef97964a240a035ec2a869fe1a37dde002b57ebc4417a27ccd853", size = 252084, upload-time = "2026-03-25T20:21:45.62Z" },
+    { url = "https://files.pythonhosted.org/packages/00/71/3a69e86f3eafe8c7a59d008d245888051005bd657760e96d5fbfb0b740c2/tomli-2.4.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:7f94b27a62cfad8496c8d2513e1a222dd446f095fca8987fceef261225538a15", size = 247973, upload-time = "2026-03-25T20:21:46.937Z" },
+    { url = "https://files.pythonhosted.org/packages/67/50/361e986652847fec4bd5e4a0208752fbe64689c603c7ae5ea7cb16b1c0ca/tomli-2.4.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:ede3e6487c5ef5d28634ba3f31f989030ad6af71edfb0055cbbd14189ff240ba", size = 256223, upload-time = "2026-03-25T20:21:48.467Z" },
+    { url = "https://files.pythonhosted.org/packages/8c/9a/b4173689a9203472e5467217e0154b00e260621caa227b6fa01feab16998/tomli-2.4.1-cp314-cp314-win32.whl", hash = "sha256:3d48a93ee1c9b79c04bb38772ee1b64dcf18ff43085896ea460ca8dec96f35f6", size = 98973, upload-time = "2026-03-25T20:21:49.526Z" },
+    { url = "https://files.pythonhosted.org/packages/14/58/640ac93bf230cd27d002462c9af0d837779f8773bc03dee06b5835208214/tomli-2.4.1-cp314-cp314-win_amd64.whl", hash = "sha256:88dceee75c2c63af144e456745e10101eb67361050196b0b6af5d717254dddf7", size = 109082, upload-time = "2026-03-25T20:21:50.506Z" },
+    { url = "https://files.pythonhosted.org/packages/d5/2f/702d5e05b227401c1068f0d386d79a589bb12bf64c3d2c72ce0631e3bc49/tomli-2.4.1-cp314-cp314-win_arm64.whl", hash = "sha256:b8c198f8c1805dc42708689ed6864951fd2494f924149d3e4bce7710f8eb5232", size = 96490, upload-time = "2026-03-25T20:21:51.474Z" },
+    { url = "https://files.pythonhosted.org/packages/45/4b/b877b05c8ba62927d9865dd980e34a755de541eb65fffba52b4cc495d4d2/tomli-2.4.1-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:d4d8fe59808a54658fcc0160ecfb1b30f9089906c50b23bcb4c69eddc19ec2b4", size = 164263, upload-time = "2026-03-25T20:21:52.543Z" },
+    { url = "https://files.pythonhosted.org/packages/24/79/6ab420d37a270b89f7195dec5448f79400d9e9c1826df982f3f8e97b24fd/tomli-2.4.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:7008df2e7655c495dd12d2a4ad038ff878d4ca4b81fccaf82b714e07eae4402c", size = 160736, upload-time = "2026-03-25T20:21:53.674Z" },
+    { url = "https://files.pythonhosted.org/packages/02/e0/3630057d8eb170310785723ed5adcdfb7d50cb7e6455f85ba8a3deed642b/tomli-2.4.1-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1d8591993e228b0c930c4bb0db464bdad97b3289fb981255d6c9a41aedc84b2d", size = 270717, upload-time = "2026-03-25T20:21:55.129Z" },
+    { url = "https://files.pythonhosted.org/packages/7a/b4/1613716072e544d1a7891f548d8f9ec6ce2faf42ca65acae01d76ea06bb0/tomli-2.4.1-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:734e20b57ba95624ecf1841e72b53f6e186355e216e5412de414e3c51e5e3c41", size = 278461, upload-time = "2026-03-25T20:21:56.228Z" },
+    { url = "https://files.pythonhosted.org/packages/05/38/30f541baf6a3f6df77b3df16b01ba319221389e2da59427e221ef417ac0c/tomli-2.4.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:8a650c2dbafa08d42e51ba0b62740dae4ecb9338eefa093aa5c78ceb546fcd5c", size = 274855, upload-time = "2026-03-25T20:21:57.653Z" },
+    { url = "https://files.pythonhosted.org/packages/77/a3/ec9dd4fd2c38e98de34223b995a3b34813e6bdadf86c75314c928350ed14/tomli-2.4.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:504aa796fe0569bb43171066009ead363de03675276d2d121ac1a4572397870f", size = 283144, upload-time = "2026-03-25T20:21:59.089Z" },
+    { url = "https://files.pythonhosted.org/packages/ef/be/605a6261cac79fba2ec0c9827e986e00323a1945700969b8ee0b30d85453/tomli-2.4.1-cp314-cp314t-win32.whl", hash = "sha256:b1d22e6e9387bf4739fbe23bfa80e93f6b0373a7f1b96c6227c32bef95a4d7a8", size = 108683, upload-time = "2026-03-25T20:22:00.214Z" },
+    { url = "https://files.pythonhosted.org/packages/12/64/da524626d3b9cc40c168a13da8335fe1c51be12c0a63685cc6db7308daae/tomli-2.4.1-cp314-cp314t-win_amd64.whl", hash = "sha256:2c1c351919aca02858f740c6d33adea0c5deea37f9ecca1cc1ef9e884a619d26", size = 121196, upload-time = "2026-03-25T20:22:01.169Z" },
+    { url = "https://files.pythonhosted.org/packages/5a/cd/e80b62269fc78fc36c9af5a6b89c835baa8af28ff5ad28c7028d60860320/tomli-2.4.1-cp314-cp314t-win_arm64.whl", hash = "sha256:eab21f45c7f66c13f2a9e0e1535309cee140182a9cdae1e041d02e47291e8396", size = 100393, upload-time = "2026-03-25T20:22:02.137Z" },
+    { url = "https://files.pythonhosted.org/packages/7b/61/cceae43728b7de99d9b847560c262873a1f6c98202171fd5ed62640b494b/tomli-2.4.1-py3-none-any.whl", hash = "sha256:0d85819802132122da43cb86656f8d1f8c6587d54ae7dcaf30e90533028b49fe", size = 14583, upload-time = "2026-03-25T20:22:03.012Z" },
+]
+
+[[package]]
+name = "typing-extensions"
+version = "4.15.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/94/1a15dd82efb362ac84269196e94cf00f187f7ed21c242792a923cdb1c61f/typing_extensions-4.15.0.tar.gz", hash = "sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466", size = 109391, upload-time = "2025-08-25T13:49:26.313Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/18/67/36e9267722cc04a6b9f15c7f3441c2363321a3ea07da7ae0c0707beb2a9c/typing_extensions-4.15.0-py3-none-any.whl", hash = "sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548", size = 44614, upload-time = "2025-08-25T13:49:24.86Z" },
+]