Added clarifications to video_url. Check video URLs for all available…

… video qualities (Fixes #257)

tests/test_media.py

@@ -23,6 +23,7 @@
 from dateutil import tz
 
 import tidalapi
+from tidalapi import VideoQuality
 from tidalapi.exceptions import MetadataNotAvailable, ObjectNotFound
 from tidalapi.media import (
     AudioExtensions,
@@ -32,7 +33,6 @@
     MimeType,
     Quality,
 )
-
 from .cover import verify_image_resolution, verify_video_resolution
 
 
@@ -341,8 +341,23 @@ def test_video_no_release_date(session):
     ]
 
 
+def test_video_not_found(session):
+    with pytest.raises(ObjectNotFound):
+        session.video(12345678)
+
+
 def test_video_url(session):
+    # Test video URLs at all available qualities
     video = session.video(125506698)
+    session.video_quality = VideoQuality.low
+    url = video.get_url()
+    assert "m3u8" in url
+    verify_video_resolution(url, 640, 360)
+    session.video_quality = VideoQuality.medium
+    url = video.get_url()
+    assert "m3u8" in url
+    verify_video_resolution(url, 1280, 720)
+    session.video_quality = VideoQuality.high
     url = video.get_url()
     assert "m3u8" in url
     verify_video_resolution(url, 1920, 1080)

tidalapi/media.py

@@ -886,7 +886,7 @@ def _get(self, media_id: str) -> Video:
             return cast("Video", video)
 
     def get_url(self) -> str:
-        """Retrieves the URL for a video.
+        """Retrieves the URL to the m3u8 video playlist
 
         :return: A `str` object containing the direct video URL
         :raises: A :class:`exceptions.URLNotAvailable` if no URL is available for this video