gd ddlZddlZddlZddlZddlZddlZddlZddlZddlZddl m cm Z ddl m Z ddlmZddlmZddlmZddlmZdZej*dZd Zgd ZeDcgc]}|d z c}Zd d gZddgZidddgezdgdezezezdgdddgezezdgdezezezdddgezezddgezezezdgdezezezdgdezezdgdezezezd ddgezd!ddgezezezd"ed#gdezd$gd%d&d'gd(d)gZdgezezezdgezezezdgezezezd*d+gezezezgd,ezdgezezd*gezezezeddgezezezd- Zgd.Zgd/Zgd0gd1gd2gd3gd4gd5gd6gd7gd8gd9gd:gd;d< Z Gd=d>Z!Gd?d@Z"GdAdBZ#GdCdDe$Z%GdEdFe%Z&GdGdHe&Z'GdIdJe&Z(GdKdLe&Z)GdMdNe%Z*GdOdPe*Z+GdQdRe*Z,GdSdTe*Z-dUZ.dVZ/dWZ0ggfdXZ1dYZ2dZZ3d[Z4d\Z5d]xa6a7d^a8d_a9d]a:d]a;d`Zdda?dea@d_aAddfZBGdgdheCZDGdidjejZFGdkdlejZHGdmdnejZJddoZKeLe dpre je jfZOn e jZOdqZPdrZQeQaRdsaSddtZTdduZUeDdve"dbdddfdwZVdxZWgifdyZXd]idddbfdzZYd{ZZd|Z[d}Z\e2dgggfd~Z]e2dgggfdZ^e2dgggfdZ_e2dgggfdZ`e2dgggfdZae2dgggfdZbe2dgggfdZce2dgggfdZde2dgggfdZee2d gfdZfe2d!gfdZge2d"gfdZhe4dddZie4dddZje4dddZke4dddZle4dddZme4dddZne4dddZoe4d ddZpe4dddZqe4d ddZre4d ddZse4d!ddZte2d#gdd_dfdZue2dgggfdZve2d!gfdZwggfdZxe3dddddgddfdZye3ddddgddfdZze3ddgddfdZ{e3ddgddfdZ|e3dddgddfdZ}e3ddddddgggddf dZ~e3dddggddfdZe3d"dgddfdZe3d!dgddfdZdZdZddZddZddZddZddZddZdZdZdZdZgfdZgfdZycc}w)N)expat)warn)mbxml)util)compatz0.7.1musicbrainzngsz([+\-&|!(){}\[\]\^"~*?:\\\/])) areaartistlabelplaceevent recordingrelease release-groupseriesurlwork instrumentz-relstags user-tagsratings user-ratingsr aliases annotationr ) recordingsreleasesrelease-groupsworkszvarious-artistsdiscidsmediaisrcsrrrr )rrr rrr r r) artistsrrr artist-creditsr!work-level-relsrrr) r"labelsrrr r#rr!zrecording-level-relsr$rrr)r"rrr r#rrrrrdiscidisrc)r"rr!iswcr" collectionrr#r!)r#r%rr!rr r) r r r rrr rrr)natalbumsingleep broadcastother compilation soundtrack spokenword interview audiobookliveremixzdj-mixzmixtape/street)official promotionbootlegzpseudo-release)entitynametexttype)aidaliasr areaaccentbegincommentendendedisoiso1iso2iso3sortnametagr=)r?r aridr artistaccentrA beginarearBcountryrCendarearDgenderipiisni primary_aliasrIrJr=)r>r?r rKr rArBeidrCrDr eventaccentpidr rJr=)r?rB descriptioniidrinstrumentaccentrJr=)r?r rAcoderBrNrCrDrQr labelaccentlaid release_countrIrJr=) addressr?r rArBrCrDlatlongrVr placeaccentr=)r?rKr artistnamerBrN creditnamedatedurformatr'numberposition primarytypeqdurrrecordingaccentreidrrgidrid secondarytypestatusrJtidtnumtracks tracksreleaser=video)r?rKr rbrBrcrirlr releasegroupreleasegroupaccentrrmrorprJr=)r?rKr rbasinbarcodecatnorBrNrcrdr discidsmediumrfr r\langmediumsriqualityrlr releaseaccentrmscriptrorprJrs tracksmediumr=)r?rBorderingattributer seriesaccentsidrJr=)r?rKr rBr(r|rrecording_countrnrJr=widr workaccent) rr r r rr r rrrrrc eZdZy)AUTH_YESN__name__ __module__ __qualname__//opt/Tautulli/lib/musicbrainzngs/musicbrainz.pyrrrrc eZdZy)AUTH_NONrrrrrrrrrc eZdZy) AUTH_IFSETNrrrrrrrrrceZdZdZy)MusicBrainzErrorz5Base class for all exceptions related to MusicBrainz.Nrrr__doc__rrrrrs<rrceZdZdZy) UsageErrorz*Error related to misuse of the module API.Nrrrrrrs1rrc eZdZy)InvalidSearchFieldErrorNrrrrrrsrrc&eZdZdfd ZdZxZS)InvalidIncludeErrorcHtt| |||_||_yN)superr__init__msgreasonselfrr __class__s rrzInvalidIncludeError.__init__s!T+D1 $($+rc|jSrrrs r__str__zInvalidIncludeError.__str__ /rzInvalid IncludesNrrrrr __classcell__rs@rrr  rrc&eZdZdfd ZdZxZS)InvalidFilterErrorcHtt| |||_||_yr)rrrrrrs rrzInvalidFilterError.__init__s!D*40 $($+rc|jSrrrs rrzInvalidFilterError.__str__rrrrrs@rrrrrrceZdZdZddZdZy)WebServiceErrorz*Error related to MusicBrainz API requests.Nc ||_||_y)zFPass ``cause`` if this exception was caused by another exception. N)messagecause)rrrs rrzWebServiceError.__init__s$,$*rcx|jrd|jz}nd}|dt|jzz }|S)Nz%s, z caused by: %s)rstrr)rrs rrzWebServiceError.__str__s8 \\ $,, 3 33tzz? **# *rNN)rrrrrrrrrrrs1 rrceZdZdZy) NetworkErrorz)Problem communicating with the MB server.Nrrrrrrs0rrceZdZdZy) ResponseErrorz#Bad response sent by the MB server.Nrrrrrrs*rrceZdZdZy)AuthenticationErrorzBReceived a HTTP 401 response while accessing a protected resource.NrrrrrrsIrrc6|D]}||vstd|zy)Nz'Bad includes: %s is not a valid include)r)includesvalid_includesis r_check_includes_implrs9 G N "%'BDE'FG GGrc*t|t|yr)rVALID_INCLUDES)r:incs r_check_includesrsnV45rc0|D]}||vst|yr)r)valuesvalidvs r _check_filterrs# Qe^ A rct|tjr|g}t|tjr|g}t|tt|t |rd|vr|dk7r t d|rd|vrd|vr|dvr t di}t|rdj||d<t|rdj||d <|S) zCheck that the status or type values are valid. Then, check that the filters can be used with the given includes. Return a params dict that can be passed to _do_mb_query. rrz+Can't have a status with no release includer)rrzECan't have a release type with no releases or release-groups involved|rpr=) isinstancer basestringrVALID_RELEASE_STATUSESVALID_RELEASE_TYPESrlenjoin)r:rrelease_status release_typeparamss r_check_filter_and_make_paramsrs .&"3"34(), 1 12$~ ."89, 34(*v/B !NOO 0Zx5O:: ">? ?F >88N3x <,/v MrcXttj|g}td|SNr)listrget_docstring_implr:rs r_docstring_getrs&N&&vr23H :x 00rcXttj|g}td|Sr)rVALID_BROWSE_INCLUDESrrrs r_docstring_browsers')--fb9:H :x 00rcXttj|g}td|S)Nfields)rVALID_SEARCH_FIELDSrr)r: search_fieldss r_docstring_searchrs',00<=M 8] 33rcfd}|S)Ncdj}|i}|jr!|jjdi||_|S)N, r)rrrf)funcvstrargsr;rs r _decoratorz#_docstring_impl.._decorator!sAyy d| <<.4<<..66DL rr)r;rrs`` rrr s rrmusicbrainz.orgTc |a|ay)zySet the username and password to be used in subsequent queries to the MusicBrainz XML API that require authentication. N)userpassword)ups rauthr3s  rc|r|s td||d|dtd|dan|d|dta|d|atj dtzy) zxSet the User-Agent to be used for requests to the MusicBrainz webservice. This must be set before requests are made.z App and version can not be emptyN/z python-musicbrainzngs/z ( z )-zset user-agent to %s) ValueError_version _useragent_client_logdebug)appversioncontacts r set_useragentr ;sR g;<<@CWhX_` 9s rrBz$_DigestAuthHandler.get_authorizationsNhht$ 3#:&CIIsO"; DK++==tS$OOrctjjxstj} |j |}|jdS#t $rYwxYw)zz8_DigestAuthHandler.get_algorithm_impls..s$'++d&7&7&:;EEGrSHAchtjj|jSr)rRsha1rNrTrUs rrWz8_DigestAuthHandler.get_algorithm_impls..s$',,t'8'8';<FFHrc|d|S)N:r)sdHs rrWz8_DigestAuthHandler.get_algorithm_impls..s!q!,-r)upper)r algorithmKDr_s` @rget_algorithm_implsz&_DigestAuthHandler.get_algorithm_implss7OO%  GA % HA -"u rN)rrrrBrNrcrrrr<r<sP # rr<ceZdZdZddZdZy)_MusicbrainzHttpRequestz4 A custom request handler that allows DELETE and PUTNctjj|||gd}||vrtd|z||_y)N)GETPOSTDELETEPUTzinvalid method: %s)rRequestrrmethod)rrlrdata allowed_ms rrz _MusicbrainzHttpRequest.__init__s=..$T*.) 9 (61 22$+rc|jSr)rlrs r get_methodz"_MusicbrainzHttpRequest.get_methods rr)rrrrrrprrrreres;rrec"d}t|D]l}|r0tjd|ztj||z |r|j ||}n|j |}|j cSt+d |z|#tj$r}|jdvr t||jdvr#tjd|jzn<|jdvr t|tjd|jz|}Yd}~ d}~wtj$r"}tjd |}Yd}~Sd}~wtj$r.}tjd t|z|}Yd}~d}~wtj$rV}t!|j"t$j&r!|j"j(} | d k(rYd}~t+|d}~wt$j,$r"}tjd |}Yd}~,d}~wt$j&$r&}|j(d k(rYd}~Wt+|d}~wt.$r}t+|d}~wwxYw)zOpen an HTTP request with a given URL opener and (optionally) a request body. Transient errors lead to retries. Permanent errors and repeated errors are translated into a small set of handleable exceptions. Return a bytestring. Nzretrying after delay (#%i))iiir)iiiz HTTP error %i)izunknown HTTP error %izbad status linez miscellaneous HTTP exception: %shzsocket timeoutzretried %i times)rangerinfor&r+openreadr HTTPErrorrZrr BadStatusLine HTTPExceptionrURLErrorrrsocketerrorerrnortimeoutIOError) openerrCbody max_retriesretry_delay_deltalast_exc retry_numfexcrZs r _safe_readrs  $.!Y99 )I 56::i++,)!  CA CA &&(?.!b&4h??K     hh/! c "" O#IIo() G C (( II%018   99 8   99 /#c( :;8 !V\\* ::  D s{ C  99 8 ! ii3 C  ! C  !sm5B  JB D..JE!!J7#F  J6?H; HJH::JI1% I11 J= J  J ParseErrorc|S)zReturn the raw response (XML)r)resps rmb_parser_nullr%s Krc tj|S#t$r}t|d}~wt$r"}t |t r t|d}~wwxYw)z2Return a Python dict representing the XML responserrN)r parse_message UnicodeErrorr ExceptionrETREE_EXCEPTIONS)rrs r mb_parser_xmlr)sU""4(( '#&&  c+ ,c* *  s A , AAAxmlcD|t}t|s td|ay)zSets the function used to parse the response from the MusicBrainz web service. If no parser is given, the parser is reset to the default parser :func:`mb_parser_xml`. Nznew_parser_fun must be callable)rcallabler parser_fun)new_parser_funs r set_parserr:s(& N #:;;Jrc|dk(r |aty|dk(r'|atdttjyt d|z)aSets the format that should be returned by the Web Service. The server currently supports `xml` and `json`. This method will set a default parser for the specified format, but you can modify it with :func:`set_parser`. .. warning:: The json format used by the server is different from the json format returned by the `musicbrainzngs` internal parser when using the `xml` format! This format may change at any time. rjsonz:The json format is non-official and may change at any timezinvalid format: %sN) ws_formatrrrloadsr)fmts r set_formatrHsG e|    IJ4::-344rrgc |i}nt|xsi}tdk(r td|r t|d<tdk7r t|d<g}t |j D]C\}} t| tjr| jd} |j|| fEtjtrdndtd |zdtj|df} t j#|d | tj$d } | g} d } |t&k(r+t j#d| zt(s tdd} |t*k(r t(rt j#d| zd} | rBt-}t/|}|j1ddt(t2| j|tj4| }t7|| |}|j9dtt j#dtz|r|j9ddn%|s#|j;ds|j9ddt=|||}t?|S)aGMakes a request for the specified `path` (endpoint) on /ws/2 on the globally-specified hostname. Parses the responses and returns the resulting object. `auth_required` and `client_required` control whether exceptions should be raised if the username/password and client are left unspecified, respectively. rzset a proper user-agent with set_useragent("application name", "application version", "contact info (preferably URL or email for your application)")clientrrutf8r httpz/ws/2/%sz request for r) debuglevelFzAuth required for %sz2authorization required; use auth(user, pass) firstTz.Using auth for %s because user and pass is setrrz User-Agentzrequesting with UA %sz Content-Typezapplication/xml; charset=UTF-8zContent-Length0) dictrrrrsorteditemsrrunicoderMappend urlunparser r  urlencoderr HTTPHandlerrrrr/r<r:r build_openerre add_header has_headerrr)pathrl auth_requiredclient_requiredrrmrnewargskeyvaluer httpHandlerhandlersadd_auth passwordMgr authHandlerrrCrs r _mb_requestr_s/ |DzRRYZ Z XEU GTZZ\*% U eV^^ ,LL(EU|$%   fT !  C JJfc23$$2K}HH  )C/0:; ; "t CcIJ*, (5   !2BhG $  ( +F "&#t 4CNN<,JJ&34  ~'GH #..)9: '- fc4 (D d rchd|vsd|vrtS|jdr|stStStS)z^ Some calls require authentication. This returns True if a call does, False otherwise rrr))r startswithrr)r:idrs r_get_auth_typers9h.H"<   < (O rct|ts|g}t||t|||}t |}t |dkDrdj |}||d<|d|}t|d||S)apMake a single GET call to the MusicBrainz XML API. `entity` is a string indicated the type of object to be retrieved. The id may be empty, in which case the query is a search. `includes` is a list of strings that must be valid includes for the entity type. `params` is a dictionary of additional parameters for the API call. The response is parsed and returned. r rrrg)r)rrrrrrrr)r:rrrrrrrs r _do_mb_queryrsv 8T"Z("H5 V MA #$u+2D%T::rcLg}|rztj|}|rRtjtd|}|r|j d|zn1|j |j n|j ||jD]\}} |t|vrt|d|tj| } tjtd| } | sT|r|j |d| dn| j } |j |d| d|r dj|j} nd j|j} | s td d | i} |rt|| d <|rt|| d <t|dg| S)aPerform a full-text search on the MusicBrainz search server. `query` is a lucene query string when no fields are set, but is escaped when any fields are given. `fields` is a dictionary of key/value query parameters. They keys in `fields` must be valid for the given entity type. z\\\1z"%s"z! is not a valid search field for z:""z:()z AND rz#at least one query term is requiredquerylimitoffsetr)r_unicoderesubLUCENE_SPECIALrlowerrrrrstriprrr) r:rrrrstrict query_parts clean_queryrr full_queryrs r _do_mb_searchrs  e$+  ; v +,{((*+k"<<>1ZS%#F++ /2F;  -- % &&% 0%  C/0 KKMEC/01  ||K(..0*xx $**,*899 J  J&/ [&VRV,,rc&t|dtdS)z1Send a DELETE request for the specified object. riTrrrs r _do_mb_deleters D(Hd33rc&t|dtdS)z.Send a PUT request for the specified object. rjTrrs r _do_mb_putrs D%400rc*t|dtd|S)zLPerform a single POST call for an endpoint with a specified request body. rhT)rr)rrs r _do_mb_postrs D&(Dt<>rctd||S)zmGet the series with the MusicBrainz `id` as a dict with a 'series' key. *Available includes*: {includes}rrrrs rget_series_by_idr|s "h //rctd||S)ziGet the work with the MusicBrainz `id` as a dict with a 'work' key. *Available includes*: {includes}rrrs rget_work_by_idrs H --rctd||S)zgGet the url with the MusicBrainz `id` as a dict with a 'url' key. *Available includes*: {includes}rrrs r get_url_by_idrs r8 ,,rc "td|||||S)zpSearch for annotations and return a dict with an 'annotation-list' key. *Available search fields*: {fields}rrrrrrrs rsearch_annotationsr ufeVV LLrc "td|||||S)zdSearch for areas and return a dict with an 'area-list' key. *Available search fields*: {fields}r rrs r search_areasr vv FFrc "td|||||S)zhSearch for artists and return a dict with an 'artist-list' key. *Available search fields*: {fields}r rrs rsearch_artistsr 5&% HHrc "td|||||S)zfSearch for events and return a dict with an 'event-list' key. *Available search fields*: {fields}r rrs r search_eventsr % GGrc "td|||||S)zoSearch for instruments and return a dict with a 'instrument-list' key. *Available search fields*: {fields}rrrs rsearch_instrumentsr rrc "td|||||S)zeSearch for labels and return a dict with a 'label-list' key. *Available search fields*: {fields}r rrs r search_labelsr rrc "td|||||S)zeSearch for places and return a dict with a 'place-list' key. *Available search fields*: {fields}r rrs r search_placesr rrc "td|||||S)mSearch for recordings and return a dict with a 'recording-list' key. *Available search fields*: {fields}rrrs rsearch_recordingsrs eVUFF KKrc "td|||||S)rrrrs rsearch_releasesrs E65&& IIrc "td|||||S)zySearch for release groups and return a dict with a 'release-group-list' key. *Available search fields*: {fields}rrrs rsearch_release_groupsrs % OOrc "td|||||S)zfSearch for series and return a dict with a 'series-list' key. *Available search fields*: {fields}rrrs r search_seriesrrrc "td|||||S)zcSearch for works and return a dict with a 'work-list' key. *Available search fields*: {fields}rrrs r search_worksrrrcftd|gg}|r||d<|sd|d<|r||d<td|||S)aSearch for releases with a :musicbrainz:`Disc ID` or table of contents. When a `toc` is provided and no release with the disc ID is found, a fuzzy search by the toc is done. The `toc` should have to same format as :attr:`discid.Disc.toc_string`. When a `toc` is provided, the format of the discid itself is not checked server-side, so any value may be passed if searching by only `toc` is desired. If no toc matches in musicbrainz but a :musicbrainz:`CD Stub` does, the CD Stub will be returned. Prevent this from happening by passing `cdstubs=False`. By default only results that match a format that allows discids (e.g. CD) are included. To include all media formats, pass `media_format='all'`. The result is a dict with either a 'disc' , a 'cdstub' key or a 'release-list' (fuzzy match with TOC). A 'disc' has an 'offset-count', an 'offset-list' and a 'release-list'. A 'cdstub' key has direct 'artist' and 'title' keys. *Available includes*: {includes}r&)rrtocnocdstubsz media-formatr)rrrr media_formatrs rget_releases_by_discidrsN2+8Xb8:2 A||~! AaD 1vz66;;=9QQRR 5aj Vq{+FHnl[GHHW Ha 00rc.||||d}td||||S)zGet all artists linked to a recording, a release or a release group. You need to give one MusicBrainz ID. *Available includes*: {includes})rrrrr r()rr release_grouprrrrrs rbrowse_artistsr,9s,% ,F (E66 BBrc,|||d}td||||S)zGet all events linked to a area, a artist or a place. You need to give one MusicBrainz ID. *Available includes*: {includes})r r r r r*)r r r rrrrs r browse_eventsr.Fs)F 5&& AArc(d|i}td||||S)zkGet all labels linked to a relase. You need to give a MusicBrainz ID. *Available includes*: {includes}rr r*)rrrrrs r browse_labelsr0Rs!  !F 5&& AArc(d|i}td||||S)zjGet all places linked to an area. You need to give a MusicBrainz ID. *Available includes*: {includes}r r r*)r rrrrs r browse_placesr2Zs d^F 5&& AArc*||d}td||||S)zGet all recordings linked to an artist or a release. You need to give one MusicBrainz ID. *Available includes*: {includes}r rrr*)r rrrrrs rbrowse_recordingsr5bs$ "F  Xuff EErc 4|||||d} td||| | ||S)aGet all releases linked to an artist, a label, a recording or a release group. You need to give one MusicBrainz ID. You can also browse by `track_artist`, which gives all releases where some tracks are attributed to that artist, but not the whole release. You can filter by :data:`musicbrainz.VALID_RELEASE_TYPES` or :data:`musicbrainz.VALID_RELEASE_STATUSES`. *Available includes*: {includes})r track_artistr rrrr*) r r7r rr+rrrrrrs rbrowse_releasesr8ms8*$, .F  8UF  >>rc .||d}td||||g|S)zGet all release groups linked to an artist or a release. You need to give one MusicBrainz ID. You can filter by :data:`musicbrainz.VALID_RELEASE_TYPES`. *Available includes*: {includes}r4rr*)r rrrrrrs rbrowse_release_groupsr:s- "F 5L ::rc(d|i}td||||S)ztGet urls by actual URL string. You need to give a URL string as 'resource' *Available includes*: {includes}resourcerr*)r<rrrrs r browse_urlsr=s! ( #F x ??rc(d|i}td||||S)zGGet all works linked to an artist *Available includes*: {includes}r rr*)r rrrrs r browse_worksr?s!  F % @@rctddS)ztList the collections for the currently :func:`authenticated ` user as a dict with a 'collection-list' key.r)rrrrrget_collectionsrAs  b ))rcHi}|r||d<|r||d<td|d|g|S)Nrrr)rr)r)collection_typerrrs r_do_collection_queryrDs5 F fWo &vh  _&MrSY ZZrct|d||S)zList the artists in a collection. Returns a dict with a 'collection' key, which again has a 'artist-list'. See `Browsing`_ for how to use `limit` and `offset`. r"rDr)rrs rget_artists_in_collectionrHs Iuf EErct|d||S)zList the releases in a collection. Returns a dict with a 'collection' key, which again has a 'release-list'. See `Browsing`_ for how to use `limit` and `offset`. rrFrGs rget_releases_in_collectionrJs Jv FFrct|d||S)zList the events in a collection. Returns a dict with a 'collection' key, which again has a 'event-list'. See `Browsing`_ for how to use `limit` and `offset`. eventsrFrGs rget_events_in_collectionrM HeV DDrct|d||S)zList the places in a collection. Returns a dict with a 'collection' key, which again has a 'place-list'. See `Browsing`_ for how to use `limit` and `offset`. placesrFrGs rget_places_in_collectionrQrNrct|d||S)zList the recordings in a collection. Returns a dict with a 'collection' key, which again has a 'recording-list'. See `Browsing`_ for how to use `limit` and `offset`. rrFrGs rget_recordings_in_collectionrSs L% HHrct|d||S)zList the works in a collection. Returns a dict with a 'collection' key, which again has a 'work-list'. See `Browsing`_ for how to use `limit` and `offset`. rrFrGs rget_works_in_collectionrUs GUF CCrcDtj|}td|S)z,Submits a set of {release_id1: barcode, ...}r)rmake_barcode_requestr)release_barcoders rsubmit_barcodesrYs  & & 7E y% ((rct}|jD]\}}t|tr|n|g||<t j |}t d|S)zmSubmit ISRCs. Submits a set of {recording-id1: [isrc1, ...], ...} or {recording_id1: isrc, ...}. r)rrrrrmake_isrc_requestr)recording_isrcs rec2isrcsrecr!rs r submit_isrcsr_s\ I'--/G e",UD"9w #G  # #I .E {E **rc |jD]8\}}|jD] \}}t|tr|n|g|||<":tjdi|}t d|S)aSubmit user tags. Takes parameters named e.g. 'artist_tags', 'recording_tags', etc., and of the form: {entity_id1: [tag1, ...], ...} If you only have one tag for an entity you can use a string instead of a list. The user's tags for each entity will be set to that list, adding or removing tags as necessary. Submitting an empty list for an entity will remove all tags for that entity by the user. rJr)rrrrmake_tag_requestr)r,r&rrrrs r submit_tagsrbsv G1  GHB$.tT$:DF1IbM GG  " " ,V ,E ue $$rc Dtjdi|}td|S)aSubmit user ratings. Takes parameters named e.g. 'artist_ratings', 'recording_ratings', etc., and of the form: {entity_id1: rating, ...} Ratings are numbers from 0-100, at intervals of 20 (20 per 'star'). Submitting a rating of 0 will remove the user's rating. ratingr)rmake_rating_requestr)r,rs rsubmit_ratingsrfs$  % % / /E x ''rcFdj|}td|d|S)zbAdd releases to a collection. Collection and releases should be identified by their MBIDs ; collection/ /releases/)rrr)r releaselists radd_releases_to_collectionrms" ((8$K ZM NNrcFdj|}td|d|S)zgRemove releases from a collection. Collection and releases should be identified by their MBIDs rhrirj)rrrks rremove_releases_from_collectionros"((8$K  KP QQrr)F)rr)Ng@)r)rNNFr)rr r&loggingr|rRrIrFrxml.etree.ElementTreeetree ElementTree xml.parsersrwarningsrrrrrr getLoggerrrRELATABLE_TYPESRELATION_INCLUDES TAG_INCLUDESRATING_INCLUDESrrrrrrrrrrrrrrrrrrrrrrrrrrrrr r rrrr rrrrrobjectrHTTPPasswordMgrr/rAr<rkrerhasattrr ExpatErrorrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr r r rrrrrrr r"r(r,r.r0r2r5r8r:r=r?rArDrHrJrMrQrSrUrYr_rbrfrmro)r:s0rrsq      %% ! w)*1P4CD&Vg%D $ n-0 i &): :0   ) ),; ;009l()0   ) ),; ;0" y,'*;;lJ#0$ yk-- <N%0&  ' '*; ;'00  ) )10: ''*;;;0B iC0H <  & '): ;I0N O0P   Q0Z ,[0\ YK]0^:,_0dkL(?:=NN[< '/ 9 fnn 8@x 5,%%u'7'78%%      5. "' %Dt$T Tl ');,!#2 tE4-l4 1 = "2B66"$Rb88 &("<<!#BR77!#BR77!#BR 7 7 %';; #%br99 )++-B?!?"$00  ".. !--< M!M 6GG 8II 7HH < M!M 7HH 7HH ;37"L L9JJ ?#7; P$P8II 6GG(*dQU 8 8F *,R(* 8 8%'00JLZ\1&8!4trd C C7Dd4 B B74BB7bTBB;!4" F F9d$$"&rtD>>,?#!%t"#%T$ :$ :5$t@@6rdAA* [ FGEEID) +%& (57O:<Ry'Es* W