CcOdZddlZddlZddlZddlmZddlmZddlm Z ddl m Z m Z m Z mZmZmZmZddlmZddlmZGd d e ZGd d eZGd de Zy)a:Read and write Ogg bitstreams and pages. This module reads and writes a subset of the Ogg bitstream format version 0. It does *not* read or write Ogg Vorbis files! For that, you should use mutagen.oggvorbis. This implementation is based on the RFC 3533 standard found at http://www.xiph.org/ogg/doc/rfc3533.txt. N)BytesIO)Type)FileType)cdata resize_bytes MutagenErrorloadfileseek_endbchrreraise) StreamInfo)TagsceZdZdZy)errorzOgg stream parsing errors.N)__name__ __module__ __qualname____doc__-/usr/lib/python3/dist-packages/mutagen/ogg.pyrrs$rrc,eZdZdZdZdZdZdZdZdZ dZ ddZ dZ e jZdZdZed Zd Zed d d ZedddZedddZedZeddZedZe ddZedZeddZy)OggPageavA single Ogg page (not necessarily a single encoded packet). A page is a header of 26 bytes, followed by the length of the data, followed by the data. The constructor is given a file-like object pointing to the start of an Ogg page. After the constructor is finished it is pointing to the start of the next page. Attributes: version (`int`): stream structure version (currently always 0) position (`int`): absolute stream position (default -1) serial (`int`): logical stream serial number (default 0) sequence (`int`): page sequence number within logical stream (default 0) offset (`int` or `None`): offset this page was read from (default None) complete (`bool`): if the last packet on this page is complete (default True) packets (list[bytes]): list of raw packet data (default []) Note that if 'complete' is false, the next page's 'continued' property must be true (so set both when constructing pages). If a file-like object is supplied to the constructor, the above attributes will be filled in based on it. rNTcg|_|y|j|_|jd}t |dk(rt  t jd|\}|_|_ |_ |_ |_ }}|dk7r"td|d|jdz fz|jdk7rtd|jzd}g}|j|}t ||k7rtd |zt|D] } || z }| d ks|j|d}"|r|j|d |_|D cgc]} |j| c} |_|jD cgc] } t | c} |k7r td y#t j$rtd|zwxYwcc} wcc} w) zRaises error, IOError, EOFErrorNrz <4sBBqIIiBz"unable to read full header; got %rOggSzread %r, expected %r, at 0x%xzversion %r unsupportedzunable to read %r lacing bytesFzunable to read full data)packetstelloffsetreadlenEOFErrorstructunpackversion_OggPage__type_flagspositionserialsequencer bytearrayappendcomplete) selffileobjheaderoggscrcsegmentstotallacings lacing_bytesclps r__init__zOggPage.__init__Is ? lln b! v;! N G%mmL&A T4<!2 ]DK ( 7?7gw||~2;445 5 <<1 04<<?@ @||H- |  (88CD D<( A QJE3wu%    NN5 !!DM189A Q9  LL )qCF )W 423 3 53|| G )getattrtyperjoinsummapr"r)r.attrsattrvaluess r__repr__zOggPage.__repr__sv;DIJDT74#67JJ0 J  &!13s3 7M3N  4 KsBc Ntjdd|j|j|j|j |j dg}g}|jD]:}tt|d\}}|jd|zt|z<dj|}|js|jdr|dd }|jtt||j||j|jdj|}t!j"|j%t&j(d d z}t'j*|j%t&j(}|dd |z|d dz}|S) zReturn a string encoding of the page header and data. A ValueError is raised if the data is too big to fit in a single page. z <4sBBqIIirrrrNl)r$packr&r'r(r)r*rdivmodr"r,r rHr-endswithextendzlibcrc32 translaterbitswap to_uint_be)r.data lacing_datadatumquotremr2s rr<z OggPage.writes^ KK WdllD%cr*K D[)*+ K  DLL!xx~ 4>>%--8"==Ks#--emm<CRy3bc* rcd}|jD]"}tt|d\}}||dzz }$|js dk(r|dz}|t t t|jz }|S)zTotal frame size.rrr)rrVr"r-rIrJ)r.sizer`rarbs rrez OggPage.sizesw\\ Es5z3/ID# D1H D }} AID CT\\*++ rcjd|z}|r|xj|zc_y|xj|zc_yNrd)r')r.bitvalmasks r __set_flagzOggPage.__set_flags2Cx     %    $ & rcBtj|jdSNrrtest_bitr'r.s rzOggPage.U^^D$5$5q9rc&|jd|Srm_OggPage__set_flagr.vs rrqzOggPage.1-rz5The first packet is continued from the previous page.)doccBtj|jdSrgrnrps rrqzOggPage.rrrc&|jd|Srgrtrvs rrqzOggPage.rxrz.This is the first page of a logical bitstream.cBtj|jdSNrnrps rrqzOggPage.rrrc&|jd|Sr}rtrvs rrqzOggPage.rxrz-This is the last page of a logical bitstream.cB|} t|}|j|k7r|j|j d||_|j |j |j|j|jzd|dz }#t$rYywxYw)a*Renumber pages belonging to a specified logical stream. fileobj must be opened with mode r+b or w+b. Starting at page number 'start', renumber all pages belonging to logical stream 'serial'. Other pages will be ignored. fileobj must point to the start of a valid Ogg page; any occurring after it and part of the specified logical stream will be numbered. No adjustment will be made to the data in the pages nor the granule position; only the page number, and so also the CRC. If an error occurs (e.g. non-Ogg data is found), fileobj will be left pointing to the place in the stream the error occurred, but the invalid data will be left intact (since this function does not change the total file size). rdrN)rr)seekrer#r*r<r )r/r)startnumberpages rrenumberzOggPage.renumbers* ,w';;&( diiZ+"DM MM$**, ' LLtyy0! 4 aKF  s B BBc|dj}|dj}g}|r4|djr td|djs.td|r!|djr|j dg|D]}||jk7rtd|z||jk7rtd|z|dz }|j sO|jr"|dj |j dn|j |j dg|jd |j dd D|Dcgc]}dj|c}Scc}w) zConstruct a list of packet data from a list of Ogg pages. If strict is true, the first page must start a new packet, and the last page must end the last packet. rzfirst packet is continuedrRzlast packet does not completerzinvalid serial number in %rzbad sequence number in %rrdc3"K|]}|g ywNr).0r9s r z%OggPage.to_packets..s=qs=s N) r)r*rA ValueErrorr-r,rrXrH)pagesstrictr)r*rrr9s r to_packetszOggPage.to_packetssCq8$$ Qx!! !<==9%% !@AA uQx)) NNC5 ! >D$ !>!EFFT]]* !>BK&&t||A7NNDLLO#45=DLL,<== >&-- ---sEcj|j|}|Dcgc] }t|c}|Dcgc] }t|c}k7r|j||djSdj |}g}|D]}t }|j|_|j |_|j|_|j|_|jD]9}|dt||t|d}} |jj| ;|j||rJ|Scc}wcc}w)aLLike from_packets but in case the size and number of the packets is the same as in the given pages the layout of the pages will be copied (the page size and number will match). If the packets don't match this behaves like:: OggPage.from_packets(packets, sequence=old_pages[0].sequence) rrN) rr" from_packetsr*rHrr-rAr(rr,) clsr old_pages old_packetsr9new_data new_pagesoldnewr^s r_from_packets_try_preservez"OggPage._from_packets_try_preservesnnY/ # $qCF $(EAQ(E E##GYq\-B-BC C88G$  "C)C< OOSEJ. / !^),(:>?2K)L(MHZ!^_ %  9~X...!)X6 9NHd__}4FD I (--F C LL # MM$ !I-L i(--7 8M 9 y>S^ + LLq )r]))F }--1H LL&( 3 ,35s8J#c$t|d|j} |jd}t ||d}fd}d} t |}|j|k(r||r|jr|S|}nd} |jd t |} |j|k(r||r|}|jr |St |}4#t$r t dwxYw#t$rYuwxYw#t$r|cYSt$r|cYSwxYw)awFind the last page of the stream 'serial'. If the file is not multiplexed this function is fast. If it is, it must read the whole the stream. This finds the last page in the actual file object, or the last page in the stream (with eos set), whichever comes first. If finishing is True it returns the last page which contains a packet finishing on it. If there exist pages but none with finishing packets returns None. Returns None in case no page with the serial exists. Raises error in case this isn't a valid ogg stream. Raises IOError. irzunable to find final Ogg headerNc, xs|jdk7S)NrR)r()r finishings ris_validz#OggPage.find_last..is_valids =7DMMR$7 7rr) r r!rindexrrrrr)rCrr#) r/r)rr^indexbytesobjr best_pagers ` r find_lastzOggPage.find_lasts0( )$||~ ;KK(E4<( 8  !8$D{{f$$99K $I   Q 7#D;;&(~$( yy w' 3 ;9: : ;   .     s;C C&3C5 C5C#& C21C25 D DDr)F)rii)rrrrr&r'r(r)r*r r-r:r?object__hash__rNr<propertyrerurArBrC staticmethodrr classmethodrrrrrrrrr%s)6GLH FH FH,4\HB  '9- CEI 9- < >E 9- ; =D $$L".".H@7;!%::x=4=4~<<rrceZdZUdZeeed<eeed<eeed<ddgZ e dZ e d dd Z d Z e d dd Zy ) OggFileTypezcOggFileType(filething) An generic Ogg file. Arguments: filething (filething) _Info_Tags_Errorzapplication/oggzapplication/x-oggc|j} |j||_|j||j|_|jj |y#t tf$r6}t|j|tjdYd}~yd}~wt$r|jdwxYw)zload(filething) Load file information from a filename. Args: filething (filething) Raises: mutagen.MutagenError r~Nno appropriate stream found) r/rinfortags _post_tagsrIOErrorr rsysexc_infor#r. filethingr/es rloadzOggFileType.loads## = 7+DI 7DII6DI II  )w 7 DKKCLLN1$5 6 6 =++;< < =sAA!!B?0,B!!B?T)writableNc|j}|jj |jj|dy#t$r6}t |j |tjdYd}~yd}~wt$r|j dwxYw#t$r6}t |j |tjdYd}~yd}~wwxYw)zdelete(filething=None) Remove tags from a file. If no filename is given, the one most recently loaded is used. Args: filething (filething) Raises: mutagen.MutagenError cyrmr)xs rrqz$OggFileType.delete..2srr~Nr) r/rclear_injectrr rrrr#rrs rdeletezOggFileType.deletes##  7 A !!';7 ; Q q(9:: Akk"?@@ A 7 DKKCLLN1$5 6 6 7s5A B,B<B"BB"" C!+,CC!c|jr)rrps radd_tagszOggFileType.add_tags:s kkrc |jj|j|y#ttf$r6}t |j |tjdYd}~yd}~wt$r|j dwxYw)a)save(filething=None, padding=None) Save a tag to a file. If no filename is given, the one most recently loaded is used. Args: filething (filething) padding (:obj:`mutagen.PaddingFunction`) Raises: mutagen.MutagenError r~Nr) rrr/rrr rrrr#)r.rpaddingrs rsavezOggFileType.save=sl = II  i// 9 7 DKKCLLN1$5 6 6 =++;< < =s&)B,A))Br)NN)rrrrrr __annotations__rr_mimesr rrrrrrrrrs~   : K!4 5F Z==,t778t==rr)rr$rrYiortypingrmutagenr mutagen._utilrrrr r r r mutagen._filer mutagen._tagsrrrrrrrrrs\ $ L PfPfY=(Y=r