o .j}(@s.dZddlmZddlmZmZddlmZddlm Z ddl m Z erReturns ``False`` because subcomponents are not lazily parsed.Frrrrris_lazy+z#ParsedSubcomponentsStrategy.is_lazynamestrcC&g}|jD] }|||7}q||fS)z:Get the subcomponents of the calendar with the given name.)rwalkrr(resultrrrrr+/s z ParsedSubcomponentsStrategy.walkcCr*)z9Get the subcomponents of the calendar with the given uid.)rwith_uidr,rrrr.6s z$ParsedSubcomponentsStrategy.with_uidNrrrrrr )rr rr )rr$)r(r)rr) __name__ __module__ __qualname____doc__rrrr#r&r+r.rrrrr s     r c@s|eZdZUdZdZded< ddZed&d d Zd'd d Z d(ddZ d)ddZ d*ddZ d+ddZ d,dd Zd-d#d$Zd%S).LazySubcomponentsStrategyz'Parse subcomponents only when accessed.) VTIMEZONEztuple[str, ...]initial_components_to_parsecCsg|_d|_dS)NF)r_initial_parsedrrrrrFs z"LazySubcomponentsStrategy.__init__rr cCstdd|jDS)zReturn the parsed components.cSsg|]}|qSr)r!.0rrrr Nsz7LazySubcomponentsStrategy.as_parsed..)r rrrrrr as_parsedJsz#LazySubcomponentsStrategy.as_parsedrcCs||jS)zQGet the subcomponents of the calendar. Parse all subcomponents. )parse_initial_componentsr<rrrrrrQs z,LazySubcomponentsStrategy.get_all_componentsrrcCs t|Sr)r rrrrrrYs z(LazySubcomponentsStrategy.set_componentsrComponent | LazySubcomponentcCs|j||Sr)rr r"rrrr#_s z'LazySubcomponentsStrategy.add_componentboolcCr%)z6Return whether the subcomponents may be lazily parsed.Trrrrrr&fr'z!LazySubcomponentsStrategy.is_lazyNonecCs4|jrdSd|_|jD] }|j|jvr|q dS)zParse the components that are required by other components. This mainly concerns the timezone components. They are required by other components that have a TZID parameter. NT)r8rr(r7r!r"rrrr=js  z2LazySubcomponentsStrategy.parse_initial_componentsr( str | None1tuple[LazySubcomponentsStrategy, list[Component]]cCsB|dur |j|S|g}|jD] }|||7}q||fS)z|Get the subcomponents of the calendar with the given name. Parse only the minimal number of subcomponents. N)r<r+r=rr,rrrr+ws  zLazySubcomponentsStrategy.walkuidr)cCs.|g}|jD] }|||7}q ||fS)zGet the subcomponents of the calendar with the given ``uid``. Parse only the minimal number of subcomponents. )r=rr.)rrCr-rrrrr.s  z"LazySubcomponentsStrategy.with_uidN)rr r/r0)rr>rr5rr?)rr@)r(rArrB)rCr)rrB)r1r2r3r4r7__annotations__rpropertyr<rrr#r&r=r+r.rrrrr5@s         r5c@seZdZdZd ddZdS) InitialSubcomponentsStrategyz>Initial strategy for the calendar. No subcomponents. rrrr5cCs|rtdtS)NzpCannot set subcomponents on an uninitialised LazyCalendar. Parse it first or add components via add_component().) ValueErrorr5rrrrrs z+InitialSubcomponentsStrategy.set_componentsN)rrrr5)r1r2r3r4rrrrrrGsrGcseZdZUdZded< fddZed&dd Zejd'd d Ze d(ddZ e d)ddZ d*ddZ d+ddZ d,d d!Zd-d$d%Zejje_ZS). LazyCalendaraA calendar that can handle big files. Subcomponents of this calendar are evaluated lazily, meaning that they are not parsed until they are accessed. This allows the calendar to handle large files without consuming too much memory or time. All properties of the calendar component are parsed immediately. Subcomponents and their properties are parsed lazily. Examples: By accessing the :attr:`~icalendar.cal.calendar.Calendar.events` of the calendar, only :class:`~icalendar.cal.event.Event` and :class:`~icalendar.cal.timezone.Timezone` are immediately parsed. .. code-block:: pycon >>> from icalendar import LazyCalendar >>> calendar = LazyCalendar.example("issue_1050_all_components") >>> len(calendar.events) == 1 True The calendar's subcomponents were not parsed because they were not accessed. The calendar is still lazy. >>> calendar.is_lazy() True When you access all :attr:`subcomponents` of the calendar, for example by getting their count, the entire calendar is parsed and becomes not lazy. >>> len(calendar.subcomponents) 5 >>> calendar.is_lazy() False zVLazySubcomponentsStrategy | ParsedSubcomponentsStrategy | InitialSubcomponentsStrategy_subcomponentscst|_tj|i|dS)zInitialize the calendar.N)rGrJsuperr)rargskwargs __class__rrrszLazyCalendar.__init__rrcCs|j\|_}|S)zThe subcomponents of the calendar. Parse all subcomponents of the calendar and return them as a list. You can manipulate this list or set it. It has the same behavior as in :class:`~icalendar.cal.calendar.Calendar`. )rJr)rr-rrr subcomponentss zLazyCalendar.subcomponentsvaluer@cC|j||_dS)rN)rJr)rrQrrrrPsst str | bytesr cCst|||jS)z/Get the iCal parser for the given input string.)r_get_component_factory types_factory)clsrSrrr_get_ical_parsers zLazyCalendar._get_ical_parserrcCst}|||S)z,Get the component factory for this calendar.)radd_component_class)rWfactoryrrrrUs z#LazyCalendar._get_component_factoryrr cCrR)zAdd a component to the calendar. Use this instead of appending to :attr:`~icalendar.cal.lazy.LazyCalendar.subcomponents`, as the latter does not parse the whole calendar. N)rJr#r"rrrr#szLazyCalendar.add_componentr?cCs |jS)aWhether the subcomponents will be parsed lazily. .. note:: If you believe that the calendar parses more than it should, please `open an issue `_. Returns: ``True`` if subcomponents are deferred and not yet parsed. ``False`` if all subcomponents have been parsed. )rJr&rrrrr&s zLazyCalendar.is_lazyr(rAselectCallable[[Component], bool]csN|j|\|_}fdd|D}|dus|j|kr%|r%|d||S)Ncsg|]}|r|qSrrr9r[rrr;sz&LazyCalendar._walk..r)rJr+r(insert)rr(r[r-rr]r_walk s  zLazyCalendar._walkrCr)cCs,|j|\|_}|j|kr|d||S)Nr)rJr.rCr^)rrCr-rrrr.s  zLazyCalendar.with_uid)rr)rQrrr@)rSrTrr )rr)rr rr@rD)r(rAr[r\rr)rCr)rr)r1r2r3r4rErrFrPsetter classmethodrXrUr#r&r_r.r __classcell__rrrNrrIs$ (       rI__main__Nissue_1050_all_componentsi'caltype[Calendar]cCs |t}t|jtksJdS)zCheck out how fast this is.N) from_icalicsleneventsCOUNT)rerrr _benchmark&s rlz Benchmarking:z_benchmark(cal))globalsnumber)rerf)#r4 __future__rtypingrricalendar.cal.component_factoryricalendar.parser.ical.lazyrcalendarrcollections.abcr icalendar.parser.ical.componentr r rr r r5rGrI__all__r1timeitexamplerkrPto_icalrhrlreprintlocalsrrrrs8        +R{