+
    ¿Ìjšl  ã                  óŽ  € ^ RI Ht R.t^ RIt^ RIt^ RIt^ RIt^ RIt^ RIt^ RI	t	^ RIH
t
 ^ RIHtHtHtHtHtHtHtHt ^RIHtHtHt ^RIHt ^RIHt ^R	IHt ^R
IHtH t H!t!H"t" ]'       d   ^RI#H$t$ ]PJ                  ! ]&4      t']'PQ                  ]PR                  ! 4       4       ]! R4      t* ! R R]PV                  4      t,R# )é    )ÚannotationsÚAttachmentBaseN)Úcached_property)ÚAnyÚListÚOptionalÚTupleÚTypeÚTYPE_CHECKINGÚTypeVarÚUnion)ÚMSG_PATHÚOVERRIDE_CLASSÚ	SAVE_TYPE)ÚAttachmentType)ÚNamedProperties)ÚPropertiesStore)ÚmsgPathToStringÚtryGetMimetypeÚverifyPropertyIdÚ
verifyType)ÚMSGFileÚ_Tc                  óZ  € ] tR t^)tRtR R ltRoR R lltRpR ltRpR R	 lltRpR
 R llt	R R lt
R R ltR R ltRpR R llt]P                  R R l4       tR R ltR R ltR R ltRpR R lltR R ltRpR  R! lltR" R# ltR$ R% ltR& R' ltR( R) ltR* R+ ltR, R- ltRqR. R/ lltRqR0 R1 llt]P                  R2 R3 l4       t] R4 R5 l4       t!] R6 R7 l4       t"] R8 R9 l4       t#] R: R; l4       t$]%R< R= l4       t&]%R> R? l4       t'] R@ RA l4       t(]%]P                  RB RC l4       4       t)] RD RE l4       t*]%RF RG l4       t+] RH RI l4       t,] RJ RK l4       t-] RL RM l4       t.] RN RO l4       t/] RP RQ l4       t0] RR RS l4       t1] RT RU l4       t2] RV RW l4       t3] RX RY l4       t4]%RZ R[ l4       t5]%R\ R] l4       t6] R^ R_ l4       t7]%R` Ra l4       t8] Rb Rc l4       t9]%Rd Re l4       t:] Rf Rg l4       t;] Rh Ri l4       t<]%Rj Rk l4       t=]%]P                  Rl Rm l4       4       t>Rnt?R# )rr   zA
The base class for all standard Attachments used by the module.
c               ó$   € V ^8„  d   QhRRRRRR/# )é   Úmsgr   Údir_ÚstrÚ	propStorer   © )Úformats   "Ú�/home/l0st/web/w4ttz.lol/public_html/toolz/MsgDoxxer/venv/lib/python3.14/site-packages/extract_msg/attachments/attachment_base.pyÚ__annotate__ÚAttachmentBase.__annotate__.   s!   € ÷ =ñ =˜Gð =¨3ð =¸?ñ =ó    c                óä   € \         P                  ! V4      V n        W n        W0n        \        VP                  V 4      V n        VP                  \         P                  ! V 4      .,           V n	        R# )zÙ
:param msg: the Message instance that the attachment belongs to.
:param dir_: the directory inside the MSG file where the attachment is
    located.
:param propStore: The PropertiesStore instance for the attachment.
N)
ÚweakrefÚrefÚ_AttachmentBase__msgÚ_AttachmentBase__dirÚ_AttachmentBase__propsr   ÚnamedÚ _AttachmentBase__namedPropertiesÚtreePathÚ_AttachmentBase__treePath)Úselfr   r   r    s   &&&&r#   Ú__init__ÚAttachmentBase.__init__.   sM   € ô —[’[ Ó%ˆŒ
ØŒ
Ø ŒÜ!0°·±¸DÓ!AˆÔØŸ,™,¬'¯+ª+°dÓ*;Ð)<Õ<ˆŽr&   Nc               ó    € V ^8„  d   QhRRRR/# )r   Ú_idr   ÚpreserveNoneÚboolr!   )r"   s   "r#   r$   r%   ;   s   € ÷ ñ ˜sð Èñ r&   c                óX   € V P                  V4      pVe   Vf	   V'       g	   V! V4      pV# )aÌ  
Like the other get as functions, but designed for when something
could be multiple types (where only one will be present).

This way you have no need to set the type, it will be handled for you.

:param overrideClass: Class/function to use to morph the data that was
    read. The data will be the first argument to the class's
    ``__init__`` method or the function itself, if that is what is
    provided. By default, this will be completely ignored if the value
    was not found.
:param preserveNone: If ``True`` (default), causes the function to
    ignore :param overrideClass: when the value could not be found (is
    ``None``). If this is changed to ``False``, then the value will be
    used regardless.
)Ú_getTypedData)r1   r5   ÚoverrideClassr6   Úvalues   &&&& r#   Ú_getTypedAsÚAttachmentBase._getTypedAs;   s1   € ð" ×"Ñ" 3Ó'ˆàÒ$ØÒ ¯Ù% eÓ,�àˆr&   c                óÀ   € \        V4       VP                  4       pV P                  RV,           V4      w  r4V'       d   V# V P                  W4      w  r4V'       d   V# R# )a•  
Gets the data for the specified id as the type that it is supposed to
be.

:param id: MUST be a 4 digit hexadecimal string.

If you know for sure what type the data is before hand, you can specify
it as being one of the strings in the constant
``FIXED_LENGTH_PROPS_STRING`` or ``VARIABLE_LENGTH_PROPS_STRING``.

:raises ReferenceError: The associated ``MSGFile`` instance has been
    garbage collected.
z__substg1.0_N)r   ÚupperÚ_getTypedStreamÚ_getTypedProperty)r1   ÚidÚ_typeÚfoundÚresults   &&&  r#   r9   ÚAttachmentBase._getTypedDataT   sW   € ô 	˜ÔØ�X‰X‹ZˆØ×,Ñ,¨^¸bÕ-@À%ÓH‰ˆßØˆMà ×2Ñ2°2Ó=‰MˆEß"�6Ð,¨Ð,r&   c               ó   € V ^8„  d   QhRR/# )r   ÚreturnzTuple[bool, Optional[object]]r!   )r"   s   "r#   r$   r%   k   s   € ÷ ñ Ð=Zñ r&   c                óš   € \        V4       V'       d   \        V4       W,          p\        4       pV P                  W4      pWCJ d   R# RV3# )aA  
Gets the property with the specified id as the type that it is supposed
to be.

:param id: MUST be a 4 digit hexadecimal string.

If you know for sure what type the property is before hand, you can
specify it as being one of the strings in the constant
``FIXED_LENGTH_PROPS_STRING`` or ``VARIABLE_LENGTH_PROPS_STRING``.
T)FN)r   r   ÚobjectÚgetPropertyVal)r1   Ú
propertyIDrC   ÚnotFoundÚrets   &&&  r#   rA   Ú AttachmentBase._getTypedPropertyk   sK   € ô 	˜Ô$ßÜ�uÔØÕˆJä“8ˆØ×!Ñ! *Ó7ˆØ‹?ØÐà�SˆyÐr&   c               ó   € V ^8„  d   QhRR/# )r   Úfilenamer   r!   )r"   s   "r#   r$   r%   ‚   s   € ÷ Yñ Y¨ñ Yr&   c                ó�   € V P                  4       ;pf   \        R4      hVP                  V P                  \	        V4      .RV4      # )aR  
Gets the contents of the specified stream as the type that it is
supposed to be.

Rather than the full filename, you should only feed this function the
filename sans the type. So if the full name is "__substg1.0_001A001F",
the filename this function should receive should be "__substg1.0_001A".

If you know for sure what type the stream is before hand, you can
specify it as being one of the strings in the constant
``FIXED_LENGTH_PROPS_STRING`` or ``VARIABLE_LENGTH_PROPS_STRING``.

If you have not specified the type, the type this method returns in many
cases cannot be predicted. As such, when using this method it is best
for you to check the type that it returns. If the function returns
``None``, that means it could not find the stream specified.

:raises ReferenceError: The associated ``MSGFile`` instance has been
    garbage collected.
úDThe MSGFile for this Attachment instance has been garbage collected.T)r*   ÚReferenceErrorr@   r+   r   )r1   rQ   rC   r   s   &&& r#   r@   ÚAttachmentBase._getTypedStream‚   sE   € ð* —:‘:“<ÐˆCÒ(Ü Ð!gÓhÐhØ×"Ñ" D§J¡J´ÀÓ0IÐ#JÈDÐRWÓXÐXr&   c               ó    € V ^8„  d   QhRRRR/# )r   Ú
customPathzpathlib.PathrH   r!   )r"   s   "r#   r$   r%   ›   s   € ÷ (ñ (°\ð (Èlñ (r&   c                óÂ  € W2,          pVP                  RR4      pV'       d²   V'       g¨   \        P                  P                  V4      w  rxVP	                  4       p	\        V4      P                  RR4      V	9   dW   \        ^^d4       F7  p
W7 RV
 RV 2,          p\        V4      P                  RR4      V	9  g   K5  Vu # 	  \        RV R24      hV# V'       g„   VP                  4       '       dn   \        P                  P                  V4      w  rx\        ^^d4       F-  p
W7 RV
 RV 2,          pVP                  4       '       d   K+  Vu # 	  \        RV R24      hV# )	a8  
"Handle Filename Conflict"

Internal function for use in determining how to modify the saving path
when a file with the same name already exists. This is mainly because
any save function that uses files will need to do this functionality.

:returns: A ``pathlib.Path`` object to where the file should be saved.
ÚoverwriteExistingFÚ\Ú/z (Ú)z@Could not create the specified file because it already exists ("z").)
ÚgetÚosÚpathÚsplitextÚnamelistr   ÚreplaceÚrangeÚFileExistsErrorÚexists)r1   Ú_ziprQ   rW   ÚkwargsÚfullFilenamerY   ÚnameÚextÚnameListÚiÚtestNames   &&&&&       r#   Ú
_handleFncÚAttachmentBase._handleFnc›   sY  € ð "Õ,ˆà"ŸJ™JÐ':¸EÓBÐçç$ÜŸG™G×,Ñ,¨XÓ6‘	�ØŸ=™=›?�Ü�|Ó$×,Ñ,¨T°3Ó7¸8ÔCÜ" 1 cž]˜Ø#-°&¸¸1¸#¸Q¸s¸eÐ0DÕ#D˜Ü˜x›=×0Ñ0°°sÓ;À8ÖKØ#+šOñ +ô .Ð0pÐq}Ðp~ð  Bð  /Có  Dð  Dð Ð÷ %¨×)<Ñ)<×)>Ò)>äŸG™G×,Ñ,¨XÓ6‘	�ä˜q #ž�AØ)¨f°B°q°c¸¸3¸%Ð,@Õ@�HØ#Ÿ?™?×,Ô,Ø'šñ 'ô *Ð,lÐmyÐlzÐz}Ð*~ÓÐàÐr&   c               ó    € V ^8„  d   QhRRRR/# ©r   rQ   r   rH   r7   r!   )r"   s   "r#   r$   r%   Å   s   € ÷ 	Cñ 	C˜xð 	C¨Dñ 	Cr&   c                óŒ   € V P                  4       ;pf   \        R4      hVP                  V P                  \	        V4      .4      # )z”
Checks if stream exists inside the attachment folder.

:raises ReferenceError: The associated ``MSGFile`` instance has been
    garbage collected.
rS   )r*   rT   re   r+   r   ©r1   rQ   r   s   && r#   re   ÚAttachmentBase.existsÅ   s>   € ð —:‘:“<ÐˆCÒ(Ü Ð!gÓhÐhØ�z‰z˜4Ÿ:™:¤°xÓ'@ÐAÓBÐBr&   c               ó    € V ^8„  d   QhRRRR/# rq   r!   )r"   s   "r#   r$   r%   Ð   s   € ÷ 	Dñ 	D ð 	D¨Tñ 	Dr&   c                óŒ   € V P                  4       ;pf   \        R4      hVP                  V P                  \	        V4      .4      # )zŸ
Checks if the string stream exists inside the attachment folder.

:raises ReferenceError: The associated ``MSGFile`` instance has been
    garbage collected.
rS   )r*   rT   ÚsExistsr+   r   rs   s   && r#   rw   ÚAttachmentBase.sExistsÐ   s>   € ð —:‘:“<ÐˆCÒ(Ü Ð!gÓhÐhØ�{‰{˜DŸJ™J¬¸Ó(AÐBÓCÐCr&   c               ó   € V ^8„  d   QhRR/# )r   rH   zTuple[bool, int]r!   )r"   s   "r#   r$   r%   Û   s   € ÷ Rñ RÐ7Gñ Rr&   c                ó�   € V P                  4       ;pf   \        R4      hVP                  WP                  VRV P                  4      # )a  
Determines if the stream with the provided id exists.

The return of this function is 2 values, the first being a ``bool`` for
if anything was found, and the second being how many were found.

:raises ReferenceError: The associated ``MSGFile`` instance has been
    garbage collected.
rS   T)r*   rT   ÚexistsTypedPropertyr+   r,   )r1   rB   rC   r   s   &&& r#   r{   Ú"AttachmentBase.existsTypedPropertyÛ   s@   € ð —:‘:“<ÐˆCÒ(Ü Ð!gÓhÐhØ×&Ñ& r¯:©:°u¸dÀDÇLÁLÓQÐQr&   c               ó   € V ^8„  d   QhRR/# ©r   rH   r   r!   )r"   s   "r#   r$   r%   ê   s   € ÷ 	ñ 	 sñ 	r&   c                ó   € R# )a  
Returns the filename to use for the attachment.

:param contentId: Use the contentId, if available.
:param customFilename: A custom name to use for the file.

If the filename starts with "UnknownFilename" then there is no guarantee
that the files will have exactly the same filename.
Nr!   ©r1   rg   s   &,r#   ÚgetFilenameÚAttachmentBase.getFilenameé   ó   ‚ r&   c               ó    € V ^8„  d   QhRRRR/# )r   rQ   r   rH   zOptional[List[bytes]]r!   )r"   s   "r#   r$   r%   õ   s   € ÷ Nñ N¨(ð NÐ7Lñ Nr&   c                óŒ   € V P                  4       ;pf   \        R4      hVP                  V P                  \	        V4      .4      # )aS  
Gets a multiple binary property as a list of ``bytes`` objects.

Like :meth:`getStringStream`, the 4 character type suffix should be
omitted. So if you want the stream "__substg1.0_00011102" then the
filename would simply be "__substg1.0_0001".

:raises ReferenceError: The associated ``MSGFile`` instance has been
    garbage collected.
rS   )r*   rT   ÚgetMultipleBinaryr+   r   rs   s   && r#   r†   Ú AttachmentBase.getMultipleBinaryõ   ó@   € ð —:‘:“<ÐˆCÒ(Ü Ð!gÓhÐhØ×$Ñ$ d§j¡j´/À(Ó2KÐ%LÓMÐMr&   c               ó    € V ^8„  d   QhRRRR/# )r   rQ   r   rH   zOptional[List[str]]r!   )r"   s   "r#   r$   r%     s   € ÷ Nñ N¨(ð NÐ7Jñ Nr&   c                óŒ   € V P                  4       ;pf   \        R4      hVP                  V P                  \	        V4      .4      # )aQ  
Gets a multiple string property as a list of ``str`` objects.

Like :meth:`getStringStream`, the 4 character type suffix should be
omitted. So if you want the stream "__substg1.0_00011102" then the
filename would simply be "__substg1.0_0001".

:raises ReferenceError: The associated ``MSGFile`` instance has been
    garbage collected.
rS   )r*   rT   ÚgetMultipleStringr+   r   rs   s   && r#   r‹   Ú AttachmentBase.getMultipleString  rˆ   r&   c               ó(   € V ^8„  d   QhRRRRRRRR/# )r   ÚpropertyNamer   Úguidr:   úOVERRIDE_CLASS[_T]rH   úOptional[_T]r!   )r"   s   "r#   r$   r%     s*   € ÷ ñ  sð °#ð ÐFXð Ð]iñ r&   c                ó@   € V P                  W4      pVe	   V! V4      pV# )aŸ  
Returns the named property, setting the class if specified.

:param overrideClass: Class/function to use to morph the data that was
    read. The data will be the first argument to the class's
    ``__init__`` method or the function itself, if that is what is
    provided. If the value is ``None``, this function is not called. If
    you want it to be called regardless, you should handle the data
    directly.
)ÚgetNamedProp)r1   rŽ   r�   r:   r;   s   &&&& r#   Ú
getNamedAsÚAttachmentBase.getNamedAs  s)   € ð ×!Ñ! ,Ó5ˆØÒÙ! %Ó(ˆEØˆr&   c               ó(   € V ^8„  d   QhRRRRRRRR/# )r   rŽ   r   r�   Údefaultr   rH   úUnion[Any, _T]r!   )r"   s   "r#   r$   r%   #  s/   € ÷ Gñ G¨ð G°Cð GÀ"ð GÐP^ñ Gr&   c                ó<   € V P                   P                  W3V4      # )zk
``instance.namedProperties.get((propertyName, guid), default)``

Can be overriden to create new behavior.
)ÚnamedPropertiesr]   )r1   rŽ   r�   r—   s   &&&&r#   r“   ÚAttachmentBase.getNamedProp#  s    € ð ×#Ñ#×'Ñ'¨Ð(<¸gÓFÐFr&   c               ó$   € V ^8„  d   QhRRRRRR/# )r   rŽ   úUnion[int, str]r:   r�   rH   r‘   r!   )r"   s   "r#   r$   r%   +  s#   € ÷ ñ ¨/ð ÐJ\ð Ðamñ r&   c                ó@   € V P                  V4      pVe	   V! V4      pV# )a•  
Returns the property, setting the class if found.

:param overrideClass: Class/function to use to morph the data that was
    read. The data will be the first argument to the class's
    ``__init__`` method or the function itself, if that is what is
    provided. If the value is ``None``, this function is not called. If
    you want it to be called regardless, you should handle the data
    directly.
©rK   )r1   rŽ   r:   r;   s   &&& r#   ÚgetPropertyAsÚAttachmentBase.getPropertyAs+  s)   € ð ×#Ñ# LÓ1ˆàÒÙ! %Ó(ˆEàˆr&   c               ó$   € V ^8„  d   QhRRRRRR/# )r   ri   r�   r—   r   rH   r˜   r!   )r"   s   "r#   r$   r%   =  s!   € ÷ 2ñ 2 ?ð 2¸Rð 2È>ñ 2r&   c                ó8   € V P                   P                  W4      # )zS
instance.props.getValue(name, default)

Can be overridden to create new behavior.
)ÚpropsÚgetValue)r1   ri   r—   s   &&&r#   rK   ÚAttachmentBase.getPropertyVal=  s   € ð �z‰z×"Ñ" 4Ó1Ð1r&   c               ó    € V ^8„  d   QhRRRR/# )r   rQ   r   rH   z#Optional[Union[List[bytes], bytes]]r!   )r"   s   "r#   r$   r%   E  s   € ÷ Vñ V°(ð VÐ?bñ Vr&   c                óŒ   € V P                  4       ;pf   \        R4      hVP                  V P                  \	        V4      .4      # )aÛ  
A combination of :meth:`getStringStream` and :meth:`getMultipleString`.

Checks to see if a single binary stream exists to return, otherwise
tries to return the multiple binary stream of the same ID.

Like :meth:`getStringStream`, the 4 character type suffix should be
omitted. So if you want the stream "__substg1.0_00010102" then the
filename would simply be "__substg1.0_0001".

:raises ReferenceError: The associated ``MSGFile`` instance has been
    garbage collected.
rS   )r*   rT   ÚgetSingleOrMultipleBinaryr+   r   rs   s   && r#   r©   Ú(AttachmentBase.getSingleOrMultipleBinaryE  ó@   € ð —:‘:“<ÐˆCÒ(Ü Ð!gÓhÐhØ×,Ñ,¨d¯j©j¼/È(Ó:SÐ-TÓUÐUr&   c               ó    € V ^8„  d   QhRRRR/# )r   rQ   r   rH   zOptional[Union[List[str], str]]r!   )r"   s   "r#   r$   r%   W  s   € ÷ Vñ V°(ð VÐ?^ñ Vr&   c                óŒ   € V P                  4       ;pf   \        R4      hVP                  V P                  \	        V4      .4      # )aÛ  
A combination of :meth:`getStringStream` and :meth:`getMultipleString`.

Checks to see if a single string stream exists to return, otherwise
tries to return the multiple string stream of the same ID.

Like :meth:`getStringStream`, the 4 character type suffix should be
omitted. So if you want the stream "__substg1.0_0001001F" then the
filename would simply be "__substg1.0_0001".

:raises ReferenceError: The associated ``MSGFile`` instance has been
    garbage collected.
rS   )r*   rT   ÚgetSingleOrMultipleStringr+   r   rs   s   && r#   r®   Ú(AttachmentBase.getSingleOrMultipleStringW  r«   r&   c               ó    € V ^8„  d   QhRRRR/# )r   rQ   r   rH   úOptional[bytes]r!   )r"   s   "r#   r$   r%   i  s   € ÷ Fñ F (ð F¨ñ Fr&   c                óŒ   € V P                  4       ;pf   \        R4      hVP                  V P                  \	        V4      .4      # )zï
Gets a binary representation of the requested stream.

This should ALWAYS return a ``bytes`` object if it was found, otherwise
returns ``None``.

:raises ReferenceError: The associated ``MSGFile`` instance has been
    garbage collected.
rS   )r*   rT   Ú	getStreamr+   r   rs   s   && r#   r³   ÚAttachmentBase.getStreami  s>   € ð —:‘:“<ÐˆCÒ(Ü Ð!gÓhÐhØ�}‰}˜dŸj™j¬/¸(Ó*CÐDÓEÐEr&   c               ó$   € V ^8„  d   QhRRRRRR/# ©r   ÚstreamIDr   r:   r�   rH   r‘   r!   )r"   s   "r#   r$   r%   w  s#   € ÷ ñ  Hð Ð=Oð ÐT`ñ r&   c                ó@   € V P                  V4      pVe	   V! V4      pV# )aµ  
Returns the specified stream, modifying it to the specified class if it
is found.

:param overrideClass: Class/function to use to morph the data that was
    read. The data will be the first argument to the class's
    ``__init__`` method or the function itself, if that is what is
    provided. If the value is ``None``, this function is not called. If
    you want it to be called regardless, you should handle the data
    directly.
©r³   ©r1   r·   r:   r;   s   &&& r#   ÚgetStreamAsÚAttachmentBase.getStreamAsw  ó'   € ð —‘˜xÓ(ˆàÒÙ! %Ó(ˆEàˆr&   c               ó    € V ^8„  d   QhRRRR/# )r   rQ   r   rH   úOptional[str]r!   )r"   s   "r#   r$   r%   Š  s   € ÷ Lñ L¨ð L°]ñ Lr&   c                óŒ   € V P                  4       ;pf   \        R4      hVP                  V P                  \	        V4      .4      # )a»  
Gets a string representation of the requested stream.

Rather than the full filename, you should only feed this function the
filename sans the type. So if the full name is "__substg1.0_001A001F",
the filename this function should receive should be "__substg1.0_001A".

This should ALWAYS return a string if it was found, otherwise returns
``None``.

:raises ReferenceError: The associated ``MSGFile`` instance has been
    garbage collected.
rS   )r*   rT   ÚgetStringStreamr+   r   rs   s   && r#   rÁ   ÚAttachmentBase.getStringStreamŠ  s@   € ð —:‘:“<ÐˆCÒ(Ü Ð!gÓhÐhØ×"Ñ" D§J¡J´ÀÓ0IÐ#JÓKÐKr&   c               ó$   € V ^8„  d   QhRRRRRR/# r¶   r!   )r"   s   "r#   r$   r%   œ  s#   € ÷ ñ ¨(ð ÐCUð ÐZfñ r&   c                ó@   € V P                  V4      pVe	   V! V4      pV# )a¼  
Returns the specified string stream, modifying it to the specified
class if it is found.

:param overrideClass: Class/function to use to morph the data that was
    read. The data will be the first argument to the class's
    ``__init__`` method or the function itself, if that is what is
    provided. If the value is ``None``, this function is not called. If
    you want it to be called regardless, you should handle the data
    directly.
r¹   rº   s   &&& r#   ÚgetStringStreamAsÚ AttachmentBase.getStringStreamAsœ  r½   r&   c               ó$   € V ^8„  d   QhRRRRRR/# )r   Ústreamsr7   ÚstoragesrH   zList[List[str]]r!   )r"   s   "r#   r$   r%   ¯  s!   € ÷ <ñ <˜tð <°dð <Àñ <r&   c                óô   € V P                  4       ;pf   \        R4      hVP                  WR4       Uu. uF8  p\        V4      ^8”  g   K  V^ ,          V P                  8X  g   K/  VR,          NK:  	  up# u upi )zÃ
Lists the streams and/or storages that exist in the attachment
directory.

Returns the paths *excluding* the attachment directory, allowing the
paths to be directly used for accessing a stream.
rS   F:é   NN)r*   rT   ÚlistDirÚlenr+   )r1   rÈ   rÉ   r   r_   s   &&&  r#   rÌ   ÚAttachmentBase.listDir¯  sy   € ð —:‘:“<ÐˆCÒ(Ü Ð!gÓhÐhØ%(§[¡[°ÀEÔ%Jó <Ñ%J˜TÜ�t“9˜q‘=ô Ø%)¨!¥W°·
±
Ñ%:ô ��R—�Ñ%Jñ <ð 	<ùò <s   ´A5ÁA5Á%A5c               ó$   € V ^8„  d   QhRRRRRR/# )r   rÈ   r7   rÉ   rH   z	List[str]r!   )r"   s   "r#   r$   r%   ¼  s&   € ÷ Lñ L ð L°tð LÈ	ñ Lr&   c                ól   € V P                  W4       Uu. uF  pRP                  V4      NK  	  up# u upi )z7
Like listDir, except it returns the paths as strings.
r[   )rÌ   Újoin)r1   rÈ   rÉ   r_   s   &&& r#   ÚslistDirÚAttachmentBase.slistDir¼  s/   € ð ,0¯<©<¸Ô+JÓKÑ+J 4�—‘˜–Ñ+JÑKÐKùÒKs   ”1c               ó   € V ^8„  d   QhRR/# )r   rH   r   r!   )r"   s   "r#   r$   r%   Ã  s   € ÷ ñ  	ñ r&   c                ó   € R# )aÔ  
Saves the attachment data.

The name of the file is determined by the logic of :meth:`getFilename`.
If you are a developer, ensure that you use this behavior.

To change the directory that the attachment is saved to, set the value
of :param customPath: when calling this function. The default save
directory is the working directory.

If you want to save the contents into a ``ZipFile`` or similar object,
either pass a path to where you want to create one or pass an instance
to :param zip:. If :param zip: is an instance, :param customPath: will
refer to a location inside the zip file.

:param extractEmbedded: If ``True``, causes the attachment, should it
    be an embedded MSG file, to save as a .msg file instead of calling its save function.
:param skipEmbedded: If ``True``, skips saving this attachment if it is
    an embedded MSG file.

:returns: A tuple that specifies how the data was saved. The value of
    the first item specifies what the second value will be.
Nr!   r€   s   &,r#   ÚsaveÚAttachmentBase.saveÂ  rƒ   r&   c               ó   € V ^8„  d   QhRR/# )r   rH   r±   r!   )r"   s   "r#   r$   r%   Ý  s   € ÷ 6ñ 6 Oñ 6r&   c                ó$   € V P                  R4      # )z§
The encoding information about the attachment object.

Will return ``b'\x2A\x86\x48\x86\xf7\x14\x03\x0b\x01'`` if
encoded in MacBinary format, otherwise it is unset.
z__substg1.0_37020102r¹   ©r1   s   &r#   ÚattachmentEncodingÚ!AttachmentBase.attachmentEncodingÜ  s   € ð �~‰~Ð4Ó5Ð5r&   c               ó   € V ^8„  d   QhRR/# ©r   rH   r¿   r!   )r"   s   "r#   r$   r%   ç  s   € ÷ 	8ñ 	8 }ñ 	8r&   c                ó$   € V P                  R4      # )a*  
The additional information about the attachment.

This property MUST be an empty string if attachmentEncoding is not set.
Otherwise it MUST be set to a string of the format ":CREA:TYPE" where
":CREA" is the four-letter Macintosh file creator code and ":TYPE" is a
four-letter Macintosh type code.
z__substg1.0_370F©rÁ   rÚ   s   &r#   ÚadditionalInformationÚ$AttachmentBase.additionalInformationæ  s   € ð ×#Ñ#Ð$6Ó7Ð7r&   c               ó   € V ^8„  d   QhRR/# rÞ   r!   )r"   s   "r#   r$   r%   ó  s   € ÷ 8ñ 8�]ñ 8r&   c                ó$   € V P                  R4      # )z9
Returns the Content ID of the attachment, if it exists.
z__substg1.0_3712rà   rÚ   s   &r#   ÚcidÚAttachmentBase.cidò  ó   € ð
 ×#Ñ#Ð$6Ó7Ð7r&   c               ó   € V ^8„  d   QhRR/# r~   r!   )r"   s   "r#   r$   r%   ú  s   € ÷ ñ �sñ r&   c                ó<  € RpRpV P                  R4      '       d   V P                  R.pM%V P                  R4      '       d   V P                  R.pV'       dE   V P                  4       ;pf   \        R4      hVP	                  V4      P
                  ;'       g    TpV# )zB
Returns the CLSID for the data stream/storage of the attachment.
z$00000000-0000-0000-0000-000000000000Nz__substg1.0_3701000Dz__substg1.0_37010102rS   )re   r+   r*   rT   Ú_getOleEntryÚclsid)r1   rë   Ú
dataStreamr   s   &   r#   rë   ÚAttachmentBase.clsidù  s‘   € ð 7ˆØˆ
à�;‰;Ð-×.Ò.ØŸ*™*Ð&<Ð=‰JØ�[‰[Ð/×0Ò0ØŸ*™*Ð&<Ð=ˆJ÷ Ø—z‘z“|Ð#�Ò,Ü$Ð%kÓlÐlØ×$Ñ$ ZÓ0×6Ñ6×?Ð?¸%ˆEàˆr&   c               ó   € V ^8„  d   QhRR/# rÞ   r!   )r"   s   "r#   r$   r%     s   € ÷ ñ ˜=ñ r&   c                ó   € V P                   # )z
Alias of :attr:`cid`.
)rå   rÚ   s   &r#   Ú	contentIdÚAttachmentBase.contentId  s   € ð
 �x‰xˆr&   c               ó   € V ^8„  d   QhRR/# ©r   rH   zOptional[datetime.datetime]r!   )r"   s   "r#   r$   r%     s   € ÷ !ñ !Ð6ñ !r&   c                ó   € V P                   # )z 
Alias of :attr:`creationTime`.
)ÚcreationTimerÚ   s   &r#   Ú	createdAtÚAttachmentBase.createdAt  s   € ð
 × Ñ Ð r&   c               ó   € V ^8„  d   QhRR/# ró   r!   )r"   s   "r#   r$   r%     s   € ÷ /ñ /Ð9ñ /r&   c                ó$   € V P                  R4      # )z&
The time the attachment was created.
Ú30070040rŸ   rÚ   s   &r#   rõ   ÚAttachmentBase.creationTime  ó   € ð
 ×"Ñ" :Ó.Ð.r&   c               ó   € V ^8„  d   QhRR/# )r   rH   zOptional[object]r!   )r"   s   "r#   r$   r%   &  s   € ÷ ñ Ð&ñ r&   c                ó   € R# )zM
The attachment data, if any.

Returns ``None`` if there is no data to save.
Nr!   rÚ   s   &r#   ÚdataÚAttachmentBase.data$  rƒ   r&   c               ó   € V ^8„  d   QhRR/# )r   rH   zOptional[Type[object]]r!   )r"   s   "r#   r$   r%   .  s   € ÷ ñ Ð0ñ r&   c                ót   €  V P                   f   R# V P                   P                  #   \         d     R# i ; i)zî
The class that the data type will use, if it can be retrieved.

This is a safe way to do type checking on data before knowing if it will
raise an exception. Returns ``None`` if no data will be returned or if
an exception will be raised.
N)rÿ   Ú	__class__Ú	ExceptionrÚ   s   &r#   ÚdataTypeÚAttachmentBase.dataType-  s7   € ð	ØŸ9™9Ò,�4ÐE°$·)±)×2EÑ2EÐEøÜô 	âð	ús   ‚( ’( ¨7¶7c               ó   € V ^8„  d   QhRR/# r~   r!   )r"   s   "r#   r$   r%   =  s   € ÷ ñ �Sñ r&   c                ó   € V P                   # )zL
Returns the directory inside the MSG file where the attachment is
located.
)r+   rÚ   s   &r#   ÚdirÚAttachmentBase.dir<  s   € ð �z‰zÐr&   c               ó   € V ^8„  d   QhRR/# rÞ   r!   )r"   s   "r#   r$   r%   E  s   € ÷ 8ñ 8˜]ñ 8r&   c                ó$   € V P                  R4      # )z)
Returns the display name of the folder.
z__substg1.0_3001rà   rÚ   s   &r#   ÚdisplayNameÚAttachmentBase.displayNameD  rç   r&   c               ó   € V ^8„  d   QhRR/# ró   r!   )r"   s   "r#   r$   r%   L  s   € ÷ /ñ /Ð&Añ /r&   c                ó$   € V P                  R4      # )z¸
The original date and time at which the instance in the recurrence
pattern would have occurred if it were not an exception.

Only applicable if the attachment is an Exception object.
Ú7FF90040rŸ   rÚ   s   &r#   ÚexceptionReplaceTimeÚ#AttachmentBase.exceptionReplaceTimeK  s   € ð ×"Ñ" :Ó.Ð.r&   c               ó   € V ^8„  d   QhRR/# rÞ   r!   )r"   s   "r#   r$   r%   V  s   € ÷ 8ñ 8˜=ñ 8r&   c                ó$   € V P                  R4      # )z&
The reported extension for the file.
z__substg1.0_3703rà   rÚ   s   &r#   Ú	extensionÚAttachmentBase.extensionU  rç   r&   c               ó   € V ^8„  d   QhRR/# ©r   rH   r7   r!   )r"   s   "r#   r$   r%   ]  s   € ÷ 5ñ 5˜ñ 5r&   c                ó6   € \        V P                  R4      4      # )zE
Indicates whether an Attachment object is hidden from the end user.
Ú7FFE000B©r7   rK   rÚ   s   &r#   ÚhiddenÚAttachmentBase.hidden\  ó   € ô
 �D×'Ñ'¨
Ó3Ó4Ð4r&   c               ó   € V ^8„  d   QhRR/# r  r!   )r"   s   "r#   r$   r%   d  s   € ÷ 5ñ 5¨$ñ 5r&   c                ó6   € \        V P                  R4      4      # )zA
Whether the attachment is a contact photo for a Contact object.
Ú7FFF000Br  rÚ   s   &r#   ÚisAttachmentContactPhotoÚ'AttachmentBase.isAttachmentContactPhotoc  r  r&   c               ó   € V ^8„  d   QhRR/# ró   r!   )r"   s   "r#   r$   r%   k  s   € ÷ /ñ /Ð&Añ /r&   c                ó$   € V P                  R4      # )z,
The last time the attachment was modified.
Ú30080040rŸ   rÚ   s   &r#   ÚlastModificationTimeÚ#AttachmentBase.lastModificationTimej  rü   r&   c               ó   € V ^8„  d   QhRR/# rÞ   r!   )r"   s   "r#   r$   r%   r  ó   € ÷ 8ñ 8˜mñ 8r&   c                ó$   € V P                  R4      # )z=
Returns the long file name of the attachment, if it exists.
z__substg1.0_3707rà   rÚ   s   &r#   ÚlongFilenameÚAttachmentBase.longFilenameq  rç   r&   c               ó   € V ^8„  d   QhRR/# rÞ   r!   )r"   s   "r#   r$   r%   y  r+  r&   c                ó$   € V P                  R4      # )z8
The fully qualified path and file name with extension.
z__substg1.0_370Drà   rÚ   s   &r#   ÚlongPathnameÚAttachmentBase.longPathnamex  rç   r&   c               ó   € V ^8„  d   QhRR/# rÞ   r!   )r"   s   "r#   r$   r%   €  s   € ÷ Nñ N˜-ñ Nr&   c                ó6   € \        W P                  R4      4      # )z?
The content-type mime header of the attachment, if specified.
z__substg1.0_370E)r   rÁ   rÚ   s   &r#   ÚmimetypeÚAttachmentBase.mimetype  s   € ô
 ˜d×$8Ñ$8Ð9KÓ$LÓMÐMr&   c               ó   € V ^8„  d   QhRR/# ró   r!   )r"   s   "r#   r$   r%   ‡  s   € ÷ )ñ )Ð7ñ )r&   c                ó   € V P                   # )z(
Alias of :attr:`lastModificationTime`.
)r(  rÚ   s   &r#   Ú
modifiedAtÚAttachmentBase.modifiedAt†  s   € ð
 ×(Ñ(Ð(r&   c               ó   € V ^8„  d   QhRR/# )r   rH   r   r!   )r"   s   "r#   r$   r%   Ž  s   € ÷ 	ñ 	�Wñ 	r&   c                óD   € V P                  4       ;pf   \        R4      hV# )zš
Returns the ``MSGFile`` instance the attachment belongs to.

:raises ReferenceError: The associated ``MSGFile`` instance has been
    garbage collected.
rS   )r*   rT   )r1   r   s   & r#   r   ÚAttachmentBase.msg�  s&   € ð —:‘:“<ÐˆCÒ(Ü Ð!gÓhÐhØˆ
r&   c               ó   € V ^8„  d   QhRR/# rÞ   r!   )r"   s   "r#   r$   r%   š  s   € ÷ 	7ñ 	7�mñ 	7r&   c                óÈ   € V P                   \        P                  J d&   V P                  '       d   V P                  R,           # V P                  ;'       g    V P
                  # )zI
The best name available for the file.

Uses long filename before short.
z.msg)Útyper   ÚMSGr  r-  ÚshortFilenamerÚ   s   &r#   ri   ÚAttachmentBase.name™  sM   € ð �9‰9œ×*Ñ*Ó*Ø××ÐØ×'Ñ'¨&Õ0Ð0Ø× Ñ ×6Ð6 D×$6Ñ$6Ð6r&   c               ó   € V ^8„  d   QhRR/# )r   rH   r   r!   )r"   s   "r#   r$   r%   ¦  s   € ÷ &ñ & ñ &r&   c                ó   € V P                   # )z=
The NamedAttachmentProperties instance for this attachment.
)r.   rÚ   s   &r#   rš   ÚAttachmentBase.namedProperties¥  s   € ð
 ×%Ñ%Ð%r&   c               ó   € V ^8„  d   QhRR/# rÞ   r!   )r"   s   "r#   r$   r%   ­  s   € ÷ 8ñ 8˜mñ 8r&   c                ó$   € V P                  R4      # )zK
The class name of an object that can display the contents of the
message.
z__substg1.0_371Arà   rÚ   s   &r#   ÚpayloadClassÚAttachmentBase.payloadClass¬  s   € ð ×#Ñ#Ð$6Ó7Ð7r&   c               ó   € V ^8„  d   QhRR/# )r   rH   r   r!   )r"   s   "r#   r$   r%   µ  s   € ÷ ñ �ñ r&   c                ó   € V P                   # )z4
Returns the Properties instance of the attachment.
)r,   rÚ   s   &r#   r¤   ÚAttachmentBase.props´  s   € ð
 �|‰|Ðr&   c               ó   € V ^8„  d   QhRR/# )r   rH   zOptional[int]r!   )r"   s   "r#   r$   r%   ¼  s   € ÷ /ñ / =ñ /r&   c                ó$   € V P                  R4      # )z½
The offset, in rendered characters, to use when rendering the attachment
within the main message text.

A value of ``0xFFFFFFFF`` indicates a hidden attachment that is not to
be rendered.
Ú370B0003rŸ   rÚ   s   &r#   ÚrenderingPositionÚ AttachmentBase.renderingPosition»  s   € ð ×"Ñ" :Ó.Ð.r&   c               ó   € V ^8„  d   QhRR/# rÞ   r!   )r"   s   "r#   r$   r%   Ç  s   € ÷ 8ñ 8˜}ñ 8r&   c                ó$   € V P                  R4      # )z6
The short file name of the attachment, if it exists.
z__substg1.0_3704rà   rÚ   s   &r#   rB  ÚAttachmentBase.shortFilenameÆ  rç   r&   c               ó   € V ^8„  d   QhRR/# )r   rH   z List[weakref.ReferenceType[Any]]r!   )r"   s   "r#   r$   r%   Î  s   € ÷ ñ Ð:ñ r&   c                ó   € V P                   # )zf
A path, as a tuple of instances, needed to get to this instance through
the MSGFile-Attachment tree.
)r0   rÚ   s   &r#   r/   ÚAttachmentBase.treePathÍ  s   € ð �‰Ðr&   c               ó   € V ^8„  d   QhRR/# )r   rH   r   r!   )r"   s   "r#   r$   r%   ×  s   € ÷ ñ �nñ r&   c                ó   € R# )z7
An enum value that identifies the type of attachment.
Nr!   rÚ   s   &r#   r@  ÚAttachmentBase.typeÕ  rƒ   r&   )Ú__dirÚ__msgÚ__namedPropertiesÚ__propsÚ
__treePath)NT)N)TF)@Ú__name__Ú
__module__Ú__qualname__Ú__firstlineno__Ú__doc__r2   r<   r9   rA   r@   rn   re   rw   r{   ÚabcÚabstractmethodr�   r†   r‹   r”   r“   r    rK   r©   r®   r³   r»   rÁ   rÅ   rÌ   rÒ   rÖ   r   rÛ   rá   rå   rë   Úpropertyrð   rö   rõ   rÿ   r  r	  r  r  r  r  r#  r(  r-  r1  r5  r9  r   ri   rš   rI  r¤   rQ  rB  r/   r@  Ú__static_attributes__r!   r&   r#   r   r   )   s  † ñõ=÷ô2-÷.÷.Yõ2(õT	Cõ	D÷Rð 	×Ñô	ó ð	õNõNõ÷ Gõ÷$2õVõ$Võ$Fõõ&Lõ$÷&<÷Lð 	×Ñôó ðð2 ô6ó ð6ð ô	8ó ð	8ð ô8ó ð8ð ôó ðð* ôó ðð ô!ó ð!ð ô/ó ð/ð Ø×Ñôó ó ðð ôó ðð ôó ðð ô8ó ð8ð ô/ó ð/ð ô8ó ð8ð ô5ó ð5ð ô5ó ð5ð ô/ó ð/ð ô8ó ð8ð ô8ó ð8ð ôNó ðNð ô)ó ð)ð ô	ó ð	ð ô	7ó ð	7ð ô&ó ð&ð ô8ó ð8ð ôó ðð ô/ó ð/ð ô8ó ð8ð ôó ðð Ø×Ñôó ó ôr&   )-Ú
__future__r   Ú__all__rf  ÚdatetimeÚ	functoolsÚloggingr^   Úpathlibr(   r   Útypingr   r   r   r	   r
   r   r   r   Ú	constantsr   r   r   Úenumsr   Úproperties.namedr   Úproperties.properties_storer   Úutilsr   r   r   r   Úmsg_classes.msgr   Ú	getLoggerra  ÚloggerÚ
addHandlerÚNullHandlerr   ÚABCr   r!   r&   r#   Ú<module>r|     s¢   ðÝ "ð ð€ó
 Û Û Û Û 	Û Û å %÷÷ ó ÷ <Ñ ;Ý "Ý .Ý 9÷ó ÷ Ý)à	×	Ò	˜8Ó	$€Ø × Ñ �'×%Ò%Ó'Ô (áˆTƒ]€ôq
�S—W‘Wö q
r&   