F2j,dZddlmZddlmZmZddlmZddlm Z erddl m Z Gdd e Z Gd d Z d d gZd S) z(Special parsing for calendar components.) annotations) TYPE_CHECKINGClassVar) Contentline)ComponentIcalParser) ComponentcJeZdZUdZdZded< fdZdd ZddZdZ xZ S)LazyCalendarIcalParseraA parser for calendar components. Instead of parsing the components, LazyComponents are created. Parsing can happen on demand. A calendar may grow over time, with its subcomponents greatly increasing in number, and requiring more memory and time to fully parse. This optimization lazily parses calendar files without consuming more memory than necessary, reducing the initial time it takes to access meta data. ) VCALENDARzClassVar[tuple[str, ...]]parse_instantlyc|}||jvs |jr|js#t |dS||dS)zIBegin a new component. This may be the first component. N)upperr componentis_lazysuperhandle_begin_componenthandle_lazy_begin_component)selfvalsc_name __class__s b/home/thesage/.hermes/hermes-agent/venv/lib/python3.11/site-packages/icalendar/parser/ical/lazy.pyrz-LazyCalendarIcalParser.handle_begin_component!sz  d* * *> +>))++ + GG * *4 0 0 0 0 0  , ,V 4 4 4 4 4component_namestrreturnNonectd|g}|jD]k}|||dddkr4|dd|krnl|jt d|d|jt|| |dS)zBegin a new component, but do not parse it yet. Parameters: component_name: The upper case name of the component, for example, ``"VEVENT"``. zBEGIN:NzEND:z+ encountered outside of a parent component.) r_content_lines_iteratorappendrstripr ValueError add_componentLazySubcomponentget_subcomponent_parser)rr content_lineslines rrz2LazyCalendarIcalParser.handle_lazy_begin_component1s%%>n%>%>??@ 0  D   & & &RaR  F**HNN$$**,,>> > !TTTT  $$ ,,];;       rr(list[Contentline]rc8t||j|jS)zGet the parser for a subcomponent. Parameters: content_lines: The content lines of the subcomponent. )r_component_factory_types_factory)rr(s rr'z.LazyCalendarIcalParser.get_subcomponent_parserKs## 42D4G   rcdS)z%Prepare the lazily parsed components.Nrs rprepare_componentsz)LazyCalendarIcalParser.prepare_componentsWsr)rrrr)r(r*rr) __name__ __module__ __qualname____doc__r __annotations__rrr'r1 __classcell__)rs@rr r s  2@O???? 55555     4     4444444rr cbeZdZdZddZeddZdd Zdd Zdd Z ddZ ddZ ddZ dS)r&zwA subcomponent that is evaluated lazily. This class holds the raw data of the subcomponent ready for parsing. namerparserrc0||_||_d|_dS)z3Initialize the lazy subcomponent with the raw data.N)_name_parser _component)rr9r:s r__init__zLazySubcomponent.__init__as  ,0rrc|jS)zdThe name of the subcomponent. The name is uppercased, per :rfc:`5545#section-2.1`. )r<r0s rr9zLazySubcomponent.namegs zrboolc|jduS)z2Return whether the subcomponent is already parsed.N)r>r0s r is_parsedzLazySubcomponent.is_parsedosd**rr c|j`|j}t|dkr t dt|d|d|_d|_|jS)z,Parse the raw data and return the component.Nrzr=parselenr$)r componentss rrFzLazySubcomponent.parsessy ? "++--J:!## 2":222)mDODLrcdS)zReturn whether the subcomponents were accessed and parsed lazily. Call :meth:`parse` to get the fully parsed component. Tr/r0s rrzLazySubcomponent.is_lazys trcBd|jd|dS)NzLazySubcomponent(name=z , parsed=))r<rCr0s r__repr__zLazySubcomponent.__repr__s'P PPT^^=M=MPPPPrlist[Component]ct|tstd||jks!|jrA|j|r'||SgS)zWalk through this component. This only parses the component if necessary. Parameters: name: The name to match for all components in the calendar, then walk through and parse the resulting matches. zname must be a string.) isinstancer TypeErrorr9r=contains_componentrFwalk)rr9s rrRzLazySubcomponent.walksw$$$ 6455 5 49   L !\< > Izz||$$S)))rN)r9rr:r)rr)rrA)rr )r9rrrM)rSrrrM) r2r3r4r5r?propertyr9rCrFrrLrRrVr/rrr&r&[s 1111 X++++    QQQQ" * * * * * *rr&N)r5 __future__rtypingrricalendar.parser.content_linerrricalendar.cal.componentr r r&__all__r/rrr]s..""""""********555555******2111111I4I4I4I4I40I4I4I4XJ*J*J*J*J*J*J*J*Z $%7 8r