Cc Q$dZgdZddlZddlZddlmZddlmZddlm Z m Z m Z ddl m Z mZmZmZmZmZmZmZmZmZdZed \ZZZd Zd Zd ZGd deZGddeZ GddeZ!GddeZ"Gdde#Z$Gdde Z%Gdde%e Z&e&Z'ee(eedddZ)dZ*d Z+Gd!d"e#Z,eGd#d$e,Z-Gd%d&e-eZ.eGd'd(e,Z/Gd)d*e-Z0Gd+d,e Z1y)-aAPEv2 reading and writing. The APEv2 format is most commonly used with Musepack files, but is also the format of choice for WavPack and other formats. Some MP3s also have APEv2 tags, but this can cause problems with many MP3 decoders and taggers. APEv2 tags, like Vorbis comments, are freeform key=value pairs. APEv2 keys can be any ASCII string with characters from 0x20 to 0x7E, between 2 and 255 characters long. Keys are case-sensitive, but readers are recommended to be case insensitive, and it is forbidden to multiple keys which differ only in case. Keys are usually stored title-cased (e.g. 'Artist' rather than 'artist'). APEv2 values are slightly more structured than Vorbis comments; values are flagged as one of text, binary, or an external reference (usually a URI). Based off the format specification found at http://wiki.hydrogenaudio.org/index.php?title=APEv2_specification. )APEv2 APEv2FileOpendeleteN)BytesIO)MutableSequence)MetadataFileType StreamInfo) DictMixincdata delete_bytestotal_ordering MutagenErrorloadfile convert_errorseek_endget_sizereraisect|ts tddt|cxkxrdkncxr$t |dk\xrt |dkxr|dvS)NzAPEv2 key must be str ~)OggSTAGID3zMP+) isinstancestr TypeErrorlenminmaxkeys //usr/lib/python3/dist-packages/mutagen/apev2.pyis_valid_apev2_keyr'*s_ c3 /00#c( !c ! ;CD(8 ; X  ; 9 9<li@i c eZdZy)errorN__name__ __module__ __qualname__r(r&r+r+?r(r+c eZdZy)APENoHeaderErrorNr,r0r(r&r3r3Cr1r(r3c eZdZy)APEUnsupportedVersionErrorNr,r0r(r&r5r5Gr1r(r5c eZdZy)APEBadItemErrorNr,r0r(r&r7r7Kr1r(r7cTeZdZdxZxZxZxZZdZdZ dZ dZ dZ dZ dZdZdZdZdZy) _APEv2DataNrFc|j||j|j|_nC|j|j|_n%t |j|j|_|jy|j ||j ||j<|j|j|j|j|_ yy)Raises IOError and apev2.errorN) _APEv2Data__find_metadataheaderfootermetadatar#_APEv2Data__fill_missing_APEv2Data__fix_brokennessdataseekreadsizetagselffileobjs r&__init__z_APEv2Data.__init__as W% ;;  KKDM [[  KKDM T[[9DM ==  G$ g& 99 LL #||DII.DH !r(c |jdd|jddk(r/|jdd|jx|_|_y t |dkrt|jd d|jd d k(r|jd d|jddk(r(|jdd|j|_y|jd d|jddk(r|jdd t|jd}|jd|z dz d|jddk(r(|jdd|j|_y|jdd|jddk(rd|_ d|_ yy#t$r|jddYywxYw#t$rtwxYw#t$rYuwxYw)NirrAPETAGEXir)sTAGi s LYRICS200iT) rCIOErrorrDtellr>r?rint ValueError is_at_startr=)rHrIoffsets r&__find_metadataz_APEv2Data.__find_metadatavs  LLa  <<?k ) LLQ *1,,. 8DK$-   3& LLq !||A&( S!$<<?k1LLQ'"),,.DK  R#<<?l2LLa(&!$W\\!_!5LLv!115||A+5 R+&-lln   Q <<?k )#D DK *W  LLA   :&&% &   sCF=BG1 8G1G3AG1=GGG..G11 G=<G=c|j|jdz|jd}t|dk7rt|dd|_t j|dd|_t j|dd|_ t j|dd|_ |jz|jdz|_ |j|jz|_ |j|jdz d|jddk(r|jdz |_n|jl|jdz|_ |j|jz |_ |jtzr|jdz |_ n|j|_ n t!d |j|xjdzc_yy) r;rLN rrMNo APE tag found)rCr?rDr!r+versionr uint32_lerEitemsflagsr=rBendr> HAS_HEADERr3)rHrIrBs r&__fill_missingz_APEv2Data.__fill_missingsi  T]]Q&'||B t9?KBQx OOD1I. __T!BZ0 __T"#Y/ ;; " b(DIyy499,DH LLB *||A+-"hhm [[ ${{R'DH499,DIzzJ&"ii"n "ii "#56 6 ;; " IIOI #r(cf|j |j}n |j}|j||dkDrY |jdd|jddk(r#|jdd|j }n ||_y|dkDrY||_y#t $r Y||_ywxYw)NrirOrLrMrN)r=rBrCrDrUrTstart)rHrIris r&__fix_brokennessz_APEv2Data.__fix_brokennesss ;; "KKEIIE Uai  S!$<<?k1LLQ'#LLNE ai    sB B0/B0)r-r.r/rir=rBr>rer?rFrarErcrdrXrJr<r@rAr0r(r&r9r9OsV+//E/F/T/FSH CG D E E K/*3j"Hr(r9c6eZdZfdZdZdZdZdZxZS) _CIDictProxycHi|_i|_tt||i|yN)_CIDictProxy__casemap_CIDictProxy__dictsuperrlrJ)rHargskwargs __class__s r&rJz_CIDictProxy.__init__s%  lD*D;F;r(c<|j|jSrn)rplowerrHr%s r& __getitem__z_CIDictProxy.__getitem__s{{399;''r(c`|j}||j|<||j|<yrnrvrorp)rHr%valuervs r& __setitem__z_CIDictProxy.__setitem__s)  #u" Er(cX|j}|j|=|j|=yrnrz)rHr%rvs r& __delitem__z_CIDictProxy.__delitem__s%  NN5 ! KK r(c|jjDcgc]}|jj|| c}Scc}wrn)rpkeysrogetrws r&rz_CIDictProxy.keyss48< 8H8H8JK""3,KKKs#A) r-r.r/rJrxr|r~r __classcell__rts@r&rlrls<(#  Lr(rlceZdZdZdZdZeeee dZ dZ fdZ fdZ fdZeeee d d dd Zeeee d dd ZxZS)rzoAPEv2(filething=None) A file with an APEv2 tag. ID3v1 tags are silently ignored and overwritten. Ncdt|j}djd|DS)z6Return tag key=value pairs in a human-readable format. c3LK|]\}}|d|jyw)=N)pprint).0kvs r& zAPEv2.pprint..sGAa4Gs"$)sortedrcjoin)rHrcs r&rz APEv2.pprints)tzz|$zzGGGGr(ct|j}|jr7|j|j |j|j yt d)z?Load tags from a filename. Raises apev2.error r`N)r9rIrFclear_APEv2__parse_tagrcr3)rH filethingrBs r&loadz APEv2.loadsH)++, 88 JJL   TXXtzz 2"#56 6r(ct|}t|D]%}|jd}|syt|dk7rtt j |dd}t j |dd}|dzdz }|dk(r td|jdx} } | st| ddd k7r+| r)|jd} | st| | z } | ddd k7r| r)| ddd k(r| dd} | jd } |j|} t| |k7rtt|j| } | || <(y#t$r0} tt| tjd Yd} ~ |d} ~ wwxYw) z"Raises IOError and APEBadItemErrorrLNr]rSrOr)zvalue type must be 0, 1, or 2asciir)rrangerDr!r+r rbr7decode UnicodeErrorrsysexc_info_get_value_type_new) rHrFcountrIitag_datarErdkindr%r{errs r& __parse_tagzAPEv2.__parse_tag%s#,u% A||AH8}! ??8BQ<0DOOHQqM2EAI!#Dqy%&EFF!,,q/ )C%%%bc(g%% Q))u  bc(g%% 23x7"#2h Ajj)LL&E5zT!%%#D)..u5EDIK% :  AcllnQ.?@@ As(E E: &E55E:c\t|std|ztt||SN%r is not a valid APEv2 key)r'KeyErrorrqrrxrHr%rts r&rxzAPEv2.__getitem__Qs.!#&83>? ?UD-c22r(c^t|std|ztt||yr)r'rrqrr~rs r&r~zAPEv2.__delitem__Ws+!#&83>? ? eT&s+r(ct|std|zt|tst|trt |t }nut|trUg}|D].}t|ts td|j|0t dj|t }nt |t}tt|;||y)aA'Magic' value setter. This function tries to guess at what kind of value you want to store. If you pass in a valid UTF-8 or Unicode string, it treats it as a text value. If you pass in a list, it treats it as a list of string/Unicode values. If you pass in a string that is not valid UTF-8, it assumes it is a binary value. Python 3: all bytes will be assumed to be a byte value, even if they are valid utf-8. If you need to force a specific type of value (e.g. binary data that also happens to be valid UTF-8, or an external reference), use the APEValue factory and set the value to the result of that:: from mutagen.apev2 import APEValue, EXTERNAL tag['Website'] = APEValue('http://example.org', EXTERNAL) rzitem in list not strN)r'rr _APEValuerAPEValueTEXTlistr appendrBINARYrqrr|)rHr%r{rcrrts r&r|zAPEv2.__setitem__]s*"#&83>? ?%+%% -E4($A%a-'(>??LLO$ !E!2D9 / eT&sE2r(T)writablecreatec P|j}t|}|jr/t||j|j z |j n7|j +|j |j |j|j ddg}|jD]\}}|j}t|ts|jd}t}|tjdt!||j"dzz }||dz|zz }|j%t||j'd t!|} d j)|}td } | tjd d t!|dz| t*t,zz } | dz } |j/| |j/|td } | tjd d t!|dz| t*z } | dz } |j/| y)zSave changes to a file. If no filename is given, the one most recently loaded is used. Tags are always written at the end of the file, and include a header and a footer. Nrrutf-8z<2IrOrct||fSrnr!)rFs r&zAPEv2.save..s3s8S/r(r$r(rMz<4Iir_s)rIr9rXrrerirCtruncaterc_writerbytesencode bytearraystructpackr!rrsortrrf IS_HEADERwrite) rHrrIrBtagsr%r{ value_datarnum_tagsr=r>s r&savez APEv2.saves##'"    $((TZZ"7 D ZZ # LL $     Q**, )JCJc5)jj) {H  E3z?EJJ!OL LH e j0 0H KKh ( )$ 1 2t9xx~;'&++eT3t9r>8(946 6) f d;'&++eT3t9r>8(* *) fr()rc|j}t|}|j:|j.t ||j |jz |j|j y)zRemove tags from a file.N)rIr9rirErrer)rHrrIrBs r&rz APEv2.deletesR ##'" :: !dii&; $((TZZ"7 D r(rn)r-r.r/__doc__filenamerrrTr+rrrrxr~r|rrrrs@r&rrsHH 7E" Z 7# 7*X3 , )3V7E" tD):*#:x7E" t#r(rFT)methodrc t|}|jjd|j |y#t$rYywxYw)zdelete(filething) Arguments: filething (filething) Raises: mutagen.MutagenError Remove tags from a file. Nr)rr3rIrCr)rts r&rrsG ) 1HHY s : AAcx|tk(rtS|tk(rtS|tk(rt St d|z)z1Returns a _APEValue subclass or raises ValueErrorzunknown kind %r)r APETextValuerAPEBinaryValueEXTERNAL APEExtValuerW)rs r&rrs= t|    &- ..r(cZ t|}||S#t$r tdwxYw)zAPEv2 tag value factory. Use this if you need to specify the value's type manually. Binary and text data are automatically detected by APEv2.__setitem__. z&kind must be TEXT, BINARY, or EXTERNAL)rrW)r{rtype_s r&rrs<%U| CABBCs *cLeZdZUeed<dZd dZedZdZ dZ dZ dZ y) rrNc^|||jk7rt|j||_yrn)rrW _validater{)rHr{rs r&rJz_APEValue.__init__ s)   1 ^^E* r(cJ|j|}|j||Srn)__new___parse)clsrBinstances r&rz_APEValue._news!;;s#r(ct)z$Sets value or raises APEBadItemErrorNotImplementedErrorrHrBs r&rz_APEValue._parse "!r(ct)z Returns bytesrrHs r&rz_APEValue._writerr(ct)z5Returns validated value or raises TypeError/ValueErrrrrHr{s r&rz_APEValue._validate rr(c`dt|j|j|jfzS)Nz %s(%r, %d))typer-r{rrs r&__repr__z_APEValue.__repr__%s&tDz22DJJ JJJr(rn) r-r.r/rV__annotations__r{rJ classmethodrrrrrr0r(r&rrs: I E+  " " " Kr(rc<eZdZdZdZdZdZdZdZdZ dZ y ) _APEUtf8Valuec |jd|_y#t$r0}tt|t j dYd}~yd}~wwxYw)Nrr)rr{UnicodeDecodeErrorrr7rr)rHrBes r&rz_APEUtf8Value._parse,sA ;W-DJ! ; OQ q(9 : : ;s A&A  Ac<t|ts td|S)N value not str)rrr rs r&rz_APEUtf8Value._validate2s%%O, , r(c8|jjdS)Nr)r{rrs r&rz_APEUtf8Value._write7szz  ))r(c,t|jSrnr!r{rs r&__len__z_APEUtf8Value.__len__:4::r(c"|jSrnrrs r& __bytes__z_APEUtf8Value.__bytes__={{}r(c |j|k(Srnr{rHothers r&__eq__z_APEUtf8Value.__eq__@zzU""r(c |j|kSrnrrs r&__lt__z_APEUtf8Value.__lt__CzzE!!r(c|jSrnrrs r&__str__z_APEUtf8Value.__str__F zzr(N) r-r.r/rrrrrrrrr0r(r&rr)s*;  *#"r(rc>eZdZdZeZdZdZdZdZ dZ dZ dZ y ) rzAn APEv2 text value. Text values are Unicode/UTF-8 strings. They can be accessed like strings (with a null separating the values), or arrays of strings. cJt|jjdS)z:Iterate over the strings of the value (not the characters)r)iterr{splitrs r&__iter__zAPETextValue.__iter__SsDJJ$$U+,,r(c>|jjd|SNr)r{r )rHindexs r&rxzAPETextValue.__getitem__Xszz&u--r(c>|jjddzS)NrrO)r{rrs r&rzAPETextValue.__len__[szz&**r(ct|ts tdt|}|||<dj ||_yNrr)rrr rrr{rHrr{valuess r&r|zAPETextValue.__setitem__^s9%%O, ,du ZZ' r(ct|ts tdt|}|j ||dj ||_yr)rrr rinsertrr{rs r&rzAPETextValue.insertfs>%%O, ,d eU#ZZ' r(cLt|}||=dj||_yr)rrr{)rHrrs r&r~zAPETextValue.__delitem__ns"d 5MZZ' r(c$dj|S)Nz / )rrs r&rzAPETextValue.pprintss{{4  r(N) r-r.r/rrrr rxrr|rr~rr0r(r&rrJs1 D- .+((( !r(rcDeZdZdZeZdZdZdZdZ dZ dZ dZ d Z y ) rzAn APEv2 binary value.c||_yrnrrs r&rzAPEBinaryValue._parse}s  r(c|jSrnrrs r&rzAPEBinaryValue._writerr(cNt|ts tdt|S)Nzvalue not bytes)rrr rs r&rzAPEBinaryValue._validates"%'-. .U|r(c,t|jSrnrrs r&rzAPEBinaryValue.__len__rr(c"|jSrnrrs r&rzAPEBinaryValue.__bytes__rr(c |j|k(Srnrrs r&rzAPEBinaryValue.__eq__rr(c |j|kSrnrrs r&rzAPEBinaryValue.__lt__rr(cdt|zS)Nz [%d bytes]rrs r&rzAPEBinaryValue.pprintss4y((r(N)r-r.r/rrrrrrrrrrrr0r(r&rrws2 D #")r(rceZdZdZeZdZy)rzRAn APEv2 external value. External values are usually URI or IRI strings. c d|jzS)Nz [External] %srrs r&rzAPEExtValue.pprints$**,,r(N)r-r.r/rrrrr0r(r&rrs D-r(rcVeZdZdZGddeZedZdZe dZ y)rzoAPEv2File(filething) Arguments: filething (filething) Attributes: tags (`APEv2`) c*eZdZdZdZdZedZy)APEv2File._Inforcyrnr0rGs r&rJzAPEv2File._Info.__init__s r(cy)NzUnknown format with APEv2 tag.r0r0r(r&rzAPEv2File._Info.pprints4r(N)r-r.r/lengthbitraterJ staticmethodrr0r(r&_Infor&s%   5  5r(r,c|j}|j||_ |jdd t ||_y#t$r}t |d}~wwxYw#t$r d|_YywxYw)Nr) rIr,inforCrTr+rrr3)rHrrIrs r&rzAPEv2File.loadsr##JJw'   LLA  gDI  (N    DI s(AA$ A! AA!$A76A7cn|jt|_yt|d|j)Nz already has tags: )rrr+rs r&add_tagszAPEv2File.add_tagss) 99 DIT499EF Fr(c t|d|j}d|v|jdz S#t$rYywxYw)NrrMsID3)rrDrT startswith)rrIr=r>s r&scorezAPEv2File.scoresM  Wc "\\^F&&*;*;F*CCD  s4 AAN) r-r.r/rr r,rrr0r+r4r0r(r&rrsE 5 5Z  G EEr(r)2r__all__rriorcollections.abcrmutagenr r r mutagen._utilr r rrrrrrrrr'rrrrrf HAS_NO_FOOTERrr+r3r5r7objectr9rlrrrTrrrrrrrrrr0r(r&r<sd, 3 +22GGG<qfh     L  u    e UUpL9L