3fiwdZddlZddlZddlmZddlmZddl m Z m Z eje ZdZdZd Zd Zd Zd Zd ZdZdZdZdZGdde ZGdde ZGdde ZGdde Zy)z:Methods for accessing MS Tasks/Todos via the MS Graph api.N) BeautifulSoup)parse) ApiComponent TrackerSet checklistitemchecklistitemsfolder get_checklistget_checklists get_folderget_task get_tasks root_folderstask task_folderceZdZdZedediZdddfd ZdZdZ d Z dd Z e d Z e d Ze d Ze dZdZdZdZdZxZS) ChecklistItemz&A Microsoft To-Do task CheckList Item.z;/todo/lists/{folder_id}/tasks/{task_id}/checklistItems/{id}z6/todo/lists/{folder_id}/tasks/{task_id}/checklistItemsNparentconc |r |r td|r |jn||_|j|ji}|j ddxs|r t |ddnd}t ||r |jn|jd||j ddxs|r t |ddnd}|j}t||_ |j|_ |jdxs |j|_ |j|ji}|j|dd|_|j|d |jd d|_|j|d i}|j!||_|j|d i}|j!||_|j|d d|_y)aRepresentation of a Microsoft To-Do task CheckList Item. :param parent: parent object :type parent: Task :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) :param str task_id: id of the task to add this item in (kwargs) :param str displayName: display name of the item (kwargs) *Need a parent or a connection but not both main_resourceNprotocolrrcasingtask_idid displayName displaynamecheckedDateTimecreatedDateTime isCheckedF) ValueErrorrget_cloud_data_keypopgetattrsuper__init__r_ccr_track_changes folder_idritem_id_ChecklistItem__displayname_parse_date_time_time_zone_ChecklistItem__checked_ChecklistItem__created_ChecklistItem__is_checked) selfrrkwargs cloud_datarcc checked_obj created_obj __class__s H/var/www/auto_recruiter/arenv/lib/python3.12/site-packages/O365/tasks.pyr,zChecklistItem.__init__#s cIJ J!'6::SZZ 4 4b9  ?D9 6 ZZ 4 4b9 "~~bh5 '^^ } vzz-> !nnR(9%:B? 88E nnR(9%:B? 88E&NN2k?EBc"|jS)zCRepresentation of the Checklist Item via the Graph api as a string.__repr__r6s r=__str__zChecklistItem.__str__]}}r>c|jrdnd}|jr:d|jjd|jjd}nd}d|d|jd|S) z7Representation of the Checklist Item via the Graph api.xoz (checked:  at ) zChecklist Item: ( )r5r3datetimer1)r6marker checked_strs r=rAzChecklistItem.__repr__asr))s >>T^^002348K8K8M7NbQ K"6("T-?-?,@+OOr>c4|j|jk(SzComparison of tasks.)r0r6others r=__eq__zChecklistItem.__eq__m||u}},,r>c|j}|d|j|d|ji}|r&t|j D] }||vs||= |S)Return a dict to communicate with the server. :param restrict_keys: a set of keys to restrict the returned data to :rtype: dict r!r%)r-r1r5listkeysr6 restrict_keysr9datakeys r= to_api_datazChecklistItem.to_api_dataqsj XX } t11 {OT..  DIIK( "m+S  " r>c|jS)z=Return Display Name of the task. :type: str )r1rBs r=r"zChecklistItem.displaynames !!!r>c|jSzBReturn Created time of the task. :type: datetime )r4rBs r=createdzChecklistItem.created ~~r>c|jS)zBReturn Checked time of the task. :type: datetime )r3rBs r=checkedzChecklistItem.checkedrcr>c|jS)z2Is the item checked. :type: bool )r5rBs r= is_checkedzChecklistItem.is_checkeds    r>cfd|_|jj|jdy)z#Mark the checklist item as checked.Tr%Nr5r.addr-rBs r= mark_checkedzChecklistItem.mark_checkeds'   56r>cfd|_|jj|jdy)z%Mark the checklist item as unchecked.Fr%NrirBs r=mark_uncheckedzChecklistItem.mark_uncheckeds'!  56r>c8|j td|j|jj t j |j|j|j}|jj|}t|S)zaDelete a stored checklist item. :return: Success / Failure :rtype: bool z.Attempting to delete an unsaved checklist itemr/rr ) r0 RuntimeError build_url _endpointsr'CONST_CHECKLIST_ITEMformatr/rrdeleteboolr6urlresponses r=ruzChecklistItem.deletes| << OP Pnn OO   4 5 < <..$,,4<< =   88??3'H~r>c|jr|jsy|j|jj t j |j|j|j}|jj}|j|j}ny|j|jj tj |j|j}|jj}|j}|||}|sy|jj|j}|js5|j |j!dd|_|j |j!d d|_|j |j!d d|_|j |j!d d|_|j"r8t)|j"j+|j,j.nd|_|j$r>t)|j$j+|j,j.|_yd|_y|j |j!d d|_|j$r8t)|j$j+|j,j.nd|_y) zCreate a new checklist item or update an existing one. Does update by checking what values have changed and update them on the server :return: Success / Failure :rtype: bool Tror[)r/rr\Fr Nr$r#r%)r0r.rqrrr'rsrtr/rrpatchr^ CONST_TASKpostclearjsonr-r4r3r5r astimezonertimezone)r6rxmethodr\ryitems r=savezChecklistItem.saves\ <<&&..##$89@@"nndllt||AC XX^^F##$2E2E#FD..##J/66"nndll7C XX]]F##%D#D) !!#}}||88DHHTND9DL!XXdhh/@&A4HDN!XXdhh/@&A4HDN $+)> FD >>dnn%001G1GH N>>dnn%001G1GH N N"XXdhh/@&A4HDN>>dnn%001G1GH N r>N)__name__ __module__ __qualname____doc__rsr~rrr,rCrArTr^propertyr"rbrergrkrmrur __classcell__r<s@r=rrs0 [LJ "&48Ct P-&""!!7 7 &>r>rceZdZdZedededediZe Z dddfd Z d Z d Z d Zd(d Zed ZedZedZej(dZedZedZedZej(dZedZej(dZedZej(dZedZedZedZej(dZedZedZdZd Z d!Z!d"Z"d#Z#d$Z$d)d%Z%d&Z&d(d'Z'xZ(S)*TaskzA Microsoft To-Do task.z7/todo/lists/{folder_id}/tasks/{id}/checklistItems/{ide}z1/todo/lists/{folder_id}/tasks/{id}/checklistItemsz"/todo/lists/{folder_id}/tasks/{id}z/todo/lists/{folder_id}/tasksNrc |r |r td|r |jn|_|jji}|j ddxs|r t |ddnd}t |r |jn|jd|j}t|_ |jdxs |j_ |jji}|j|dd_ |j|d |jd d xsd _|j|d i}|j|d d _|j|dd_|j|dd_|j|dd_|j|dd_j&dk(_|j|dd_jj,}j"r$t/j"j1|nd_j$r$t/j$j1|nd_|j|di} j3| _|j|di} j3| _|j|dd_|j|di} j3| _fd|j|dgD_y)a Representation of a Microsoft To-Do task. :param parent: parent object :type parent: Folder :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) :param str folder_id: id of the calender to add this task in (kwargs) :param str subject: subject of the task (kwargs) rrNrrrr/r titlesubjectrJbodycontent contentTypehtmlr$lastModifiedDateTimestatus completed importance dueDateTimereminderDateTime isReminderOnFcompletedDateTimec3^K|]$}jddij|i&ywrNchecklist_item_constructorr(.0rr6s r= z Task.__init__..Ts:"  ,D + + X4 XD..E$.. ! , ,X 6d <@??E$// " - -h 7PT ..M!2B744W= !~~b);&c"|jS)z9Representation of the Task via the Graph api as a string.r@rBs r=rCz Task.__str__YrDr>cr|jrdnd}|jr:d|jjd|jjd}nd}|jr:d|jjd|jjd}nd}d|d|j d |d |S) z-Representation of the Task via the Graph api.rFrGz(due: rHrIrJz (completed: zTask: (rK)rrrLrMrr)r6rNdue_str compl_strs r=rAz Task.__repr__]s++ ::tzz01djjoo6G5HKGG   t//4467tD>"2!G9Ai[IIr>c4|j|jk(SrQ)rrRs r=rTz Task.__eq__orUr>c|j}|d|j|d|jrdndi}|jr0|d|j|d|ji||d<n d||d<|j r%|j |j ||d <n d||d <|jr%|j |j||d <n d||d <|jr$|j |j||d <|r&t|jD] }||vs||= |S) rWrrr notStartedrrrNrrr) r-rrrrr_build_date_time_time_zonerrrXrYrZs r=r^zTask.to_api_datassK XX wK xL)<)<+,  ;;=!4>>9 t{{ DF  $DF  ::&*&E&Edjj&QDM" #&*DM" # ??+/+J+J,D&' (,0D&' (   ,0,K,K  -D'( ) DIIK( "m+S  " r>c|jSra)rrBs r=rbz Task.createdrcr>c|jS)zHReturn Last modified time of the task. :type: datetime )rrBs r=modifiedz Task.modifieds r>c|jS)zvReturn Body of the task. :getter: Get body text :setter: Set body of task :type: str )rrBs r=rz Task.bodys{{r>cf||_|jj|jdy)Nr)rr.rjr-r6values r=rz Task.bodys&   01r>c|jS)znReturn Task importance. :getter: Get importance level (Low, Normal, High) :type: str )rrBs r=rzTask.importances   r>cX|jjdjk(S)zqIs the task starred (high importance). :getter: Check if importance is high :type: bool high)rcasefoldrBs r= is_starredzTask.is_starreds%  ))+v/@@@r>c|jS)zsSubject of the task. :getter: Get subject :setter: Set subject of task :type: str )rrBs r=rz Task.subjects~~r>cf||_|jj|jdy)Nr)rr.rjr-rs r=rz Task.subjects&  12r>c|jS)zwDue Time of task. :getter: Get the due time :setter: Set the due time :type: datetime )rrBs r=duezTask.dueszzr>cH|rt|tjs tdt|tjs5tj|j |j |j}|j'|j|jj}nH|j|jjk7r%|j|jj}||_ |jj|j!dy)Nz%'due' must be a valid datetime objecttzinfor) isinstancedtrLr&datetimeyearmonthdayrreplacerrrrr.rjr-rs r=rzTask.dues eRWW- !HIIeR[[1 EJJ UYYG||# T]]-C-C D!7!77(()?)?@   78r>c|jS)zReminder Time of task. :getter: Get the reminder time :setter: Set the reminder time :type: datetime )rrBs r=reminderz Task.remindersr>cH|rt|tjs tdt|tjs5tj|j |j |j}|j'|j|jj}nH|j|jjk7r%|j|jj}||_ |jj|j!dy)Nz*'reminder' must be a valid datetime objectrr)rrrLr&rrrrrrrrrrr.rjr-rs r=rz Task.reminders eRWW- !MNNeR[[1 EJJ UYYG||# T]]-C-C D!7!77(()?)?@ ); <=r>c|jS)z`Return isReminderOn of the task. :getter: Get isReminderOn :type: bool )rrBs r=is_reminder_onzTask.is_reminder_ons$$$r>c|jS)zGStatus of task :getter: Get status :type: str )rrBs r=rz Task.statuss}}r>c|jS)zCompleted Time of task. :getter: Get the completed time :setter: Set the completed time :type: datetime )rrBs r=rzTask.completed%sr>c||jnt|tjs t dt|tj s5tj |j |j|j}|j'|j|jj}nH|j|jjk7r%|j|jj}|j||_|j j#|j%dy)Nz+'completed' must be a valid datetime objectrr)mark_uncompletedrrrLr&rrrrrrrrrmark_completedrr.rjr-rs r=rzTask.completed/s =  ! ! #eRWW- !NOOeR[[1 EJJ UYYG||# T]]-C-C D!7!77(()?)?@    !  )< =>r>c|jS)zIs task completed or not. :getter: Is completed :setter: Set the task to completed :type: bool )rrBs r= is_completedzTask.is_completedCs"""r>c|jS)znChecklist items for the task. :getter: Get checklistItems :type: list[ChecklistItem] )rrBs r=checklist_itemszTask.checklist_itemsMs%%%r>cfd|_|jj|jdy)zMark the task as completed.TrNrr.rjr-rBs r=rzTask.mark_completedVs'"  23r>cfd|_|jj|jdy)zMark the task as uncompleted.FrNrrBs r=rzTask.mark_uncompleted[s'#  23r>c"|j td|j|jj t j |j|j}|jj|}t|S)zWDelete a stored task. :return: Success / Failure :rtype: bool z$Attempting to delete an unsaved taskr/r ) rrprqrrr'r~rtr/rrurvrws r=ruz Task.delete`su << EF Fnn OO   + 2 2..T\\ 3   88??3'H~r>c|jr|jsy|j|jj t j |j|j}|jj}|j|j}nn|j|jj tj |j}|jj}|j}|||}|sy|jj|jsh|j}|j |jdd|_|j |jd d|_|j |jd d|_|j |jd d|_|j r8t'|j j)|j*j,nd|_|j"r8t'|j"j)|j*j,nd|_|j |jd dd k(|_yt0j2j5j7|j*j, |_y)zCreate a new task or update an existing one. Does update by checking what values have changed and update them on the server :return: Success / Failure :rtype: bool Trr{r/r|Fr Nr$rrrr)rr.rqrrr'r~rtr/rr}r^CONST_TASK_FOLDERrrrr-rrrrrrrrrrnowr)r6rxrr\ryrs r=rz Task.savess5 <<&&..##J/66"nn7C XX^^F##$2E2E#FD..##$56===WCXX]]F##%D#D) !!#||==?D88DHHTND9DL!XXdhh/@&A4HDN"hhtxx0F'GNDO#xx(=tDD >>dnn%001G1GH N??doo&11$--2H2HI O #'((488H+=t"D "SD !kkoo/77t}}?U?U7VDOr>c|jdk7r |jS t|jd}|jjS#t$r|jcYSwxYw)zqParse the body html and returns the body text using bs4. :return: body text :rtype: str r html.parser)rrbstextrp)r6soups r= get_body_textzTask.get_body_textsZ >>V #99  "dii/D99>> ! 99  sA A! A!cP|jdk(rt|jdSdS)znReturn the beautifulsoup4 of the html body. :return: Html body :rtype: BeautifulSoup rrN)rrrrBs r= get_body_soupzTask.get_body_soups% 04~~/Gr$))]+QTQr>cjjjtj j j }i}|r||d<|r||d<|r)t|tr||d<n||jz}jj||}|s tdS|j}fd|jdgDS) aReturn list of checklist items of a specified task. :param query: the query string or object to query items :param batch: the batch on to retrieve items. :param order_by: the order clause to apply to returned items. :rtype: checklistItems r$top$orderby$filterparamsrc3^K|]$}jddij|i&ywrrrs r=rz+Task.get_checklist_items..s:  ,D + + X4 XDc|yt|trY|j|jj t j |j|j|}d}d}nl|j|jj tj |j|j}ddi}||jz}d}|jj ||}|sy|r|j}n)|jj d g}|r|d }ny|jd d |i|j|iS) zReturn a Checklist Item instance by it's id. :param param: an item_id or a Query instance :return: Checklist Item for the specified info :rtype: ChecklistItem N)r/r ideTrrrFrrrrr)rrrqrrr'CONST_GET_CHECKLISTrtr/rrrrrrr()r6paramrxrby_idryrs r=get_checklist_itemzTask.get_checklist_itemsD = eS !..##$78??"nn5@C FE..##$89@@"nnAC a[F eoo' 'FE88<<F<3 ==?D==?&&w3DAw.t..   00$7  r>c>|j|||jS)z0Create a checklist item within a specified task.)rr"r)rr)r6r"s r=new_checklist_itemzTask.new_checklist_items%..[$,,/  r>rNNN))rrrrrrr~rrrrrr,rCrArTr^rrbrrsetterrrrrrrrrrrrrrurrrr rrrrs@r=rrs! VQ8: J "/!%4J XJ$-*X [[22!!AA ^^33 ZZ 9 9__ > >%%  ??&##&&4 4 &9v" R' R* X r>rcreZdZdZededediZeZ dddfd Z dZ d Z d Z d Zd Zdd ZddZdZxZS)FolderzA Microsoft To-Do folder./todo/lists/{id}z/todo/lists/{id}/tasksz/todo/lists/{id}/tasks/{ide}Nrc *|r |r td|r |jn||_|jddxs|r t|ddnd}t||r |j n|jd||j|ji}|j|jdd|_ |j|jdd|_ d |_ |j|jd dd k(rd |_ yy) ayRepresentation of a Microsoft To-Do Folder. :param parent: parent object :type parent: ToDo :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) rrNrrr!rJr FwellknownListName defaultListT) r&rr)r*r+r,rr'r(r-namer/ is_default)r6rrr7rr8r<s r=r,zFolder.__init__,s cIJ J!'6::S ?D9 6>$((#67 < M"DO Nr>c"|jS)z;Representation of the Folder via the Graph api as a string.r@rBs r=rCzFolder.__str__PrDr>cD|jrdnd}d|j|S)z/Representation of the folder via the Graph api.z (default)rJzFolder: )rr)r6suffixs r=rAzFolder.__repr__Ts$!%b$))VH--r>c4|j|jk(S)zComparison of folders.rrRs r=rTz Folder.__eq__Ys~~00r>c6|jsy|j|jjtj |j}|j d|ji}|jj||}t|S)zoUpdate this folder. Only name can be changed. :return: Success / Failure :rtype: bool Fr r!r|) r/rqrrr' CONST_FOLDERrtr-rrr}rv)r6rxr\rys r=updatez Folder.update]s} ~~nn OO   - 4 4 4 G  HH] #TYY 88>>#D>1H~r>c|jsy|j|jjtj |j}|j j|}|syd|_y)zUDelete this folder. :return: Success / Failure :rtype: bool Fr#NT)r/rqrrr'r$rtrrurws r=ruz Folder.deletersd ~~nn OO   - 4 4 4 G 88??3'r>cjjjtj j }i}|r||d<|r||d<|r)t |tr||d<n||jz}jj||}|s tdS|j}fd|jdgDS) aReturn list of tasks of a specified folder. :param query: the query string or object to query tasks :param batch: the batch on to retrieve tasks. :param order_by: the order clause to apply to returned tasks. :rtype: tasks r#rrrrrc3^K|]$}jddij|i&ywr)task_constructorr()rrr6s r=rz#Folder.get_tasks..s9  "D ! ! N N$2F2F1M N rr) rqrrr'CONST_GET_TASKSrtr/rrrrrrrs` r=rzFolder.get_taskssnn OO   0 7 74>> 7 J   "F6N !)F:  %%$)y!%//++88<<F<38O}} "-  r>c>|j|||jS)z(Create a task within a specified folder.)rrr/)r)r/)r6rs r=new_taskzFolder.new_tasks%$$DNN%  r>c~|yt|trN|j|jj t j |j|}d}d}na|j|jj tj |j}ddi}||jz}d}|jj ||}|sy|r|j}n)|jj d g}|r|d }ny|jd d |i|j|iS) zReturn a Task instance by it's id. :param param: an task_id or a Query instance :return: task for the specified info :rtype: Task N)r r Tr#rrFrrrrr)rrrqrrr'CONST_GET_TASKrtr/r*rrrr)r()r6rrxrrryrs r=rzFolder.get_tasks! = eS !..##N3::dnnRW:XCFE..##O4;;t~~;NCa[F eoo' 'FE88<<F<3 ==?D==?&&w3DAw$t$$QDQT5I5I44PQQr>rr)rrrrr$r*r.rrrr)r,rCrArTr%rurr,rrrs@r=rr"s^# (16J !%4"#H. 1**% N $Rr>rcveZdZdZedediZeZe Z dddfd Z dZ dZ dd Zd Zdd Zd Zdd ZddZxZS)ToDozA Microsoft To-Do class for MS Graph API. In order to use the API following permissions are required. Delegated (work or school account) - Tasks.Read, Tasks.ReadWrite z /todo/listsrNrc |r |r td|r |jn||_|jddxs|r t|ddnd}t||r |j n|jd|y)alInitialise the ToDo object. :param parent: parent object :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) rrNrr)r&rr)r*r+r,rr')r6rrr7rr<s r=r,z ToDo.__init__sz cIJ J!'6::S ?D9 6c"|jS)z9Representation of the ToDo via the Graph api as a string.r@rBs r=rCz ToDo.__str__rDr>cy)z0Representation of the ToDo via the Graph api as.zMicrosoft To-DorrBs r=rAz ToDo.__repr__s r>c |j|jjt}i}|r||d<|r)t |t r||d<n||j z}|jj||xsd}|sgS|j}|jdgDcgc]"}|jdd|i|j|i$c}Scc}w)aReturn a list of folders. To use query an order_by check the OData specification here: https://docs.oasis-open.org/odata/odata/v4.0/errata03/os/complete/ part2-url-conventions/odata-v4.0-errata03-os-part2-url-conventions -complete.html :param query: the query string or object to list folders :param int limit: max no. of folders to get. Over 999 uses batch. :rtype: list[Folder] rrNrrrr) rqrrr'CONST_ROOT_FOLDERSrrrrrfolder_constructorr()r6rlimitrxrryr\rFs r= list_folderszToDo.list_folders snnT__001CDE "F6N %%$)y!%//++88<<FNd<;I}}XXgr*  $D # # M4 MD4H4H!3L M   s,'Cc&|sy|j|jjt}|jj ||j d|i}|sy|j}|jdd|i|j|iS)zCreate a new folder. :param str folder_name: name of the new folder :return: a new folder instance :rtype: Folder Nr!r|rr) rqrrr'r5rrr-rr6r()r6 folder_namerxryr\s r= new_folderzToDo.new_folder-snnT__001CDE88==DHH],C[+Q=R}}'t&&SdSt7K7KT6RSSr>c|r |r td|s |s td|r|j|jjtj |}|j j|}|r.|jd d|i|j|jiSdS|jdj|}|j|}|dS) zReturn a folder by it's id or name. :param str folder_id: the folder id to be retrieved. :param str folder_name: the folder name to be retrieved. :return: folder for the given info :rtype: Folder zProvide only one of the optionszProvide one of the optionsr#rNr!)rrr) rprqrrr'CONST_GET_FOLDERrtrr6r(r new_queryequalsr8)r6r/r:rxryrfolderss r=r zToDo.get_folderBs @A A;< < ..##$45<< <JCxx||C(H (''$($8$8(--/#J    }-44[A##%#0qzr>cR|j}|D]}|js|cSy)zPReturn the default folder for the current user. :rtype: Folder N)r8r)r6r@r s r=get_default_folderzToDo.get_default_folderbs/ ##% F    r>cH|j}|j||S)aDGet tasks from the default Folder. :param order_by: orders the result set based on this condition :param int batch: batch size, retrieves items in batches allowing to retrieve more items than the limit. :return: list of items in this folder :rtype: list[Task] or Pagination )r r )rBr)r6r r default_folders r=rzToDo.get_tasksls(002'''GGr>cF|j}|j|S)zReturn a new (unsaved) Task object in the default folder. :param str subject: subject text for the new task :return: new task :rtype: Task )r)rBr,)r6rrDs r=r,z ToDo.new_taskys&002&&w&77r>)NNr)rrrrr5r=rrrr6rr)r,rCrAr8r;r rBrr,rrs@r=r0r0s` M,J  !%4 2!  DT*@ H8r>r0)rrrloggingbs4rrdateutil.parserrutilsrr getLoggerrlogrsCONST_CHECKLIST_ITEMSr$rrr=r.r*r5r~rrrrr0rr>r=rMs@$!+g!&( %'#  !dLdN] <] @vR\vRrf8<f8r>