ZimSrSrSSKrSSKJr SSKJr SSKJrJ r J r SSK J r SSK r SSKrSSKJr \R*"S5rS rS rS rS rS rSrSrSrSrSr Sr!Sr"Sr#Sr$Sr%Sr&Sr'Sr(Sr)Sr*Sr+Sr,"SS \-5r."S!S"\/5r0"S#S$\-5r1S%r2\3S&:Xa\Rh"\2"55 gg!\a SSKJs Jr Nf=f)'aCommon operations for OpenXML files (docx, xlsx, pptx, ...) This is mostly based on ECMA-376 (5th edition, Part 1) http://www.ecma-international.org/publications/standards/Ecma-376.htm See also: Notes on Microsoft's implementation of ECMA-376: [MS-0E376] .. codeauthor:: Intra2net AG License: BSD, see source code or documentation ooxml is part of the python-oletools package: http://www.decalage.info/python/oletools z0.54.2N) log_helper)uopen)ZipFile BadZipfile is_zipfile)splitextooxmlz[Content_Types].xmlz _rels/.rels)zz Word.Documentz Excel.Sheetwordexcel powerpointnonemixedzword-xmlz excel-xmlz word-xml2003z excel-xml2003c|UcgURSS:Xa[URRS5S:Xa<SRURURRS5S-S5/nOSRUR5/nUR(a:UR S RURR S S 555 UR(a:UR S RURR S S 555 URR5Hup#UR S RX#55 US:XdM-UR[5(aUS==S- ss'MVUR[5(aUS==S- ss'MUR[5(aUS==S- ss'MU[;aUS==S- ss'MUS==S- ss'M SRU5n[!U5S:aUSSS-$US-$)z for debugging: print an element NNoner{}z[tag={{...}}{0}z[tag={0}z text="{0}" z\nz tail="{0}"z {0}="{1}" ContentTypez-->xlsz-->docz-->pptz-->_z!!!z, z...]])tagcountformatindextextappendreplacetailattribitems startswithCONTENT_TYPES_EXCELCONTENT_TYPES_WORDCONTENT_TYPES_PPTCONTENT_TYPES_NEUTRALjoinlen)elempartskeyvaluers h/var/www/eduai.edurigo.com/question_generate/ques_gen_env/lib/python3.13/site-packages/oletools/ooxml.py debug_strr0s | xx{cdhhnnS1Q6"))$((488>>#3Fq3H3I*JKN""488,/ yy ]))$))*;*;D%*HIJ yy ]))$))*;*;D%*HIJkk'')  \((45 -  344b Y& !!"455b Y& !!"344b Y& //b W$ b V# * ::e D 4y3DSzG## $;c~[RRS:Xa[U[5$[U[ 5$)zBversion-independent test for isinstance(some_var, (str, unicode)) )sys version_infomajor isinstance basestringstr)some_vars r/isstrr;s0 "(J// h $$r1c[U5nUR5(aSn[US5n[R"[ UR S55nSSS5 U(d[$UR5SnU[:Xa[$U[:Xa[$[$SnSnSnUR[5H|upn[R!S[#U 5-5 U R$Sn XjR)[*5-nXZR)[,5-nXzR)[.5-nM~ U(aU(d U(d[4$U(dU(a U(d[6$U(dU(d U(a[8$U(dU(d U(d[$[R;S 5 [<$!,(df  GNx=f![&a GM'f=f![0aEn U R2R)S5(a[U R2;a [sSn A $eSn A ff=f) z5return one of the DOCTYPE_* constants or raise error NrrF rinvalid subfilez'Encountered contradictory content types) XmlParser is_single_xmlrresearchOFFICE_XML_PROGID_REGEXread DOCTYPE_NONEgroupsWORD_XML_PROG_IDDOCTYPE_WORD_XMLEXCEL_XML_PROG_IDDOCTYPE_EXCEL_XMLiter_xmlFILE_CONTENT_TYPESloggerdebugr0r"KeyErrorr$r%r&r'BadOOXML more_info DOCTYPE_WORD DOCTYPE_EXCELDOCTYPE_POWERPOINTwarning DOCTYPE_MIXED) filenameparsermatchhandleprog_idis_docis_xlsis_ppt_r+ content_typeoo_errs r/get_typerds x F  8S !VII5v{{47HIE" ,,.# & &# # ' '$ $ F F F //*<=JAQ LL40 1 #{{=9  --.AB BF --.@A AF --.?@ @F> fV fV &V!! & NN<= Q" !&       & &'8 9 9"f&6&66  sT+G /99H92H>8H99H>ch[U5nU[:Xagg![a g[a gf=f)z>Determine whether given file is an ooxml file; tries get_type FT)rdrRIOErrorrG)rYdoctypes r/is_ooxmlrhs@8$ ,   s  1 11c\rSrSrSrSrSSjrSrSrSr S r S r SS jr \ R4S jrS rSrSrSrSrSrSrSrg) ZipSubFilea)A file-like object like ZipFile.open returns them, with size and seek() ZipFile.open() gives file handles that can be read but not seek()ed since the file is being decompressed in the background. This class implements a reset() function (close and re-open stream) and a seek() that uses it. --> can be used as argument to olefile.OleFileIO and olefile.isOleFile() Can be used as a context manager:: with zipfile.ZipFile('file.zip') as zipper: # replaces with zipper.open(subfile) as handle: with ZipSubFile(zipper, 'subfile') as handle: print('subfile in file.zip has size {0}, starts with {1}' .format(handle.size, handle.read(20))) handle.reset() Attributes always present: container: the containing zip file name: name of file within zip file mode: open-mode, 'r' per default size: size of the stream (constructor arg or taken from ZipFile.getinfo) closed: True if there was an open() but no close() since then Attributes only not-None after open() and before close(): handle: direct handle to subfile stream, created by ZipFile.open() pos: current position within stream (can deviate from actual position in self.handle if we fake jump to end) See also (and maybe could some day merge with): ppt_record_parser.IterStream; also: oleobj.FakeFile iNc^XlX lUcOURU5RUl[ R SRUR55 OX@lSUR5;a[SRU55eX0l SUl SUl SUl g)z0remember all necessary vars but do not open yet Nzzip stream has size {0}wz%Can only read, mode "{0}" not allowedT) containernamegetinfo file_sizesizerOrPrlower ValueErrormoder\posclosed)selfrnrYrurrs r/__init__ZipSubFile.__init__s" <!))(3==DI LL299$))D EI $**, D$fTl, ,   r1cgNTrxs r/readableZipSubFile.readable!r1cgNFr}r~s r/writableZipSubFile.writable$sr1cgr|r}r~s r/seekableZipSubFile.seekable'rr1cURb [S5eURRURUR 5UlSUlSUlU$)z@open subfile for reading; open mode given to constructor before zre-opening file not supported!rF)r\rfrnopenrorurvrwr~s r/rZipSubFile.open*sK ;; ":; ;nn))$))TYY?   r1c[S5e)zwrite is not allowed zwriting not implemented)rfrxargskwargss r/writeZipSubFile.write4s/00r1cURc [S5eURUR:agURR U5nU=R[ U5- slU$)zm read given number of bytes (or all data) from stream returns bytes (i.e. str in python2, bytes in python3) zread on closed handler1)r\rfrvrrrFr*)rxrrdatas r/rFZipSubFile.read8sX ;; 12 2 88tyy {{% CI r1c.U[R:XaUnObU[R:XaURU-nO>U[R:XaUR U-nO[ SRU55eUS:a [S5eX0R:XagUS:XaUR5 gX0R:a"UR5 URU5 gX0R :aURX0R- 5 gX0lg)z4re-position point so read() will continue elsewhere z(invalid offset {0}, need SEEK_* constantrz%Seek beyond start of file not allowedN) ioSEEK_SETSEEK_CURrvSEEK_ENDrrrtrrfreset _seek_skip)rxrvoffsetnew_poss r/seekZipSubFile.seekHs R[[ G r{{ "hhnG r{{ "ii#oGG$fVn. . Q;AB B   \ JJL xx  JJL OOG $ yy OOGhh. /Hr1c[XR5up#[U5HnURUR5 M URU5 g)z;helper for seek: skip forward by given amount using read() N)divmod CHUNK_SIZErangerF)rxto_skipn_chunksleftoverras r/rZipSubFile._seek_skipjs?$G__=xA IIdoo &! (r1cUR$)z#inform about position of next read )rvr~s r/tellZipSubFile.tellus xxr1cDUR5 UR5 g)zclose and re-open N)closerr~s r/rZipSubFile.resetzs  r1c|URbURR5 SUlSUlSUlg)z close file NT)r\rrvrwr~s r/rZipSubFile.closes3 ;; " KK     r1c&UR5 U$)z)start of context manager; opens the file )rr~s r/ __enter__ZipSubFile.__enter__s  r1c$UR5 g)z(end of context manager; closes the file N)rrs r/__exit__ZipSubFile.__exit__s  r1cURcSnOKURS:XaSnO8URUR:aSnOSRUR5nSRURURUR U5$)z6creates a nice textual representation for this object rwrzopen, at startz open, at endzopen, at pos {0}z*[ZipSubFile {0} (size {1}, mode {2}, {3})])r\rvrrrroru)rxstatuss r/__str__ZipSubFile.__str__so ;; F XX]%F XX "#F'..txx8F;tyy$))TYY? @r1)rwrnr\rurorvrr)r=N)r)__name__ __module__ __qualname____firstlineno____doc__rryrrrrrrFrrrrrrrrrr__static_attributes__r}r1r/rjrjsd>J"1 "{{ D    @r1rjc0^\rSrSrSrSU4SjjrSrU=r$)rRiz3exception thrown if file is not an office XML file cz>[[U] SRX(aSU-OS55 XlX lg)z2create exception, remember filename and more_info z {0} is not an Office XML file{1}z: N)superrRryrrYrS)rxrYrS __class__s r/ryBadOOXML.__init__s7 h& . VH)dY. D F! "r1)rYrSN)rrrrrryr __classcell__)rs@r/rRrRs>##r1rRcD\rSrSrSrSrSrS SjrS SjrSr S r S r g) rAiarparser for OOXML files handles two different types of files: "regular" OOXML files are zip archives that contain xml data and possibly other files in binary format. In Office 2003, Microsoft introduced another xml-based format, which uses a single xml file as data source. The content of these types is also different. Method :py:meth:`is_single_xml` tells them apart. cJXlSUl[5UlSUlgr)rY did_iter_allsetsubfiles_no_xml_is_single_xml)rxrYs r/ryXmlParser.__init__s! !"u"r1czURb UR$[UR5(aSUlgSn[URS5n[R "[ URS55nSSS5 U(aSUlg[URS5e!,(df  N3=f)zvdetermine whether this is "regular" ooxml or a single xml file Raises a BadOOXML if this is neither one or the other NFr=r>Tzis no zip and has no prog_id) rrrYrrCrDrErFrR)rxr[r\s r/rBXmlParser.is_single_xmls    *&& & dmm $ $"'D  4==# &&II5v{{47HIE' "&D t}}&DEE ' &s +B,, B:Nc#># UR5(aJU(a[URS5e[URS5nSU4v SSS5 SUlgSnSn[ UR5nU(dUR 5nO&[U5(aU/nO[SU55nUH#nURUS5nXR4v SSS5 M% U(dSUlU(aUR5 gg!,(df  N=f!,(df  Mn=f![a'n[URS[U5-5eSnAf[a [URS5ef=f!U(aUR5 ff=f7f) z Find files in zip or just give single xml file yields pairs (subfile-name, file-handle) where file-handle is an open file-like object. (Do not care too much about encoding here, the xml parser reads the encoding from the first lines in the file.) zxml has no subfilesrbNTc3$# UHov M g7frr}).0args r/ 'XmlParser.iter_files..s$9DSSDsr=zinvalid subfile: znot in zip format) rBrRrYrrrnamelistr;tuplerQr9rr)rxrr\zippersubfilessubfileorig_errs r/ iter_filesXmlParser.iter_filess`     t}}.CDDdmmT*fFl"+ $D FH # /%0H4[[ $xH %$9D$99H'GWc2f%o-32 ((,D%LLN=+*$32 Dt}}2S]BDD Ct}}.ABB CLLNsgA F D F'A*D-DD-1F DF D* %D-- E=7"E$E==FFFc ## Uc/nO^[U5(a(U/n[RSRU55 O&Un[RSRU55 UR U5GHupVSnSn/n [ R "Xg5GHupU cM U S:XacU RU;aL[RSRU RU55 U RU RU45 US- nMtU S:XdeUS-nUS:deU RU;n U (aU RU4n U S U :XaU R5 O[RS RU U S 55 U (aXU S SU:aL[RS RU S 55 U R5 U (aU S SU:aMLU (dU(dX[U4v U(aGMmU (aGMwU R5 GM US:XaGMe g![a [RS 5 Nlf=f![ RanURRU5 Uc[!UR"S 5eUR%S5(a[R&nO[RnU"SRX^5S-5 SnANSnAff=f7f)aIterate xml contents of document If given subfile name[s] as optional arg[s], will only parse that subfile[s] yields 3-tuples (subfilename, element, depth) where depth indicates how deep in the hierarchy the element is located. Containers of element will come *after* the elements they contain (since they are only finished then). Subfiles that are not xml (e.g. OLE or image files) are remembered internally and can be retrieved using iter_non_xml(). The argument need_children is set to False per default. If you need to access an element's children, set it to True. Note, however, that leaving it at False should save a lot of memory. Otherwise, the parser has to keep every single element in memory since the last element returned is the root which has the rest of the document as children. c.f. http://www.ibm.com/developerworks/xml/library/x-hiperfparse/ Argument tags restricts output to tags with names from that list (or equal to that string). Children are preserved for these. Nzlooking for tags: {0})startendrrz remember start of tag {0} at {1}rrrzBfound end for wanted tag {0} but last start tag {1} does not matchzrecover: pop {0}z0found end of {0} at depth {1} but no start eventzcontent is not valid XMLz.xmlz$ xml-parsing for {0} failed ({1}). z Run iter_non_xml to investigate.)r;rOrPrrET iterparserrpoperror IndexErrorclear ParseErrorraddrRrYendswithrW)rxr need_childrentags want_tagsrr\eventsdepth inside_tagseventr+ is_wantedcurr_tagerrlogs r/rMXmlParser.iter_xmls0 <I 4[[I LL077= >I LL077= >#x8OG%FEK7 8#%<<#?KE| '88y0"LL)K*0&5*AC'..%/@A   E>*>QJE A:&: $I 5I $(HHe#4;*2(: + 1 & .66 content-type - defaults is a dict that maps extension --> content-type No guarantees on accuracy of these content types! Default Extension.rNrz/found content type for extension {0[0]}: {0[1]}rOverridePartName/z-found content type for subfile {0[0]}: {0[1]}r@)rBrMrNrrr"r$rrOrPrrRrSdict)rxdefaultsfilesrar+ extensionrrcs r/get_content_typesXmlParser.get_content_typeses     r6M "mm,>? 88$$Y// $ K 8I ++C00$-abM OOY M0J$KLLL"**0&"*>@XX&&z22"kk*5G))#..")!"+LL';;}+E!FGLL"**0&r*;=@.E{DN** **+<==&&*:*:: s%C E:/A5E:: G4F>=F>>Gc#Z# UR(d[RS5 UR(dgUR 5(agUR 5up[ UR5nURHvnURS5(aUSSnSnXA;aXnO2[U5SnURS5(aUSSnXb;aX&n[X45nXEU4v SSS5 Mx SSS5 g!,(df  M=f!,(df  g=f7f)aretrieve subfiles that were found by iter_xml to be non-xml also looks for content type info in the [Content_Types].xml subfile. yields 3-tuples (filename, content_type, file_handle) where content_type is based on filename or default for extension or is None, and file_handle is a ZipSubFile. Caller does not have to care about closing handle, will be closed even in error condition. To handle binary parts of an xlsb file, use xls_parser.parse_xlsb_part zQDid not iterate through complete file. Should run iter_xml() without args, first.Nrrr) rrOrWrrBrrrYr$rrj)rx content_typescontent_defaultsrrrbrr\s r/ iter_non_xmlXmlParser.iter_non_xmls  NNH I##       *.*@*@*B' T]] #v//%%c**%abkG# +#0#9L ( 1! 4I ++C00$-abM  4'7'B 0F!77100$ #10$ #s7A6D+8A4D,D3 D? D+ D D D($D+)rrrYrr)NFN) rrrrrryrBrrMrrrr}r1r/rArAs*# F*+#Z]~&+P&8r1rAc [R"SS5 [[R5S:wa [ S5 g[ S[ [RS5-5 [[RS5nUR5H6upnUS:dM[ SRUS U-[U555 M8 [UR55H?unupn[ S RX=(d S 55 US :dM4[ S 5 O [R"5 g)z Test xml parsing; called when running this file as a script. Prints every element found in input file (to be given as command line arg). FrPr3z/To test this code, give me a single file as argzDetected type: rz {0} {1}{2}r?z Non-XML subfile: {0} of type {1}unknowndz...r)renable_loggingr*r4argvprintrdrArMrr0 enumerater end_logging)rZrr+rrrbras r/testrs eW- 388} @A hsxx{3 34sxx{ #F & 1u 19 -&&wu ioN O!2.7v7J7J7L-M))q 1vg9z: < 3; &M  .N r1__main__)5r __version__r4oletools.common.log_helperroletools.common.io_encodingrzipfilerrros.pathrrrC lxml.etreeetreer ImportErrorxml.etree.cElementTree cElementTreeget_or_create_silent_loggerrOrNFILE_RELATIONSHIPSr%r&r'r(rErIrKrTrUrVrGrXrJrLDOCTYPE_WORD_XML2003DOCTYPE_EXCEL_XML2003r0r;rdrhobjectrjrtrRrArrexitr}r1r/r%s9 X  1-33 (  / / 8+" A"!  !  %'@%-` $r@r@j #z #"88D > zHHTV](''(sB99C  C