gV= ,ddlZddlmZddlmZddlmZmZmZddl m Z m Z m Z ddl mZddlmZmZmZmZmZmZmZej.Gdd e eeeeZej.Gd d e e eeeeZej.Gd d e eZy)N)Path) quote_plus)mediautilsvideo)PlayablePlexPartialObject PlexSession) BadRequest) RatingMixin ArtUrlMixinArtMixinPosterUrlMixin PosterMixinPhotoalbumEditMixinsPhotoEditMixinscleZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d ZddZddZedZy ) Photoalbuma Represents a single Photoalbum (collection of photos). Attributes: TAG (str): 'Directory' TYPE (str): 'photo' addedAt (datetime): Datetime the photo album was added to the library. art (str): URL to artwork image (/library/metadata//art/). composite (str): URL to composite image (/library/metadata//composite/) fields (List<:class:`~plexapi.media.Field`>): List of field objects. guid (str): Plex GUID for the photo album (local://229674). images (List<:class:`~plexapi.media.Image`>): List of image objects. index (sting): Plex index number for the photo album. key (str): API URL (/library/metadata/). lastRatedAt (datetime): Datetime the photo album was last rated. librarySectionID (int): :class:`~plexapi.library.LibrarySection` ID. librarySectionKey (str): :class:`~plexapi.library.LibrarySection` key. librarySectionTitle (str): :class:`~plexapi.library.LibrarySection` title. listType (str): Hardcoded as 'photo' (useful for search filters). ratingKey (int): Unique key identifying the photo album. summary (str): Summary of the photoalbum. thumb (str): URL to thumbnail image (/library/metadata//thumb/). title (str): Name of the photo album. (Trip to Disney World) titleSort (str): Title to use when sorting (defaults to title). type (str): 'photo' updatedAt (datetime): Datetime the photo album was updated. userRating (float): Rating of the photo album (0.0 - 10.0) equaling (0 stars - 5 stars). Directoryphoto photoalbumctj|jjd|_|jjd|_|jjd|_|j|tj|_ |jjd|_ |j|tj|_ tjt|jjd|_|jjddj#dd|_tj|jjd |_tjt|jjd |_|jjd |_|jjd |_d |_tjt|jjd|_|jjd|_|jjd|_|jjd|_|jjd|j6|_|jjd|_tj|jjd|_tjt>|jjd|_ y)/ Load attribute values from Plex XML response. addedAtart compositeguidindexkey /children lastRatedAtlibrarySectionIDlibrarySectionKeylibrarySectionTitler ratingKeysummarythumbtitle titleSorttype updatedAt userRatingN)!r toDatetimeattribgetrrr findItemsrFieldfieldsrImageimagescastintrreplacerr"r#r$r%listTyper&r'r(r)r*r+r,floatr-selfdatas "/opt/Tautulli/lib/plexapi/photo.py _loadDatazPhotoalbum._loadData6s''  (BC ;;??5)5nnT5;;7 KKOOF+ nnT5;;7 ZZT[[__W%=> ;;??5"-55k2F ++DKKOOM,JK % 3 @R0S T!%1D!E#';;??3H#I  C)EF{{y1 [[__W- [[__W- djjAKKOOF+ ))$++//+*FG**UDKKOOL,IJcP|jd}|j|t|S)z Returns the :class:`~plexapi.photo.Photoalbum` that matches the specified title. Parameters: title (str): Title of the photo album to return. r! title__iexact)r fetchItemrr<r)rs r>albumzPhotoalbum.albumNs)  )$~~c:U~CCr@c P|jd}|j|tfi|S)zL Returns a list of :class:`~plexapi.photo.Photoalbum` objects in the album. r!)r fetchItemsrr<kwargsrs r>albumszPhotoalbum.albumsWs* )$tsJ9&99r@cP|jd}|j|t|S)z Returns the :class:`~plexapi.photo.Photo` that matches the specified title. Parameters: title (str): Title of the photo to return. r!rB)rrDPhotorEs r>rzPhotoalbum.photo\s)  )$~~c5~>>r@c P|jd}|j|tfi|S)zG Returns a list of :class:`~plexapi.photo.Photo` objects in the album. r!)rrHrMrIs r>photoszPhotoalbum.photoses* )$tsE4V44r@cd|jd}|j|tj|S)z Returns the :class:`~plexapi.video.Clip` that matches the specified title. Parameters: title (str): Title of the clip to return. r!rB)rrDrCliprEs r>clipzPhotoalbum.clipjs-  )$~~c5::U~CCr@c d|jd}|j|tjfi|S)zF Returns a list of :class:`~plexapi.video.Clip` objects in the album. r!)rrHrrQrIs r>clipszPhotoalbum.clipsss. )$tsEJJ9&99r@c$|j|S)z3 Alias to :func:`~plexapi.photo.Photoalbum.photo`. )episode)r<r)s r>r0zPhotoalbum.getxs||E""r@Nc0g}|jD]E}|r*tjj||jn|}||j ||z }G|j |jzD]}||j ||z }|S)a Download all photos and clips from the photo album. See :func:`~plexapi.base.Playable.download` for details. Parameters: savepath (str): Defaults to current working dir. keep_original_name (bool): True to keep the original filename otherwise a friendlier filename is generated. subfolders (bool): True to separate photos/clips in to photo album folders. )rKospathjoinr)downloadrOrT)r<savepathkeep_original_name subfolders filepathsrF _savepathrs r>r[zPhotoalbum.download|s [[] GE?I Xu{{;xI  3EF FI G[[]TZZ\1 FE 2DE EI Fr@cT|jj|d|jdSz3 Get the Plex Web URL with the correct parameters. details)baseendpointrlegacy)_server _buildWebURLrr<res r> _getWebURLzPhotoalbum._getWebURLs%||((dYDHH]^(__r@ctj|j}tt ddz |dz |dddz SzL Returns the Plex Media Server data directory where the metadata is stored. MetadataPhotosrrdNz.bundle)rsha1hashrstrrr< guid_hashs r>metadataDirectoryzPhotoalbum.metadataDirectorysGNN499- 4 #h.1=9QR=/QX@YYZZr@)NFFN)__name__ __module__ __qualname____doc__TAGTYPE _searchTyper?rFrKrrOrRrTr0r[rkpropertyrtr@r>rrsd6 C DKK0D: ?5 D: #"`[[r@rcdeZdZdZdZdZdZdZdZdZ dZ e dZ d d Z d d Ze d Zy)rMa Represents a single Photo. Attributes: TAG (str): 'Photo' TYPE (str): 'photo' addedAt (datetime): Datetime the photo was added to the library. createdAtAccuracy (str): Unknown (local). createdAtTZOffset (int): Unknown (-25200). fields (List<:class:`~plexapi.media.Field`>): List of field objects. guid (str): Plex GUID for the photo (com.plexapp.agents.none://231714?lang=xn). images (List<:class:`~plexapi.media.Image`>): List of image objects. index (sting): Plex index number for the photo. key (str): API URL (/library/metadata/). lastRatedAt (datetime): Datetime the photo was last rated. librarySectionID (int): :class:`~plexapi.library.LibrarySection` ID. librarySectionKey (str): :class:`~plexapi.library.LibrarySection` key. librarySectionTitle (str): :class:`~plexapi.library.LibrarySection` title. listType (str): Hardcoded as 'photo' (useful for search filters). media (List<:class:`~plexapi.media.Media`>): List of media objects. originallyAvailableAt (datetime): Datetime the photo was added to Plex. parentGuid (str): Plex GUID for the photo album (local://229674). parentIndex (int): Plex index number for the photo album. parentKey (str): API URL of the photo album (/library/metadata/). parentRatingKey (int): Unique key identifying the photo album. parentThumb (str): URL to photo album thumbnail image (/library/metadata//thumb/). parentTitle (str): Name of the photo album for the photo. ratingKey (int): Unique key identifying the photo. sourceURI (str): Remote server URI (server:///com.plexapp.plugins.library) (remote playlist item only). summary (str): Summary of the photo. tags (List<:class:`~plexapi.media.Tag`>): List of tag objects. thumb (str): URL to thumbnail image (/library/metadata//thumb/). title (str): Name of the photo. titleSort (str): Title to use when sorting (defaults to title). type (str): 'photo' updatedAt (datetime): Datetime the photo was updated. userRating (float): Rating of the photo (0.0 - 10.0) equaling (0 stars - 5 stars). year (int): Year the photo was taken. rcX tj||tj|jj d|_|jj d|_tjt|jj d|_ |j|tj|_|jj d|_|j|tj |_tjt|jj d|_|jj dd|_tj|jj d|_tjt|jj d |_|jj d |_|jj d |_d |_|j|tj2|_ tj|jj d d|_|jj d|_tjt|jj d|_|jj d|_tjt|jj d|_|jj d|_|jj d|_ tjt|jj d|_!|jj d|_"|jj d|_#|j|tjH|_%|jj d|_&|jj d|_'|jj d|jN|_(|jj d|_)tj|jj d|_*tjtV|jj d|_,tjt|jj d|_-y) rrcreatedAtAccuracycreatedAtTZOffsetrrrr r"r#r$r%roriginallyAvailableAtz%Y-%m-%d parentGuid parentIndex parentKeyparentRatingKey parentThumb parentTitler&sourcer'r(r)r*r+r,r-yearN).rr?rr.r/r0rrr6r7rr1rr2r3rr4r5rrr"r#r$r%r9Mediarrrrrrrr& sourceURIr'Tagtagsr(r)r*r+r,r:r-rr;s r>r?zPhoto._loadDatas.4&''  (BC !%1D!E!&CAT1U!VnnT5;;7 KKOOF+ nnT5;;7 ZZT[[__W%=> ;;??5"- ++DKKOOM,JK % 3 @R0S T!%1D!E#';;??3H#I  ^^D%++6 %*%5%5dkkooF]6^`j%k"++//,7 ::c4;;??=+IJ5$zz#t{{?P/QR;;??=9;;??=9C)EF2{{y1 NN43 [[__W- [[__W- djjAKKOOF+ ))$++//+*FG**UDKKOOL,IJJJsDKKOOF$;< r@ch|jr|jd|jS|jS)z) Returns a filename for use in download. z - )rr)r<s r>_prettyfilenamezPhoto._prettyfilenames1   &&'s4::,7 7zzr@c8|j|jS)z8 Return the photo's :class:`~plexapi.photo.Photoalbum`. )rDrrs r>rzPhoto.photoalbums~~dnn--r@c t|dr/|jjj|jS|j r=|jjj|j jStd)zK Returns the :class:`~plexapi.library.LibrarySection` the item belongs to. r#zsectionz Photo.sectionsi 4+ ,<<''33D4I4IJ J ^^<<''33DOO4E4V4VW W[\ \r@c|jDcgc]"}|jD]}|s|j$c}}Scc}}w)z This does not exist in plex xml response but is added to have a common interface to get the locations of the photo. Returns: List of file paths where the photo is found on disk. )rpartsfile)r<itemparts r> locationszPhoto.locationss2'+jjPdTZZPT4 P PPPs;;Nc*ddlm}m}m}|jj } ||jd} |r|n |j | _|j | _|j| _ |j| _ |jj| _ |j} d| jdt|j | _|j%|| _|j)|| _| j-| ||S)a Add current photo as sync item for specified device. See :func:`~plexapi.myplex.MyPlexAccount.sync` for possible exceptions. Parameters: resolution (str): maximum allowed resolution for synchronized photos, see PHOTO_QUALITY_* values in the module :mod:`~plexapi.sync`. client (:class:`~plexapi.myplex.MyPlexDevice`): sync destination, see :func:`~plexapi.myplex.MyPlexAccount.sync`. clientId (str): sync destination, see :func:`~plexapi.myplex.MyPlexAccount.sync`. limit (int): maximum count of items to sync, unlimited if `None`. title (str): descriptive title for the new :class:`~plexapi.sync.SyncItem`, if empty the value would be generated from metadata of current photo. Returns: :class:`~plexapi.sync.SyncItem`: an instance of created syncItem. r)SyncItemPolicy MediaSettingsNz library://z/item/)clientclientId) plexapi.syncrrrrh myPlexAccountr) rootTitler9 contentType METADATA_TYPE metadataTypemachineIdentifierruuidrrlocationcreatepolicy createPhoto mediaSettingssync) r< resolutionrrlimitr)rrrmyplex sync_itemrs r>rz Photo.sync s$ A@++-T\\40 #(%djj "jj  $ !%!3!3 &*ll&D&D #,,.)',,vj>R=ST !==/ "/";";J"G {{9Vh{GGr@cT|jj|d|jdSrb)rhrirrjs r>rkzPhoto._getWebURL/s%||((dYDNNcd(eer@ctj|j}tt ddz |dz |dddz Srm)rrprrqrrrs r>rtzPhoto.metadataDirectory3sGNN4??3 4 #h.1=9QR=/QX@YYZZr@)NNNNru)rvrwrxryrzr{rr?rrrr}rrrkrtr~r@r>rMrMsh&N C DM"=H .]QQ"HHf[[r@rMceZdZdZdZdZy) PhotoSessionzh Represents a single Photo session loaded from :func:`~plexapi.server.PlexServer.sessions`. Tc\tj||tj||y)rN)rMr?r r;s r>r?zPhotoSession._loadDataAs  d#dD)r@N)rvrwrxry _SESSIONTYPEr?r~r@r>rr:sL*r@r)rXpathlibr urllib.parserplexapirrr plexapi.baserr r plexapi.exceptionsr plexapi.mixinsr r rrrrrregisterPlexObjectrrMrr~r@r>rs #''AA)D[ k D[D[N^[x ^[^[B *; * *r@