[chore] Add Tautulli v2.15.0 support (#54)

Author: nwithan8

tautulli/API_VERSIONS.json

@@ -1,11 +1,8 @@
 [
-  "2.14.0-beta",
-  "2.14.0",
-  "2.14.1-beta",
-  "2.14.1",
   "2.14.2",
   "2.14.3",
   "2.14.4",
   "2.14.5",
-  "2.14.6"
+  "2.14.6",
+  "2.15.0"
 ]

tautulli/api/json_api.py

@@ -638,7 +638,7 @@ def edit_user(self, user_id: str, friendly_name: str = None, custom_thumb: str =
     def export_metadata(self, section_id: int = None, user_id: int = None, rating_key: int = None,
                         file_format: str = 'csv', metadata_level: int = 1, media_info_level: int = 1,
                         thumb_level: int = 0, art_level: int = 0, custom_fields: List[str] = None,
-                        export_type: str = None, individual_files: bool = False) -> bool:
+                        export_type: str = None, individual_files: bool = False, logo_level: int = 0) -> bool:
         """
         Export library or media metadata to a file
 
@@ -664,6 +664,8 @@ def export_metadata(self, section_id: int = None, user_id: int = None, rating_ke
         :type export_type: str, optional
         :param individual_files: Export each item as an individual field for library/user export (default: False)
         :type individual_files: bool, optional
+        :param logo_level: Level of logo images to export (default: 0)
+        :type logo_level: int, optional
         :returns: `True` if successful, `False` if unsuccessful
         :rtype: bool
         """
@@ -681,7 +683,7 @@ def export_metadata(self, section_id: int = None, user_id: int = None, rating_ke
         params = build_optional_params(file_format=file_format, metadata_level=metadata_level,
                                        media_info_level=media_info_level, thumb_level=thumb_level, art_level=art_level,
                                        custom_fields=custom_fields, export_type=export_type,
-                                       individual_files=individual_files)
+                                       individual_files=individual_files, logo_level=logo_level)
         name, value = _which_used(section_id=section_id, user_id=user_id, rating_key=rating_key)
         if name:
             params[name] = value

tautulli/api/object_api.py

@@ -449,7 +449,7 @@ def edit_user(self, user_id: str, friendly_name: str = None, custom_thumb: str =
     def export_metadata(self, section_id: int = None, user_id: int = None, rating_key: int = None,
                         file_format: str = 'csv', metadata_level: int = 1, media_info_level: int = 1,
                         thumb_level: int = 0, art_level: int = 0, custom_fields: List[str] = None,
-                        export_type: str = None, individual_files: bool = False) -> bool:
+                        export_type: str = None, individual_files: bool = False, logo_level: int = 0) -> bool:
         """
         Export library or media metadata to a file
 
@@ -475,6 +475,8 @@ def export_metadata(self, section_id: int = None, user_id: int = None, rating_ke
         :type export_type: str, optional
         :param individual_files: Export each item as an individual field for library/user export (default: False)
         :type individual_files: bool, optional
+        :param logo_level: Level of logo images to export (default: 0)
+        :type logo_level: int, optional
         :returns: `True` if successful, `False` if unsuccessful
         :rtype: bool
         """

tautulli/models/exports_table.py

@@ -21,6 +21,7 @@ class DatumModel(BaseModel):
     file_size: Optional[int] = None
     filename: Optional[Any] = None
     individual_files: Optional[int] = None
+    logo_level: Optional[int] = None
     media_info_level: Optional[int] = None
     media_type: Optional[str] = None
     media_type_title: Optional[str] = None

tautulli/models/metadata.py

@@ -83,6 +83,7 @@ class MediaInfoItemModel(BaseModel):
     channel_vcn: Optional[str] = None
     parts: Optional[List[PartModel]] = None
 
+
 class MarkerModel(BaseModel):
     id: Optional[int] = None
     type: Optional[str] = None
@@ -91,6 +92,7 @@ class MarkerModel(BaseModel):
     first: Optional[bool] = None
     final: Optional[bool] = None
 
+
 class MetadataModel(BaseModel):
     media_type: Optional[str] = None
     section_id: Optional[str] = None
@@ -146,6 +148,65 @@ class MetadataModel(BaseModel):
     media_info: Optional[List[MediaInfoItemModel]] = None
     edition_title: Optional[str] = None
     markers: Optional[MarkerModel] = None
+    slug: Optional[str] = None
+    parent_slug: Optional[str] = None
+    grandparent_slug: Optional[str] = None
+
+    @property
+    def is_movie(self) -> bool:
+        return self.media_type == "movie"
+
+    @property
+    def is_show(self) -> bool:
+        return self.media_type == "show"
+
+    @property
+    def is_season(self) -> bool:
+        return self.media_type == "season"
+
+    @property
+    def is_episode(self) -> bool:
+        return self.media_type == "episode"
+
+    @property
+    def is_artist(self) -> bool:
+        return self.media_type == "artist"
+
+    @property
+    def is_album(self) -> bool:
+        return self.media_type == "album"
+
+    @property
+    def is_track(self) -> bool:
+        return self.media_type == "track"
+
+    @property
+    def is_clip(self) -> bool:
+        return self.media_type == "clip"
 
+    @property
+    def _plex_watch_url_slug(self) -> str:
+        if any([self.is_movie, self.is_show, self.is_artist, self.is_clip]):
+            return self.slug
+        elif any([self.is_season, self.is_album]):
+            return self.parent_slug
+        elif any([self.is_episode, self.is_track]):
+            return self.grandparent_slug
+        return ""
 
+    @property
+    def _plex_watch_url_type(self) -> str:
+        if self.is_movie:
+            return "movie"
+        elif any([self.is_show, self.is_season, self.is_episode]):
+            return "show"
+        else:
+            return ""
 
+    @property
+    def plex_watch_url(self) -> str:
+        _prefix = self._plex_watch_url_type
+        _slug = self._plex_watch_url_slug
+        if not _prefix or not _slug:
+            return ""
+        return f"https://watch.plex.tv/{_prefix}/{_slug}"