=[j`:>dZddlmZddlZddlmZddlmZmZmZm Z m Z m Z ddl m Z ddlmZddlmZd d lmZd d lmZmZmZd d lmZd d lmZd dlmZd dlmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+ej,e-Z.e e+e"fZ/GddeZ0dS)a High-level Reminders service built on top of the iCloud Reminders CloudKit API. Public API: - RemindersService.lists() -> Iterable[RemindersList] - RemindersService.reminders(list_id=None) -> Iterable[Reminder] - RemindersService.list_reminders(list_id, include_completed=False, results_limit=200) - RemindersService.get(reminder_id) -> Reminder - RemindersService.sync_cursor() -> str - RemindersService.iter_changes(since=None) -> Iterable[ReminderChangeEvent] - RemindersService.create(...) - RemindersService.update(reminder) -> None - RemindersService.delete(reminder) -> None - RemindersService.add_location_trigger(reminder, ...) -> tuple[Alarm, LocationTrigger] - RemindersService.create_hashtag(...) / update_hashtag(...) / delete_hashtag(...) - RemindersService.create_url_attachment(...) / update_attachment(...) / delete_attachment(...) - RemindersService.create_recurrence_rule(...) / update_recurrence_rule(...) / delete_recurrence_rule(...) - RemindersService.alarms_for(reminder) -> list[AlarmWithTrigger] - RemindersService.tags_for(reminder) -> list[Hashtag] - RemindersService.attachments_for(reminder) -> list[Attachment] - RemindersService.recurrence_rules_for(reminder) -> list[RecurrenceRule] The service returns typed reminder, list, alarm, attachment, hashtag, and recurrence models so normal callers do not need to work with CloudKit records directly. ) annotationsN)datetime)AnyDictIterableListOptionalUnion)CKRecord)CloudKitExtraMode) BaseService)RemindersRecordMapper)_decode_crdt_document_encode_crdt_document_generate_resolution_token_map)RemindersReadAPI)RemindersWriteAPI)CloudKitRemindersClient) AlarmAlarmWithTriggerHashtagImageAttachmentListRemindersResultLocationTrigger ProximityRecurrenceFrequencyRecurrenceRuleReminderReminderChangeEvent RemindersList URLAttachmentceZdZdZdZdZdZdddfdZddZ dddZ ddZ ddddZ ddZ ddd.Z dd1Zdd2Zddd3d3d4ejfdd=Zdd@ZddBZddCZ dddHZdddddddIddQZddRZejdSd!d!dTdd[ZdddddTdd^Zdd_Z ddddZddfZddhZ ddjZ!ddlZ"ddoZ#ddqZ$ddtZ%ddxZ&ddyZ'dd{Z(dd}Z)ddZ*ddZ+ddZ,xZ-S)RemindersServicez Typed Reminders API for snapshot reads, incremental sync, and mutations. Use this service for list discovery, reminder CRUD, and supported reminder metadata such as alarms, hashtags, attachments, and recurrence rules. zcom.apple.reminders productionprivateN)cloudkit_validation_extra service_rootstrsessionrparamsDict[str, Any]r'CloudKitExtraMode | Nonect|||jdjdjdj}ddd|pi}t ||||_d fd }t|t_ t|j t_ t|j t_dS) Nz /database/1//T) remapEnumsgetCurrentSyncToken)validation_extrareturnrcjSN)_rawselfsk/home/thesage/.hermes/hermes-agent/venv/lib/python3.11/site-packages/pyicloud/services/reminders/service.pyget_rawz*RemindersService.__init__..get_rawis 9 )r3r)super__init__r( _CONTAINER_ENV_SCOPErr6rLOGGER_mapperr_readsr_writes) r8r(r*r+r'endpoint base_paramsr: __class__s ` r9r=zRemindersService.__init__Ps  w777  ; ; ; ;!% ; ;-1[ ; ;  #'  | ,   6           -Wf== &w fEE ($,GG r;r3Iterable[RemindersList]c4|jS)z Yield reminder lists as ``RemindersList`` models. Use this to discover available lists and obtain the ``list_id`` values needed by creation and query helpers. )rClistsr7s r9rJzRemindersService.listsps{  """r;list_id Optional[str]Iterable[Reminder]c#Ki}|r|g}nd|D}|D].}||dd}|jD] }|||j< /|D]}|VdS)z Yield reminders across all lists or for a specific list. Args: list_id: Optional list identifier. When provided, only reminders in that list are returned. cg|] }|j S)id).0lsts r9 z.RemindersService.reminders..s7773777r;TrKinclude_completed results_limitN)rJlist_reminders remindersrQvalues)r8rK reminder_maplist_idslidbatchreminders r9rZzRemindersService.remindersys-/   8yHH77$**,,777H 5 5C''"&!(E "O 5 5,4 X[)) 5%++--  HNNNN  r;c4|jS)z Return the current sync token for the Reminders zone. Persist this token and pass it to ``iter_changes(since=...)`` later to enumerate only newer changes. )rC sync_cursorr7s r9rbzRemindersService.sync_cursors{&&(((r;sincerdIterable[ReminderChangeEvent]c8|j|S)a Yield reminder change events since an optional sync token. Updated reminders are returned with ``type="updated"`` and a hydrated ``reminder`` payload. Deletions are returned with ``type="deleted"`` and only the ``reminder_id`` populated. rc)rC iter_changes)r8rds r9rgzRemindersService.iter_changess{''e'444r; reminder_idrc6|j|S)z~ Return a single reminder by ID. Args: reminder_id: The full reminder record identifier. )rCget)r8rhs r9rjzRemindersService.gets{{+++r;Frtitledesc completedbooldue_dateOptional[datetime]priorityintflaggedall_day time_zoneparent_reminder_idc J|j||||||||| |  S)a Create a reminder and return the hydrated ``Reminder`` model. Args: list_id: Target reminder list ID. title: Reminder title. desc: Reminder notes/body text. completed: Whether the reminder should be created as completed. due_date: Optional due date. Naive datetimes are treated as UTC. priority: Apple Reminders priority value. Common values are ``0`` (none), ``1`` (high), ``5`` (medium), and ``9`` (low). flagged: Whether the reminder is flagged. all_day: Whether the reminder should be treated as all-day. time_zone: Optional time zone name for the due date. parent_reminder_id: Optional parent reminder ID for subtasks. ) rKrlrmrnrprrrtrurvrw)rDcreate) r8rKrlrmrnrprrrtrurvrws r9ryzRemindersService.createsA:|""1#   r;r`Nonec:|j|dS)z Persist changes made to a ``Reminder`` model back to iCloud. Fetch the reminder, mutate its fields locally, then pass it to ``update()``. N)rDupdater8r`s r9r|zRemindersService.update  H%%%%%r;c:|j|dS)z Soft-delete a reminder in iCloud. The provided ``Reminder`` model is marked deleted and the remote record is updated accordingly. N)rDdeleter}s r9rzRemindersService.deleter~r;ggY@addresslatitudefloat longituderadius proximityrtuple[Alarm, LocationTrigger]c D|j|||||||S)z Add a location-based alarm trigger to a reminder. Returns the created ``Alarm`` and ``LocationTrigger`` records. )r`rlrrrrr)rDadd_location_trigger)r8r`rlrrrrrs r9rz%RemindersService.add_location_triggers8|001   r;namerc8|j||S)z,Create and attach a hashtag to ``reminder``.)rDcreate_hashtag)r8r`rs r9rzRemindersService.create_hashtag s|**8T:::r;hashtagc<|j||dS)z Update a hashtag name. Note: the iCloud Reminders web app currently treats hashtag names as effectively read-only in some live flows, so rename behavior may not be reflected consistently outside the API. N)rDupdate_hashtag)r8rrs r9rzRemindersService.update_hashtags" ##GT22222r;c<|j||dS)z.Detach and delete a hashtag from ``reminder``.N)rDdelete_hashtag)r8r`rs r9rzRemindersService.delete_hashtags  ##Hg66666r; public.urlurlutir"c:|j|||S)z(Create a URL attachment on ``reminder``.)rDcreate_url_attachment)r8r`rrs r9rz&RemindersService.create_url_attachments|11(CEEEr;rrfilename file_sizewidthheight attachment Attachmentrr Optional[int]rrc H|j|||||||dS)z Update a reminder attachment in place. URL attachments can update ``url`` and ``uti``. Image attachments can update metadata such as filename, size, and dimensions. rN)rDupdate_attachment)r8rrrrrrrs r9rz"RemindersService.update_attachment(sB" &&  '     r;c<|j||dS)z2Detach and delete an attachment from ``reminder``.N)rDdelete_attachment)r8r`rs r9rz"RemindersService.delete_attachmentCs  &&x<<<<>>r;recr r!c6|j|Sr5)rBrecord_to_listr8rs r9_record_to_listz RemindersService._record_to_lists|**3///r;c6|j|Sr5)rBrecord_to_reminderrs r9_record_to_reminderz$RemindersService._record_to_reminders|..s333r;rc6|j|Sr5)rBrecord_to_alarmrs r9_record_to_alarmz!RemindersService._record_to_alarms|++C000r;Optional[LocationTrigger]c6|j|Sr5)rBrecord_to_alarm_triggerrs r9_record_to_alarm_triggerz)RemindersService._record_to_alarm_triggers|33C888r;Optional[Attachment]c6|j|Sr5)rBrecord_to_attachmentrs r9_record_to_attachmentz&RemindersService._record_to_attachments|00555r;c6|j|Sr5)rBrecord_to_hashtagrs r9_record_to_hashtagz#RemindersService._record_to_hashtags|--c222r;c6|j|Sr5)rBrecord_to_recurrence_rulers r9_record_to_recurrence_rulez+RemindersService._record_to_recurrence_rules|55c:::r;)r(r)r*rr+r,r'r-)r3rHr5)rKrLr3rM)r3r))rdrLr3re)rhr)r3r)rkFNrFFNN)rKr)rlr)rmr)rnrorprqrrrsrtrorurorvrLrwrLr3r)r`rr3rz)r`rrlr)rr)rrrrrrrrr3r)r`rrr)r3r)rrrr)r3rz)r`rrrr3rz)r)r`rrr)rr)r3r")rrrrLrrLrrLrrrrrrr3rz)r`rrrr3rz) r`rrrrrsrrsrrsr3r) rrrrrrrrrrr3rz)r`rrrr3rz)FrU)rKr)rWrorXrsr3r)r`rr3r)r`rr3r)r`rr3r)r`rr3r)rrr3r))rr)r3r))rrr3r))rr r3r!)rr r3r)rr r3r)rr r3r)rr r3r)rr r3r)rr r3r).__name__ __module__ __qualname____doc__r>r?r@r=rJrZrbrgrjryr|rrARRIVINGrrrrrrrrDAILYrrrrYrrrrrrrrrrrrrr __classcell__)rGs@r9r$r$Ds'J D F?C HHHHHHHH@####"&>)))) $ 5 5 5 5 5 5,,,,'+#',0( ( ( ( ( T&&&&&&&&(1     2;;;;33337777 FFFFF"!"&#'# $      6====*=)B !!"      448"&*.+/      $GGGG#(      $0000....5555:::: 6666++++????000044441111999966663333;;;;;;;;r;r$)1r __future__rloggingrtypingrrrrr r pyicloud.common.cloudkitr pyicloud.common.cloudkit.baser pyicloud.services.baser _mappersr _protocolrrrrCrrDrclientrmodelsrrrrrrrrrrr r!r" getLoggerrrArr$rPr;r9rs6#"""""================------;;;;;;......++++++ %$$$$$&&&&&&++++++  8 $ $ =/1 2 r;r;r;r;r;{r;r;r;r;r;r;