Merge pull request #182 from vmx/recording-details

feat(videos): add video recording details

pyyoutube/models/video.py

@@ -221,6 +221,17 @@ class VideoStatus(BaseModel, DatetimeTimeMixin):
     selfDeclaredMadeForKids: Optional[bool] = field(default=None, repr=False)
 
 
+@dataclass
+class VideoRecordingDetails(BaseModel, DatetimeTimeMixin):
+    """
+    A class representing the video recording details.
+
+    Refer: https://developers.google.com/youtube/v3/docs/videos#recordingDetails
+    """
+
+    recordingDate: Optional[str] = field(default=None, repr=False)
+
+
 @dataclass
 class VideoLiveStreamingDetails(BaseModel, DatetimeTimeMixin):
     """
@@ -251,6 +262,7 @@ class Video(BaseResource):
     statistics: Optional[VideoStatistics] = field(default=None, repr=False)
     topicDetails: Optional[VideoTopicDetails] = field(default=None, repr=False)
     player: Optional[Player] = field(default=None, repr=False)
+    recordingDetails: Optional[VideoRecordingDetails] = field(default=None, repr=False)
     liveStreamingDetails: Optional[VideoLiveStreamingDetails] = field(
         default=None, repr=False
     )

pyyoutube/utils/constants.py

@@ -63,6 +63,7 @@
     "statistics",
     "status",
     "topicDetails",
+    "recordingDetails",
     "liveStreamingDetails",
 }
 

testdata/modeldata/videos/video_recording_details.json

@@ -0,0 +1,3 @@
+{
+  "recordingDate": "2024-07-03T00:00:00Z"
+}

tests/models/test_videos.py

@@ -21,6 +21,8 @@ class VideoModelTest(unittest.TestCase):
         VIDEO_INFO = json.loads(f.read().decode("utf-8"))
     with open(BASE_PATH + "video_api_response.json", "rb") as f:
         VIDEO_API_RESPONSE = json.loads(f.read().decode("utf-8"))
+    with open(BASE_PATH + "video_recording_details.json", "rb") as f:
+        RECORDING_DETAILS = json.loads(f.read().decode("utf-8"))
 
     def testVideoContentDetails(self) -> None:
         m = models.VideoContentDetails.from_dict(self.CONTENT_DETAILS_INFO)
@@ -97,3 +99,11 @@ def testVideoListResponse(self) -> None:
         self.assertEqual(m.kind, "youtube#videoListResponse")
         self.assertEqual(m.pageInfo.totalResults, 1)
         self.assertEqual(m.items[0].id, "D-lhorsDlUQ")
+
+    def testVideoRecordingDetails(self) -> None:
+        m = models.VideoRecordingDetails.from_dict(self.RECORDING_DETAILS)
+
+        self.assertEqual(
+            m.string_to_datetime(m.recordingDate).isoformat(),
+            "2024-07-03T00:00:00+00:00",
+        )