compuglobal 0.4.2__tar.gz → 0.5.0__tar.gz

{compuglobal-0.4.2 → compuglobal-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: compuglobal
-Version: 0.4.2
+Version: 0.5.0
 Summary: Python wrapper for the CGHMC API (Frinkiac, Morbotron Master Of All Science and more.
 Keywords: The Simpsons,Futurama,Rick and Morty,West Wing,Frinkiac,Morbotron,Master of all Science,Capital Beat,API,API Wrapper,CompuGlobal,CompuGlobalHyperMegaNet,CGHMC
 Author: MitchellAW
@@ -12,7 +12,7 @@ Classifier: Programming Language :: Python :: 3.14
 Classifier: Operating System :: OS Independent
 Classifier: Intended Audience :: Developers
 License-File: LICENSE
-Requires-Dist: aiohttp>=3.14.0
+Requires-Dist: aiohttp>=3.14.1
 Requires-Dist: pydantic>=2.13.0
 Project-URL: Documentation, https://compuglobal.readthedocs.io/en/latest/
 Project-URL: Source, https://github.com/MitchellAW/CompuGlobal

{compuglobal-0.4.2 → compuglobal-0.5.0}/compuglobal/__init__.py

@@ -8,7 +8,7 @@ from compuglobal.aio import (
     MasterOfAllScience,
     Morbotron,
 )
-from compuglobal.errors import APIPageStatusError, NoSearchResultsFoundError
+from compuglobal.errors import APIPageStatusError, MaximumRetriesExceededError, NoSearchResultsFoundError
 from compuglobal.models.comic import ComicLayout, ComicOverlay, ComicPanel, ComicStrip
 from compuglobal.models.episode import Episode, EpisodeMetadata, EpisodeSummary
 from compuglobal.models.font import FontAlignment, FontColor, FontFamily
@@ -22,7 +22,7 @@ from compuglobal.models.timestamp import Timestamp
 __title__ = "compuglobal"
 __author__ = "MitchellAW"
 __license__ = "MIT"
-__version__ = "0.4.2"
+__version__ = "0.5.0"
 
 __all__ = [
     "APIPageStatusError",
@@ -42,6 +42,7 @@ __all__ = [
     "FrameResult",
     "Frinkiac",
     "MasterOfAllScience",
+    "MaximumRetriesExceededError",
     "Morbotron",
     "NoSearchResultsFoundError",
     "OverlayFormat",

{compuglobal-0.4.2 → compuglobal-0.5.0}/compuglobal/aio.py

@@ -35,8 +35,10 @@ class AsyncCompuGlobalAPI:
     ----------
     session : aiohttp.ClientSession
         The client session to use for all API calls
-    default_format : OverlayFormat | None, optional
+    default_format : OverlayFormat | None
         The default overlay format to use for all overlays/subtitles
+    max_retries : int
+        The maximum number of retries for all API requests
 
     Attributes
     ----------
@@ -64,20 +66,25 @@ class AsyncCompuGlobalAPI:
     media: MediaAPI = MediaAPI()
     metadata: MetadataAPI = MetadataAPI()
 
-    def __init__(self, session: aiohttp.ClientSession, default_format: OverlayFormat | None = None) -> None:
+    def __init__(
+        self,
+        session: aiohttp.ClientSession,
+        default_format: OverlayFormat | None = None,
+        max_retries: int = 0,
+    ) -> None:
         extra_fonts = list(self.EXTRA_FONTS)
         if default_format is None:
             chosen_font = extra_fonts[0] if len(extra_fonts) > 0 else FontFamily.IMPACT
             default_format = OverlayFormat(font_family=chosen_font)
 
-        allowed_fonts = FontFamily.universal_fonts() + extra_fonts
+        allowed_fonts = extra_fonts + FontFamily.universal_fonts()
 
         self.config = CompuGlobalAPIConfig(
             title=self.TITLE,
             allowed_fonts=allowed_fonts,
             default_format=default_format,
         )
-        self.client = CompuGlobalAPIClient(base_url=self.BASE_URL, session=session)
+        self.client = CompuGlobalAPIClient(base_url=self.BASE_URL, session=session, max_retries=max_retries)
 
     async def get_screencap(
         self,
@@ -89,9 +96,9 @@ class AsyncCompuGlobalAPI:
 
         Parameters
         ----------
-        episode : str | None, optional
+        episode : str | None
             An episode key
-        timestamp : int | None, optional
+        timestamp : int | None
             A timestamp of the screencap
 
         Returns
@@ -118,9 +125,9 @@ class AsyncCompuGlobalAPI:
         ----------
         search_text : str
             The search text to query
-        season_minimum : int | None, optional
+        season_minimum : int | None
             The minimum season allowed in the search results
-        season_maximum : int | None, optional
+        season_maximum : int | None
             The maximum season allowed in the search results
 
         Returns
@@ -165,9 +172,9 @@ class AsyncCompuGlobalAPI:
         ----------
         search_text : str
             The search text to query
-        season_minimum : int | None, optional
+        season_minimum : int | None
             The minimum season allowed in the search
-        season_maximum : int | None, optional
+        season_maximum : int | None
             The maximum season allowed in the search
 
         Returns
@@ -189,9 +196,9 @@ class AsyncCompuGlobalAPI:
 
         Parameters
         ----------
-        season_minimum : int | None, optional
+        season_minimum : int | None
             Minimum season number allowed in random result
-        season_maximum : int | None, optional
+        season_maximum : int | None
             Maximum season number allowed in random result
 
         Returns
@@ -329,9 +336,9 @@ class AsyncCompuGlobalAPI:
         ----------
         screencap : Screencap
             The screencap to use in the comic panel
-        subtitles : list[Subtitle] | None, optional
+        subtitles : list[Subtitle] | None
             A list of subtitles to overlay in the comic panel
-        overlay_format : OverlayFormat | None, optional
+        overlay_format : OverlayFormat | None
             The formatting to use in the comic panel overlay (subtitle)
 
         Returns
@@ -359,9 +366,9 @@ class AsyncCompuGlobalAPI:
         ----------
         screencap : Screencap
             The screencap to use in the comic strip
-        subtitles : list[Subtitle] | None, optional
+        subtitles : list[Subtitle] | None
             The subtitles to overlay in the comic strip
-        overlay_format : OverlayFormat | list[OverlayFormat] | None, optional
+        overlay_format : OverlayFormat | list[OverlayFormat] | None
             The formatting to use in the comic strip overlays (subtitleS). See :meth:`OverlayFormat.normalise` for
             full details on how formats are resolved.
 
@@ -389,9 +396,9 @@ class AsyncCompuGlobalAPI:
         ----------
         screencap : Screencap
             The screencap to make the comic with
-        subtitles : list[Subtitle] | None, optional
+        subtitles : list[Subtitle] | None
             The subtitles to override in the comic maker, by default None
-        overlay_format : OverlayFormat | list[OverlayFormat] | None, optional
+        overlay_format : OverlayFormat | list[OverlayFormat] | None
             The subtitle/overlay formatting to override in the comic maker, by default None
 
         Returns
@@ -423,9 +430,9 @@ class AsyncCompuGlobalAPI:
         ----------
         screencap : Screencap
             The screencap to use for the gif
-        subtitles : list[Subtitle] | None, optional
+        subtitles : list[Subtitle] | None
             The subtitles to overlay in the gif
-        overlay_format : OverlayFormat | list[OverlayFormat] | None, optional
+        overlay_format : OverlayFormat | list[OverlayFormat] | None
             The formatting to use in the gif overlays (subtitles). See :meth:`OverlayFormat.normalise` for
             full details on how formats are resolved.
 
@@ -463,9 +470,9 @@ class AsyncCompuGlobalAPI:
         ----------
         screencap : Screencap
             The screencap to make the comic with
-        subtitles : list[Subtitle] | None, optional
+        subtitles : list[Subtitle] | None
             The subtitles to override in the comic maker, by default None
-        overlay_format : OverlayFormat | list[OverlayFormat] | None, optional
+        overlay_format : OverlayFormat | list[OverlayFormat] | None
             The subtitle/overlay formatting to override in the comic maker, by default None
 
         Returns

{compuglobal-0.4.2 → compuglobal-0.5.0}/compuglobal/api/client.py

@@ -1,5 +1,6 @@
 """Module for handling API requests to CGHMC APIs."""
 
+import asyncio
 import logging
 from http import HTTPStatus
 from typing import Any
@@ -7,7 +8,7 @@ from typing import Any
 from aiohttp import ClientSession
 
 from compuglobal.api.endpoint import PreparedRequest, RequestMethod
-from compuglobal.errors import APIPageStatusError
+from compuglobal.errors import APIPageStatusError, MaximumRetriesExceededError
 
 log = logging.getLogger(__name__)
 
@@ -21,12 +22,15 @@ class CompuGlobalAPIClient:
         The base URL of the API (e.g. https://frinkiac.com)
     session : ClientSession
         The client session to use for all API requests
+    max_retries : int
+        The maximum number of retries for each request before raising an :class:`APIPageStatusError`
 
     """
 
-    def __init__(self, base_url: str, session: ClientSession) -> None:
+    def __init__(self, base_url: str, session: ClientSession, max_retries: int = 0) -> None:
         self.base_url = base_url
         self.session = session
+        self.max_retries = max_retries
 
     async def get(self, url: str, params: dict[str, Any] | None = None) -> dict[str, Any] | list[Any]:
         """Get the JSON response from the API using the given url, and params.
@@ -35,7 +39,7 @@ class CompuGlobalAPIClient:
         ----------
         url : str
             The url to use in the request
-        params : dict[str, Any] | None, optional
+        params : dict[str, Any] | None
             The query params to use in the request
 
         Returns
@@ -54,7 +58,11 @@ class CompuGlobalAPIClient:
                 log.debug("Response %s | GET %s", response.status, url)
                 return await response.json()
 
-            log.error("Non-2xx response %s | GET %s", response.status, url)
+            if response.status == HTTPStatus.TOO_MANY_REQUESTS:
+                retry_after = int(response.headers.get("Retry-After", 60))
+                raise APIPageStatusError(response.status, self.base_url, retry_after=retry_after)
+
+            log.error("Non-2xx response %s | POST %s | Headers %s", response.status, url, response.headers)
             raise APIPageStatusError(response.status, self.base_url)
 
     async def post_data(self, url: str, json: dict[str, Any] | list[Any] | None) -> str:
@@ -83,7 +91,11 @@ class CompuGlobalAPIClient:
                 log.debug("Response %s | POST %s", response.status, url)
                 return await response.text()
 
-            log.error("Non-2xx response %s | POST %s")
+            log.error("Non-2xx response %s | POST %s | Headers %s", response.status, url, response.headers)
+            if response.status == HTTPStatus.TOO_MANY_REQUESTS:
+                retry_after = int(response.headers.get("Retry-After", 60))
+                raise APIPageStatusError(response.status, self.base_url, retry_after=retry_after)
+
             raise APIPageStatusError(response.status, self.base_url)
 
     async def handle_request(self, request: PreparedRequest) -> str | dict[str, Any] | list[Any]:
@@ -99,9 +111,44 @@ class CompuGlobalAPIClient:
         str | dict[str, Any] | list[Any]
             The json response from the API
 
-        """
-        log.debug("%s %s | params=%s | body=%s", request.method.value, request.url, request.params, request.body)
-        if request.method == RequestMethod.POST:
-            return await self.post_data(request.url, json=request.body)
+        Raises
+        ------
+        APIPageStatusError
+            Raised immediately for non-2xx responses that are not retryable (e.g. anything other than a 429).
+        MaximumRetriesExceededError
+            Raised when the maximum number of retries is exceeded.
 
-        return await self.get(request.url, params=request.params)
+        """
+        for attempt in range(self.max_retries + 1):
+            try:
+                log.debug(
+                    "%s %s | params=%s | body=%s",
+                    request.method.value,
+                    request.url,
+                    request.params,
+                    request.body,
+                )
+                if request.method == RequestMethod.POST:
+                    return await self.post_data(request.url, json=request.body)
+
+                return await self.get(request.url, params=request.params)
+
+            except APIPageStatusError as error:
+                if error.page_status != HTTPStatus.TOO_MANY_REQUESTS or attempt >= self.max_retries:
+                    raise
+
+                log.warning(
+                    "Rate limited (429) | %s %s | retrying in %.2fs (attempt %d/%d)",
+                    request.method.value,
+                    request.url,
+                    error.retry_after,
+                    attempt + 1,
+                    self.max_retries + 1,
+                )
+
+                if error.retry_after is not None:
+                    # Add a buffer of 50-1000ms depending on retry amount
+                    buffer = max(0.05, min(1, error.retry_after * 0.02))
+                    await asyncio.sleep(error.retry_after + buffer)
+
+        raise MaximumRetriesExceededError

{compuglobal-0.4.2 → compuglobal-0.5.0}/compuglobal/api/endpoint.py

@@ -34,11 +34,11 @@ class PreparedRequest:
     ----------
     url: str
         The url of the request
-    method: RequestMethod, optional
+    method: RequestMethod
         The HTTP RequestMethod for the request (GET/POST/PUT)
-    params: dict[str, Any] | None, optional
+    params: dict[str, Any] | None
         The query parameters to use in the request
-    body: dict[str, Any] | list[Any] | None, optional
+    body: dict[str, Any] | list[Any] | None
         The JSON request body to post
 
     """
@@ -61,13 +61,13 @@ class Endpoint:
     ----------
     path : str
         The url path containing any path parameter names
-    method : RequestMethod, optional
+    method : RequestMethod
         The HTTP RequestMethod for the request (GET/POST/PUT)
-    required_query_params : frozenset[str], optional
+    required_query_params : frozenset[str]
         The required query parameters to use in the request
-    optional_query_params : frozenset[str], optional
+    optional_query_params : frozenset[str]
         Optional query params that can be used in the request
-    body_model : type[BaseModel] | None, optional
+    body_model : type[BaseModel] | None
         The pydantic model for the json body
 
     """
@@ -120,9 +120,9 @@ class Endpoint:
         ----------
         base_url : str
             The base url of the API
-        query : dict[str, Any] | None, optional
+        query : dict[str, Any] | None
             The query params to use in the url
-        path_params : dict[str, Any] | None, optional
+        path_params : dict[str, Any] | None
             The path params to use in the url
 
         Returns
@@ -154,11 +154,11 @@ class Endpoint:
         ----------
         base_url : str
             The base url of the API
-        query : dict[str, Any] | None, optional
+        query : dict[str, Any] | None
             The query params to use in the params of the request
-        path_params : dict[str, Any] | None, optional
+        path_params : dict[str, Any] | None
             The path params to use in the path of the request
-        body : BaseModel | None, optional
+        body : BaseModel | None
             The json body model to use in the request
 
         Returns

compuglobal-0.5.0/compuglobal/errors.py

@@ -0,0 +1,42 @@
+"""All errors/exceptions returned by CompuGlobal APIs."""
+
+from http import HTTPStatus
+
+
+class NoSearchResultsFoundError(Exception):
+    """Raised when no search results are found."""
+
+    def __init__(self, message: str = "No search results found.") -> None:
+        super().__init__(message)
+
+
+class MaximumRetriesExceededError(Exception):
+    """Raised when the maximum number of retries is exceeded."""
+
+    def __init__(self, message: str = "Maximum number of retries exceeded.") -> None:
+        super().__init__(message)
+
+
+class APIPageStatusError(Exception):
+    """Raised when the status code for the API is not 200.
+
+    Parameters
+    ----------
+    page_status : int
+        The page status code returned by the API.
+    url : str
+        The base url that raised the error.
+    retry_after : int | None
+        Number of seconds to wait before retrying if error was a 429.
+
+    """
+
+    def __init__(self, page_status: int, url: str, retry_after: int | None = None) -> None:
+        self.page_status = page_status
+        self.url = url
+        self.retry_after = retry_after
+
+        msg = f"Error {page_status}. {url} may be down."
+        if page_status == HTTPStatus.TOO_MANY_REQUESTS and self.retry_after is not None:
+            msg += f" Retry after {retry_after} seconds."
+        super().__init__(msg)

{compuglobal-0.4.2 → compuglobal-0.5.0}/compuglobal/models/comic.py

@@ -124,7 +124,7 @@ class ComicOverlay(BaseCompuGlobalModel):
         ----------
         subtitles : list[Subtitle]
             A list of subtitles
-        overlay_format : OverlayFormat | None, optional
+        overlay_format : OverlayFormat | None
             The format to use in the overlay
 
         Returns
@@ -171,7 +171,7 @@ class ComicPanel(BaseCompuGlobalModel):
         ----------
         screencap : Screencap
             Screencap to use for the comic panel
-        overlay_format : OverlayFormat | None, optional
+        overlay_format : OverlayFormat | None
             The format to use in the comic panel overlay.
 
         Returns
@@ -186,7 +186,7 @@ class ComicPanel(BaseCompuGlobalModel):
 
     @property
     def encoded(self) -> str:
-        """Get the base 64 encoded representation of this panel.
+        """The base 64 encoded representation of this panel.
 
         Returns
         -------
@@ -208,7 +208,7 @@ class ComicStrip(BaseCompuGlobalModel, frozen=False):
     ----------
     panels : list[ComicPanel]
         The list of ComicPanels to use in the comic strip
-    layout : ComicLayout | None, optional
+    layout : ComicLayout | None
         The layout to use when displaying the panels
 
     """
@@ -233,7 +233,7 @@ class ComicStrip(BaseCompuGlobalModel, frozen=False):
         ----------
         screencap : Screencap
             The screencap to use for the comic strip
-        overlay_format : OverlayFormat | list[OverlayFormat] | None, optional
+        overlay_format : OverlayFormat | list[OverlayFormat] | None
             The format(s) to use in the overlays. See :meth:`OverlayFormat.normalise` for
             full details on how formats are resolved.
 
@@ -266,7 +266,7 @@ class ComicStrip(BaseCompuGlobalModel, frozen=False):
         ----------
         subtitles : list[Subtitle]
             The subtitles to use for the overlays
-        overlay_format : OverlayFormat | list[OverlayFormat] | None, optional
+        overlay_format : OverlayFormat | list[OverlayFormat] | None
             The format(s) to use in the overlays. See :meth:`OverlayFormat.normalise` for
             full details on how formats are resolved.
 
@@ -284,7 +284,7 @@ class ComicStrip(BaseCompuGlobalModel, frozen=False):
 
     @property
     def encoded(self) -> str:
-        """Get the base 64 encoded representation of this comic strip.
+        """The base 64 encoded representation of this comic strip.
 
         Returns
         -------

{compuglobal-0.4.2 → compuglobal-0.5.0}/compuglobal/models/episode.py

@@ -30,6 +30,10 @@ class EpisodeMetadata(BaseCompuGlobalModel):
         The original air date of the episode (yyyy-mm-dd)
     wiki_link : str
         The wikipedia link for the episode
+    video_width : int
+        The width of the video in pixels
+    video_height : int
+        The height of the video in pixels
 
     """
 
@@ -42,6 +46,8 @@ class EpisodeMetadata(BaseCompuGlobalModel):
     writer: str = Field(alias="Writer")
     original_air_date: str = Field(alias="OriginalAirDate")
     wiki_link: str = Field(alias="WikiLink")
+    video_width: int = Field(alias="VideoWidth", ge=0, default=480)
+    video_height: int = Field(alias="VideoHeight", ge=0, default=360)
 
 
 class EpisodeSummary(BaseCompuGlobalModel):

{compuglobal-0.4.2 → compuglobal-0.5.0}/compuglobal/models/font.py

@@ -41,8 +41,8 @@ class FontFamily(StrEnum):
         return [
             FontFamily.IMPACT,
             FontFamily.COMIC_NEUE,
-            FontFamily.JOST,
             FontFamily.PACIFICO,
+            FontFamily.JOST,
         ]
 
 
@@ -70,7 +70,7 @@ class FontColor(BaseCompuGlobalModel):
         The amount of green in the color (0-255)
     blue : int
         The amount of blue in the color (0-255)
-    alpha : int, optional
+    alpha : int
         The amount of alpha transparency in the color (0-255)
 
     """

{compuglobal-0.4.2 → compuglobal-0.5.0}/compuglobal/models/frame.py

@@ -17,12 +17,18 @@ class Frame(BaseCompuGlobalModel):
         The episode key (S01E01)
     timestamp : int
         The timestamp of the frame
+    video_width : int
+        The width of the video in pixels
+    video_height : int
+        The height of the video in pixels
 
     """
 
     id: int = Field(alias="Id")
     key: str = Field(alias="Episode")
     timestamp: int = Field(alias="Timestamp", ge=0)
+    video_width: int = Field(alias="VideoWidth", ge=0, default=480)
+    video_height: int = Field(alias="VideoHeight", ge=0, default=360)
 
     @property
     def timecode(self) -> str:

{compuglobal-0.4.2 → compuglobal-0.5.0}/compuglobal/models/overlay.py

@@ -36,7 +36,7 @@ class OverlayFormat(BaseCompuGlobalModel):
     text_alignment: FontAlignment = Field(default=FontAlignment.ALIGN_CENTER)
     all_caps: bool = Field(default=True)
 
-    def __str__(self) -> str:  # noqa: D105
+    def __str__(self) -> str:  # ruff: ignore[undocumented-magic-method]
         return str(self.model_dump(exclude_defaults=True))
 
     @property
@@ -63,9 +63,8 @@ class OverlayFormat(BaseCompuGlobalModel):
         """
         return self.font_color.rgba
 
-    @classmethod
+    @staticmethod
     def normalise(
-        cls,
         overlay_format: "OverlayFormat | list[OverlayFormat] | None",
         size: int,
     ) -> "list[OverlayFormat]":
@@ -73,7 +72,7 @@ class OverlayFormat(BaseCompuGlobalModel):
 
         Parameters
         ----------
-        overlay_format : OverlayFormat | list[OverlayFormat] | None, optional
+        overlay_format : OverlayFormat | list[OverlayFormat] | None
             The format(s) to use in the overlays:
 
             - If ``None``, default formatting is applied to all overlays
@@ -91,12 +90,12 @@ class OverlayFormat(BaseCompuGlobalModel):
 
         """
         if overlay_format is None:
-            return size * [cls()]
+            return size * [OverlayFormat()]
 
-        if isinstance(overlay_format, cls):
+        if isinstance(overlay_format, OverlayFormat):
             return size * [overlay_format]
 
         if len(overlay_format) < size:
-            return overlay_format + [cls()] * (size - len(overlay_format))
+            return overlay_format + [OverlayFormat()] * (size - len(overlay_format))
 
         return overlay_format[:size]

{compuglobal-0.4.2 → compuglobal-0.5.0}/compuglobal/models/screencap.py

@@ -22,6 +22,10 @@ class ScreencapMoment(BaseCompuGlobalModel):
         The content of the subtitle
     title : str
         The title of the episode in the snapshot
+    video_width : int
+        The width of the video in pixels
+    video_height : int
+        The height of the video in pixels
 
     """
 
@@ -29,6 +33,8 @@ class ScreencapMoment(BaseCompuGlobalModel):
     timestamp: int = Field(alias="Timestamp", ge=0)
     content: str = Field(alias="Content")
     title: str = Field(alias="Title")
+    video_width: int = Field(alias="VideoWidth", ge=0, default=480)
+    video_height: int = Field(alias="VideoHeight", ge=0, default=360)
 
     @property
     def key(self) -> str:

{compuglobal-0.4.2 → compuglobal-0.5.0}/compuglobal/models/stream.py

@@ -152,7 +152,7 @@ class Stream(BaseCompuGlobalModel):
         ----------
         screencap : Screencap
             The screencap to use for the Stream
-        overlay_format : OverlayFormat | list[OverlayFormat] | None, optional
+        overlay_format : OverlayFormat | list[OverlayFormat] | None
             The format(s) to use in the overlays. See :meth:`OverlayFormat.normalise` for
             full details on how formats are resolved.
 
@@ -183,7 +183,7 @@ class Stream(BaseCompuGlobalModel):
         ----------
         screencap : Screencap
             The screencap to use for the overlays
-        overlay_format : OverlayFormat | list[OverlayFormat] | None, optional
+        overlay_format : OverlayFormat | list[OverlayFormat] | None
             The format(s) to use in the overlays. See :meth:`OverlayFormat.normalise` for
             full details on how formats are resolved.
 
@@ -207,7 +207,7 @@ class Stream(BaseCompuGlobalModel):
 
     @property
     def caption(self) -> str:
-        """Get the entire caption of the Stream (all overlays) as a string.
+        """The entire caption of the Stream (all overlays) as a string.
 
         Returns
         -------
@@ -219,7 +219,7 @@ class Stream(BaseCompuGlobalModel):
 
     @property
     def encoded(self) -> str:
-        """Get the base 64 encoded representation of this stream's overlays.
+        """The base 64 encoded representation of this stream's overlays.
 
         Returns
         -------

{compuglobal-0.4.2 → compuglobal-0.5.0}/compuglobal/models/subtitle.py

@@ -38,7 +38,7 @@ class Subtitle(BaseCompuGlobalModel):
 
     @property
     def duration(self) -> int:
-        """Get the duration of the subtitle in milliseconds.
+        """The duration of the subtitle in milliseconds.
 
         Returns
         -------

{compuglobal-0.4.2 → compuglobal-0.5.0}/pyproject.toml

@@ -12,7 +12,7 @@ license = "MIT"
 requires-python = ">=3.13"
 dynamic = ["version", "description"]
 dependencies = [
-    "aiohttp>=3.14.0", "pydantic>=2.13.0"
+    "aiohttp>=3.14.1", "pydantic>=2.13.0"
 ]
 classifiers = [
     "Programming Language :: Python :: 3.13",
@@ -62,12 +62,12 @@ line-length = 120
 [tool.ruff.lint]
 preview = true
 select = ["ALL"]
-ignore = ["CPY001", "D107", "D203", "D213"]
+ignore = ["missing-copyright-notice", "undocumented-public-init", "incorrect-blank-line-before-class", "multi-line-summary-second-line"]
 
 [tool.ruff.lint.per-file-ignores]
-"examples/*" = ["INP001", "T201", "ANN201", "D103"]
-"docs/*" = ["A001", "INP001", "D100"]
-"tests/*" = ["S101", "D103", "PLR2004", "S311"]
+"examples/*" = ["implicit-namespace-package", "print", "missing-return-type-undocumented-public-function", "undocumented-public-function"]
+"docs/*" = ["builtin-variable-shadowing", "implicit-namespace-package", "undocumented-public-module"]
+"tests/*" = ["assert", "undocumented-public-function", "magic-value-comparison", "suspicious-non-cryptographic-random-usage"]
 
 [tool.pyrefly]
 project-includes = [

compuglobal-0.4.2/compuglobal/errors.py

@@ -1,24 +0,0 @@
-"""All errors/exceptions returned by CompuGlobal APIs."""
-
-
-class NoSearchResultsFoundError(Exception):
-    """Raised when no search results are found."""
-
-    def __init__(self, message: str = "No search results found.") -> None:
-        super().__init__(message)
-
-
-class APIPageStatusError(Exception):
-    """Raised when the status code for the API is not 200.
-
-    Parameters
-    ----------
-    page_status : int
-        The page status code returned by the API.
-    url : str
-        The base url that raised the error.
-
-    """
-
-    def __init__(self, page_status: int, url: str) -> None:
-        super().__init__(f"Error {page_status}. {url} may be down.")