g¿ddlmZddlmZddlmZmZmZmZddlm Z m Z m Z m Z m Z mZddlmZmZmZddlmZmZddlmZmZGdd ZGd d ZGd d ZGddZGddZGddZGddZGddZ GddZ!GddZ"Gdde!e"Z#GddZ$Gd d!Z%Gd"d#e$e%Z&Gd$d%Z'Gd&d'Z(Gd(d)e'e(Z)Gd*d+Z*Gd,d-Z+Gd.d/e*e+Z,Gd0d1Z-Gd2d3e-Z.Gd4d5e-Z/Gd6d7e-Z0Gd8d9e-Z1Gd:d;e-Z2Gd<d=e-Z3Gd>d?e-Z4Gd@dAe-Z5GdBdCe-Z6GdDdEe-Z7GdFdGe-Z8GdHdIe-Z9GdJdKe-Z:GdLdMe-Z;GdNdOe-Z<GdPdQe-Z=GdRdSe-Z>GdTdUZ?GdVdWe?Z@GdXdYe?ZAGdZd[e?ZBGd\d]e?ZCGd^d_e?ZDGd`dae?ZEGdbdce?ZFGdddee?ZGGdfdge?ZHGdhdie?ZIGdjdke?ZJGdldmZKGdndoe"e(e+e.e/e0e1e2e3e4e5e6e7e8e9e>e@eAeBeCeDeFeJZLGdpdqe"e(e+e.e/e0e1e3e4e5e6e7e8e9e>e@eCeDZMGdrdse"e(e+e.e/e1e7e9e>e@eD ZNGdtdue"e(e+e.e/e0e1e3e5e7e9e>e@eBeDeJZOGdvdwe"e(e+e.e/e1e5e7e9e>e@eAeCeDeEeGeHZPGdxdye"e(e+e.e/e1e3e5e6e7e9e>e@eCeDeEeHZQGdzd{e"e(e+e.e/e1e9e:e;ee@eCeDeEZRGd|d}e"e(e.e5e7e9e> ZSGd~de"e(e.e=e5e7e9e>eI ZTGdde"e(e+e.e/e0e1e5e7e9e>eDZUGdde"e(e5e7e9ZVy))deque)datetime)DequeSetTupleUnion) parse_qslquote quote_plusunquote urlencodeurlsplit)mediasettingsutils) BadRequestNotFound) deprecated openOrReadc(eZdZdZdZdZdZdZy)AdvancedSettingsMixinz9 Mixin for Plex objects that can have advanced settings. cd|jd}|j|tjdS)zC Returns a list of :class:`~plexapi.settings.Preferences` objects. z?includePreferences=1 Preferences)clsrtag)key fetchItemsrrselfrs #/opt/Tautulli/lib/plexapi/mixins.py preferencesz!AdvancedSettingsMixin.preferencess. /0s(<(<=QQc |j} tfd|DS#t$r?|Dcgc]}|jncc}w}}t dd|j d|dwxYw)z Returns a :class:`~plexapi.settings.Preferences` object for the specified pref. Parameters: pref (str): The id of the preference to return. c3BK|]}|jk(s|ywN)id).0pprefs r z3AdvancedSettingsMixin.preference..s9aADDDL9szUnknown preference "z" for z. Available preferences: N)r!next StopIterationr&rTYPE)rr)prefsr(availablePrefss ` r preferencez AdvancedSettingsMixin.preferences   " Q9599 9 Q,12qadd22N21$vdii[I55C4DFGLP Q Qs' A/A(A/c zi}|jd}|jDcic]}|js|j|}}|j D]_\}} ||}|j}|j||jt|r|||<Ht |dt||t|z} |jj| |jjj|Scc}w#t $r(t |dt|jwxYw)z) Edit a Plex object's advanced settings. /prefs?z not found in method)rr! enumValuesr&itemsKeyErrorrlistkeysgetstrr _serverquery_sessionput) rkwargsdatarr)r! settingIDvaluer5urls r editAdvancedz"AdvancedSettingsMixin.editAdvanced"s2 '"151A1A1CWttww}W W &  K Iu S"9-J~~eZ^^CJ%?@"'Y%tJ7G6HIJJ KIdO# 3t||'<'<'@'@A X S%tKr?)rrArr0rDs r defaultAdvancedz%AdvancedSettingsMixin.defaultAdvanced6s} '"**, 5J","4"4D  5IdO# 3t||'<'<'@'@A r"N)__name__ __module__ __qualname____doc__r!r0rErHr"r rr sCR Q(r"rc\eZdZdZd deeeefdeeedfde fdZ ddde fdZ d Z y) SmartFilterMixinz5 Mixin for Plex objects that can have smart filters. NfeedreturnOnreturncg}d}| td}n|jdddg}|r|j\}}|dk(r"|j|j ||nI||vr|dk(s|j ||fn/||vr|r||k(s t d|}n|j||i|r|st|dkDr|d}|r||iS|jS) z< Parse filter groups from input lines between push and pop. NpopandorpushzAcannot have different logical operators for the same filter groupr) setaddpopleftappend_parseFilterGroups appendleft ValueErrorlenrT)rrPrQcurrentFiltersStackoperatorForStackallowedLogicalOperatorsrrCs r r]z#SmartFilterMixin._parseFilterGroupsDs*,  5zH LL #($-JCf}#**++D(;e|OOS%L1//#,<,C$($' $**C<814 C(;$ *r"rOceZdZdZdZdZy)SplitMergeMixinz6 Mixin for Plex objects that can be split and merged. c|jd}|jj||jjj|S)z5 Split duplicated Plex object into separate objects. z/splitr3rr<r=r>r?rs r rpzSplitMergeMixin.splits> &! 3t||'<'<'@'@A r"ct|tst|jd}|jddj d|D}|j j||j jj|S)z Merge other Plex objects into the current object. Parameters: ratingKeys (list): A list of rating keys to merge. rlz /merge?ids=c32K|]}t|ywr%)r;)r'rs r r*z(SplitMergeMixin.merge..s.J!s1v.Jsr3) isinstancer8r;rprjoinr<r=r>r?)r ratingKeysrs r mergezSplitMergeMixin.mergesr *d+Z..s3J +chh.Jz.J&J%KL 3t||'<'<'@'@A r"N)rIrJrKrLrprrMr"r rrs@ r"rc&eZdZdZdZddZddZy)UnmatchMatchMixinz; Mixin for Plex objects that can be unmatched and matched. c|jd}|jj||jjjy)z' Unmatches metadata match from object. z/unmatchr3Nrrs r unmatchzUnmatchMatchMixin.unmatchs9 (# 3t||'<'<'@'@Ar"Nc|jd}ddi}|rSt|||gsE|jj|d<t j |j||d<ntd||||fDr||j |d<n||d<|t|dd |d<n||d<|xs|jj|d<||jj|d<n't j |j||d<|d zt|z}|j|tj S) a Return list of (:class:`~plexapi.media.SearchResult`) metadata matches. Parameters: agent (str): Agent name to be used (imdb, thetvdb, themoviedb, etc.) title (str): Title of item to search for year (str): Year of item to search in language (str) : Language of item to search in Examples: 1. video.matches() 2. video.matches(title="something", year=2020) 3. video.matches(title="something") 4. video.matches(year=2020) 5. video.matches(title="something", year="") 6. video.matches(title="", year=2020) 7. video.matches(title="", year="") 1. The default behaviour in Plex Web = no params in plexapi 2. Both title and year specified by user 3. Year automatically filled in 4. Title automatically filled in 5. Explicitly searches for title with blank year 6. Explicitly searches for blank title with year 7. I don't know what the user is thinking... return the same result as 1 For 2 to 7, the agent and language is automatically filled in z/matchesmanualrXlanguageagentc3$K|]}|du ywr%rM)r'xs r r*z,UnmatchMatchMixin.matches..sIQ1D=Istitleyear?r) ranysectionrrgetAgentIdentifierrgetattrrr rr SearchResult)rrrrrrparamss r matcheszUnmatchMatchMixin.matchess/8 (#A eT845!%!8!8F: #66t||~uMF7OI5%x*HII=&*jjF7O&+F7O<%,T62%>F6N%)F6N%-%H1H1Hz"=&*lln&:&:F7O&+&>&>t||~u&UF7OCi)F++s(:(:;;r"cd|jd}|r,|j|}|r|d}ntd|d|d|s td|j|jd}|d zt |z}|j j||j jj |S) a Use match result to update show metadata. Parameters: auto (bool): True uses first match from matches False allows user to provide the match searchResult (:class:`~plexapi.media.SearchResult`): Search result from ~plexapi.base.matches() agent (str): Agent name to be used (imdb, thetvdb, themoviedb, etc.) z/match)rrz$No matches found using this agent: (:)zZfixMatch() requires either auto=True or searchResult=:class:`~plexapi.media.SearchResult`.)guidnamerr3) rrrrrr r<r=r>r?)r searchResultautorr autoMatchrrAs r fixMatchzUnmatchMatchMixin.fixMatchs &!  5 1I(| !EeWAi[XYZ[[PQ Q'++&++-Sy9V,, 4 (=(=(A(AB r")NNNN)NFN)rIrJrKrLrrrrMr"r rrsEB 6-r"rcHeZdZdZedZdZdZedZdZ dZ y) PlayedUnplayedMixinz@ Mixin for Plex objects that can be marked played and unplayed. cN|jrt|jdkDSdS)z' Returns True if this video is played. rF) viewCountboolrs r isPlayedzPlayedUnplayedMixin.isPlayed)s#,0>>tDNNQ&'DuDr"cbd}|jdd}|jj|||S)z! Mark the Plex object as played. z /:/scrobblecom.plexapp.plugins.libraryr identifierr ratingKeyr<r=rrrs r markPlayedzPlayedUnplayedMixin.markPlayed.s27TU 3v. r"cbd}|jdd}|jj|||S)z# Mark the Plex object as unplayed. z /:/unscrobblerrrrrs r markUnplayedz PlayedUnplayedMixin.markUnplayed5s27TU 3v. r"c|jS)z Alias to self.isPlayed. )rrs r isWatchedzPlayedUnplayedMixin.isWatched<}}r"c$|jy)zB Alias to :func:`~plexapi.mixins.PlayedUnplayedMixin.markPlayed`. N)rrs r markWatchedzPlayedUnplayedMixin.markWatchedAs  r"c$|jy)zD Alias to :func:`~plexapi.mixins.PlayedUnplayedMixin.markUnplayed`. N)rrs r markUnwatchedz!PlayedUnplayedMixin.markUnwatchedEs r"N) rIrJrKrLpropertyrrrrrrrMr"r rr&sAJ EEr"rceZdZdZddZy) RatingMixinz9 Mixin for Plex objects that can have user star ratings. Nc|d}n+t|ttfr |dks|dkDr tdd|jd|}|j j ||j jj|S)aI Rate the Plex object. Note: Plex ratings are displayed out of 5 stars (e.g. rating 7.0 = 3.5 stars). Parameters: rating (float, optional): Rating from 0 to 10. Exclude to reset the rating. Raises: :exc:`~plexapi.exceptions.BadRequest`: If the rating is invalid. r zRating must be between 0 to 10.z /:/rate?key=z/&identifier=com.plexapp.plugins.library&rating=r3) rrnfloatrrr<r=r>r?)rratingrs r ratezRatingMixin.rateMsz >FFS%L1VaZ6B;>? ?T^^,,[\b[cd 3t||'<'<'@'@A r"r%)rIrJrKrLrrMr"r rrJs Cr"rc eZdZdZedZy) ArtUrlMixinz@ Mixin for Plex objects that can have a background artwork url. ch|jdd}|r|jj|dSdS)z) Return the art url for the Plex object. artgrandparentArtT includeTokenN firstAttrr<rDrrs r artUrlzArtUrlMixin.artUrlbs6nnU$45;>t||$7HDHr"N)rIrJrKrLrrrMr"r rr_sJ IIr"rceZdZdZdZdZy) ArtLockMixinzC Mixin for Plex objects that can have a locked background artwork. c*|jdiddiS)z0 Lock the background artwork for a Plex object. art.lockedrXrM_editrs r lockArtzArtLockMixin.lockArtltzz.\1-..r"c*|jdiddiS)z2 Unlock the background artwork for a Plex object. rrrMrrs r unlockArtzArtLockMixin.unlockArtprr"N)rIrJrKrLrrrMr"r rrisM//r"rc$eZdZdZdZddZdZy)ArtMixinz: Mixin for Plex objects that can have background artwork. c`|jd|jdtjS)z@ Returns list of available :class:`~plexapi.media.Art` objects. /library/metadata//artsr)rrrArtrs r artsz ArtMixin.artsxs(!3DNN3C5IuyyYYr"Ncl|rXd|jdt|}|jj||jjj |S|rWd|jd}t |}|jj||jjj ||S)z Upload a background artwork from a url or filepath. Parameters: url (str): The full URL to the image to upload. filepath (str): The full file path the the image to upload or file-like object. rz /arts?url=r3rr4rArr r<r=r>postrrrDfilepathrrAs r uploadArtzArtMixin.uploadArt|s &t~~&6jC@QRC LL  s4<<+@+@+E+E  F  &t~~&6e.sFA+0EaFsNTr)r+imagesr<rD)rimages r logoUrlzLogoUrlMixin.logoUrls?FFMAFt|| =PDPr"N)rIrJrKrLrrrMr"r rrs< QQr"rceZdZdZdZdZy) LogoLockMixinz5 Mixin for Plex objects that can have a locked logo. ctd)z" Lock the logo for a Plex object. z&Logo cannot be locked through the API.NotImplementedErrorrs r lockLogozLogoLockMixin.lockLogos!"JKKr"ctd)z$ Unlock the logo for a Plex object. z(Logo cannot be unlocked through the API.r rs r unlockLogozLogoLockMixin.unlockLogos!"LMMr"N)rIrJrKrLr rrMr"r rrs?LNr"rc$eZdZdZdZddZdZy) LogoMixinz- Mixin for Plex objects that can have logos. c`|jd|jdtjS)zA Returns list of available :class:`~plexapi.media.Logo` objects. r /clearLogosr)rrrLogors r logoszLogoMixin.logoss+!3DNN3C;OUZU_U_``r"Ncl|rXd|jdt|}|jj||jjj |S|rWd|jd}t |}|jj||jjj ||S)z Upload a logo from a url or filepath. Parameters: url (str): The full URL to the image to upload. filepath (str): The full file path the the image to upload or file-like object. rz/clearLogos?url=r3rrrrs r uploadLogozLogoMixin.uploadLogos &t~~&66FzRUFWXC LL  s4<<+@+@+E+E  F  &t~~&6kBCh'D LL  s4<<+@+@+E+ED  Q r"ctd)z Set the logo for a Plex object. Raises: :exc:`~plexapi.exceptions.NotImplementedError`: Logo cannot be set through the API. zTLogo cannot be set through the API. Re-upload the logo using "uploadLogo" to set it.r )rlogos r setLogozLogoMixin.setLogos " ?  r"r)rIrJrKrLrrrrMr"r rrs7a  r"rc0eZdZdZedZedZy)PosterUrlMixinz4 Mixin for Plex objects that can have a poster url. cj|jddd}|r|jj|dSdS)z+ Return the thumb url for the Plex object. thumb parentThumbgrandparentThumbTrNr)rrs r thumbUrlzPosterUrlMixin.thumbUrl8w 7IJ=Bt||D9LLr"c|jS)z Alias to self.thumbUrl. )r rs r posterUrlzPosterUrlMixin.posterUrlrr"N)rIrJrKrLrr r#rMr"r rrs-> MM r"rceZdZdZdZdZy)PosterLockMixinz7 Mixin for Plex objects that can have a locked poster. c*|jdiddiS)z$ Lock the poster for a Plex object. thumb.lockedrXrMrrs r lockPosterzPosterLockMixin.lockPostertzz0^Q/00r"c*|jdiddiS)z& Unlock the poster for a Plex object. r'rrMrrs r unlockPosterzPosterLockMixin.unlockPosterr)r"N)rIrJrKrLr(r+rMr"r r%r%sA11r"r%c$eZdZdZdZddZdZy) PosterMixinz/ Mixin for Plex objects that can have posters. c`|jd|jdtjS)zC Returns list of available :class:`~plexapi.media.Poster` objects. r/postersr)rrrPosterrs r posterszPosterMixin.posterss+!3DNN3C8LRWR^R^__r"Ncl|rXd|jdt|}|jj||jjj |S|rWd|jd}t |}|jj||jjj ||S)z Upload a poster from a url or filepath. Parameters: url (str): The full URL to the image to upload. filepath (str): The full file path the the image to upload or file-like object. rz /posters?url=r3r/rrrs r uploadPosterzPosterMixin.uploadPosters &t~~&6mJsOCTUC LL  s4<<+@+@+E+E  F  &t~~&6h?Ch'D LL  s4<<+@+@+E+ED  Q r"c&|j|S)z Set the poster for a Plex object. Parameters: poster (:class:`~plexapi.media.Poster`): The poster object to select. r)rposters r setPosterzPosterMixin.setPosters   r"r)rIrJrKrLr1r3r6rMr"r r-r-s9` r"r-c eZdZdZedZy) ThemeUrlMixinz3 Mixin for Plex objects that can have a theme url. cj|jddd}|r|jj|dSdS)z+ Return the theme url for the Plex object. theme parentThemegrandparentThemeTrNrrr:s r themeUrlzThemeUrlMixin.themeUrlr!r"N)rIrJrKrLrr>rMr"r r8r8 s= MMr"r8ceZdZdZdZdZy)ThemeLockMixinz6 Mixin for Plex objects that can have a locked theme. c*|jdiddiS)z# Lock the theme for a Plex object. theme.lockedrXrMrrs r lockThemezThemeLockMixin.lockThemer)r"c*|jdiddiS)z% Unlock the theme for a Plex object. rBrrMrrs r unlockThemezThemeLockMixin.unlockThemer)r"N)rIrJrKrLrCrErMr"r r@r@s@11r"r@c$eZdZdZdZddZdZy) ThemeMixinz. Mixin for Plex objects that can have themes. c`|jd|jdtjS)zB Returns list of available :class:`~plexapi.media.Theme` objects. r/themesr)rrrThemers r themeszThemeMixin.themes$s+!3DNN3C7KQVQ\Q\]]r"Ncp|rYd|jdt|}|jj||jjj ||S|rXd|jd}t |}|jj||jjj |||S)a Upload a theme from url or filepath. Warning: Themes cannot be deleted using PlexAPI! Parameters: url (str): The full URL to the theme to upload. filepath (str): The full file path to the theme to upload or file-like object. timeout (int, optional): Timeout, in seconds, to use when uploading themes to the server. (default config.TIMEOUT). rz /themes?url=)r4timeoutrI)r4rArMr)rrDrrMrrAs r uploadThemezThemeMixin.uploadTheme(s &t~~&6l:c?BSTC LL  s4<<+@+@+E+Ew  W  &t~~&6g>Ch'D LL  s4<<+@+@+E+EDZa  b r"ctd)z Set the theme for a Plex object. Raises: :exc:`~plexapi.exceptions.NotImplementedError`: Themes cannot be set through the API. zXThemes cannot be set through the API. Re-upload the theme using "uploadTheme" to set it.r r=s r setThemezThemeMixin.setTheme<s " A  r")NNN)rIrJrKrLrKrNrPrMr"r rGrG!s8^(  r"rGceZdZdZddZy)EditFieldMixinz' Mixin for editing Plex object fields. c p|d|xsd|d|rdndi}|j||jdi|S)a Edit the field of a Plex object. All field editing methods can be chained together. Also see :func:`~plexapi.base.PlexPartialObject.batchEdits` for batch editing fields. Parameters: field (str): The name of the field to edit. value (str): The value to edit the field to. locked (bool): True (default) to lock the field, False to unlock the field. Example: .. code-block:: python # Chaining multiple field edits with reloading Movie.editTitle('A New Title').editSummary('A new summary').editTagline('A new tagline').reload() z.valuer.lockedrXrrM)updater)rfieldrClockedr@editss r editFieldzEditFieldMixin.editFieldKsM$gV ekrgW Fq   Vtzz"E""r"NT)rIrJrKrLrYrMr"r rRrRHs 1#r"rRceZdZdZddZy) AddedAtMixinz8 Mixin for Plex objects that can have an added at date. ct|tr7ttt j |dj }n2t|tr"tt|j }|jd||S)a- Edit the added at date. Parameters: addedAt (int or str or datetime): The new value as a unix timestamp (int), "YYYY-MM-DD" (str), or datetime object. locked (bool): True (default) to lock the field, False to unlock the field. %Y-%m-%daddedAtrW)rr;rnroundrstrptime timestamprY)rr_rWs r editAddedAtzAddedAtMixin.editAddedAtgsj gs #% 1 1': F P P RSTG  *% 1 1 345G~~i~@@r"NrZ)rIrJrKrLrdrMr"r r\r\ds B Ar"r\ceZdZdZddZy)AudienceRatingMixinz: Mixin for Plex objects that can have an audience rating. c*|jd||S)z Edit the audience rating. Parameters: audienceRating (float): The new value. locked (bool): True (default) to lock the field, False to unlock the field. audienceRatingr`rY)rrhrWs r editAudienceRatingz&AudienceRatingMixin.editAudienceRatingys~~.v~NNr"NrZ)rIrJrKrLrjrMr"r rfrfvs DOr"rfceZdZdZddZy)ContentRatingMixinz8 Mixin for Plex objects that can have a content rating. c*|jd||S)z Edit the content rating. Parameters: contentRating (str): The new value. locked (bool): True (default) to lock the field, False to unlock the field. contentRatingr`ri)rrnrWs r editContentRatingz$ContentRatingMixin.editContentRating~~o}V~LLr"NrZ)rIrJrKrLrorMr"r rlrls BMr"rlceZdZdZddZy)CriticRatingMixinz7 Mixin for Plex objects that can have a critic rating. c*|jd||S)z Edit the critic rating. Parameters: criticRating (float): The new value. locked (bool): True (default) to lock the field, False to unlock the field. rr`ri)r criticRatingrWs r editCriticRatingz"CriticRatingMixin.editCriticRatings~~h V~DDr"NrZ)rIrJrKrLrurMr"r rrrrs AEr"rrceZdZdZddZy)EditionTitleMixinz8 Mixin for Plex objects that can have an edition title. c*|jd||S)z Edit the edition title. Plex Pass is required to edit this field. Parameters: editionTitle (str): The new value. locked (bool): True (default) to lock the field, False to unlock the field. editionTitler`ri)rryrWs r editEditionTitlez"EditionTitleMixin.editEditionTitles~~nl6~JJr"NrZ)rIrJrKrLrzrMr"r rwrws BKr"rwceZdZdZddZy)OriginallyAvailableMixinzD Mixin for Plex objects that can have an originally available date. clt|tr|jd}|jd||S)a  Edit the originally available date. Parameters: originallyAvailable (str or datetime): The new value "YYYY-MM-DD (str) or datetime object. locked (bool): True (default) to lock the field, False to unlock the field. r^originallyAvailableAtr`rrstrftimerY)roriginallyAvailablerWs r editOriginallyAvailablez0OriginallyAvailableMixin.editOriginallyAvailables8 )8 4"5">">z"J ~~57JSY~ZZr"NrZ)rIrJrKrLrrMr"r r|r|s N [r"r|ceZdZdZddZy)OriginalTitleMixinz9 Mixin for Plex objects that can have an original title. c*|jd||S)z Edit the original title. Parameters: originalTitle (str): The new value. locked (bool): True (default) to lock the field, False to unlock the field. originalTitler`ri)rrrWs r editOriginalTitlez$OriginalTitleMixin.editOriginalTitlerpr"NrZ)rIrJrKrLrrMr"r rrs CMr"rceZdZdZddZy)SortTitleMixinz4 Mixin for Plex objects that can have a sort title. c*|jd||S)z Edit the sort title. Parameters: sortTitle (str): The new value. locked (bool): True (default) to lock the field, False to unlock the field. titleSortr`ri)r sortTitlerWs r editSortTitlezSortTitleMixin.editSortTitles~~k9V~DDr"NrZ)rIrJrKrLrrMr"r rrs >Er"rceZdZdZddZy) StudioMixinz0 Mixin for Plex objects that can have a studio. c*|jd||S)z Edit the studio. Parameters: studio (str): The new value. locked (bool): True (default) to lock the field, False to unlock the field. studior`ri)rrrWs r editStudiozStudioMixin.editStudios~~hv~>>r"NrZ)rIrJrKrLrrMr"r rrs :?r"rceZdZdZddZy) SummaryMixinz1 Mixin for Plex objects that can have a summary. c*|jd||S)z Edit the summary. Parameters: summary (str): The new value. locked (bool): True (default) to lock the field, False to unlock the field. summaryr`ri)rrrWs r editSummaryzSummaryMixin.editSummary~~i~@@r"NrZ)rIrJrKrLrrMr"r rr ;Ar"rceZdZdZddZy) TaglineMixinz1 Mixin for Plex objects that can have a tagline. c*|jd||S)z Edit the tagline. Parameters: tagline (str): The new value. locked (bool): True (default) to lock the field, False to unlock the field. tagliner`ri)rrrWs r editTaglinezTaglineMixin.editTaglinerr"NrZ)rIrJrKrLrrMr"r rrrr"rceZdZdZddZy) TitleMixinz/ Mixin for Plex objects that can have a title. cni}|jdk(r|j|d<|jd|fd|i|S)z Edit the title. Parameters: title (str): The new value. locked (bool): True (default) to lock the field, False to unlock the field. albumzartist.id.valuerrW)r-parentRatingKeyrY)rrrWr@s r editTitlezTitleMixin.editTitlesC 99 (,(<( or List<:class:`~plexapi.media.MediaTag`>): List of tags to add or remove. locked (bool): True (default) to lock the tags, False to unlock the tags. remove (bool): True to remove the tags in items. Example: .. code-block:: python # Chaining multiple tag edits with reloading Show.addCollection('New Collection').removeGenre('Action').addLabel('Favorite').reload() rM)rr8r _tagPlural _tagHelper _tagSingularrUr)rrr6rWrr@tagsrXs r rzEditTagsMixin.editTagsUs$%&GE4!5r:D$%u  1 1# 6vvN Vtzz"E""r"c8|dk(ry|dk(ry|ddk(r|ddS|S)z$ Return the singular name of a tag. countriescountrysimilarrsNrMrs r rzEditTagsMixin._tagSingularss5 +  I  W^s8O r"c8|dk(ry|dk(ry|ddk7r|dzS|S)z" Return the plural name of a tag. rrrrrrMrs r rzEditTagsMixin._tagPlural~s4 )  I  W^9  r"ct|ts|g}|d|rdndi}|r"|d}djd|D||<|St|D]\}}t |d|d}|||<|S) z: Return a dict of the query parameters for editing a tag. rTrXrz [].tag.tag-rlc3DK|]}tt|ywr%)r r;)r'ts r r*z+EditTagsMixin._tagHelper..s$BqU3q6]$Bs [z ].tag.tag)rr8r enumerater;)rr6rWrrAtagnameritems r rzEditTagsMixin._tagHelpers%&GEe7O&Qa  [)GHH$BE$BBDM  %U+ %4 XJas)4 $W  % r"N)TF) rIrJrKrLrrr staticmethodrrrrMr"r rrNs^/()9*9#<r"rc eZdZdZddZddZy)CollectionMixinz3 Mixin for Plex objects that can have collections. c*|jd||S)z Add a collection tag(s). Parameters: collections (List or List<:class:`~plexapi.media.MediaTag`>): List of tags. locked (bool): True (default) to lock the field, False to unlock the field. collectionr`rr collectionsrWs r addCollectionzCollectionMixin.addCollections}}\;v}FFr"c,|jd||dS)z Remove a collection tag(s). Parameters: collections (List or List<:class:`~plexapi.media.MediaTag`>): List of tags. locked (bool): True (default) to lock the field, False to unlock the field. rTrWrrrs r removeCollectionz CollectionMixin.removeCollections}}\;vd}SSr"NrZ)rIrJrKrLrrrMr"r rrs=GTr"rc eZdZdZddZddZy) CountryMixinz1 Mixin for Plex objects that can have countries. c*|jd||S)z Add a country tag(s). Parameters: countries (List or List<:class:`~plexapi.media.MediaTag`>): List of tags. locked (bool): True (default) to lock the field, False to unlock the field. rr`rrrrWs r addCountryzCountryMixin.addCountrys}}Y &}AAr"c,|jd||dS)z Remove a country tag(s). Parameters: countries (List or List<:class:`~plexapi.media.MediaTag`>): List of tags. locked (bool): True (default) to lock the field, False to unlock the field. rTrrrs r removeCountryzCountryMixin.removeCountrys}}Y &}NNr"NrZ)rIrJrKrLrrrMr"r rrs;BOr"rc eZdZdZddZddZy) DirectorMixinz1 Mixin for Plex objects that can have directors. c*|jd||S)z Add a director tag(s). Parameters: directors (List or List<:class:`~plexapi.media.MediaTag`>): List of tags. locked (bool): True (default) to lock the field, False to unlock the field. directorr`rr directorsrWs r addDirectorzDirectorMixin.addDirector}}Z6}BBr"c,|jd||dS)z Remove a director tag(s). Parameters: directors (List or List<:class:`~plexapi.media.MediaTag`>): List of tags. locked (bool): True (default) to lock the field, False to unlock the field. rTrrrs r removeDirectorzDirectorMixin.removeDirector}}Z6$}OOr"NrZ)rIrJrKrLrrrMr"r rr;CPr"rc eZdZdZddZddZy) GenreMixinz. Mixin for Plex objects that can have genres. c*|jd||S)z Add a genre tag(s). Parameters: genres (List or List<:class:`~plexapi.media.MediaTag`>): List of tags. locked (bool): True (default) to lock the field, False to unlock the field. genrer`rrgenresrWs r addGenrezGenreMixin.addGenre}}WfV}< or List<:class:`~plexapi.media.MediaTag`>): List of tags. locked (bool): True (default) to lock the field, False to unlock the field. rTrrrs r removeGenrezGenreMixin.removeGenre}}WfVD}IIr"NrZ)rIrJrKrLrrrMr"r rr8=Jr"rc eZdZdZddZddZy) LabelMixinz. Mixin for Plex objects that can have labels. c*|jd||S)z Add a label tag(s). Parameters: labels (List or List<:class:`~plexapi.media.MediaTag`>): List of tags. locked (bool): True (default) to lock the field, False to unlock the field. labelr`rrlabelsrWs r addLabelzLabelMixin.addLabelrr"c,|jd||dS)z Remove a label tag(s). Parameters: labels (List or List<:class:`~plexapi.media.MediaTag`>): List of tags. locked (bool): True (default) to lock the field, False to unlock the field. rTrrr s r removeLabelzLabelMixin.removeLabelrr"NrZ)rIrJrKrLr r rMr"r rrrr"rc eZdZdZddZddZy) MoodMixinz- Mixin for Plex objects that can have moods. c*|jd||S)z Add a mood tag(s). Parameters: moods (List or List<:class:`~plexapi.media.MediaTag`>): List of tags. locked (bool): True (default) to lock the field, False to unlock the field. moodr`rrmoodsrWs r addMoodzMoodMixin.addMoods}}VU6}::r"c,|jd||dS)z Remove a mood tag(s). Parameters: moods (List or List<:class:`~plexapi.media.MediaTag`>): List of tags. locked (bool): True (default) to lock the field, False to unlock the field. rTrrrs r removeMoodzMoodMixin.removeMoods}}VU6$}GGr"NrZ)rIrJrKrLrrrMr"r rr s7;Hr"rc eZdZdZddZddZy) ProducerMixinz1 Mixin for Plex objects that can have producers. c*|jd||S)z Add a producer tag(s). Parameters: producers (List or List<:class:`~plexapi.media.MediaTag`>): List of tags. locked (bool): True (default) to lock the field, False to unlock the field. producerr`rr producersrWs r addProducerzProducerMixin.addProducer%rr"c,|jd||dS)z Remove a producer tag(s). Parameters: producers (List or List<:class:`~plexapi.media.MediaTag`>): List of tags. locked (bool): True (default) to lock the field, False to unlock the field. rTrrrs r removeProducerzProducerMixin.removeProducer.rr"NrZ)rIrJrKrLrrrMr"r rr"rr"rc eZdZdZddZddZy)SimilarArtistMixinz7 Mixin for Plex objects that can have similar artists. c*|jd||S)z Add a similar artist tag(s). Parameters: artists (List or List<:class:`~plexapi.media.MediaTag`>): List of tags. locked (bool): True (default) to lock the field, False to unlock the field. rr`rrartistsrWs r addSimilarArtistz#SimilarArtistMixin.addSimilarArtist;s}}Y}??r"c,|jd||dS)z Remove a similar artist tag(s). Parameters: artists (List or List<:class:`~plexapi.media.MediaTag`>): List of tags. locked (bool): True (default) to lock the field, False to unlock the field. rTrrr#s r removeSimilarArtistz&SimilarArtistMixin.removeSimilarArtistDs}}Yt}LLr"NrZ)rIrJrKrLr%r'rMr"r r!r!8sA@Mr"r!c eZdZdZddZddZy) StyleMixinz. Mixin for Plex objects that can have styles. c*|jd||S)z Add a style tag(s). Parameters: styles (List or List<:class:`~plexapi.media.MediaTag`>): List of tags. locked (bool): True (default) to lock the field, False to unlock the field. styler`rrstylesrWs r addStylezStyleMixin.addStyleQrr"c,|jd||dS)z Remove a style tag(s). Parameters: styles (List or List<:class:`~plexapi.media.MediaTag`>): List of tags. locked (bool): True (default) to lock the field, False to unlock the field. r+Trrr,s r removeStylezStyleMixin.removeStyleZrr"NrZ)rIrJrKrLr.r0rMr"r r)r)Nrr"r)c eZdZdZddZddZy)TagMixinz, Mixin for Plex objects that can have tags. c*|jd||S)z Add a tag(s). Parameters: tags (List or List<:class:`~plexapi.media.MediaTag`>): List of tags. locked (bool): True (default) to lock the field, False to unlock the field. rr`rrrrWs r addTagzTagMixin.addTaggs}}UD}88r"c,|jd||dS)z Remove a tag(s). Parameters: tags (List or List<:class:`~plexapi.media.MediaTag`>): List of tags. locked (bool): True (default) to lock the field, False to unlock the field. rTrrr4s r removeTagzTagMixin.removeTagps}}UD}EEr"NrZ)rIrJrKrLr5r7rMr"r r2r2ds69Fr"r2c eZdZdZddZddZy) WriterMixinz/ Mixin for Plex objects that can have writers. c*|jd||S)z Add a writer tag(s). Parameters: writers (List or List<:class:`~plexapi.media.MediaTag`>): List of tags. locked (bool): True (default) to lock the field, False to unlock the field. writerr`rrwritersrWs r addWriterzWriterMixin.addWriter}s}}Xwv}>>r"c,|jd||dS)z Remove a writer tag(s). Parameters: writers (List or List<:class:`~plexapi.media.MediaTag`>): List of tags. locked (bool): True (default) to lock the field, False to unlock the field. r;Trrr<s r removeWriterzWriterMixin.removeWriters}}Xwvd}KKr"NrZ)rIrJrKrLr>r@rMr"r r9r9zs9?Lr"r9c0eZdZdZddZddZddZddZy)WatchlistMixinzA Mixin for Plex objects that can be added to a user's watchlist. Nc |xs|jj}|j|S#t$r|j}Y(wxYw)a Returns True if the item is on the user's watchlist. Also see :func:`~plexapi.myplex.MyPlexAccount.onWatchlist`. Parameters: account (:class:`~plexapi.myplex.MyPlexAccount`, optional): Account to check item on the watchlist. Note: This is required if you are not connected to a Plex server instance using the admin account. )r< myPlexAccountAttributeError onWatchlistraccounts r rFzWatchlistMixin.onWatchlistsK #=!;!;!=G""4(( #llG #s1A A c |xs|jj}|j||S#t$r|j}Y*wxYw)a Add this item to the specified user's watchlist. Also see :func:`~plexapi.myplex.MyPlexAccount.addToWatchlist`. Parameters: account (:class:`~plexapi.myplex.MyPlexAccount`, optional): Account to add item to the watchlist. Note: This is required if you are not connected to a Plex server instance using the admin account. )r<rDrEaddToWatchlistrGs r rJzWatchlistMixin.addToWatchlistsM #=!;!;!=G t$  #llG #3A  A c |xs|jj}|j||S#t$r|j}Y*wxYw)a Remove this item from the specified user's watchlist. Also see :func:`~plexapi.myplex.MyPlexAccount.removeFromWatchlist`. Parameters: account (:class:`~plexapi.myplex.MyPlexAccount`, optional): Account to remove item from the watchlist. Note: This is required if you are not connected to a Plex server instance using the admin account. )r<rDrEremoveFromWatchlistrGs r rMz"WatchlistMixin.removeFromWatchlistsM #=!;!;!=G ##D)  #llG #rKc |xs|jj}|jj ddd}|j |j d|d}|j|S#t$r|j}YhwxYw)a Return a list of :class:`~plexapi.media.Availability` objects for the available streaming services for this item. Parameters: account (:class:`~plexapi.myplex.MyPlexAccount`, optional): Account used to retrieve availability. Note: This is required if you are not connected to a Plex server instance using the admin account. /rXrrz/availabilities)r<rDrErrsplitr=METADATA findItems)rrHrrAs r streamingServicesz WatchlistMixin.streamingServicess #=!;!;!=GII$$S!,R0 }} 0 011CI;o^_~~d##  #llG #sA11B B r%)rIrJrKrLrFrJrMrSrMr"r rBrBsK )  $r"rBc eZdZy)MovieEditMixinsNrIrJrKrMr"r rUrU r"rUc eZdZy)ShowEditMixinsNrVrMr"r rYrYrWr"rYc eZdZy)SeasonEditMixinsNrVrMr"r r[r[  r"r[c eZdZy)EpisodeEditMixinsNrVrMr"r r^r^r\r"r^c eZdZy)ArtistEditMixinsNrVrMr"r r`r`r\r"r`c eZdZy)AlbumEditMixinsNrVrMr"r rbrbr\r"rbc eZdZy)TrackEditMixinsNrVrMr"r rdrdr\r"rdc eZdZy)PhotoalbumEditMixinsNrVrMr"r rfrf r"rfc eZdZy)PhotoEditMixinsNrVrMr"r riris  r"ric eZdZy)CollectionEditMixinsNrVrMr"r rkrk r\r"rkc eZdZy)PlaylistEditMixinsNrVrMr"r rmrm)rgr"rmN)Wrrrtypingrrrr urllib.parser r r r r rplexapirrrplexapi.exceptionsrr plexapi.utilsrrrrOrrrrrrrrrrrrrr%r-r8r@rGrRr\rfrlrrrwr|rrrrrrrrrrrrrrrrrrrr!r)r2r9rBrUrYr[r^r`rbrdrfrirkrmrMr"r rss++SS**3022jZ*Z*z.ZZz//--!!H*II / /{LBQQ N N  m  F   1 1./BMM 1 1$ $ N##8A>A$ O. O M M E E K K [~ [ M M E^ E ?. ? A> A A> AGG" K~ K C~ C H> H T^ T Gn GMM`TmT,O=O,PMP,JJ,JJ,H H,PMP,MM,JJ,F}F,L-L,=$=$@ />%'9;LN_0.|Z\=*j-Yd   />%'9;L0.+, OZ   />%'8*oZ   />%'9;LnlJ]J   />%'8L*o\:z9FXZd   />%'8nk<UdZY   />%'8 "24H/ZY   /., O  /(., Tc   />%'9;LL*o   /L* r"