Extract includeGuids inclusion for parent/child searches into a mixin

Author: Touchstone64

plexapi/mixins/__init__.py

@@ -29,7 +29,7 @@
 from .split_merge import SplitMergeMixin
 from .unmatch_match import UnmatchMatchMixin
 from .watchlist import WatchlistMixin
-
+from .tv_parent_child import TvParentChildMixin
 
 class MovieEditMixins(
     ArtLockMixin, PosterLockMixin, ThemeLockMixin,
@@ -140,23 +140,26 @@ class ShowMixins(
     AdvancedSettingsMixin, SplitMergeMixin, UnmatchMatchMixin, ExtrasMixin, HubsMixin, RatingMixin,
     ArtMixin, LogoMixin, PosterMixin, SquareArtMixin, ThemeMixin,
     ShowEditMixins,
-    WatchlistMixin
+    WatchlistMixin,
+    TvParentChildMixin
 ):
     pass
 
 
 class SeasonMixins(
     AdvancedSettingsMixin, ExtrasMixin, RatingMixin,
     ArtMixin, LogoMixin, PosterMixin, SquareArtMixin, ThemeUrlMixin,
-    SeasonEditMixins
+    SeasonEditMixins,
+    TvParentChildMixin
 ):
     pass
 
 
 class EpisodeMixins(
     ExtrasMixin, RatingMixin,
     ArtMixin, LogoMixin, PosterMixin, SquareArtMixin, ThemeUrlMixin,
-    EpisodeEditMixins
+    EpisodeEditMixins,
+    TvParentChildMixin
 ):
     pass
 

plexapi/mixins/tv_parent_child.py

@@ -0,0 +1,16 @@
+from plexapi import utils
+
+class TvParentChildMixin:
+    """ Mixin for Plex objects that have parent/child relationships (episode/season/show). """
+
+    def _buildRelationKey(self, key, **kwargs):
+        """ Returns a key suitable for fetching parent/child TV items """
+        args = {}
+
+        args['includeGuids'] = int(bool(kwargs.pop('includeGuids', True)))
+        for name, value in list(kwargs.items()):
+            args[name] = value
+
+        params = utils.joinArgs(args).lstrip('?')
+
+        return f"{key}?{params}"