Ng=dZddlmZddlZddlZddlZddlZddlZddl m Z ddl m Z m Z mZddlmZddlmZddlmZdd lmZdd lmZGd d ZGd dZGddeZGddeZGddeZGddeZGddeZGddeZ GddeZ!GddeZ"Gdd eZ#d(d'Z$dS))aRProvides access to all properties of a top-level object (message, recipient, attachment). This object is accessed using the `.properties` property of a top-level object. The properties for each top-level object are segregated into its own properties object. Many property-ids (PIDs) and property-types (PTYPs) are available as constants in `oxml.domain.contants`. ```python >>> from oxmsg import Message >>> from oxmsg.domain import constants as c >>> msg = Message.load("message.msg") >>> properties = msg.properties >>> properties.str_prop_value(c.PID_MESSAGE_CLASS).value 'IPM.Note' ``` ) annotationsN) defaultdict)FinalIteratorcast) constants) encodings)model) reference) lazypropertyceZdZdZd'dZd(d Zd)d Zed*dZd+dZ d,dZ d-dZ ed.dZ d/dZ d0dZed*dZed1dZed2d!Zed3d#Zed4d%Zd&S)5 Propertiesz4Provides access to properties from an OXMSG storage.storagem.PropStorageTproperties_header_offsetintc"||_||_dSN)_storage_properties_header_offset)selfrrs L/var/www/html/ai-engine/env/lib/python3.11/site-packages/oxmsg/properties.py__init__zProperties.__init__(s *B&&&returnIterator[m.PropertyT]c*t|jSr)iter_property_sequencers r__iter__zProperties.__iter__.sD+,,,rpid bytes | Nonec~||tj}|dStt|jS)zRetrieve bytes of PtypBinary property identified by `pid`. Returns `None` if property is not present in this collection. N) _get_propertyc PTYP_BINARYrBinaryPropertyvaluerr"propertys rbinary_prop_valuezProperties.binary_prop_value1s9 %%c1=99  4NH--33rstrc|tj}|tj|jS|jS)a The encoding used for a PidTagBody or PidTagHtml property of PtypString8/Binary. Must be cherry-picked because it is required before constructing the properties collection. Note when these are PtypString they unconditionally use UTF-16LE. )_cherry_pick_int_propr&PID_INTERNET_CODEPAGEr encoding_from_codepager)_str_prop_encoding)rinternet_codepages r body_encodingzProperties.body_encoding=sA!66q7NOO  (34E4KLL L&&rdt.datetime | Nonecr|j|}|dStt|jS)zRead datetime property value from the properties stream. - Microseconds are truncated. - Returns `None` when no `pid` property is present in properties stream. N)_properties_mappinggetr TimePropertyr)r*s rdate_prop_valuezProperties.date_prop_valueMs8 +//44  4L(++11r int | Nonecr|j|}|dStt|jS)zRetrieve int value of PtypInteger32 property identified by `pid`. Returns `None` if no `pid` property is present in this collection. N)r7r8r Int32Propertyr)r*s rint_prop_valuezProperties.int_prop_valueZs8 +//44  4M8,,22r str | Nonec||tjtjf}|dSt t |jS)zRetrieve str value of PtypString or PtypString8 property identified by `pid`. Returns the empty str if property is not present in this collection. N)r%r& PTYP_STRING PTYP_STRING8rStringPropertyr)r*s rstr_prop_valuezProperties.str_prop_valuefs@ %%cAM1>+JKK  4NH--33rboolc|tj}|dSt|tjzS)zMTrue indicates PtypString properties in this message are encoded "utf-16-le".NF)r>r&PID_STORE_SUPPORT_MASKrEmSTORE_UNICODE_OK)rstore_support_masks rstring_props_are_unicodez#Properties.string_props_are_unicoders="001IJJ  %5&);;<<z4Properties._prop_segment_sequence..sC  7||r!!  "!!!   rNrg)tuple_batched_bytesrproperties_stream_bytesrr s rrRz!Properties._prop_segment_sequencesU  ) 5d6T6V6VWY[      r#defaultdict[int, list[m.PropertyT]]ctt}|jD]"}||j|#|S)aProperties in this collection grouped by property-id (PID). Not sure if this solves an actual problem in practice, but it's at least theoretically possible that the same PID could appear twice in a property collection with different PTYPs. )rlistrr"append)rproperties_by_pidr`s rr\zProperties._properties_by_pidsJBMTARAR( / /A ae $ + +A . . . .  r(types.MappingProxyType[int, m.PropertyT]cHtjd|jDS)z5The property objects in this collection keyed by pid.ci|] }|j| S)r")rir`s r z2Properties._properties_mapping..s&Q&Q&QAqua&Q&Q&Qr)typesMappingProxyTyperr s rr7zProperties._properties_mappings'%&Q&Q9P&Q&Q&QRRRrtuple[m.PropertyT, ...]ctjdtjfd}t fd|DS)zrProperty object for each property in this collection. Properties are in property-id (PID) order. rNcJ|dddS)NrOr)rS)xrTs rz/Properties._property_sequence..s&SZZPQRTSTRTPUEVEVWXEYr)keyc3rK|]1}t|jjjV2dS)rUrstr_prop_encodingr4N) BasePropertyfactoryrr2r4)rirUrs rrjz0Properties._property_sequence..sb     "&"9"0 !        r)rPrQsortedrRrk)rsegmentsrTs` @rrzProperties._property_sequencesn mF##$5;Y;Y;Y;YZZZ    $      rN)rrrr)rr)r"rrr#rr-)r"rrr5)r"rrr;)r"rrr?rrE)r"rrrL)r"rrWrXrrY)rrd)rrn)rrs)rrz)__name__ __module__ __qualname____doc__rr!r,r r4r:r>rDrKr/r%r2rRr\r7rrvrrrr%s>>BBBB ---- 4 4 4 4 ' ' '\ ' 2 2 2 2 3 3 3 3 4 4 4 4===\=        \     \   ! ! !\ !SSS\S   \   rrceZdZUdZejdZded<ejdZded<dd Z e ddZ e ddZ e ddZe ddZe ddZeddZdS)rz6Base class for properties, providing common behaviors.rNFinal[struct.Struct]rT ! !"7++ + 1% % %"7++ + 1;  11 1 1$ $ $ )) ) 1$ $ $ )) ) 1= !'733 3 1> ! !""3+   1;  (( (  W  !!! !g!!"""W%%%rc`tj|j}||jndS)z?The Microsft name for this property, like "PidTagMessageClass".Nznot recorded in model)refproperty_descriptorsr8r"ms_name)r prop_descs rnamezBaseProperty.names0,00:: $-$9y  ?VVrrc\|j|jdddS)zJThe property-id (PID) for this property, like 0x3701 for attachment bytes.NrOr)rTrSrr s rr"zBaseProperty.pids(xt}RaR011!44rc\|j|jdddS)zGThe property-type (PTYP) for this property, like 0x0102 for PtypBinary.Nrr)rrSrr s rr]zBaseProperty.ptyps*y bqb 122155rcrtj|j}|r|jn |jddS)zCThe Microsft name for the type of this property, like "PtypString".04Xz not recorded in model)rproperty_type_descriptorsr8r]r)rprop_type_descs r ptyp_namezBaseProperty.ptyp_names?6::49EE&4 bN " "TY:b:b:b:b rc |jddS)zOThe latter 8 bytes of the property segment, where the property value is stored.Nrr s r_payloadzBaseProperty._payload's}QRR  rN)rUr) rUrrrrr-r4r-rrrrrrr)rrrrrPrQrT__annotations__rr classmethodrr+rr"r]rr rrvrrrrs/@@ - f 5 5C5555!.t!4!4D4444    )&)&)&[)&VWWWXW 555X5666X6   X !!!\!!!rrc<eZdZdZd fd Zed dZxZS) r(z'Property for PtypBinary OLE properties.rUrrrcXt|||_dSrsuperrrrrUr __class__s rrzBinaryProperty.__init__0& !!! rrcL|j|j|jS)z"The bytes of this binary property.)rproperty_stream_bytesr"r]r s rr)zBinaryProperty.value4s }2248TYGGGrrUrrrrrrrrrr r) __classcell__rs@rr(r(-sk11      HHH\HHHHHrr(cVeZdZUdZejdZded<ed dZ dS) rz(Property for PtypBoolean OLE properties.zrs&#""""" ######((((((((((''''''""""""######))))))######r r r r r r r r jP!P!P!P!P!P!P!P!f H H H H H\ H H HBBBBBlBBB55555l555aaaaa<aaa277777L77777777L777 \ \ \ \ \\ \ \ \     l   , A A A A A< A A A      r