compuglobal 0.3.7__tar.gz → 0.3.8__tar.gz

{compuglobal-0.3.7 → compuglobal-0.3.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: compuglobal
-Version: 0.3.7
+Version: 0.3.8
 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.13.0
+Requires-Dist: aiohttp>=3.14.0
 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.3.7 → compuglobal-0.3.8}/compuglobal/__init__.py

@@ -16,11 +16,12 @@ from compuglobal.models.frame import Frame, FrameResult
 from compuglobal.models.screencap import Screencap, ScreencapMoment
 from compuglobal.models.stream import Stream, StreamOverlay
 from compuglobal.models.subtitle import Subtitle
+from compuglobal.models.timestamp import Timestamp
 
 __title__ = "compuglobal"
 __author__ = "MitchellAW"
 __license__ = "MIT"
-__version__ = "0.3.7"
+__version__ = "0.3.8"
 
 __all__ = [
     "APIPageStatusError",
@@ -47,4 +48,5 @@ __all__ = [
     "Stream",
     "StreamOverlay",
     "Subtitle",
+    "Timestamp",
 ]

{compuglobal-0.3.7 → compuglobal-0.3.8}/compuglobal/models/frame.py

@@ -3,6 +3,7 @@
 from pydantic import Field
 
 from compuglobal.models.base import BaseCompuGlobalModel
+from compuglobal.models.timestamp import Timestamp
 
 
 class Frame(BaseCompuGlobalModel):
@@ -32,10 +33,7 @@ class Frame(BaseCompuGlobalModel):
             A readable timestamp for the frame in format `mm:ss`.
 
         """
-        seconds = int(self.timestamp / 1000)
-        minutes = int(seconds / 60)
-        seconds -= minutes * 60
-        return f"{minutes}:{seconds:02d}"
+        return Timestamp.get_real_timestamp(timestamp=self.timestamp)
 
     def __str__(self) -> str:
         """Get the string representation of the Frame.

{compuglobal-0.3.7 → compuglobal-0.3.8}/compuglobal/models/screencap.py

@@ -6,6 +6,7 @@ from compuglobal.models.base import BaseCompuGlobalModel
 from compuglobal.models.episode import EpisodeMetadata
 from compuglobal.models.frame import Frame
 from compuglobal.models.subtitle import Subtitle
+from compuglobal.models.timestamp import Timestamp
 
 
 class ScreencapMoment(BaseCompuGlobalModel):
@@ -29,6 +30,17 @@ class ScreencapMoment(BaseCompuGlobalModel):
     content: str = Field(alias="Content")
     title: str = Field(alias="Title")
 
+    def get_real_timestamp(self) -> str:
+        """Get a readable timestamp for the moments timestamp in format `mm:ss`.
+
+        Returns
+        -------
+        str
+            A readable timestamp in format `mm:ss`.
+
+        """
+        return Timestamp.get_real_timestamp(self.timestamp)
+
 
 class Screencap(BaseCompuGlobalModel):
     """A Screencap of an episode at a point in time of a TV Show.
@@ -58,7 +70,7 @@ class Screencap(BaseCompuGlobalModel):
     max_timestamp: int = Field(alias="MaxTimestamp", ge=0)
 
     def get_real_timestamp(self) -> str:
-        """Get a readable timestamp for the frame in format "mm:ss".
+        """Get a readable timestamp for the frame in format `mm:ss`.
 
         Returns
         -------
@@ -66,10 +78,21 @@ class Screencap(BaseCompuGlobalModel):
             A readable timestamp for the frame in format `mm:ss`.
 
         """
-        return self.frame.get_real_timestamp()
+        return Timestamp.get_real_timestamp(timestamp=self.frame.timestamp)
+
+    def get_duration(self) -> int:
+        """Get duration of screencap subtitles in milliseconds.
+
+        Returns
+        -------
+        int
+            Duration in milliseconds
+
+        """
+        return Timestamp.get_subtitles_duration(self.subtitles)
 
     def captions(self) -> list[str]:
-        """Get a list of captions for the screencap from all subttiles.
+        """Get a list of captions for the screencap from all subtitles.
 
         Returns
         -------

{compuglobal-0.3.7 → compuglobal-0.3.8}/compuglobal/models/subtitle.py

@@ -3,6 +3,7 @@
 from pydantic import Field
 
 from compuglobal.models.base import BaseCompuGlobalModel
+from compuglobal.models.timestamp import Timestamp
 
 
 class Subtitle(BaseCompuGlobalModel):
@@ -41,7 +42,7 @@ class Subtitle(BaseCompuGlobalModel):
         Returns
         -------
         int
-            The duration in milliseonds.
+            The duration in milliseconds.
 
         """
-        return self.end_timestamp - self.start_timestamp
+        return Timestamp.get_duration(start_timestamp=self.start_timestamp, end_timestamp=self.end_timestamp)

compuglobal-0.3.8/compuglobal/models/timestamp.py

@@ -0,0 +1,76 @@
+"""Timestamp module with helper class for working with timestamps."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from compuglobal.models.subtitle import Subtitle
+
+
+class Timestamp:
+    """Helper class for working with timestamps."""
+
+    @staticmethod
+    def get_minutes_seconds(milliseconds: int) -> tuple[int, int]:
+        """Get minutes and seconds from milliseconds.
+
+        Parameters
+        ----------
+        milliseconds : int
+            The length of time in milliseconds
+
+        Returns
+        -------
+        tuple[int, int]
+            The minutes, and seconds as a tuple
+
+        """
+        seconds = int(milliseconds / 1000)
+        minutes = int(seconds / 60)
+        seconds -= minutes * 60
+        return minutes, seconds
+
+    @staticmethod
+    def get_real_timestamp(timestamp: int) -> str:
+        """Get a readable timestamp for the frame in format `mm:ss`.
+
+        Returns
+        -------
+        str
+            A readable timestamp for the frame in format `mm:ss`.
+
+        """
+        minutes, seconds = Timestamp.get_minutes_seconds(timestamp)
+        return f"{minutes}:{seconds:02d}"
+
+    @staticmethod
+    def get_duration(start_timestamp: int, end_timestamp: int) -> int:
+        """Get the duration of the subtitle in milliseconds.
+
+        Returns
+        -------
+        int
+            The duration in milliseconds.
+
+        """
+        return end_timestamp - start_timestamp
+
+    @staticmethod
+    def get_subtitles_duration(subtitles: list[Subtitle]) -> int:
+        """Get the duration between the start of the earliest subtitle, and the end of the latest subtitle.
+
+        Parameters
+        ----------
+        subtitles : list[Subtitle]
+            The subtitles
+
+        Returns
+        -------
+        int
+            The duration in milliseconds
+
+        """
+        start_timestamp = min(subtitle.start_timestamp for subtitle in subtitles)
+        end_timestamp = max(subtitle.end_timestamp for subtitle in subtitles)
+        return Timestamp.get_duration(start_timestamp, end_timestamp)

{compuglobal-0.3.7 → compuglobal-0.3.8}/pyproject.toml

@@ -12,7 +12,7 @@ license = "MIT"
 requires-python = ">=3.13"
 dynamic = ["version", "description"]
 dependencies = [
-    "aiohttp>=3.13.0", "pydantic>=2.13.0"
+    "aiohttp>=3.14.0", "pydantic>=2.13.0"
 ]
 classifiers = [
     "Programming Language :: Python :: 3.13",