lj=ddlZddlmZddlmZddlmZmZmZddl m Z m Z m Z m Z ddlmZddlmZmZej&Gdd e eZej&Gd d e e eZej&Gd d e eZy)N)Path) quote_plus)mediautilsvideo)PlayablePlexPartialObject PlexSessioncached_data_property) BadRequest)PhotoalbumMixins PhotoMixinsceZdZdZdZdZdZdZedZ edZ dZ d Z d Z d Zd Zd ZdZddZddZedZy) 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|_|jjd|_tjt|jjd|_ |jjddjdd|_ tj|jjd |_ tjt|jjd |_|jjd |_|jjd |_d |_tjt|jjd|_|jjd|_|jjd|_|jjd|_|jjd|j*|_|jjd|_tj|jjd|_tjt2|jjd|_y)/ Load attribute values from Plex XML response. addedAtart compositeguidindexkey /children lastRatedAtlibrarySectionIDlibrarySectionKeylibrarySectionTitler ratingKeysummarythumbtitle titleSorttype updatedAt userRatingN)r toDatetimeattribgetrrrrcastintrreplacerrrr r!listTyper"r#r$r%r&r'r(floatr)selfdatas :/DATA/.local/lib/python3.12/site-packages/plexapi/photo.py _loadDatazPhotoalbum._loadData.s''  (BC ;;??5)5KKOOF+ ZZT[[__W%=> ;;??5"-55k2F ++DKKOOM,JK % 3 @R0S T!%1D!E#';;??3H#I  C)EF{{y1 [[__W- [[__W- djjAKKOOF+ ))$++//+*FG**UDKKOOL,IJcV|j|jtjSN findItems_datarFieldr3s r5fieldszPhotoalbum.fieldsD~~djj%++66r7cV|j|jtjSr9r;r<rImager>s r5imageszPhotoalbum.imagesHr@r7cP|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 fetchItemrr3r%rs r5albumzPhotoalbum.albumLs)  )$~~c:U~CCr7c P|jd}|j|tfi|S)zL Returns a list of :class:`~plexapi.photo.Photoalbum` objects in the album. r)r fetchItemsrr3kwargsrs r5albumszPhotoalbum.albumsUs* )$tsJ9&99r7cP|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. rrF)rrHPhotorIs r5rzPhotoalbum.photoZs)  )$~~c5~>>r7c P|jd}|j|tfi|S)zG Returns a list of :class:`~plexapi.photo.Photo` objects in the album. r)rrLrQrMs r5photoszPhotoalbum.photoscs* )$tsE4V44r7cd|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. rrF)rrHrCliprIs r5clipzPhotoalbum.cliphs-  )$~~c5::U~CCr7c d|jd}|j|tjfi|S)zF Returns a list of :class:`~plexapi.video.Clip` objects in the album. r)rrLrrUrMs r5clipszPhotoalbum.clipsqs. )$tsEJJ9&99r7c$|j|S)z3 Alias to :func:`~plexapi.photo.Photoalbum.photo`. )episode)r3r%s r5r,zPhotoalbum.getvs||E""r7Nc0g}|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. )rOospathjoinr%downloadrSrX)r3savepathkeep_original_name subfolders filepathsrJ _savepathrs r5r_zPhotoalbum.downloadzs [[]E?I Xu{{;xI  3EF FI#[[]TZZ\1E 2DE EI2r7cT|jj|d|jdSz3 Get the Plex Web URL with the correct parameters. details)baseendpointrlegacy)_server _buildWebURLrr3ris r5 _getWebURLzPhotoalbum._getWebURLs%||((dYDHH]^(__r7ctj|j}tt ddz |dz |dddz SzL Returns the Plex Media Server data directory where the metadata is stored. MetadataPhotosrrhNz.bundle)rsha1hashrstrrr3 guid_hashs r5metadataDirectoryzPhotoalbum.metadataDirectorysGNN499- 4 #h.1=9QR=/QX@YYZZr7)NFFr9)__name__ __module__ __qualname____doc__TAGTYPE _searchTyper6r r?rDrJrOrrSrVrXr,r_ropropertyrxr7r5rr s6 C DKK,7777D: ?5 D: #"`[[r7rceZdZdZdZdZdZdZedZ edZ edZ edZ dZ d Zd Zed Zdd ZddZedZy )rQa 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. rc0 tj||tj|jj d|_|jj d|_tjt|jj d|_ |jj d|_ tjt|jj d|_ |jj dd|_ tj|jj d|_tjt|jj d |_|jj d |_|jj d |_d |_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|_|jj d|_|jj d|_|jj d|j<|_|jj d|_ tj|jj d|_!tjtD|jj d|_#tjt|jj d|_$y) rrcreatedAtAccuracycreatedAtTZOffsetrrrrrrr r!roriginallyAvailableAtz%Y-%m-%d parentGuid parentIndex parentKeyparentRatingKey parentThumb parentTitler"sourcer#r$r%r&r'r(r)yearN)%rr6rr*r+r,rrr-r.rrrrrrr r!r0rrrrrrrr" sourceURIr#r$r%r&r'r(r1r)rr2s r5r6zPhoto._loadDatas4&''  (BC !%1D!E!&CAT1U!VKKOOF+ ZZT[[__W%=> ;;??5"- ++DKKOOM,JK % 3 @R0S T!%1D!E#';;??3H#I  %*%5%5dkkooF]6^`j%k"++//,7 ::c4;;??=+IJ5$zz#t{{?P/QR;;??=9;;??=9C)EF2{{y1 [[__W- [[__W- djjAKKOOF+ ))$++//+*FG**UDKKOOL,IJJJsDKKOOF$;< r7cV|j|jtjSr9r:r>s r5r?z Photo.fieldsr@r7cV|j|jtjSr9rBr>s r5rDz Photo.imagesr@r7cV|j|jtjSr9)r;r<rMediar>s r5rz Photo.mediar@r7cV|j|jtjSr9)r;r<rTagr>s r5tagsz Photo.tagss~~djj%))44r7ch|jr|jd|jS|jS)z) Returns a filename for use in download. z - )rr%r>s r5_prettyfilenamezPhoto._prettyfilenames1   &&'s4::,7 7zzr7c8|j|jS)z8 Return the photo's :class:`~plexapi.photo.Photoalbum`. )rHrr>s r5rzPhoto.photoalbums~~dnn--r7c t|dr/|jjj|jS|j r=|jjj|j jStd)zK Returns the :class:`~plexapi.library.LibrarySection` the item belongs to. rzs r5sectionz Photo.sectionsi 4+ ,<<''33D4I4IJ J ^^<<''33DOO4E4V4VW W[\ \r7c|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)r3itemparts r5 locationszPhoto.locationss2'+jjPjdTZZT4 Z jPPPs;;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.syncrrrrl myPlexAccountr% rootTitler0 contentType METADATA_TYPE metadataTypemachineIdentifierruuidrrlocationcreatepolicy createPhoto mediaSettingssync) r3 resolutionrrlimitr%rrrmyplex sync_itemrs r5rz Photo.syncs$ A@++-T\\40 #(%djj "jj  $ !%!3!3 &*ll&D&D #,,.)',,vj>R=ST !==/ "/";";J"G {{9Vh{GGr7cT|jj|d|jdSrf)rlrmrrns r5rozPhoto._getWebURL6s%||((dYDNNcd(eer7ctj|j}tt ddz |dz |dddz Srq)rrtrrurrvs r5rxzPhoto.metadataDirectory:sGNN4??3 4 #h.1=9QR=/QX@YYZZr7)NNNNr9)ryrzr{r|r}r~rr6r r?rDrrrrrrrrrorxrr7r5rQrQs&N C DM=@77777755 .]QQ"HHf[[r7rQceZdZdZdZdZy) PhotoSessionzh Represents a single Photo session loaded from :func:`~plexapi.server.PlexServer.sessions`. Tc\tj||tj||y)rN)rQr6r r2s r5r6zPhotoSession._loadDataHs  d#dD)r7N)ryrzr{r| _SESSIONTYPEr6rr7r5rrAsL*r7r)r\pathlibr urllib.parserplexapirrr plexapi.baserr r r plexapi.exceptionsr plexapi.mixinsr rregisterPlexObjectrrQrrr7r5rs #''WW)8G['G[G[Tg[xg[g[T *; * *r7