U 'ciTF@sxdZddgZddlZddlZddlZddlZddlmZddlZddl m Z ddl m Z m Z eeZGdddZdS) z: A simple and thin Python library for the Spotify Web API SpotifySpotifyExceptionN) defaultdict)r)REQUESTS_SESSIONRetryc<@s|eZdZdZdZdZdddddd d d d d ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;dd?gdfddZ?ddZ@dgddZAddZBdhdd„ZCdiddĄZDdjddƄZEdkddȄZFddʄZGdd̄ZHdd΄ZIdlddЄZJdmdd҄ZKgfddԄZLgfddքZMgfdd؄ZNdnddڄZOdodd܄ZPdpddބZQdqddZRdrddZSdsddZTdtddZUduddZVdvddZWgfddZXgfddZYgfddZZdwddZ[dxddZ\dyddZ]dzddZ^d{ddZ_d|ddZ`gfddZagfddZbgfddZcgfddZdd}ddZed~dd Zfdd d Zgdd d ZhdddZidddZjddZkddZlgfddZmddZndddZodddZpdddZqdd d!Zrdd"d#Zsdd$d%Ztdd&d'Zudd(d)Zvdd*d+Zwdd,d-Zxdd.d/Zyd0d1Zzdd2d3Z{d4d5Z|d6d7Z}d8d9Z~d:d;Zd<d=Zd>d?Zdd@dAZddBdCZddDdEZdCS(ra Example usage:: import spotipy urn = 'spotify:artist:3jOstUTkEu2JkjvRdBA5Gu' sp = spotipy.Spotify() artist = sp.artist(urn) print(artist) user = sp.user('plamere') print(user) )iiiiZADARZAUATZBEZBOZBRZBGCAZCLZCOCRZCYZCZZDKZDOZECZSVZEEZFIZFRZDEZGRGTZHNZHKZHUZISZIDZIEZITZJPLVZLILTZLUZMYZMTZMXZMCNLZNZZNINOZPAZPYPEZPHZPLZPTZSGESZSKZSEZCHZTWZTRZGBUSZUYz^spotify:(?:(?Ptrack|artist|album|playlist|show|episode|audiobook):(?P[0-9A-Za-z]+)|user:(?P[0-9A-Za-z]+):playlist:(?P[0-9A-Za-z]+))$z^(http[s]?:\/\/)?open.spotify.com\/(intl-\w\w\/)?(?Ptrack|artist|album|playlist|show|episode|user|audiobook)\/(?P[0-9A-Za-z]+)(\?.*)?$z^[0-9A-Za-z]+$NTg333333?c Cs|d|_||_||_||_||_||_||_|p2|j|_| |_ | |_ | |_ | |_ t |tjrb||_n|rp|ntj|_dS)aO Creates a Spotify API client. :param auth: An access token (optional) :param requests_session: A Requests session object or a truthy value to create one. A falsy value disables sessions. It should generally be a good idea to keep sessions enabled for performance reasons (connection pooling). :param client_credentials_manager: SpotifyClientCredentials object :param oauth_manager: SpotifyOAuth object :param auth_manager: SpotifyOauth, SpotifyClientCredentials, or SpotifyImplicitGrant object :param proxies: Definition of proxies (optional). See Requests doc https://2.python-requests.org/en/master/user/advanced/#proxies :param requests_timeout: Tell Requests to stop waiting for a response after a given number of seconds :param status_forcelist: Tell requests what type of status codes retries should occur on :param retries: Total number of retries to allow :param status_retries: Number of times to retry on bad status codes :param backoff_factor: A backoff factor to apply between attempts after the second try See urllib3 https://urllib3.readthedocs.io/en/latest/reference/urllib3.util.html :param language: The language parameter advertises what language the user prefers to see. See ISO-639-1 language code: https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes zhttps://api.spotify.com/v1/N)prefix_authclient_credentials_manager oauth_manager auth_managerproxiesrequests_timeoutdefault_retry_codesstatus_forcelistbackoff_factorretriesstatus_retrieslanguage isinstancerequestsSession_session_build_sessionapi) selfauthZrequests_sessionrrrrrrr r!rr"r+2/tmp/pip-unpacked-wheel-5vxoxy0m/spotipy/client.py__init__}s"2   zSpotify.__init__cCs ||_dSN)r)r)r*r+r+r,set_authszSpotify.set_authcCs|jSr.) _auth_managerr)r+r+r,rszSpotify.auth_managercCs"|dk r||_n|jp|j|_dSr.)r0rr)r)rr+r+r,rs cCs&t|ddr"t|jtr"|jdS)z+Make sure the connection (pool) gets closedr&N)getattrr#r&rcloser1r+r+r,__del__szSpotify.__del__c Csbt|_t|jddtddddg|j|j|jd}tj j |d}|j d||j d |dS) NFGETPOSTPUTDELETE)totalconnectreadZallowed_methodsstatusrr) max_retrieszhttp://zhttps://) r$r%r&rr frozensetr!rradapters HTTPAdaptermount)r)retryadapterr+r+r,r's  zSpotify._build_sessioncCs`|jrdd|jiS|js iSz|jjdd}Wntk rP|j}YnXdd|iS)N AuthorizationzBearer F)Zas_dict)rrZget_access_token TypeError)r)tokenr+r+r, _auth_headersszSpotify._auth_headerscCstt|d}|ds|j|}|}d|dkrZ|dd|d<|dd=|rt||d<nd|d<|rtt||d<|jdk r|j|d<td |d |d | dd |d | d z8|j j ||f||j |j d|}||}Wnjtjjk r} z| j}z,|} | di} | d} | d} Wn&tk rd|jpZd} d} YnXtd|d |d | dd|jd| t|jd|jd| | |jdW5d} ~ XYntjjk rF}z\|j }tdz|jdj} Wnttfk rd} YnXtdd|jd| dW5d}~XYntk r^d}YnXtd||S)N)paramshttp content_typerHz Content-Typedatazapplication/jsonzAccept-LanguagezSending z to z with Params: z Headers: z and Body: )headersrtimeouterrormessagereasonzHTTP Error for z returned z due to z: )rPrLzMax Retries reachedrrz: Max Retries)rPz RESULTS: ) dict startswithrrGjsondumpsr"loggerdebuggetr&requestrrraise_for_statusr$ exceptions HTTPErrorresponse ValueErrortextrN status_coderurlrL RetryErrorargsrP IndexErrorAttributeErrorpath_url)r)methodrapayloadrHrcrLr]results http_errorZ json_responserNmsgrPZ retry_errorrYr+r+r,_internal_calls~        4    0    zSpotify._internal_callcKs|r|||d|||S)Nr5updaterlr)rarcrhkwargsr+r+r,_get=s z Spotify._getcKs|r|||d|||S)Nr6rmror+r+r,_postCs z Spotify._postcKs|r|||d|||S)Nr8rmror+r+r,_deleteHs zSpotify._deletecKs|r|||d|||S)Nr7rmror+r+r,_putMs z Spotify._putcCs|dr||dSdSdS)z returns the next result given a paged result Parameters: - result - a previously returned paged result nextNrqr)resultr+r+r,ruRsz Spotify.nextcCs|dr||dSdSdS)z returns the previous result given a paged result Parameters: - result - a previously returned paged result previousNrvrwr+r+r,ry]szSpotify.previouscCs|d|}|jd||dS)z returns a single track given the track's ID, URI or URL Parameters: - track_id - a spotify URI, URL or ID - market - an ISO 3166-1 alpha-2 country code. trackztracks/market_get_idrq)r)track_idr|tridr+r+r,rzhs z Spotify.trackcs*fdd|D}jdd||dS)z returns a list of tracks given a list of track IDs, URIs, or URLs Parameters: - tracks - a list of spotify URIs, URLs or IDs. Maximum: 50 IDs. - market - an ISO 3166-1 alpha-2 country code. csg|]}d|qSrzr~.0tr1r+r, {sz"Spotify.tracks..z tracks/?ids=,r{rqjoin)r)tracksr|tlistr+r1r,rsszSpotify.trackscCs|d|}|d|S)z returns a single artist given the artist's ID, URI or URL Parameters: - artist_id - an artist ID, URI or URL artistartists/r}r) artist_idrr+r+r,r~s zSpotify.artistcs&fdd|D}dd|S)z returns a list of artists given the artist IDs, URIs, or URLs Parameters: - artists - a list of artist IDs, URIs or URLs csg|]}d|qSrrrar1r+r,rsz#Spotify.artists..z artists/?ids=rr)r)artistsrr+r1r,rszSpotify.artistsrcCs@|rtdt|p|}|d|}|jd|d||||dS)a% Get Spotify catalog information about an artist's albums .. deprecated:: This method is deprecated and may be removed in a future version. Use `artist_albums(..., include_groups='...')` instead. Parameters: - artist_id - the artist ID, URI or URL - include_groups - the types of items to return. One or more of 'album', 'single', 'appears_on', 'compilation'. If multiple types are desired, pass in a comma separated string; e.g., 'album,single'. - country - limit the response to one particular country. - limit - the number of albums to return - offset - the index of the first album to return zYou're using `artist_albums(..., album_type='...')` which will be removed in future versions. Please adjust your code accordingly by using `artist_albums(..., include_groups='...')` instead.rrz/albums)include_groupscountrylimitoffsetwarningswarnDeprecationWarningr~rq)r)rZ album_typerrrrrr+r+r, artist_albumss  zSpotify.artist_albumscCs"|d|}|jd|d|dS)z Get Spotify catalog information about an artist's top 10 tracks by country. Parameters: - artist_id - the artist ID, URI or URL - country - limit the response to one particular country. rrz /top-tracks)rr})r)rrrr+r+r,artist_top_trackss zSpotify.artist_top_trackscCs*tdt|d|}|d|dS)a~ Get Spotify catalog information about artists similar to an identified artist. Similarity is based on analysis of the Spotify community's listening history. .. deprecated:: This endpoint has been removed by Spotify and is no longer available. Parameters: - artist_id - the artist ID, URI or URL zUYou're using `artist_related_artists(...)`, which is marked as deprecated by Spotify.rrz/related-artistsrrr+r+r,artist_related_artistss  zSpotify.artist_related_artistscCs<|d|}|dk r*|d|d|S|d|SdS)z returns a single album given the album's ID, URIs or URL Parameters: - album_id - the album ID, URI or URL - market - an ISO 3166-1 alpha-2 country code albumNalbums/?market=r})r)album_idr|rr+r+r,rs z Spotify.album2cCs&|d|}|jd|d|||dS)aJ Get Spotify catalog information about an album's tracks Parameters: - album_id - the album ID, URI or URL - limit - the number of items to return - offset - the index of the first item to return - market - an ISO 3166-1 alpha-2 country code. rrz/tracks/rrr|r})r)rrrr|rr+r+r, album_trackss  zSpotify.album_trackscsNfdd|D}|dk r6dd|d|Sdd|SdS)z returns a list of albums given the album IDs, URIs, or URLs Parameters: - albums - a list of album IDs, URIs or URLs - market - an ISO 3166-1 alpha-2 country code csg|]}d|qSrrrr1r+r,rsz"Spotify.albums..Nz albums/?ids=r&market=r)r)albumsr|rr+r1r,rszSpotify.albumscCs|d|}|jd||dS)a returns a single show given the show's ID, URIs or URL Parameters: - show_id - the show ID, URI or URL - market - an ISO 3166-1 alpha-2 country code. The show must be available in the given market. If user-based authorization is in use, the user's country takes precedence. If neither market nor user country are provided, the content is considered unavailable for the client. showshows/r{r})r)show_idr|rr+r+r,rs z Spotify.showcs*fdd|D}jdd||dS)a0 returns a list of shows given the show IDs, URIs, or URLs Parameters: - shows - a list of show IDs, URIs or URLs - market - an ISO 3166-1 alpha-2 country code. Only shows available in the given market will be returned. If user-based authorization is in use, the user's country takes precedence. If neither market nor user country are provided, the content is considered unavailable for the client. csg|]}d|qSrrrsr1r+r,rsz!Spotify.shows..z shows/?ids=rr{r)r)showsr|rr+r1r,rs z Spotify.showscCs&|d|}|jd|d|||dS)a Get Spotify catalog information about a show's episodes Parameters: - show_id - the show ID, URI or URL - limit - the number of items to return - offset - the index of the first item to return - market - an ISO 3166-1 alpha-2 country code. Only episodes available in the given market will be returned. If user-based authorization is in use, the user's country takes precedence. If neither market nor user country are provided, the content is considered unavailable for the client. rrz /episodes/rr})r)rrrr|rr+r+r, show_episodes s  zSpotify.show_episodescCs|d|}|jd||dS)a* returns a single episode given the episode's ID, URIs or URL Parameters: - episode_id - the episode ID, URI or URL - market - an ISO 3166-1 alpha-2 country code. The episode must be available in the given market. If user-based authorization is in use, the user's country takes precedence. If neither market nor user country are provided, the content is considered unavailable for the client. episodez episodes/r{r})r)Z episode_idr|rr+r+r,r3s zSpotify.episodecs*fdd|D}jdd||dS)a? returns a list of episodes given the episode IDs, URIs, or URLs Parameters: - episodes - a list of episode IDs, URIs or URLs - market - an ISO 3166-1 alpha-2 country code. Only episodes available in the given market will be returned. If user-based authorization is in use, the user's country takes precedence. If neither market nor user country are provided, the content is considered unavailable for the client. csg|]}d|qSrrrer1r+r,rNsz$Spotify.episodes..zepisodes/?ids=rr{r)r)episodesr|rr+r1r,rBs zSpotify.episodes rzcCs|jd|||||dS)a| searches for an item Parameters: - q - the search query (see how to write a query in the official documentation https://developer.spotify.com/documentation/web-api/reference/search/) # noqa - limit - the number of items to return (min = 1, default = 10, max = 50). The limit is applied within each type, not on the total response. - offset - the index of the first item to return - type - the types of items to return. One or more of 'artist', 'album', 'track', 'playlist', 'show', and 'episode'. If multiple types are desired, pass in a comma separated string; e.g., 'track,album,episode'. - market - An ISO 3166-1 alpha-2 country code or the string from_token. searchqrrtyper|rv)r)rrrrr|r+r+r,rQszSpotify.searchcCsNtdt|s|j}t|ts.t|ts.g}tdt|||||||S)ah (experimental) Searches multiple markets for an item Parameters: - q - the search query (see how to write a query in the official documentation https://developer.spotify.com/documentation/web-api/reference/search/) # noqa - limit - the number of items to return (min = 1, default = 10, max = 50). If a search is to be done on multiple markets, then this limit is applied to each market. (e.g. search US, CA, MX each with a limit of 10). If multiple types are specified, this applies to each type. - offset - the index of the first item to return - type - the types of items to return. One or more of 'artist', 'album', 'track', 'playlist', 'show', or 'episode'. If multiple types are desired, pass in a comma separated string. - markets - A list of ISO 3166-1 alpha-2 country codes. Search all country markets by default. - total - the total number of results to return across multiple markets and types. zSearching multiple markets is an experimental feature. Please be aware that this method's inputs and outputs can change in the future.z0Searching multiple markets is poorly performing.)rr UserWarning country_codesr#listtuple_search_multiple_markets)r)rrrrmarketsr9r+r+r,search_marketsdszSpotify.search_marketscCs|d|S)z Gets basic profile information about a Spotify User Parameters: - user - the id of the usr users/rv)r)userr+r+r,rsz Spotify.usercCs|jd||dS)z Get current user playlists without required getting his profile Parameters: - limit - the number of items to return - offset - the index of the first item to return z me/playlistsrrrv)r)rrr+r+r,current_user_playlistsszSpotify.current_user_playlistsrcCs*|d|}|jd|||d|dS)a Gets playlist by id. Parameters: - playlist - the id of the playlist - fields - which fields to return - market - An ISO 3166-1 alpha-2 country code or the string from_token. - additional_types - list of item types to return. valid types are: track and episode playlist playlists/r)fieldsr|additional_typesr~rqr)r) playlist_idrr|rplidr+r+r,rs zSpotify.playlistdcCs tdt|||||||S)a Get full details of the tracks of a playlist. .. deprecated:: This method is deprecated and may be removed in a future version. Use `playlist_items(playlist_id, ..., additional_types=('track',))` instead. Parameters: - playlist_id - the playlist ID, URI or URL - fields - which fields to return - limit - the maximum number of tracks to return - offset - the index of the first track to return - market - an ISO 3166-1 alpha-2 country code. - additional_types - list of item types to return. valid types are: track and episode zUYou should use `playlist_items(playlist_id, ...,additional_types=('track',))` instead)rrrplaylist_items)r)rrrrr|rr+r+r,playlist_trackss zSpotify.playlist_tracksrzrc Cs0|d|}|jd|d||||d|dS)a Get full details of the tracks and episodes of a playlist. Parameters: - playlist_id - the playlist ID, URI or URL - fields - which fields to return - limit - the maximum number of tracks to return - offset - the index of the first track to return - market - an ISO 3166-1 alpha-2 country code. - additional_types - list of item types to return. valid types are: track and episode rr/tracksr)rrrr|rr)r)rrrrr|rrr+r+r,rs  zSpotify.playlist_itemscCs|d|}|d|dS)z} Get cover image of a playlist. Parameters: - playlist_id - the playlist ID, URI or URL rr/imagesr})r)rrr+r+r,playlist_cover_images zSpotify.playlist_cover_imagecCs$|d|}|jd|d|ddS)a Replace the image used to represent a specific playlist Parameters: - playlist_id - the id of the playlist - image_b64 - image data as a Base64 encoded JPEG image string (maximum payload size is 256 KB) rrrz image/jpeg)rhrJr~rt)r)rZ image_b64rr+r+r,playlist_upload_cover_images   z#Spotify.playlist_upload_cover_imagecCs6tdt|dkr&|d|dS|j|||dS)at Gets a single playlist of a user .. deprecated:: This method is deprecated and may be removed in a future version. Use `playlist(playlist_id)` instead. Parameters: - user - the id of the user - playlist_id - the id of the playlist - fields - which fields to return z.You should use `playlist(playlist_id)` insteadNrz/starred)rr|)rrrrqr)r)rrrr|r+r+r, user_playlists zSpotify.user_playlistcCs tdt|j|||||dS)aZ Get full details of the tracks of a playlist owned by a user. .. deprecated:: This method is deprecated and may be removed in a future version. Use `playlist_tracks(playlist_id)` instead. Parameters: - user - the id of the user - playlist_id - the id of the playlist - fields - which fields to return - limit - the maximum number of tracks to return - offset - the index of the first track to return - market - an ISO 3166-1 alpha-2 country code. z5You should use `playlist_tracks(playlist_id)` instead)rrrr|)rrrr)r)rrrrrr|r+r+r,user_playlist_tracksszSpotify.user_playlist_trackscCs|jd|d||dS)z Gets playlists of a user Parameters: - user - the id of the usr - limit - the number of items to return - offset - the index of the first item to return r /playlistsrrv)r)rrrr+r+r,user_playlists5s  zSpotify.user_playlistsFcCs$||||d}|jd|d|dS)a` Creates a playlist for a user Parameters: - user - the id of the user - name - the name of the playlist - public - is the created playlist public - collaborative - is the created playlist collaborative - description - the description of the playlist )namepublic collaborative descriptionrrrh)rr)r)rrrrrrKr+r+r,user_playlist_createAs zSpotify.user_playlist_createcCstdt||||||S)a This function is no longer in use, please use the recommended function in the warning! Changes a playlist's name and/or public/private state .. deprecated:: This method is deprecated and may be removed in a future version. Use `playlist_change_details(playlist_id, ...)` instead. Parameters: - user - the id of the user - playlist_id - the id of the playlist - name - optional name of the playlist - public - optional is the playlist public - collaborative - optional is the playlist collaborative - description - optional description of the playlist zBYou should use `playlist_change_details(playlist_id, ...)` instead)rrrplaylist_change_details)r)rrrrrrr+r+r,user_playlist_change_detailsTs z$Spotify.user_playlist_change_detailscCstdt||S)a This function is no longer in use, please use the recommended function in the warning! Unfollows (deletes) a playlist for a user .. deprecated:: This method is deprecated and may be removed in a future version. Use `current_user_unfollow_playlist(playlist_id)` instead. Parameters: - user - the id of the user - name - the name of the playlist zDYou should use `current_user_unfollow_playlist(playlist_id)` instead)rrrcurrent_user_unfollow_playlist)r)rrr+r+r,user_playlist_unfollowus zSpotify.user_playlist_unfollowcs,tdtfdd|D}|||S)a* This function is no longer in use, please use the recommended function in the warning! Adds tracks to a playlist .. deprecated:: This method is deprecated and may be removed in a future version. Use `playlist_add_items(playlist_id, tracks)` instead. Parameters: - user - the id of the user - playlist_id - the id of the playlist - tracks - a list of track URIs, URLs or IDs - position - the position to add the tracks z@You should use `playlist_add_items(playlist_id, tracks)` insteadcsg|]}d|qSr_get_urirtidr1r+r,rsz4Spotify.user_playlist_add_tracks..rrrplaylist_add_items)r)rrrpositionr+r1r,user_playlist_add_trackss z Spotify.user_playlist_add_trackscs,tdtfdd|D}|||S)a2 This function is no longer in use, please use the recommended function in the warning! Adds episodes to a playlist .. deprecated:: This method is deprecated and may be removed in a future version. Use `playlist_add_items(playlist_id, episodes)` instead. Parameters: - user - the id of the user - playlist_id - the id of the playlist - episodes - a list of track URIs, URLs or IDs - position - the position to add the episodes zBYou should use `playlist_add_items(playlist_id, episodes)` insteadcsg|]}d|qSrrrr1r+r,rsz6Spotify.user_playlist_add_episodes..r)r)rrrrr+r1r,user_playlist_add_episodess z"Spotify.user_playlist_add_episodescCstdt|||S)a This function is no longer in use, please use the recommended function in the warning! Replace all tracks in a playlist for a user .. deprecated:: This method is deprecated and may be removed in a future version. Use `playlist_replace_items(playlist_id, tracks)` instead. Parameters: - user - the id of the user - playlist_id - the id of the playlist - tracks - the list of track ids to add to the playlist zDYou should use `playlist_replace_items(playlist_id, tracks)` instead)rrrplaylist_replace_items)r)rrrr+r+r,user_playlist_replace_trackss z$Spotify.user_playlist_replace_trackscCstdt||||||S)aC This function is no longer in use, please use the recommended function in the warning! Reorder tracks in a playlist from a user .. deprecated:: This method is deprecated and may be removed in a future version. Use `playlist_reorder_items(playlist_id, ...)` instead. Parameters: - user - the id of the user - playlist_id - the id of the playlist - range_start - the position of the first track to be reordered - range_length - optional the number of tracks to be reordered (default: 1) - insert_before - the position where the tracks should be inserted - snapshot_id - optional playlist's snapshot ID zAYou should use `playlist_reorder_items(playlist_id, ...)` instead)rrrplaylist_reorder_items)r)rr range_start insert_before range_length snapshot_idr+r+r,user_playlist_reorder_trackssz$Spotify.user_playlist_reorder_trackscCstdt||||S)a This function is no longer in use, please use the recommended function in the warning! Removes all occurrences of the given tracks from the given playlist .. deprecated:: This method is deprecated and may be removed in a future version. Use `playlist_remove_all_occurrences_of_items(playlist_id, tracks)` instead. Parameters: - user - the id of the user - playlist_id - the id of the playlist - tracks - the list of track ids to remove from the playlist - snapshot_id - optional id of the playlist snapshot zVYou should use `playlist_remove_all_occurrences_of_items(playlist_id, tracks)` instead)rrr(playlist_remove_all_occurrences_of_items)r)rrrrr+r+r,.user_playlist_remove_all_occurrences_of_trackssz6Spotify.user_playlist_remove_all_occurrences_of_tracksc Csvtdt|d|}g}|D]$}||d|d|ddq d|i}|rZ||d<|jd |d |d |d S) aG This function is no longer in use, please use the recommended function in the warning! Removes specific occurrences of the given tracks from the given playlist .. deprecated:: This endpoint has been removed by Spotify and is no longer available. Parameters: - user - the id of the user - playlist_id - the id of the playlist - tracks - an array of objects containing Spotify URIs of the tracks to remove with their current positions in the playlist. For example: [ { "uri":"4iV5W9uYEdYUVa79Axb7Rh", "positions":[2] }, { "uri":"1301WleyT98MSxVHPZCA6M", "positions":[7] } ] - snapshot_id - optional id of the playlist snapshot zrYou're using `user_playlist_remove_specific_occurrences_of_tracks(...)`, which is marked as deprecated by Spotify.rrzuri positionsrrrrrz /playlists/rr)rrrr~appendrrs) r)rrrrrftrackstrrhr+r+r,3user_playlist_remove_specific_occurrences_of_tracks s& z;Spotify.user_playlist_remove_specific_occurrences_of_trackscCstdt||S)a This function is no longer in use, please use the recommended function in the warning! Add the current authenticated user as a follower of a playlist. .. deprecated:: This method is deprecated and may be removed in a future version. Use `current_user_follow_playlist(playlist_id)` instead. Parameters: - playlist_owner_id - the user id of the playlist owner - playlist_id - the id of the playlist zBYou should use `current_user_follow_playlist(playlist_id)` instead)rrrcurrent_user_follow_playlist)r)playlist_owner_idrr+r+r,user_playlist_follow_playlist4s z%Spotify.user_playlist_follow_playlistcCstdt|||S)a This function is no longer in use, please use the recommended function in the warning! Check to see if the given users are following the given playlist .. deprecated:: This method is deprecated and may be removed in a future version. Use `playlist_is_following(playlist_id, user_ids)` instead. Parameters: - playlist_owner_id - the user id of the playlist owner - playlist_id - the id of the playlist - user_ids - the ids of the users that you want to check to see if they follow the playlist. Maximum: 5 ids. zEYou should use `playlist_is_following(playlist_id, user_ids)` instead)rrrplaylist_is_following)r)rruser_idsr+r+r,user_playlist_is_followingGs z"Spotify.user_playlist_is_followingcCshi}t|tr||d<t|tr(||d<t|tr:||d<t|trL||d<|jd|d||dS)a Changes a playlist's name and/or public/private state, collaborative state, and/or description Parameters: - playlist_id - the id of the playlist - name - optional name of the playlist - public - optional is the playlist public - collaborative - optional is the playlist collaborative - description - optional description of the playlist rrrrrrr)r#strboolrtr~)r)rrrrrrKr+r+r,r^s    zSpotify.playlist_change_detailscCs|d|d|dS)z Unfollows (deletes) a playlist for the current authenticated user Parameters: - playlist_id - the id of the playlist rr /followers)rsr~)r)rr+r+r,r~sz&Spotify.current_user_unfollow_playlistcs6d|}fdd|D}jd|d||dS)z Adds tracks/episodes to a playlist Parameters: - playlist_id - the id of the playlist - items - a list of track/episode URIs or URLs - position - the position to add the tracks rcsg|]}d|qSrrrr1r+r,rsz.Spotify.playlist_add_items..rr)rhr)r~rr)r)ritemsrrrr+r1r,rs  zSpotify.playlist_add_itemscs<d|}fdd|D}d|i}jd|d|dS)z Replace all tracks/episodes in a playlist Parameters: - playlist_id - the id of the playlist - items - list of track/episode ids to comprise playlist rcsg|]}d|qSrrrr1r+r,rsz2Spotify.playlist_replace_items..urisrrrr)r)rr rrrhr+r1r,rs  zSpotify.playlist_replace_itemscCs:|d|}|||d}|r$||d<|jd|d|dS)a Reorder tracks in a playlist Parameters: - playlist_id - the id of the playlist - range_start - the position of the first track to be reordered - range_length - optional the number of tracks to be reordered (default: 1) - insert_before - the position where the tracks should be inserted - snapshot_id - optional playlist's snapshot ID r)rrrrrrrr)r)rrrrrrrhr+r+r,rs  zSpotify.playlist_reorder_itemscsRd|}fdd|D}ddd|Di}|r<||d<jd|d|d S) a< Removes all occurrences of the given tracks/episodes from the given playlist Parameters: - playlist_id - the id of the playlist - items - list of track/episode ids to remove from the playlist - snapshot_id - optional id of the playlist snapshot rcsg|]}d|qSrrrr1r+r,rszDSpotify.playlist_remove_all_occurrences_of_items..rcSsg|] }d|iqS)rr+)rrzr+r+r,rsrrrr)r~rs)r)rr rrrrhr+r1r,rs  z0Spotify.playlist_remove_all_occurrences_of_itemscCsd|d|}g}|D]$}||d|d|ddqd|i}|rN||d<|jd|d |d S) aK Removes all occurrences of the given tracks from the given playlist Parameters: - playlist_id - the id of the playlist - items - an array of objects containing Spotify URIs of the tracks/episodes to remove with their current positions in the playlist. For example: [ { "uri":"4iV5W9uYEdYUVa79Axb7Rh", "positions":[2] }, { "uri":"1301WleyT98MSxVHPZCA6M", "positions":[7] } ] - snapshot_id - optional id of the playlist snapshot rrzrrrrrrrr)r~rrrs)r)rr rrrrrhr+r+r,-playlist_remove_specific_occurrences_of_itemss  z5Spotify.playlist_remove_specific_occurrences_of_itemscCs|jd|dd|idS)z Add the current authenticated user as a follower of a playlist. Parameters: - playlist_id - the id of the playlist rr rrrt)r)rrr+r+r,rs z$Spotify.current_user_follow_playlistcCs d|dd|}||S)a$ Check to see if the given users are following the given playlist Parameters: - playlist_id - the id of the playlist - user_ids - the ids of the users that you want to check to see if they follow the playlist. Maximum: 5 ids. rz/followers/contains?ids=rrrq)r)rrendpointr+r+r,r s zSpotify.playlist_is_followingcCs |dS)zv Get detailed profile information about the current user. An alias for the 'current_user' method. zme/rvr1r+r+r,mesz Spotify.mecCs|S)zl Get detailed profile information about the current user. An alias for the 'me' method. )rr1r+r+r, current_userszSpotify.current_usercCs|jd|d|dS)aa Get information about the current users currently playing track. Parameters: - market - An ISO 3166-1 alpha-2 country code or the string from_token. - additional_types - list of item types to return. valid types are: track and episode me/player/currently-playingrr|rrr)r|rr+r+r,current_user_playing_track$s z"Spotify.current_user_playing_trackcCs|jd|||dS)aN Gets a list of the albums saved in the current authorized user's "Your Music" library Parameters: - limit - the number of albums to return (MAX_LIMIT=50) - offset - the index of the first album to return - market - an ISO 3166-1 alpha-2 country code. z me/albumsrrvr)rrr|r+r+r,current_user_saved_albums3s z!Spotify.current_user_saved_albumscs&fdd|D}dd|S)z Add one or more albums to the current user's "Your Music" library. Parameters: - albums - a list of album URIs, URLs or IDs csg|]}d|qSrrrr1r+r,rFsz9Spotify.current_user_saved_albums_add..zme/albums?ids=rrtrr)ralistr+r1r,current_user_saved_albums_add?sz%Spotify.current_user_saved_albums_addcs&fdd|D}dd|S)z Remove one or more albums from the current user's "Your Music" library. Parameters: - albums - a list of album URIs, URLs or IDs csg|]}d|qSrrrr1r+r,rPsz.zme/albums/?ids=rrsrrr+r1r, current_user_saved_albums_deleteIsz(Spotify.current_user_saved_albums_deletecs&fdd|D}dd|S)u Check if one or more albums is already saved in the current Spotify user’s “Your Music” library. Parameters: - albums - a list of album URIs, URLs or IDs csg|]}d|qSrrrr1r+r,rZsz>Spotify.current_user_saved_albums_contains..zme/albums/contains?ids=rrrr+r1r,"current_user_saved_albums_containsSsz*Spotify.current_user_saved_albums_containscCs|jd|||dS)a> Gets a list of the tracks saved in the current authorized user's "Your Music" library Parameters: - limit - the number of tracks to return - offset - the index of the first track to return - market - an ISO 3166-1 alpha-2 country code z me/tracksrrvrr+r+r,current_user_saved_tracks]s z!Spotify.current_user_saved_trackscs2g}|dk rfdd|D}dd|S)z Add one or more tracks to the current user's "Your Music" library. Parameters: - tracks - a list of track URIs, URLs or IDs Ncsg|]}d|qSrrrr1r+r,rrsz9Spotify.current_user_saved_tracks_add..me/tracks/?ids=rrr)rrr+r1r,current_user_saved_tracks_addisz%Spotify.current_user_saved_tracks_addcs2g}|dk rfdd|D}dd|S)z Remove one or more tracks from the current user's "Your Music" library. Parameters: - tracks - a list of track URIs, URLs or IDs Ncsg|]}d|qSrrrr1r+r,r~sz.r rrr!r+r1r, current_user_saved_tracks_deleteusz(Spotify.current_user_saved_tracks_deletecs2g}|dk rfdd|D}dd|S)u Check if one or more tracks is already saved in the current Spotify user’s “Your Music” library. Parameters: - tracks - a list of track URIs, URLs or IDs Ncsg|]}d|qSrrrr1r+r,rsz>Spotify.current_user_saved_tracks_contains..zme/tracks/contains?ids=rrr!r+r1r,"current_user_saved_tracks_containssz*Spotify.current_user_saved_tracks_containscCs|jd|||dS)aD Gets a list of the episodes saved in the current authorized user's "Your Music" library Parameters: - limit - the number of episodes to return - offset - the index of the first episode to return - market - an ISO 3166-1 alpha-2 country code z me/episodesrrvrr+r+r,current_user_saved_episodess z#Spotify.current_user_saved_episodescs2g}|dk rfdd|D}dd|S)z Add one or more episodes to the current user's "Your Music" library. Parameters: - episodes - a list of episode URIs, URLs or IDs Ncsg|]}d|qSrrrr1r+r,rsz;Spotify.current_user_saved_episodes_add..me/episodes/?ids=rrr)rZelistr+r1r,current_user_saved_episodes_addsz'Spotify.current_user_saved_episodes_addcs2g}|dk rfdd|D}dd|S)z Remove one or more episodes from the current user's "Your Music" library. Parameters: - episodes - a list of episode URIs, URLs or IDs Ncsg|]}d|qSrrrr1r+r,rsz>Spotify.current_user_saved_episodes_delete..r&rrr'r+r1r,"current_user_saved_episodes_deletesz*Spotify.current_user_saved_episodes_deletecs2g}|dk rfdd|D}dd|S)u Check if one or more episodes is already saved in the current Spotify user’s “Your Music” library. Parameters: - episodes - a list of episode URIs, URLs or IDs Ncsg|]}d|qSrrrr1r+r,rsz@Spotify.current_user_saved_episodes_contains..zme/episodes/contains?ids=rrr'r+r1r,$current_user_saved_episodes_containssz,Spotify.current_user_saved_episodes_containscCs|jd|||dS)a; Gets a list of the shows saved in the current authorized user's "Your Music" library Parameters: - limit - the number of shows to return - offset - the index of the first show to return - market - an ISO 3166-1 alpha-2 country code zme/showsrrvrr+r+r,current_user_saved_showss z Spotify.current_user_saved_showscs&fdd|D}dd|S)z Add one or more albums to the current user's "Your Music" library. Parameters: - shows - a list of show URIs, URLs or IDs csg|]}d|qSrrrr1r+r,rsz8Spotify.current_user_saved_shows_add..z me/shows?ids=rrr)rslistr+r1r,current_user_saved_shows_addsz$Spotify.current_user_saved_shows_addcs&fdd|D}dd|S)z Remove one or more shows from the current user's "Your Music" library. Parameters: - shows - a list of show URIs, URLs or IDs csg|]}d|qSrrrr1r+r,rsz;Spotify.current_user_saved_shows_delete..zme/shows/?ids=rrr,r+r1r,current_user_saved_shows_deletesz'Spotify.current_user_saved_shows_deletecs&fdd|D}dd|S)u Check if one or more shows is already saved in the current Spotify user’s “Your Music” library. Parameters: - shows - a list of show URIs, URLs or IDs csg|]}d|qSrrrr1r+r,rsz=Spotify.current_user_saved_shows_contains..zme/shows/contains?ids=rrr,r+r1r,!current_user_saved_shows_containssz)Spotify.current_user_saved_shows_containscCs|jdd||dS)a  Gets a list of the artists followed by the current authorized user Parameters: - limit - the number of artists to return - after - the last artist ID retrieved from the previous request z me/followingr)rrafterrv)r)rr1r+r+r,current_user_followed_artistss z%Spotify.current_user_followed_artistscs4g}|dk rfdd|D}jdd|ddS)z Check if the current user is following certain artists Returns list of booleans respective to ids Parameters: - ids - a list of artist URIs, URLs or IDs Ncsg|]}d|qSrrrir1r+r,rsz:Spotify.current_user_following_artists..me/following/containsrridsrrr)r7Zidlistr+r1r,current_user_following_artistssz&Spotify.current_user_following_artistscs4g}|dk rfdd|D}jdd|ddS)z Check if the current user is following certain users Returns list of booleans respective to ids Parameters: - ids - a list of user URIs, URLs or IDs Ncsg|]}d|qS)rrr3r1r+r,r sz8Spotify.current_user_following_users..r5rrr6rr8r+r1r,current_user_following_userssz$Spotify.current_user_following_users medium_termcCs|jd|||dS)a_ Get the current user's top artists Parameters: - limit - the number of entities to return (max 50) - offset - the index of the first entity to return - time_range - Over what time frame are the affinities computed Valid-values: short_term, medium_term, long_term zme/top/artists time_rangerrrvr)rrr=r+r+r,current_user_top_artistss z Spotify.current_user_top_artistscCs|jd|||dS)aU Get the current user's top tracks Parameters: - limit - the number of entities to return - offset - the index of the first entity to return - time_range - Over what time frame are the affinities computed Valid-values: short_term, medium_term, long_term z me/top/tracksr<rvr>r+r+r,current_user_top_tracks s zSpotify.current_user_top_trackscCs|jd|||dS)a; Get the current user's recently played tracks Parameters: - limit - the number of entities to return - after - unix timestamp in milliseconds. Returns all items after (but not including) this cursor position. Cannot be used if before is specified. - before - unix timestamp in milliseconds. Returns all items before (but not including) this cursor position. Cannot be used if after is specified zme/player/recently-played)rr1beforerv)r)rr1rAr+r+r,current_user_recently_played/s z$Spotify.current_user_recently_playedcCs|dd|S)zi Follow one or more artists Parameters: - ids - a list of artist IDs me/following?type=artist&ids=rrr)r7r+r+r,user_follow_artistsBszSpotify.user_follow_artistscCs|dd|S)ze Follow one or more users Parameters: - ids - a list of user IDs me/following?type=user&ids=rrrDr+r+r,user_follow_usersIszSpotify.user_follow_userscCs|dd|S)zk Unfollow one or more artists Parameters: - ids - a list of artist IDs rCrrrDr+r+r,user_unfollow_artistsPszSpotify.user_unfollow_artistscCs|dd|S)zg Unfollow one or more users Parameters: - ids - a list of user IDs rFrrrDr+r+r,user_unfollow_usersWszSpotify.user_unfollow_userscCs"tdt|jd|||||dS)a Get a list of Spotify featured playlists .. deprecated:: This endpoint has been removed by Spotify and is no longer available. Parameters: - locale - The desired language, consisting of a lowercase ISO 639-1 alpha-2 language code and an uppercase ISO 3166-1 alpha-2 country code, joined by an underscore. - country - An ISO 3166-1 alpha-2 country code. - timestamp - A timestamp in ISO 8601 format: yyyy-MM-ddTHH:mm:ss. Use this parameter to specify the user's local time to get results tailored for that specific date and time in the day - limit - The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50 - offset - The index of the first item to return. Default: 0 (the first object). Use with limit to get the next set of items. zQYou're using `featured_playlists(...)`, which is marked as deprecated by Spotify.zbrowse/featured-playlists)localer timestamprrrrrrq)r)rJrrKrrr+r+r,featured_playlists^szSpotify.featured_playlistscCs|jd|||dS)a Get a list of new album releases featured in Spotify Parameters: - country - An ISO 3166-1 alpha-2 country code. - limit - The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50 - offset - The index of the first item to return. Default: 0 (the first object). Use with limit to get the next set of items. zbrowse/new-releasesrrrrv)r)rrrr+r+r, new_releasess zSpotify.new_releasescCs|jd|||dS)a Get info about a category Parameters: - category_id - The Spotify category ID for the category. - country - An ISO 3166-1 alpha-2 country code. - locale - The desired language, consisting of an ISO 639-1 alpha-2 language code and an ISO 3166-1 alpha-2 country code, joined by an underscore. browse/categories/)rrJrv)r) category_idrrJr+r+r,categorys zSpotify.categorycCs|jd||||dS)an Get a list of categories Parameters: - country - An ISO 3166-1 alpha-2 country code. - locale - The desired language, consisting of an ISO 639-1 alpha-2 language code and an ISO 3166-1 alpha-2 country code, joined by an underscore. - limit - The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50 - offset - The index of the first item to return. Default: 0 (the first object). Use with limit to get the next set of items. zbrowse/categories)rrJrrrv)r)rrJrrr+r+r, categoriesszSpotify.categoriescCs&tdt|jd|d|||dS)a Get a list of playlists for a specific Spotify category .. deprecated:: This endpoint has been removed by Spotify and is no longer available. Parameters: - category_id - The Spotify category ID for the category. - country - An ISO 3166-1 alpha-2 country code. - limit - The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50 - offset - The index of the first item to return. Default: 0 (the first object). Use with limit to get the next set of items. zQYou're using `category_playlists(...)`, which is marked as deprecated by Spotify.rPrrNrL)r)rQrrrr+r+r,category_playlistss zSpotify.category_playlistsc  stdtt|d}|r6dfdd|D|d<|rHd||d<|rhdfdd|D|d <|rt||d <d D]*}d D] } | |} | |kr|| || <qqxjd|S)ak Get a list of recommended tracks for one to five seeds. (at least one of `seed_artists`, `seed_tracks` and `seed_genres` are needed) .. deprecated:: This endpoint has been removed by Spotify and is no longer available. Parameters: - seed_artists - a list of artist IDs, URIs or URLs - seed_tracks - a list of track IDs, URIs or URLs - seed_genres - a list of genre names. Available genres for recommendations can be found by calling recommendation_genre_seeds - country - An ISO 3166-1 alpha-2 country code. If provided, all results will be playable in this country. - limit - The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 100 - min/max/target_ - For the tuneable track attributes listed in the documentation, these values provide filters and targeting on results. zNYou're using `recommendations(...)`, which is marked as deprecated by Spotify.)rrcsg|]}d|qSrrrr1r+r,r sz+Spotify.recommendations.. seed_artists seed_genrescsg|]}d|qSrrrr1r+r,rs seed_tracksr|)Z acousticnessZ danceabilityZ duration_msZenergyZinstrumentalnesskeyZlivenessZloudnessmodeZ popularityZ speechinessZtempoZtime_signatureZvalence)Zmin_Zmax_Ztarget_recommendations)rZ)rrrrRrrq) r)rUrVrWrrrprH attributerparamr+r1r,rZs.! zSpotify.recommendationscCstdt|dS)z Get a list of genres available for the recommendations function. .. deprecated:: This endpoint has been removed by Spotify and is no longer available. zYYou're using `recommendation_genre_seeds(...)`, which is marked as deprecated by Spotify.z%recommendations/available-genre-seedsrLr1r+r+r,recommendation_genre_seeds,s z"Spotify.recommendation_genre_seedscCs&tdt|d|}|d|S)z Get audio analysis for a track based upon its Spotify ID .. deprecated:: This endpoint has been removed by Spotify and is no longer available. Parameters: - track_id - a track URI, URL or ID zMYou're using `audio_analysis(...)`, which is marked as deprecated by Spotify.rzzaudio-analysis/r)r)rrr+r+r,audio_analysis9s  zSpotify.audio_analysiscsptdtt|tr2d|}d|}n&fdd|D}dd|}d|krh|dS|SdS) a+ Get audio features for one or multiple tracks based upon their Spotify IDs .. deprecated:: This endpoint has been removed by Spotify and is no longer available. Parameters: - tracks - a list of track URIs, URLs or IDs, maximum: 100 ids zMYou're using `audio_features(...)`, which is marked as deprecated by Spotify.rzzaudio-features/?ids=csg|]}d|qSrrrr1r+r,r]sz*Spotify.audio_features..raudio_featuresN)rrrr#rr~rqr)r)rZtrackidrirr+r1r,r_Js   zSpotify.audio_featurescCs |dS)z1 Get a list of user's available devices. zme/player/devicesrvr1r+r+r,devicesfszSpotify.devicescCs|jd||dS)z Get information about user's current playback. Parameters: - market - an ISO 3166-1 alpha-2 country code. - additional_types - `episode` to get podcast track information me/playerrrvrr+r+r,current_playbackkszSpotify.current_playbackcCs|jd||dS)z Get user's currently playing track. Parameters: - market - an ISO 3166-1 alpha-2 country code. - additional_types - `episode` to get podcast track information rrrvrr+r+r,currently_playingtszSpotify.currently_playingcCs|g|d}|jd|dS)ac Transfer playback to another device. Note that the API accepts a list of device ids, but only actually supports one. Parameters: - device_id - transfer playback to this device - force_play - true: after transfer, play. false: keep current state. )Z device_idsZplayrarr )r) device_idZ force_playrKr+r+r,transfer_playback~s zSpotify.transfer_playbackcCs|dk r|dk rtddS|dk r>t|ts>tddSi}|dk rR||d<|dk rb||d<|dk rr||d<|dk r||d<|j|d||d S) a Start or resume user's playback. Provide a `context_uri` to start playback of an album, artist, or playlist. Provide a `uris` list to start playback of one or more tracks. Provide `offset` as {"position": } or {"uri": ""} to start playback at a particular offset. Parameters: - device_id - device target for playback - context_uri - spotify context uri to play - uris - spotify track uris - offset - offset into context by index or track - position_ms - (optional) indicates from what position to start playback. Must be a positive number. Passing in a position that is greater than the length of the track will cause the player to start playing the next song. Nz,Specify either context uri or uris, not bothzURIs must be a list context_urir r position_mszme/player/playr)rVwarningr#rrt_append_device_id)r)rdrfr rrgrKr+r+r,start_playbacks&   zSpotify.start_playbackcCs||d|S)zr Pause user's playback. Parameters: - device_id - device target for playback zme/player/pause)rtrir)rdr+r+r,pause_playbackszSpotify.pause_playbackcCs||d|S)z Skip user's playback to next track. Parameters: - device_id - device target for playback zme/player/nextrrrirkr+r+r, next_trackszSpotify.next_trackcCs||d|S)z Skip user's playback to previous track. Parameters: - device_id - device target for playback zme/player/previousrmrkr+r+r,previous_tracks zSpotify.previous_trackcCs0t|tstddS||d||S)z Seek to position in current track. Parameters: - position_ms - position in milliseconds to seek to - device_id - device target for playback zPosition_ms must be an integerNzme/player/seek?position_ms=r#intrVrhrtri)r)rgrdr+r+r, seek_tracks  zSpotify.seek_trackcCs2|dkrtddS||d||dS)z Set repeat mode for playback. Parameters: - state - `track`, `context`, or `off` - device_id - device target for playback )rzcontextoffz Invalid stateNzme/player/repeat?state=)rVrhrtrir)staterdr+r+r,repeats zSpotify.repeatcCsRt|tstddS|dks(|dkr6tddS||d||dS)z Set playback volume. Parameters: - volume_percent - volume between 0 and 100 - device_id - device target for playback zVolume must be an integerNrrz+Volume must be between 0 and 100, inclusivez me/player/volume?volume_percent=rp)r)Zvolume_percentrdr+r+r,volumes   zSpotify.volumecCs@t|tstddSt|}||d||dS)z Toggle playback shuffling. Parameters: - state - true or false - device_id - device target for playback zstate must be a booleanNzme/player/shuffle?state=)r#rrVrhrlowerrtrirur+r+r,shuffles   zSpotify.shufflecCs |dS)z Gets the current user's queue zme/player/queuervr1r+r+r,queuesz Spotify.queuecCs6|d|}d|}|dk r,|d|7}||S)a Adds a song to the end of a user's queue If device A is currently playing music, and you try to add to the queue and pass in the id for device B, you will get a 'Player command failed: Restriction violated' error I therefore recommend leaving device_id as None so that the active device is targeted :param uri: song uri, id, or url :param device_id: the id of a Spotify device. If None, then the active device is used. rzzme/player/queue?uri=N &device_id=)rrr)r)rrdrr+r+r, add_to_queues   zSpotify.add_to_queuecCs |dS)z Get the list of markets where Spotify is available. Returns a list of the countries in which Spotify is available, identified by their ISO 3166-1 alpha-2 country code with additional country codes for special territories. rrvr1r+r+r,available_markets1szSpotify.available_marketscCs.|r*d|kr|d|7}n|d|7}|S)zr Append device ID to API path. Parameters: - device_id - device id to append ?r|z ?device_id=r+)r)pathrdr+r+r,ri8s zSpotify._append_device_idcCsttj|}|dk r>|}|d|kr6tddd|dSttj|}|dk r||}|d|krttddd|dSttj|dk r|StddddS)NrirQzUnexpected Spotify URI type.idzUnexpected Spotify URL type.zUnsupported URL / URI.)rerr_regex_spotify_uri groupdictr_regex_spotify_url _regex_base62)r)rrZ uri_matchZuri_match_groupsZ url_matchZurl_match_groupsr+r+r,r~Es    zSpotify._get_idcCs*||r|Sd|d|||SdS)Nzspotify::)_is_urir~)r)rrr+r+r,r]s zSpotify._get_uricCsttj|dk Sr.)rrrr)r)rr+r+r,rcszSpotify._is_uric Cs|r$||kr$|}td|dttt}dd|dD}d} |D]} |jd||||| d} |D]} | | || | <t|| | d |kr|| | d d||| | d <| t|| | d 7} |rf||| krf|| }qf|rH| |krH|SqH|S) Nz!limit was auto-adjusted to equal z$ as it must not be higher than totalcSsg|] }|dqS)rr+)r item_typer+r+r,rnsz4Spotify._search_multiple_markets..rrrrr )rrrrrRsplitrqlen) r)rrrrrr9riZ item_typescountrrxrr+r+r,rfs8    z Spotify._search_multiple_marketscCs2|d|}d|}|r(|d|7}||S)z Get Spotify catalog information for a single audiobook identified by its unique Spotify ID. Parameters: - id - the Spotify ID for the audiobook - market - an ISO 3166-1 alpha-2 country code. audiobook audiobooks/rr})r)rr| audiobook_idrr+r+r, get_audiobooks   zSpotify.get_audiobookcs>fdd|D}dd|}|r4|d|7}|S)z Get Spotify catalog information for multiple audiobooks based on their Spotify IDs. Parameters: - ids - a list of Spotify IDs for the audiobooks - market - an ISO 3166-1 alpha-2 country code. csg|]}d|qS)rr)rrr1r+r,rsz*Spotify.get_audiobooks..zaudiobooks?ids=rrr)r)r7r|Z audiobook_idsrr+r1r,get_audiobookss zSpotify.get_audiobookscCs>|d|}d|d|d|}|r4|d|7}||S)u7 Get Spotify catalog information about an audiobook’s chapters. Parameters: - id - the Spotify ID for the audiobook - market - an ISO 3166-1 alpha-2 country code. - limit - the maximum number of items to return - offset - the index of the first item to return rrz/chapters?limit=z&offset=rr})r)rr|rrrrr+r+r,get_audiobook_chapterss zSpotify.get_audiobook_chapters)NN)NN)NN)NN)N)N)NNNrr)r)N)rrN)N)N)N)rrN)N)N)rrrzN)rrrzNN)rr)NNr)NrrNr)NrrNr)NNN)NNNrrN)rr)TFr)NNNN)N)N)rN)N)N)NNNN)N)rN)N)N)T)Nr)rrN)rrN)N)N)N)rrN)N)N)N)rrN)rN)N)N)rrr;)rrr;)rNN)NNNrr)Nrr)NN)NNrr)NNrr)NNNrN)NN)NN)T)NNNNN)N)N)N)N)N)N)N)N)N)N)Nrr)__name__ __module__ __qualname____doc__r=rrrrrr-r/propertyrsetterr4r'rGrlrqrrrsrtruryrzrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr rrrrrrrrrrr"r#r$r%r(r)r*r+r.r/r0r2r9r:r?r@rBrErGrHrIrMrOrRrSrTrZr]r^r_r`rbrcrerjrlrnrorrrwrxrzr{r}r~rir~rrrrrrr+r+r+r,rsJ  G   J         %              #    #  !   $  )              )"K    +       ")r__all__rTloggingrr collectionsrr$Zspotipy.exceptionsrZ spotipy.utilrr getLoggerrrVrr+r+r+r,s