3fiIddlZddlZddlmZddlmZddlmZddl m Z m Z ddl m Z mZmZmZmZmZej&eZGdd eeZGd d eZGd d eZGddeZy)N)parse) HTTPError)Category)Message RecipientType)NEXT_LINK_KEYWORD ApiComponentAttachableMixin Pagination Recipients TrackerSetceZdZdZddddddZeZddd fd Zd Zd Z d Z e dZ e dZ e dZejdZe dZejdZe dZejdZe dZejdZe dZe dZejdZe dZejdZe dZejdZe dZejd Ze d!Zejd"Ze d#Zejd$Ze d%Zejd&Ze d'Zejd(Ze d)Ze d*Ze d+Zejd,Ze d-Zejd.Ze d/Z e jd0Z e d1Z!e!jd2Z!e d3Z"e"jd4Z"e d5Z#e#jd6Z#e d7Z$d?d8Z%d9Z&d:Z'd?e(jRd;d<Z*d?d=Z+d>Z,xZ-S)@ContactzI Contact manages lists of events on associated contact on Microsoft 365. /contactsz/contacts/{id}z$/contactFolders/{folder_id}/contactsz/contacts/{id}/photo/$valuez#/contacts/{id}/photos/{size}/$value)contact root_contact child_contactphoto photo_sizeNparentconc 2 |r |r td|r |jn||_|jddxs|r t|ddnd}t ||r |j n|jd||j|ji}|j}t||_ |j|dd|_ |j|dd|_ |j|d d|_|j j}|jr$t!|jj#|nd|_ |jr$t!|jj#|nd|_|j|d d |_|j|d d |_|j|d d |_|j|dd |_|j|dd |_|j|dd |_|j|dd |_|j|dd |_|j|dd |_|j|dgxsg|_|j|dd |_|j|dgxsg|_|j|dg}t=|D cgc]2} | j|dd | j|dd f4c} ||d|_|j|d} d|j>_ | r)| |j>vr|j>jC| |j|di|_"|j|di|_#|j|di|_$|j|d d|_%|j|d!g|_&|j|d"d|_'|j|d#d |_(|j|d$d} |j|d%d} | r)| |jRvr|jRjC| | r)| |jRvr|jRjC| d&|j>_ ycc} w)'a Create a contact API component :param parent: parent account for this folder :type parent: Account :param Connection con: connection to use if no parent specified :param Protocol protocol: protocol to use if no parent specified (kwargs) :param str main_resource: use this resource instead of parent resource (kwargs) *Need a parent or a connection but not both main_resourceNprotocolrr)casingidcreatedDateTimelastModifiedDateTime displayNamefileAs givenNamesurnametitlejobTitle companyName departmentofficeLocationbusinessPhones mobilePhone homePhonesemailAddressesnameaddress) recipientsrfieldemailTbusinessAddress homeAddress otherAddresspreferredLanguage categoriesparentFolderId personalNotesmailuserPrincipalNameF)* ValueErrorrpopgetattrsuper__init__rget_cloud_data_key_ccr_track_changes object_id_Contact__created_Contact__modifiedtimezoner astimezone_Contact__display_name_Contact__fileAs_Contact__name_Contact__surname_Contact__title_Contact__job_title_Contact__company_name_Contact__department_Contact__office_location_Contact__business_phones_Contact__mobile_phone_Contact__home_phonesr _Contact__emailsuntrackadd_Contact__business_address_Contact__home_address_Contact__other_address_Contact__preferred_language_Contact__categories_Contact__folder_id_Contact__personal_notesemails)selfrrkwargsr cloud_datacclocal_tzrcrcpr5r=user_principal_name __class__s O/var/www/auto_recruiter/arenv/lib/python3.12/site-packages/O365/address_book.pyrCzContact.__init__"sU cIJ J!'6::S ?D9H6C"r(|R8  nnR _b9 #9 r:!~~bk26 %>>"Z."=(nnR ->C&NN2l+;R@!+3C0Db!I!+3C0Db!I!OR(nnR ->C'^^B|,C)~~b.@"E$.NN26I3J37%9!'NN2l+;R@%>>"-=*>E *r//BB G~~bj$/(nnR0C-DdK D + KKOOD ! #6dkk#I KKOO/ 0 % 7+s7Tc"|jSN__repr__rds rl__str__zContact.__str__w}}c>|jxs|jxsdS)Nz Unknown Name) display_name full_namerqs rlrpzContact.__repr__zs  DDNNDnDrtc4|j|jk(Srn)rHrdothers rl__eq__zContact.__eq__}~~00rtc|jS)z0 Created Time :rtype: datetime )rIrqs rlcreatedzContact.createds ~~rtc|jS)z6 Last Modified Time :rtype: datetime )rJrqs rlmodifiedzContact.modifieds rtc|jS)z Display Name :getter: Get the display name of the contact :setter: Update the display name :type: str )rMrqs rlrvzContact.display_name"""rtcf||_|jj|jdy)Nr#)rMrGr[rFrdvalues rlrvzContact.display_name'#  78rtc|jS)zw File As :getter: Get the fileAs of the contact :setter: Update the fileAs :type: str )rNrqs rlr%zContact.fileAss}}rtcf||_|jj|jdy)Nr%)rNrGr[rFrs rlr%zContact.fileAss&   23rtc|jS)zv First Name :getter: Get the name of the contact :setter: Update the name :type: str )rOrqs rlr1z Contact.names{{rtcf||_|jj|jdy)Nr&)rOrGr[rFrs rlr1z Contact.names&   56rtc|jS)z Surname of Contact :getter: Get the surname of the contact :setter: Update the surname :type: str )rPrqs rlr'zContact.surnames~~rtcf||_|jj|jdy)Nr')rPrGr[rFrs rlr'zContact.surnames&  34rtcjdj|j|jjS)z9 Full Name (Name + Surname) :rtype: str z{} {})formatr1r'striprqs rlrwzContact.full_names& ~~dii6<<>>rtc|jS)z Title (Mr., Ms., etc..) :getter: Get the title of the contact :setter: Update the title :type: str )rQrqs rlr(z Contact.titles||rtcf||_|jj|jdy)Nr()rQrGr[rFrs rlr(z Contact.titles&   12rtc|jS)z{ Job Title :getter: Get the job title of contact :setter: Update the job title :type: str )rRrqs rl job_titlezContact.job_titlesrtcf||_|jj|jdy)Nr))rRrGr[rFrs rlrzContact.job_titles'   45rtc|jS)z Name of the company :getter: Get the company name of contact :setter: Update the company name :type: str )rSrqs rl company_namezContact.company_namerrtcf||_|jj|jdy)Nr*)rSrGr[rFrs rlrzContact.company_namerrtc|jS)z~ Department :getter: Get the department of contact :setter: Update the department :type: str )rTrqs rlr+zContact.department   rtcf||_|jj|jdy)Nr+)rTrGr[rFrs rlr+zContact.department s'!  67rtc|jS)z Office Location :getter: Get the office location of contact :setter: Update the office location :type: str )rUrqs rloffice_locationzContact.office_location%%%rtcf||_|jj|jdy)Nr,)rUrGr[rFrs rlrzContact.office_locations(!& )9 :;rtc|jS)z Business Contact numbers :getter: Get the contact numbers of contact :setter: Update the contact numbers :type: list[str] )rVrqs rlbusiness_phoneszContact.business_phonesrrtct|tr t|}t|ts|g}||_|jj |j dy)Nr-) isinstancetuplelistrVrGr[rFrs rlrzContact.business_phones)sL eU #KE%&GE!& )9 :;rtc|jS)z Personal Contact numbers :getter: Get the contact numbers of contact :setter: Update the contact numbers :type: list[str] )rWrqs rl mobile_phonezContact.mobile_phone2rrtcf||_|jj|jdy)Nr.)rWrGr[rFrs rlrzContact.mobile_phone<rrtc|jS)z Home Contact numbers :getter: Get the contact numbers of contact :setter: Update the contact numbers :type: list[str] )rXrqs rl home_phoneszContact.home_phonesAs!!!rtct|tr||_nEt|tr |g|_n,t|trt||_n t d|j j|jdy)Nzhome_phones must be a listr/) rrrXstrrr?rGr[rFrs rlrzContact.home_phonesKsg eT "!&D  s #"'D  u %!%eD 9: :  67rtc|jS)zF List of email ids of the Contact :rtype: Recipients )rYrqs rlrczContact.emailsWs }}rtcN|jsy|jdjS)zE Primary(First) email id of the Contact :rtype: str Nr)rcr2rqs rl main_emailzContact.main_email_s" {{{{1~%%%rtc|jS)z Business Address :getter: Get the address of contact :setter: Update the address :type: dict )r\rqs rlbusiness_addresszContact.business_addressis&&&rtct|ts td||_|jj |j dy)Nz"business_address" must be dictr6)rdictr?r\rGr[rFrs rlrzContact.business_addressss>%&>? ?"' ): ;rtc|jS)z Assigned Categories :getter: Get the categories :setter: Update the categories :type: list[str] )r`rqs rlr:zContact.categoriesrrtct|tr`g|_|D]S}t|tr&|jj |j 9|jj |UnGt|t r |g|_n.t|tr|j g|_n td|jj|jdy)Nzcategories must be a listr:) rrr`rappendr1rr?rGr[rF)rdrvals rlr:zContact.categoriess eT " "D  2c8,%%,,SXX6%%,,S1  2 s #!&D  x (!& D 89 9  67rtc|jSrn)rbrqs rlpersonal_noteszContact.personal_notess$$$rtcf||_|jj|jdy)Nr<)rbrGr[rFrs rlrzContact.personal_notess' %  9:rtc|jS)z9ID of the containing folder :rtype: str )rarqs rl folder_idzContact.folder_ids rtc |j}i|d|j|d|j|d|j|d|j|d|j |d|j |d|j|d|j|d |j|d |j|d |j|d |j|d |jDcgc]>}|jd|jxsd|jd|ji@c}|d|j |d|j"|d|j$|d|j&|d|j(i}|r=|j+|dt-|j/D] }||vs||= |Scc}w)z} Returns a dictionary in cloud format :param restrict_keys: a set of keys to restrict the returned data to. r#r%r&r'r(r)r*r+r,r-r.r/r0r1r$r2r6r7r8r:r<)rFrMrNrOrPrQrRrSrTrUrVrWrXrcr1r2r\r]r^r`rbr[rkeys)rd restrict_keysrg recipientdatakeys rl to_api_datazContact.to_api_datas: XX } t22 xL$--  {OT[[  yM4>>  wK  zND,,   } t22  | d//   $"8"8   $"8"8  } t22  | d00   48KK#A'0%)HHV$4inn6J$(HHY$79J9J$L#A  !4#:#:! " } t22# $ ~  4 4% & | d//' (  !6!6) .    b DIIK( "m+S  " !#AsAG/c|js td|j|jj dj |j}|j j|}t|S)z Deletes this contact :return: Success or Failure :rtype: bool :raises RuntimeError: if contact is not yet saved to cloud z'Attempting to delete an unsaved Contactrr ) rH RuntimeError build_url _endpointsrDrrdeleteboolrdurlresponses rlrzContact.deletesh~~HI Inn OO   / 6 6$.. 6 IK88??3'H~rtcZ|jr|jsy|j|jj dj |j}|j j}|j|j}n|jrE|j|jj dj |j}n*|j|jj d}|j j}|j|j}|||}|sy |js |j}|j |jd d |_|j |jd d |_ |j |jd d |_|jj }|jr$t#|j$j'|nd |_ |jr*t#|j(j'||_yd |_yt*j,j/j1|jj |_y)z Saves this contact to the cloud (create or update existing one based on what values have changed) :return: Saved or Not :rtype: bool Trr)rrrrrFr Nr!r")tzinfo)rHrGrrrDrrpatchrrapostjsonrFrIrJrrKrr~rLrdtdatetimenowreplace)rdrmethodrrrrhs rlsavez Contact.saves >>&&..##N3::dnn:MOCXX^^F##$2E2E#FDnnOO''8??"&"2"2@45nnT__%8%8%CDXX]]F##$2E2E#FD#D)~~mmoG$[[$>DN$[[2C)DdKDN%kk$((3I*J*.0DO}}--H!^^#4<<0;;15 N"__$DMM2==DO  37 O !kkoo/77t}}?U?U7VDOrt)recipient_typect|tr t|}|xs|jj }|sy|j |d}t |t|j}|j||S)a This method returns a new draft Message instance with contacts first email as a recipient :param Recipient recipient: a Recipient instance where to send this message. If None first email of this contact will be used :param RecipientType recipient_type: section to add recipient into :return: newly created message :rtype: Message or None NTris_draft) rrrrc get_first_recipient_with_addressmessage_constructorrArr[)rdrr new_messagetarget_recipientss rlrzContact.new_message@sv nc **>:NO!M!M!O ..dT.J #K^5I5I1JKi(rtc|E|j|jjdj|j}nE|j|jjdj|j|} |j j|}|sy|jS#t $r.}tjdj|Yd}~yd}~wwxYw)zReturns this contact profile photo :param str size: 48x48, 64x64, 96x96, 120x120, 240x240, 360x360, 432x432, 504x504, and 648x648 Nrrr)r sizez;Error while retrieving the contact profile photo. Error: {}) rrrDrrHrrlogdebugcontent)rdrrres rlget_profile_photozContact.get_profile_photoYs <..!4!4W!=!D!D!D!WXC..!4!4\!B!I!IT^^bf!I!ghC xx||C(H   IISZZ[\] ^ sB88 C/$C**C/c|j|jjdj|j}|j j ||ddi}t|S)z` Updates this contact profile photo :param bytes photo: the photo data in bytes rrz Content-typez image/jpeg)rheaders)rrrDrrHrrr)rdrrrs rlupdate_profile_photozContact.update_profile_photoosZ nnT__009@@DNN@ST88>>#ENL;Y>ZH~rtrn).__name__ __module__ __qualname____doc__rrrrCrrrpr{propertyr~rrvsetterr%r1r'rwr(rrr+rrrrrcrrrrrr:rrrrrrTOrrr __classcell__rks@rlrrsS(?.; J"!%4S&jE1##99 ]]44 [[77 ^^55?? \\33  66##99!!88&&<<&&<<##99"" 8 8&&''== ##99 $$:: ))??!!88 %%;;  $L"0dMz1BaseContactFolder.get_contacts..sC:-D,,PDP040D0Dg/NP:s*-r)rr constructor next_linklimit)rrrrDrrr max_top_valuerrupdate as_paramsriterrr r r) rdrr r r rrrrcontactsrs ` rl get_contactszBaseContactFolder.get_contactssT( 99..!4!4_!EFC..##$56==~~>'(C =EDMM$?$??MM//E5%e4 !)F:  %%$)y! eoo/088<<F<38O}}:#'88GR#8:HH.5 YT*.*B*B(1@ @Ortc|sy|jjdd|jd}t|j d|}|r|dSdS) z Returns a Contact by it's email :param email: email to get contact for :return: Contact for specified email :rtype: Contact Nemail_addressesr2eq) collection attributeword operationrrr r)qanyrrr!)rdr5r r s rlget_contact_by_emailz&BaseContactFolder.get_contact_by_emails_ (9Y"'++-4A)))?@&x{0D0rt)d)rrrrrrrrrrCrrrpr{r!r,rrs@rlrrzs]6%:,)< J"!!%4'JR61;td$;z 1rtrcjeZdZdZd dZdddddZdZdZdZd Z d Z e jfdd d Z y) ContactFolderz! A Contact Folder representation Nc6|r |r td|s |s td|r=|j|jjdj |}d}n|j r+|j|jjd}nD|j|jjdj |j }dj |jd |d d }|jj|| }|sy|r|j}n+|jjd }|r|dnd}|y|jd|j|j|jd|j|iS)aY Returns a Contact Folder by it's id or child folders by name :param folder_id: the folder_id to be retrieved. Can be any folder Id (child or not) :param folder_name: the folder name to be retrieved. Must be a child of this folder :return: a single contact folder :rtype: ContactFolder zProvide only one of the optionszProvide one of the optionsrrNrrz {} eq '{}'r#r)rrrrr)rrrr)rrrrDrrrrFrrrkrrrE)rdr folder_namerrrfolders rlrzContactFolder.get_folder s @A A;< < ..##L188I8FHCFyynnT__%8%8%HInnOO''8??>>@+,".!4!4TXXm5L5@"BKLNF88<<F<3 ]]_F]]_((1F"(VAYdF~t~~@$((T]],0,>,>@!%!5!5v >@ @rt)r r c v|jr+|j|jjd}nD|j|jjdj |j }i}|r||d<|r||d<|r5t |tr||d<n|j|j|jj||xsd}|sgS|j}|jd gDcgc]"}|jd d |i|j|i$c}Scc}w) a Returns a list of child folders :param int limit: max no. of folders to get. Over 999 uses batch. :param query: applies a OData filter to the request :type query: Query or str :param order_by: orders the result set based on this condition :type order_by: Query or str :return: list of folders :rtype: list[ContactFolder] rrrrrrNrrrr)rrrrDrrrrrrrrrkrE) rdrr r rrrrr2s rl get_folderszContactFolder.get_folders>s 99..!4!4^!DEC..##O4;;t~~;NPC "F6N !)F:  %%$)y! eoo/088<<FNd<;I}}#hhw35MdMt/C/CV.LM5 55s 'D6c|sy|jr+|j|jjd}nD|j|jjdj |j }|j j||jd|i}|sy|j}|jdd|i|j|iS) z Creates a new child folder :param str folder_name: name of the new folder to create :return: newly created folder :rtype: ContactFolder or None Nrrrr#rrr) rrrrDrrrrrFrrkrE)rdr1rrr2s rlcreate_child_folderz!ContactFolder.create_child_folderfs 99..!4!4^!DEC..##O4;;t~~;NPC88=='+xx '> &L!Nt~~LTLd.B.BF-KLLrtc|jry|sy|j|jjdj |j }|j j||jd|i}|sy|j}|j|jdd|_ |j|jdd|_ y ) z Change this folder name :param str name: new name to change to :return: Updated or Not :rtype: bool Frrr#rr$r;NT) rrrrDrrrrrFrr1r)rdr1rrr2s rlupdate_folder_namez ContactFolder.update_folder_names 99nn OO   - 4 4 4 GI88>>#TXXm-Dd,K>LJJtxx 6; DHH-=$>Ertc(|jry|sy|j|jjdj |j }t |tr |j }nt |tr|}ny|jj||jd|i}|sy|j}|j|jdd|_ |j|jdd|_y ) z Change this folder name :param to_folder: folder_id/ContactFolder to move into :type to_folder: str or ContactFolder :return: Moved or Not :rtype: bool Frrr;rr#r$NT)rrrrDrrrr/rrrrFrr1r)rd to_folderrrrr2s rl move_folderzContactFolder.move_folders 99nn OO   - 4 4 4 GI i /!++I  3 '!I88>>#(,1A(BI'N"PJJtxx 6; DHH-=$>Ertc|js |jsy|j|jj dj |j}|j j|}|syd|_y)zS Deletes this folder :return: Deleted or Not :rtype: bool FrrNT)rrrrrDrrrrs rlrzContactFolder.deletesk 99DNNnn OO   - 4 4 4 GI88??3'rtcd|j|}|js|j|_|S)z Creates a new contact to be saved into it's parent folder :return: newly created contact :rtype: Contact )r)rrr_ContactFolder__folder_id)rdrs rl new_contactzContactFolder.new_contacts/ **$*7yy"&..G rt)r cvt|tr t|}|jd|Dcgc]6}|jr(|jdj r|jd8}}|sy|j |d}t|t|j}|j||Scc}w)ad This method returns a new draft Message instance with all the contacts first email as a recipient :param RecipientType recipient_type: section to add recipient into :param query: applies a OData filter to the request :type query: Query or str :return: newly created message :rtype: Message or None Nr)rTr) rrrr!rcr2rrArr[)rdrr rr3rrs rlrzContactFolder.new_messages nc **>:N&*%6%6T%6%OG! GNN1,=,E,EnnQ'G G..dT.J #K^5I5I1JKj)Gs;B6)NNrn)rrrrrr4r6r8r;rr?rrrrrtrlr/r/sM+2@h&5td&5PM64!F* *7)9)9Drtr/c0eZdZdZdddfd ZdZxZS) AddressBookz& A class representing an address book Nrc ,t|d||dd|y)NT)rrrr)rBrC)rdrrrerks rlrCzAddressBook.__init__s ECdEfErtc8dj|jS)NzAddress Book resource: {})rrrqs rlrpzAddressBook.__repr__s*11$2D2DEErt)rrrrrCrprrs@rlrBrBs0!%4FFrtrB)rrloggingdateutil.parserrrequests.exceptionsrcategoryrmessagerrutilsr r r r r r getLoggerrrrrr/rBrrtrlrLss!)+g!b lOb JJ1 J1Zp%pfF-Frt