+
    ¿ÌjöB  ã            	       ó2  € R t Rt^ RIt^ RIt^ RIHt ^ RIt]P                  P                  ]P                  P                  ]P                  P                  ]P                  P                  ]4      4      4      4      t]]P                  9  d   ]P                  P                  ^ ]4       A^ RIHt ]P"                  ^ ,          ^8¼  d   ]tR tR tR t ! R R	]P.                  4      t ! R
 R]P2                  4      t ! R R]4      t ! R R]P2                  4      t]! . RNR NR!NR"NR#NR$NR%NR&NR'NR(NR)NR*NR+NR,NR-NR.NR/NR0NR1NR2NR3NR4NR5NR6NR7NR8NR9NR:NR;NR<NR=NR>NR?NR@NRANRBNRCNRDNRENRFN4      t]! . RGO4      t ! R R]P@                  4      t! ! R R]!4      t" ! R R]!4      t# ! R R]!4      t$ ! R R]P@                  4      t% ! R R]%4      t&R t'](R8X  d8   ]PR                  ! ]PT                  ! ]PV                  R,          ]]4      4       R# R# )HzPParse xls up to some point

Read storages, (sub-)streams, records from xls file
z0.54N)Úunpack)Úrecord_basec                ó\  € Rp \        V 4      pVP                  4        F2  p\        V\        4      '       g   K   Ve   VP	                  4        R# R# 	  Ve   VP	                  4        R#   \
         d    \        P                  ! RRR7        L;i ; i  Te   TP	                  4        i i ; i)zò
determine whether a given file is an excel ole file

returns True if given file is an ole file and contains a Workbook stream

todo: could further check that workbook stream starts with a globals
substream.
See also: oleid.OleID.check_excel
NTz/Ignoring exception in is_xls, assume is not xls)Úexc_infoF)ÚXlsFileÚiter_streamsÚ
isinstanceÚWorkbookStreamÚcloseÚ	ExceptionÚloggingÚdebug)ÚfilenameÚxls_fileÚstreams   &  Úm/home/l0st/web/w4ttz.lol/public_html/toolz/MsgDoxxer/venv/lib/python3.14/site-packages/oletools/xls_parser.pyÚis_xlsr   Q   s¢   € ð €Hð
Ü˜8Ó$ˆØ×+Ñ+Ö-ˆFÜ˜&¤.×1Ô1Øð
 ÒØ�N‰NÖñ  ñ .ð ÒØ�N‰NÔÙøô ô %Ü�ŠÐGØ#÷	%ð%ûð ÒØ�N‰NÕð  ús.   „1A+ ºA+ ÁA+ Á+#BÂB ÂBÂB ÂB+c                ó¾   € \        WV^,            4      ^ 8H  pV'       d-   V^,           V,           pW^,           V P                  R4      V3# \        W^,           V4      # )z<read a unicode string from a XLUnicodeStringNoCch structure Úascii)ÚordÚdecodeÚread_unicode_2byte)ÚdataÚ	start_idxÚn_charsÚlow_bytes_onlyÚend_idxs   &&&  r   Úread_unicoder   j   s]   € ô ˜$¨°1­Ð5Ó6¸!Ñ;€NßØ˜a•- 'Õ)ˆØ˜a•K Ð(×/Ñ/°Ó8¸'ÐAÐAä! $°!­°WÓ=Ð=ó    c                óÊ   a € W^,          ,           pVR8  d%   R \        RRV,          ,           S W 4       4       pMV 3R l\        W^4       4       pRP                  V4      V3# )z9read a unicode string with characters encoded by 2 bytes é   c              3   ó8   "  € T F  p\        V4      x € K  	  R # 5i)N)Úunichr)Ú.0Úvals   & r   Ú	<genexpr>Ú%read_unicode_2byte.<locals>.<genexpr>z   s   é € ð HÙFð %(”F˜3—K�KÛFùs   ‚Ú<ÚHc           
   3   ón   <"  € T F*  p\        \        R SW^,            4      ^ ,          4      x € K,  	  R# 5i)ú<HN)r"   r   )r#   Údata_idxr   s   & €r   r%   r&   }   s6   øé € ð BÙ$@˜ô œ6 $¨¨X¸qµjÐ(AÓBÀ1ÕE×FÐFÛ$@ùs   ƒ25Ú )r   ÚrangeÚjoin)r   r   r   r   Úunicharss   f&&  r   r   r   v   sh   ø€ à A�+Õ%€GØ�„}ñHÜ˜3  W¥Õ,¨d°9Ð.EÔFóH‰ôBÜ$)¨)¸aÔ$@óBˆà�8‰8�HÓ˜wÐ&Ð&r   c                   ó4   a € ] tR t^†t o Rt]R 4       tRtV tR# )r   z0An xls file has most streams made up of records c                ó(   € VR8X  d   \         # \        # )zhelper for iter_streams ÚWorkbook)r	   Ú	XlsStream)ÚclsÚstream_names   &&r   Ústream_class_for_nameÚXlsFile.stream_class_for_name‰   s   € ð ˜*Ô$Ü!Ð!ÜÐr   © N)	Ú__name__Ú
__module__Ú__qualname__Ú__firstlineno__Ú__doc__Úclassmethodr6   Ú__static_attributes__Ú__classdictcell__©Ú__classdict__s   @r   r   r   †   s   ø‡ € Ù;àñó ör   r   c                   ó:   a € ] tR t^‘t o RtR t]R 4       tRtV t	R# )r3   z,most streams in xls file consist of records c                óX   € \        RV P                  P                  ^4      4      w  rWR3# )úkread first few bytes of record to determine size and type

returns (type, size, other) where other is None
ú<HHN)r   r   Úread)ÚselfÚrec_typeÚrec_sizes   &  r   Úread_record_headÚXlsStream.read_record_head”   s-   € ô
 $ E¨4¯;©;×+;Ñ+;¸AÓ+>Ó?ÑˆØ 4Ð'Ð'r   c                ó   € \         R3# )úCdetermine a class for given record type

returns (clz, force_read)
F)Ú	XlsRecord©r4   rI   s   &&r   Úrecord_class_for_typeÚXlsStream.record_class_for_typeœ   s   € ô ˜%ÐÐr   r8   N)
r9   r:   r;   r<   r=   rK   r>   rQ   r?   r@   rA   s   @r   r3   r3   ‘   s!   ø‡ € Ù7ò(ð ñ ó ö r   r3   c                   ó4   a € ] tR t^¥t o Rt]R 4       tRtV tR# )r	   z*Stream in excel file that holds most info c                óÀ   € V\         P                  8X  d	   \         R3# V\        P                  8X  d	   \        R3# V\        P                  8X  d	   \        R3# \        R3# ©rN   TF)ÚXlsRecordBofÚTYPEÚXlsRecordEofÚXlsRecordSupBookrO   rP   s   &&r   rQ   Ú$WorkbookStream.record_class_for_type¨   s[   € ð ”|×(Ñ(Ô(Ü Ð%Ð%Øœ×*Ñ*Ô*Ü Ð&Ð&ØÔ)×.Ñ.Ô.Ü# TÐ)Ð)ä˜eÐ#Ð#r   r8   N)	r9   r:   r;   r<   r=   r>   rQ   r?   r@   rA   s   @r   r	   r	   ¥   s   ø‡ € Ù5àñ$ó ö$r   r	   c                   óB   a € ] tR t^¸t o Rt^€t^tR t]R 4       t	Rt
V tR# )Ú
XlsbStreamz?binary stream of an xlsb file, usually have a record structure c                ó(  € \        V P                  P                  ^4      4      pWP                  ,          '       dV   \        V P                  P                  ^4      4      pWP                  ,          W P                  ,          ^,          ,           pMTp^ p^ p\        ^4       Fi  p\        V P                  P                  ^4      4      pWAV P                  ,          V,          ,          pV^,          pWP                  ,          ^ 8X  g   Ki   M	  W4R3# )rE   N)r   r   rG   ÚHIGH_BIT_MASKÚLOW7_BIT_MASKr-   )rH   r$   Úval2rI   rJ   ÚshiftÚ_s   &      r   rK   ÚXlsbStream.read_record_head¾   sã   € ô
 �$—+‘+×"Ñ" 1Ó%Ó&ˆØ×#Ñ#×#Ô#Ü�t—{‘{×'Ñ'¨Ó*Ó+ˆDà×0Ñ0Õ0Ø× 2Ñ 2Õ2°qÕ8õ:‰Hð ˆHàˆØˆÜ�q–ˆAÜ�d—k‘k×&Ñ& qÓ)Ó*ˆCØ˜t×1Ñ1Õ1°eÕ;Õ;ˆHØ�Q�JˆEØ×(Ñ(Õ(¨QÖ.Ùñ ð  4Ð'Ð'r   c                óL   € V\         P                  8X  d	   \         R3# \        R3# rU   )ÚXlsbBeginSupBookrW   Ú
XlsbRecordrP   s   &&r   rQ   Ú XlsbStream.record_class_for_typeÖ   s)   € ð Ô'×,Ñ,Ô,Ü# TÐ)Ð)ä˜uÐ$Ð$r   r8   N)r9   r:   r;   r<   r=   r^   r_   rK   r>   rQ   r?   r@   rA   s   @r   r\   r\   ¸   s+   ø‡ € ÙJà€MØ€Mò(ð0 ñ%ó ö%r   r\   c                   ó.   a € ] tR tRt o RtRtR tRtV tR# )rO   i(  z0basic building block of data in workbook stream i    c                óŠ   €  \         V P                  ,          #   \         d    RP                  T P                  4      u # i ; i)ú:simplification for subclasses to create their own __str__ zXlsRecord type {0})ÚFREQUENT_RECORDSÚtypeÚKeyErrorÚformat©rH   s   &r   Ú	_type_strÚXlsRecord._type_str.  s:   € ð	:Ü# D§I¡IÕ.Ð.øÜô 	:Ø'×.Ñ.¨t¯y©yÓ9Ò9ð	:úó   ‚ ™&AÁAr8   N©	r9   r:   r;   r<   r=   ÚMAX_SIZErp   r?   r@   rA   s   @r   rO   rO   (  s   ø‡ € Ù;ð €H÷:ð :r   rO   c                   óL   a € ] tR tRt o RtRt^t]! . RO4      tR t	R t
RtV tR# )	rV   i6  z(record found at beginning of substreams i	  c                ó†   € V P                   f
   R V n        R # \        RV P                   R,          4      ^ ,          V n        R # )Nr*   :é   é   N)r   Údoctyper   ©rH   rb   s   &&r   Úfinish_constructingÚ XlsRecordBof.finish_constructing>  s1   € Ø�9‰9ÒØˆDŒLÙä˜d D§I¡I¨c¥NÓ3°AÕ6ˆŽr   c                óœ   € R P                  V P                  V P                  9   d"   V P                  V P                  ,          4      # R4      # )zBOF Record ({0} substream)Úunknown)rn   ry   ÚDOCTYPESro   s   &r   rp   ÚXlsRecordBof._type_strE  sA   € Ø+×2Ñ2Ø+/¯<©<¸4¿=¹=Ô+HˆD�M‰M˜$Ÿ,™,Õ'óð 	àóð 	r   )ry   N))é   Úworkbook)é   zdialog/worksheet)é    Úchart)é@   Úmacro)r9   r:   r;   r<   r=   rW   ÚSIZEÚdictr   r{   rp   r?   r@   rA   s   @r   rV   rV   6  s0   ø‡ € Ù3Ø€DØ€Dáò 7ó 8€Hò7÷ð r   rV   c                   ó2   a € ] tR tRt o Rt^
t^ tR tRtV t	R# )rX   iK  z"record found at end of substreams c                ó   € R # )z
EOF Recordr8   ro   s   &r   rp   ÚXlsRecordEof._type_strP  s   € Ùr   r8   N)
r9   r:   r;   r<   r=   rW   rˆ   rp   r?   r@   rA   s   @r   rX   rX   K  s   ø‡ € Ù-Ø€DØ€D÷ð r   rX   c                   óP   a € ] tR tRt o RtRtRtRtRtRt	Rt
R	tR
tR tR tRtV tR# )rY   iT  zÁThe SupBook record specifies a supporting link

"... The collection of records specifies the contents of an external
workbook, DDE data source, or OLE data source." (MS-XLS, paragraph 2.4.271)
i®  r~   zself-referencingzaddin-referencingÚunusedz
same-sheetzole/dde data sourcezexternal workbookc                óî  € RV n         RV n        RV n        V P                  V n        V P
                  f   R# V P                  ^8  d%   \        RP                  V P                  4      4      h\        RV P
                  R,          4      w  V n         V n        ^ V P                  u;8  d   ^ÿ8:  d.   M M*\        V P
                  ^V P                  4      w  V n        pM
R^uV n        pV P                  R8X  d   V P                  V n        R# V P                   ^8X  d%   V P                  R8X  d   V P                  V n        R# V P                  R8X  d   V P                  V n        R# V P                  R	8X  d   V P                  V n        R# V P                   ^ 8X  d&   V P                  '       d   V P                  V n        R# V P                   ^ 8”  d(   V P                  '       d   V P                   V n        R# R# R# )
z>Finish constructing this record; called at end of constructor.Nz+not enough data (size is {0} but need >= 4)rF   :Nrx   Nr,   i  i:  Ú Ú )ÚctabÚcchÚ	virt_pathÚLINK_TYPE_UNKNOWNÚsupport_link_typer   ÚsizeÚ
ValueErrorrn   r   r   ÚLINK_TYPE_SELFÚLINK_TYPE_ADDINÚLINK_TYPE_UNUSEDÚLINK_TYPE_SAMESHEETÚLINK_TYPE_OLE_DDEÚLINK_TYPE_EXTERNALrz   s   &&r   r{   Ú$XlsRecordSupBook.finish_constructinge  sw  € ð ˆŒ	ØˆŒØˆŒØ!%×!7Ñ!7ˆÔØ�9‰9ÒÙð �9‰9�qŒ=ÜÐJß$™f T§Y¡YÓ/ó1ð 1ä$ U¨D¯I©I°b­MÓ:ÑˆŒ	�4”8Øˆt�x‰xÖ˜4×ä ,¨T¯Y©Y¸¸4¿8¹8Ó DÑˆDŒN™Aà # QÐˆDŒN˜Að �8‰8�uÔØ%)×%8Ñ%8ˆDÖ"Ø�Y‰Y˜#Ô $§(¡(¨fÔ"4Ø%)×%9Ñ%9ˆDÖ"à�^‰^˜yÔ(Ø%)×%:Ñ%:ˆDÖ"Ø�^‰^˜yÔ(Ø%)×%=Ñ%=ˆDÖ"Ø�Y‰Y˜#Ô $§.§. .Ø%)×%;Ñ%;ˆDÖ"Ø�Y‰Y˜Œ]˜tŸ~Ÿ~˜~Ø%)×%<Ñ%<ˆDÖ"ñ  .‰]r   c                ó8   € R P                  V P                  4      # )zSupBook Record ({0}))rn   r–   ro   s   &r   rp   ÚXlsRecordSupBook._type_str‰  s   € Ø%×,Ñ,¨T×-CÑ-CÓDÐDr   )r“   r’   r–   r”   N)r9   r:   r;   r<   r=   rW   r•   r™   rš   r›   rœ   r�   rž   r{   rp   r?   r@   rA   s   @r   rY   rY   T  sK   ø‡ € ñð €Dà!ÐØ'€NØ)€OØÐØ&ÐØ-ÐØ,Ðò"=÷HEð Er   rY   c                   ó.   a € ] tR tRt o RtRtR tRtV tR# )rf   i�  zilike an xls record, but from binary part of xlsb file

has no MAX_SIZE and types have different meanings
Nc                óŠ   €  \         V P                  ,          #   \         d    RP                  T P                  4      u # i ; i)rj   zXlsbRecord type {0})ÚFREQUENT_RECORDS_XLSBrl   rm   rn   ro   s   &r   rp   ÚXlsbRecord._type_str•  s:   € ð	;Ü(¨¯©Õ3Ð3øÜô 	;Ø(×/Ñ/°·	±	Ó:Ò:ð	;úrr   r8   rs   rA   s   @r   rf   rf   �  s   ø‡ € ñð
 €H÷;ð ;r   rf   c                   óH   a € ] tR tRt o RtRtRtRtRtRt	Rt
R	 tR
 tRtV tR# )re   i�  zŽRecord beginning an external link in xlsb file

contains information about the link itself (e.g. for DDE the link is
string1 + ' ' + string2)
ih  r‚   ÚDDEÚOLEÚ
unexpectedr~   c                ó,  € V P                   V n        R V n        R V n        V P                  f   R# \        RV P                  R,          4      ^ ,          V n        V P                  ^ 8X  d   V P                  V n        M�V P                  ^8X  d   V P                  V n        MjV P                  ^8X  d   V P                  V n        MG\        P                  ! RP                  V P                  ^ ,          4      4       V P                  V n        ^p\        RV P                  W"^,            4      ^ ,          pVR8X  d   \        P                  ! R4       M|V P                  V^,          V,           ^,           8  d1   \        P                  ! RP                  W0P                  4      4       M&\        V P                  V^,           V4      w  V n        p\        RV P                  W"^,            4      ^ ,          pVR8X  d   \        P                  ! R4       R# V P                  V^,          V,           ^,           8  d9   \        P                  ! RP                  W0P                  4      R	,           4       R# \        V P                  V^,           V4      w  V n        pR# )
r,   Nr*   :é    rw   Nz$Unexpected link type {0} encounteredz<Il   ÿÿ z*Max string length 0xFFFFFFF is not allowedz0Impossible string length {0} for data length {1}z for string2)r•   Ú	link_typeÚstring1Ústring2r   r   ÚsbtÚLINK_TYPE_WORKBOOKÚLINK_TYPE_DDEÚLINK_TYPE_OLEr   Úwarningrn   ÚLINK_TYPE_UNEXPECTEDr—   r   )rH   rb   r   r   s   &&  r   r{   Ú$XlsbBeginSupBook.finish_constructing«  sã  € Ø×/Ñ/ˆŒØˆŒØˆŒØ�9‰9ÒÙÜ˜$ §	¡	¨#¥Ó/°Õ2ˆŒØ�8‰8�qŒ=Ø!×4Ñ4ˆD�NØ�X‰X˜Œ]Ø!×/Ñ/ˆD�NØ�X‰X˜Œ]Ø!×/Ñ/ˆD�Nä�OŠOÐBß#™V D§I¡I¨a¥LÓ1ô3à!×6Ñ6ˆDŒNàˆ	Ü˜˜tŸy™y¨¸Qµ;Ð?Ó@ÀÕCˆØ�jÔ Ü�OŠOÐHÕIØ�Y‰Y˜ � YÕ.¨qÕ0Ô0Ü�OŠOÐNß#™V G¯Y©YÓ7õ9ô '9¸¿¹Ø9BÀ1½Àgó'OÑ#ˆDŒL˜)ô ˜˜tŸy™y¨¸Qµ;Ð?Ó@ÀÕCˆØ�jÔ Ü�OŠOÐHÖIØ�Y‰Y˜ � YÕ.¨qÕ0Ô0Ü�OŠOÐNß#™V G¯Y©YÓ7¸.õIö Jô 1°·±¸IÀa½KØ18ó:‰OˆDŒLš!r   c                ód   € R P                  V P                  V P                  V P                  4      # )z+XlsbBeginSupBook Record ({0}, "{1}", "{2}"))rn   r¬   r­   r®   ro   s   &r   rp   ÚXlsbBeginSupBook._type_strÒ  s%   € Ø<ß‘�t—~‘~ t§|¡|°T·\±\ÓBð	Cr   )r¬   r¯   r­   r®   N)r9   r:   r;   r<   r=   rW   r°   r±   r²   r´   r•   r{   rp   r?   r@   rA   s   @r   re   re   �  s?   ø‡ € ñð €DØ#ÐØ€MØ€MØ'ÐØ!Ðò%:÷NCð Cr   re   c              #  ó  "  € Rp \        W P                  V\        P                  4      pVP	                  4        F  pVx € K	  	   Te   TP                  4        R# R#   \
         d    h i ; i  Te   TP                  4        i i ; i5i)zBExcel xlsb files also have bin files with record structure. iter! N)r\   r—   r   ÚSTGTY_STREAMÚiter_recordsr   r
   )Úfile_streamrb   r   Úxlsb_streamÚrecords   &&&  r   Úparse_xlsb_partr¾   Ü  sŠ   é € à€Kð	 Ü  ×.>Ñ.>ÀÜ!,×!9Ñ!9ó;ˆà!×.Ñ.Ö0ˆFØŒLò 1ð
 Ò"Ø×ÑÖñ #øô ô Øðûð Ò"Ø×ÑÕð #üs)   ‚B	†A A ÁB	ÁA,Á,A/ Á/BÂB	Ú__main__:é   NN)éœ   ÚBuiltInFnGroupCount)ic  ÚBookExt)iº  ÚCodeName)éB   ÚCodePage)ic  ÚDat)ij  Ú
DataLabExt)ik  ÚDataLabExtContents)é×   ÚDBCell)éÜ   ÚDbOrParmQry)i  Ú
DBQueryExt)iv  ÚDConn)é#   Ú
ExternName)é   ÚExternSheet)éÿ   ÚExtSST)i  Ú	ExtString)ig  ÚFeatHdr)é[   ÚFileSharing)i  ÚFormat)é1   ÚFont)i—  ÚGUIDTypeLib)i¸  ÚHLink)éá   ÚInterfaceHdr)éâ   ÚInterfaceEnd)i  ÚIndex)é   ÚLbl)éÁ   ÚMms)é]   ÚObj)i'  Ú
ObjectLink)i
  Ú	OleDbConn)éÞ   ÚOleObjectSize)i¦  ÚRichTextStream)ib  ÚSheetExt)i¼  ÚShrFmla)i  Ú	SxViewExt)iX  Ú
SxViewLink)i  ÚWebPub)éà   zXF (formatting))i}  zXFExt (formatting))i“  ÚStyle)i’  ÚStyleExt))iL  ÚBrtEndSupBook)i›  ÚBrtSupAddin)ic  ÚBrtSupBookSrc)iJ  ÚBrtSupNameBits)iH  ÚBrtSupNameBool)iK  ÚBrtSupNameEnd)iE  ÚBrtSupNameErr)iI  ÚBrtSupNameFmla)iG  ÚBrtSupNameNil)iD  ÚBrtSupNameNum)iF  ÚBrtSupNameSt)iA  ÚBrtSupNameStart)iC  ÚBrtSupNameValueEnd)iB  ÚBrtSupNameValueStart)if  Ú
BrtSupSame)ie  Ú
BrtSupSelf)ig  Ú
BrtSupTabs),r=   Ú__version__ÚsysÚos.pathÚosÚstructr   r   ÚpathÚnormpathÚdirnameÚabspathÚ__file__Ú
PARENT_DIRÚinsertÚoletoolsr   Úversion_infoÚchrr"   r   r   r   ÚOleRecordFiler   ÚOleRecordStreamr3   r	   r\   r‰   rk   r¤   ÚOleRecordBaserO   rV   rX   rY   rf   re   r¾   r9   ÚexitÚtestÚargvr8   r   r   Ú<module>r     sH  ðñðL €ó" Û Ý Û ð �W‰W×Ñ˜bŸg™gŸo™o¨b¯g©g¯o©oØ‡G�G‡O�O�HÓó/ó  ó !€
à�S—X‘XÔØ‡H�H‡O�O�A�zÔ"ØÝ  ð
 ×Ñ�AÕ˜!ÔØ€Fòò2	>ò	'ô ˆk×'Ñ'ô ô �×+Ñ+ô  ô($�Yô $ô&'%�×,Ñ,ô '%ñ^ ð )Ø!ð)àð)ð ð)ð ð	)ð
 ð)ð ð)ð !ð)ð ð)ð ð)ð ð)ð ð)ð ð)ð ð)ð ð)ð ð)ð  ð!)ð" ð#)ð$ ð%)ð& ð')ð( ð))ð* ð+)ð, ð-)ð. ð/)ð0 ð1)ð2 ð3)ð4 ð5)ð6 ð7)ð8 ð9)ð: ð;)ð< ð=)ð> ð?)ð@ ðA)ðB ðC)ðD ðE)ðF ðG)ðH ðI)ðJ ðK)ðL !ðM)ðN ðO)ðP ðQ)ó )Ð ñX ò ó Ð ô*:�×)Ñ)ô :ô�9ô ô*�9ô ô6E�yô 6Eôr;�×*Ñ*ô ;ô 7C�zô 7Cò~ ð( ˆzÔØ‡H‚Hˆ[×Ò˜cŸh™h r�l¨G°^ÓDÖEñ r   