F2jxdZddlmZddlZddlmZmZddlmZddl Z erddl Z GddeZ Gdd e Z Gd d e Z Gd d e ZGdde ZdS)a Data state management for CalendarObjectResource. This module implements the Strategy/State pattern for managing different representations of calendar data (raw string, icalendar object, vobject object). See https://github.com/python-caldav/caldav/issues/613 for design discussion. TODO: verify that we have sufficient test coverage - both through unit tests and integration tests ) annotationsN)ABCabstractmethod) TYPE_CHECKINGcreZdZdZeddZeddZeddZdd Zdd Z dd Z dS) DataStatezAbstract base class for calendar data states. Each concrete state represents a different "source of truth" for the calendar data. The state provides access to all representations, but only one is authoritative at any time. returnstrcdS)zGet raw iCalendar string representation. This may involve serialization if the current state holds a parsed object. Nselfs X/home/thesage/.hermes/hermes-agent/venv/lib/python3.11/site-packages/caldav/datastate.pyget_datazDataState.get_data!  icalendar.CalendarcdS)zGet a fresh copy of the icalendar object. This is safe for read-only access - modifications won't affect the stored data. Nr r s rget_icalendar_copyzDataState.get_icalendar_copy*rrvobject.base.ComponentcdS)zGet a fresh copy of the vobject object. This is safe for read-only access - modifications won't affect the stored data. Nr r s rget_vobject_copyzDataState.get_vobject_copy3rr str | Nonec|}|jD]&}|jdvrd|vrt|dcS'dS)zExtract UID without full parsing if possible. Default implementation parses the data, but subclasses can optimize. VEVENTVTODOVJOURNALFREEBUSYUIDN)r subcomponentsnamer rcalcomps rget_uidzDataState.get_uid<s\ %%''% ( (DyGGGEUYMM4;'''''trcf|}|jD]}|jdvr |jcSdS)zGet the component type (VEVENT, VTODO, VJOURNAL, FREEBUSY) without full parsing. Default implementation parses the data, but subclasses can optimize. rN)rr!r"r#s rget_component_typezDataState.get_component_typeGsN %%''% ! !DyGGGy   HtrboolcdS)z!Check if this state has any data.Tr r s rhas_datazDataState.has_dataRstrNr r r rr rr rr r)) __name__ __module__ __qualname____doc__rrrrr&r(r+r rrrrs   ^    ^    ^         rrcBeZdZdZddZddZddZdd Zdd Zdd Z dS) NoDataStatezNull Object pattern - no data loaded yet. This state is used when a CalendarObjectResource is created without any initial data. It provides empty/default values for all accessors. r r cdS)Nr r s rrzNoDataState.get_data^srrrc(tjSN) icalendarCalendarr s rrzNoDataState.get_icalendar_copyas!###rrc(ddl}|jSNr)vobject iCalendarrr?s rrzNoDataState.get_vobject_copyds w """rrcdSr:r r s rr&zNoDataState.get_uiditrcdSr:r r s rr(zNoDataState.get_component_typelrCrr)cdS)NFr r s rr+zNoDataState.has_dataosurNr,r-r.r/r0) r1r2r3r4rrrr&r(r+r rrr6r6Ws $$$$#### rr6cLeZdZdZddZddZddZdd Zdfd Zdd Z xZ S) RawDataStatezState when raw string data is the source of truth. This is the most common initial state when data is loaded from a CalDAV server. datar c||_dSr:_data)rrHs r__init__zRawDataState.__init__zs  rr c|jSr:rJr s rrzRawDataState.get_data}s zrrcJtj|jSr:)r;r< from_icalrKr s rrzRawDataState.get_icalendar_copys!++DJ777rrc4ddl}|j|jSr>)r?readOnerKrAs rrzRawDataState.get_vobject_copyswtz***rrctjd|jtj}|r'|dSt S)Nz ^UID:(.+)$)researchrK MULTILINEgroupstripsuperr&)rmatch __class__s rr&zRawDataState.get_uidsR -R\BB  *;;q>>'')) )ww   rc^d|jvrdSd|jvrdSd|jvrdSd|jvrdSdS) Nz BEGIN:VEVENTrz BEGIN:VTODOrzBEGIN:VJOURNALrzBEGIN:FREEBUSY VFREEBUSYrJr s rr(zRawDataState.get_component_typesO TZ ' '8 dj ( (7  + +:  + +;tr)rHr r,r-r.r/) r1r2r3r4rLrrrr&r( __classcell__)r[s@rrGrGss 8888++++ !!!!!!        rrGcJeZdZdZddZddZddZdd Zdd Zdd Z ddZ dS)IcalendarStatezState when icalendar object is the source of truth. This state is entered when: - User calls edit_icalendar_instance() - User sets icalendar_instance property - User modifies the icalendar object calendarrc||_dSr: _calendar)rras rrLzIcalendarState.__init__s !rr r cZ|jdS)Nzutf-8)rdto_icaldecoder s rrzIcalendarState.get_datas$~%%''..w777rcdtj|Sr:r;r<rOrr s rrz!IcalendarState.get_icalendar_copys!!++DMMOO<<r?rQrrAs rrzIcalendarState.get_vobject_copy%wt}}///rrcl|jjD]&}|jdvrd|vrt|dcS'dS)Nrrrr]r )rdr!r"r rr%s rr&zIcalendarState.get_uidsKN0 ( (DyHHHUVZ]]4;'''''trcH|jjD]}|jdvr |jcSdS)Nrp)rdr!r"rqs rr(z!IcalendarState.get_component_types=N0 ! !DyHHHy   ItrN)rarr,r-r.r/) r1r2r3r4rLrrrkrr&r(r rrr`r`s""""8888====0000  rr`cJeZdZdZddZddZdd Zdd Zdd Zdd Z ddZ dS) VobjectStatezState when vobject object is the source of truth. This state is entered when: - User calls edit_vobject_instance() - User sets vobject_instance property - User modifies the vobject object vobjrc||_dSr:_vobject)rrus rrLzVobjectState.__init__s  rr r c4|jSr:)rx serializer s rrzVobjectState.get_datas}&&(((rrcdtj|Sr:rir s rrzVobjectState.get_icalendar_copys!!++DMMOO<<rmrAs rrzVobjectState.get_vobject_copyrnrc|jS)zzReturns THE vobject object (not a copy). This is the authoritative object - modifications will be saved. rwr s rget_authoritative_vobjectz&VobjectState.get_authoritative_vobjects }rrc t|jdr#t|jjjjSt|jdr#t|jjjjSt|jdr#t|jjjjSt|jdr#t|jjjjSn#t$rYnwxYwdS)Nveventvtodovjournal vfreebusy) hasattrrxr ruidvaluerrrAttributeErrorr s rr&zVobjectState.get_uids t}h// >4=/39:::00 >4=.28999 33 >4=15;<<< 44 >4=26<=== >    D ts"7C#7C#27C#*7C## C0/C0ct|jdrdSt|jdrdSt|jdrdSt|jdrdSdS) Nrrrrrrrr])rrxr s rr(zVobjectState.get_component_typesk 4=( + + 8 T]G , , 7 T]J / / : T]K 0 0 ;trN)rurr,r-r.r/) r1r2r3r4rLrrrr~r&r(r rrrtrts))))====0000           rrt)r4 __future__rrTabcrrtypingrr;r?rr6rGr`rtr rrrsR  #""""" ######## NNN;;;;;;;;|)8'''''9'''T)))))Y)))X66666966666r