+ j1UrRt^RIHt^RIt^RIHt^RIHtHtH t H t ^RI H t H t HtHtHtHtHtHtHtHt^RIHt^RIHt^RIHt^R IHt^R IHt^R I H!t!]'dA^R I"H#t#H$t$^R IH%t%Ht^RI&H't'^RI(H)t)^RI*H+t+^RI,H-t-^RI.H/t/^RI0H1t1^RI2H3t3^RI4H5t5R]! R2t6!RR]4t7R.t8R#)z :rfc:`5545` iCalendar component.) annotationsN) timedelta) TYPE_CHECKINGLiteralcastoverload) CONCEPTS_TYPE_SETTERLINKS_TYPE_SETTERRELATED_TO_TYPE_SETTERcategories_propertyimages_propertymulti_language_text_propertysingle_string_propertysource_property uid_property url_property) Component) get_example)Timezone)IncompleteComponent)CalendarIcalParser) __version__)IterableSequence)datedatetime)Path) Availability)Event)FreeBusy)Journal)Todo)Self)ComponentIcalParserz-//collective//icalendar//z//ENca]tRt^-tRtRtR;tRt ] R?R R ll4t ] RRl4t ] ] R@RRll44t] ] RRl44t] R@RV3Rlll4t]RRl4t]RRl4t]RRl4t]RRl4t]RRl4tR R!ltR"R#lt]R$R%l4t]P2]P43R&R'llt]!R R R(4t]!RRR)4t]!R R*R+4t ]!t"]#t$]!RR,4t%]!RR-4t&]!RR.R/R07t']!RR14t(])t*]+t,]R2R3l4t-]-P\R4R5l4t-]-P^R64t-]0t1] RAR7V3R8lll4t2R9t3R:t4V;t5#)BCalendara The "VCALENDAR" object is a collection of calendar information. This information can include a variety of components, such as "VEVENT", "VTODO", "VJOURNAL", "VFREEBUSY", "VTIMEZONE", or any other type of calendar component. Examples: Create a new Calendar: >>> from icalendar import Calendar >>> calendar = Calendar.new(name="My Calendar") >>> print(calendar.calendar_name) My Calendar VCALENDARVERSIONPRODIDCALSCALEMETHOD DESCRIPTION X-WR-CALDESCNAME X-WR-CALNAMECOLORc V^8dQhRRRR/#)namestrreturnr%)formats"U/home/ralf/ical-fahrzeuge/venv/lib/python3.14/site-packages/icalendar/cal/calendar.py __annotate__Calendar.__annotate__[s==3=x=c 8VP\RV44#)z0Return the calendar example with the given name. calendars) from_icalr)clsr2s&&r7exampleCalendar.exampleZs}}[d;<rBs&&r7_get_ical_parserCalendar._get_ical_parser_s ""&@&@&BCDUDUVVr:c$V^8dQhRRRRRR/#)r1rBstr | bytes | PathmultiplezLiteral[False]r4r%r5)r6s"r7r8r9fs$#/= r:c R#Nr5r>rBrJs&&&r7r=Calendar.from_icaldsr:c$V^8dQhRRRRRR/#)r1rBrIrJz Literal[True]r4zlist[Calendar]r5)r6s"r7r8r9ls$#/< r:c R#rLr5rMs&&&r7r=rNjsr:c$V^8dQhRRRRRR/#)r1rBrIrJboolr4Calendar | list[Calendar]r5)r6s"r7r8r9qs$  # /3 " r:c 8<\R\SV` WR74#)aParse iCalendar data into calendar instances. Parameters: st: iCalendar data as bytes or string, or a path to an iCalendar file. multiple: If ``True``, returns a list of calendars. If ``False``, returns a single calendar. Returns: Calendar or list of calendars. rS)rJ)rsuperr=)r>rBrJ __class__s&&&r7r=rNps$ '):2):)Q  r:cV^8dQhRR/#)r1r4z list[Event]r5)r6s"r7r8r9s## #r:c $VPR4#)aAll event components in the calendar. This is a shortcut to get all events. Modifications do not change the calendar. Use :meth:`Component.add_component `. >>> from icalendar import Calendar >>> calendar = Calendar.example() >>> event = calendar.events[0] >>> event.start datetime.date(2022, 1, 1) >>> print(event["SUMMARY"]) New Year's Day VEVENTwalkselfs&r7eventsCalendar.eventss yy""r:cV^8dQhRR/#)r1r4z list[Todo]r5)r6s"r7r8r9s""z"r:c $VPR4#)zAll todo components in the calendar. This is a shortcut to get all todos. Modifications do not change the calendar. Use :meth:`Component.add_component `. VTODOrZr\s&r7todosCalendar.todossyy!!r:cV^8dQhRR/#)r1r4z list[Journal]r5)r6s"r7r8r9s%%-%r:c $VPR4#)zAll journal components in the calendar. This is a shortcut to get all journals. Modifications do not change the calendar. Use :meth:`Component.add_component `. VJOURNALrZr\s&r7journalsCalendar.journalssyy$$r:cV^8dQhRR/#)r1r4zlist[Availability]r5)r6s"r7r8r9s** 2*r:c $VPR4#)zAll :class:`Availability` components in the calendar. This is a shortcut to get all availabilities. Modifications do not change the calendar. Use :meth:`Component.add_component `. VAVAILABILITYrZr\s&r7availabilitiesCalendar.availabilitiessyy))r:cV^8dQhRR/#)r1r4zlist[FreeBusy]r5)r6s"r7r8r9s&&.&r:c $VPR4#)zAll FreeBusy components in the calendar. This is a shortcut to get all FreeBusy. Modifications do not change the calendar. Use :meth:`Component.add_component `. VFREEBUSYrZr\s&r7freebusyCalendar.freebusysyy%%r:cV^8dQhRR/#r1r4zset[str]r5)r6s"r7r8r9sr:c \4pVPRR7FCwr#\VR4'gKVPVPP R44KE VR0, #)aRThe set of TZIDs in use. This goes through the whole calendar to find all occurrences of timezone information like the TZID parameter in all attributes. >>> from icalendar import Calendar >>> calendar = Calendar.example("timezone_rdate") >>> calendar.get_used_tzids() {'posix/Europe/Vaduz'} Even if you use UTC, this will not show up. F)sortedparamsTZIDN)setproperty_itemshasattraddrxget)r]result_namevalues& r7get_used_tzidsCalendar.get_used_tzidss[ //u/=LEuh'' 5<<++F34>r:cV^8dQhRR/#rur5)r6s"r7r8r9s8r:c VP4R0, pVPFpVPVP4K V#)aThe set of missing timezone component tzids. To create a :rfc:`5545` compatible calendar, all of these timezones should be added. UTC is excluded: per :rfc:`5545#section-3.2.19`, UTC datetimes use the ``Z`` suffix and never require a VTIMEZONE component. UTC)r timezonesdiscardtz_name)r]tzidstimezones& r7get_missing_tzidsCalendar.get_missing_tzidssB##%/H MM(** +' r:cV^8dQhRR/#)r1r4zlist[Timezone]r5)r6s"r7r8r9s & &> &r:c $VPR4#)aReturn the timezones components in this calendar. >>> from icalendar import Calendar >>> calendar = Calendar.example("pacific_fiji") >>> [timezone.tz_name for timezone in calendar.timezones] ['custom_Pacific/Fiji'] .. note:: This is a read-only property. VTIMEZONErZr\s&r7rCalendar.timezonessyy%%r:c V^8dQhRRRR/#)r1 first_dater last_dater5)r6s"r7r8r9s0)0)0)0)r:c VP4pV'gR#\VP4pVF@p\P!WQVR7pTP PYF4T^, pKB R# \ dKTi;i)awAdd all missing VTIMEZONE components. This adds all the timezone components that are required. VTIMEZONE components are inserted at the beginning of the calendar to ensure they appear before other components that reference them. .. note:: Timezones that are not known will not be added. Parameters: first_date: Earlier than anything that happens in the calendar. last_date: Later than anything happening in the calendar. >>> from icalendar import Calendar, Event >>> from datetime import datetime >>> from zoneinfo import ZoneInfo >>> calendar = Calendar() >>> event = Event() >>> calendar.add_component(event) >>> event.start = datetime(1990, 10, 11, 12, tzinfo=ZoneInfo("Europe/Berlin")) >>> calendar.timezones [] >>> calendar.add_missing_timezones() >>> calendar.timezones[0].tz_name 'Europe/Berlin' >>> calendar.get_missing_tzids() # check that all are added set() N)rr)rlenrr from_tzid ValueError subcomponentsinsert)r]rr missing_tzidsexisting_timezone_counttzidrs&&& r7add_missing_timezonesCalendar.add_missing_timezonessD..0  "%dnn"5!D #--9    % %&= H #q ( #"   sA88 BBaThe display name of this calendar, per :rfc:`7986#section-5.1`. Implements both the ``NAME`` property from :rfc:`7986#section-5.1` and the widely used ``X-WR-CALNAME`` extension for broader client compatibility. Multiple language variants can be stored by setting this property more than once, each with a different ``LANGUAGE`` parameter value. Example: Set the name of the calendar. .. code-block:: pycon >>> from icalendar import Calendar >>> calendar = Calendar() >>> calendar.calendar_name = "My Calendar" >>> print(calendar.to_ical().decode()) BEGIN:VCALENDAR NAME:My Calendar X-WR-CALNAME:My Calendar END:VCALENDAR aA description of the calendar's content. Implements both ``DESCRIPTION`` from :rfc:`5545#section-3.8.1.5` and :rfc:`7986#section-5.2` and ``X-WR-CALDESC`` for broader calendar client compatibility. Multiple language variants can be stored by setting this property more than once with different ``LANGUAGE`` parameter values. Example: Add a description to a calendar. .. code-block:: pycon >>> from icalendar import Calendar >>> calendar = Calendar() >>> calendar.description = "This is a calendar" >>> print(calendar.to_ical().decode()) BEGIN:VCALENDAR DESCRIPTION:This is a calendar X-WR-CALDESC:This is a calendar END:VCALENDAR aEA CSS3 color name or value used to visually distinguish this calendar, per :rfc:`7986#section-5.9`. Implements both ``COLOR`` from :rfc:`7986#section-5.9` and ``X-APPLE-CALENDAR-COLOR``. The value is a case-insensitive CSS3 color name, for example, ``"turquoise"``, or a hex code, for example, ``"#ffffff"``, drawn from the `CSS3 color specification `_. Since :rfc:`7986`, individual ``VEVENT``, ``VTODO``, and ``VJOURNAL`` subcomponents may also carry their own color. Example: .. code-block:: pycon >>> from icalendar import Calendar >>> calendar = Calendar() >>> calendar.color = "black" >>> print(calendar.to_ical().decode()) BEGIN:VCALENDAR COLOR:black END:VCALENDAR zX-APPLE-CALENDAR-COLORaThe product identifier for the software that created this iCalendar object. This property is defined in :rfc:`5545#section-3.7.3`. It's required exactly once per iCalendar object. The value should be a globally unique string. The conventional format is a Formal Public Identifier (FPI), for example, ``-//My Company//My Product//EN``, but any unique string is acceptable. Example: Set a custom product identifier on a new calendar. .. code-block:: pycon >>> from icalendar import Calendar >>> cal = Calendar() >>> cal.prodid = "-//MyApp//MyCalendar//EN" >>> str(cal.prodid) '-//MyApp//MyCalendar//EN' See also: :attr:`version` a9The iCalendar specification version required to interpret this object. This property is defined in :rfc:`5545#section-3.7.4`. It's required exactly once per calendar object. The value ``"2.0"`` indicates :rfc:`5545` compliance, which is the default used by this library. A range such as ``"1.0;2.0"`` may indicate minimum and maximum supported versions. Example: .. code-block:: pycon >>> from icalendar import Calendar >>> cal = Calendar() >>> cal.version = "2.0" >>> str(cal.version) '2.0' See also: :attr:`prodid` aThe calendar scale for date and time values in this iCalendar object. This property is defined in :rfc:`5545#section-3.7.1`. The only value currently defined is ``"GREGORIAN"`` (the default). When this property is absent, Gregorian is assumed. Per :rfc:`7529`, non-Gregorian calendar systems are expressed via ``RRULE`` transformations rather than a different ``CALSCALE`` value. However, icalendar currently implements only the parsing of this value, not a transformation. Example: .. code-block:: pycon >>> from icalendar import Calendar >>> cal = Calendar() >>> cal.calscale 'GREGORIAN' GREGORIAN)defaultaThe iTIP scheduling method associated with this calendar object, per :rfc:`5545#section-3.7.2`. When present, ``METHOD`` indicates that this object is part of a scheduling transaction, such as a meeting invitation or cancellation. Scheduling methods are defined by :rfc:`5546#section-1.4` (iTIP), with values such as ``"REQUEST"``, ``"REPLY"``, ``"CANCEL"``, and ``"PUBLISH"``. When used inside a MIME message, this value must match the ``method`` parameter of the ``Content-Type`` header. If absent, the calendar is treated as a plain data snapshot with no scheduling semantics. Example: .. code-block:: pycon >>> from icalendar import Calendar >>> cal = Calendar() >>> cal.method = "REQUEST" >>> str(cal.method) 'REQUEST' cV^8dQhRR/#)r1r4timedelta | Noner5)r6s"r7r8r9sAA"2Ar:c PVPR4pV'd VP#R#)aA suggested minimum polling interval for fetching updates to this calendar, per :rfc:`7986#section-5.7`. Calendar clients should not poll more frequently than this interval. The value must be a positive duration. Returns: A :class:`~datetime.timedelta`, or ``None`` when not set. Raises: ValueError: When setting a non-positive (zero or negative) duration. TypeError: When setting a value that is not a :class:`~datetime.timedelta` or ``None``. Example: .. code-block:: pycon >>> from datetime import timedelta >>> from icalendar import Calendar >>> cal = Calendar() >>> cal.refresh_interval = timedelta(hours=1) >>> cal.refresh_interval datetime.timedelta(seconds=3600) REFRESH-INTERVALN)r~dt)r]refresh_intervals& r7rCalendar.refresh_intervals(2 88$67&6""@D@r:cV^8dQhRR/#)r1rrr5)r6s"r7r8r9s & &&6 &r:c \V\4'gVe \R4hVe!VP4^8:d \ R4hVeV=VP RV4R#V=R#)zSet the REFRESH-INTERVAL.NzKREFRESH-INTERVAL must be either a positive timedelta, or None to delete it.z.REFRESH-INTERVAL must be a positive timedelta.r) isinstancer TypeError total_secondsrrr})r]rs&&r7rrsm%++0A)   !4!4!6!!;MN N  % HH' /%r:c (VPR4R#)zDelete REFRESH-INTERVAL.rN)popr\s&r7rrs #$r:c*lV^8dQhRRRRRRRRRRR RR R R R RRRRRRRRRRRRRRRRRRRRRRRRR R!/#)"r1calscalez str | None categoriesz Sequence[str]colorconceptsr descriptionlanguage last_modifiedzdate | datetime | Nonelinksr methodr2 organizationprodidrrrefidszlist[str] | str | None related_tor sourcerzIterable[Component] | Noneuidzstr | uuid.UUID | Noneurlversionr3r4r"r5)r6s"r7r8r9 s\\\" \  \ ' \ \\.\!\\\!\\+\ '!\"+#\$%\&2'\($)\*+\,-\. /\r:c  <\SV`VVVVVVR7pV f;V 'd3T ;'gRpV'dVP4MRpRV RV RV 2p M V f\p V VnVVnV VnVVnVVnV Vn VVn VVn VeTM\P!4VnVVnV VnVVnV#)a\Create a new Calendar. This creates a new Calendar in accordance with :rfc:`5545` and :rfc:`7986`. Parameters: calscale: The :attr:`calscale` of the calendar. categories: The :attr:`categories` of the calendar. color: The :attr:`color` of the calendar. concepts: The :attr:`~icalendar.cal.component.Component.concepts` of the calendar. description: The :attr:`description` of the calendar. language: The language for the calendar. Used to generate localized `prodid`. last_modified: The :attr:`~icalendar.cal.component.Component.last_modified` of the calendar. links: The :attr:`~icalendar.cal.component.Component.links` of the calendar. method: The :attr:`method` of the calendar. name: The :attr:`calendar_name` of the calendar. organization: The organization name. Used to generate `prodid` if not provided. prodid: The :attr:`prodid` of the component. If ``None`` and ``organization`` is provided, generates a `prodid` in the format of "-//organization//name//language". If ``None`` and ``organization`` is not provided, sets it to :attr:`~icalendar.cal.calendar.DEFAULT_PRODID`. refresh_interval: The :attr:`refresh_interval` of the calendar. refids: :attr:`~icalendar.cal.component.Component.refids` of the calendar. related_to: :attr:`~icalendar.cal.component.Component.related_to` of the calendar. source: The :attr:`source` of the calendar. subcomponents: The subcomponents of the calendar. uid: The :attr:`uid` of the calendar. If None, this is set to a new :func:`uuid.uuid4`. url: The :attr:`url` of the calendar. version: The :attr:`version` of the calendar. Returns: :class:`Calendar` Raises: ~error.InvalidCalendar: If the content is not valid according to :rfc:`5545`. .. warning:: As time progresses, we will be stricter with the validation. )rrrrrrr%ENz-//z//)rUnewupperDEFAULT_PRODIDrr calendar_namerrrrruuiduuid4rrrr)r>rrrrrrrrrr2rrrrrrrrrrcalendarapp_namelangrVs"&&&&&&&&&&&&&&&&&&&& r7r Calendar.new s~'!' %  >l))zH'/8>>#TD<.8*Btf=F ^#F "!%* $(!os4::<  $4! r:c VPR4'g \R4hVPR4'g \R4hVP'g \R4hR#)zValidate that the calendar has required properties and components. This method can be called explicitly to validate a calendar before output. Raises: ~error.IncompleteComponent: If the calendar lacks required properties or components. r(zCalendar must have a PRODIDr'zCalendar must have a VERSIONz@Calendar must contain at least one component (event, todo, etc.)N)r~rrr\s&r7validateCalendar.validatejs[xx!!%&CD Dxx ""%&DE E!!!%R "r:r5)r'r(r)r*r+r,r-r.)r(r')r(r'r)r*r/) CATEGORIESr+r-)r?)F)Nr5NNNNNNNNNNNNNNNNNz2.0)6__name__ __module__ __qualname____firstlineno____doc__r2canonical_orderrequired singletonsrJ classmethodr?rFrr=propertyr^rcrhrmrrrrrrDEFAULT_FIRST_DATEDEFAULT_LAST_DATErr rrrrr rrrrrrrrrrrrsetterdeleterr imagesrr__static_attributes__ __classcell__)rVs@r7r%r%-sh D OHJH ==WW   "##"""%%**&&&  & & $66"440)d1 M8/ K: # , !1 E4%J C # F4% G0& $)H,$ F0 C F AA6 & &%%F\\\|r:r%)9r __future__rrrrtypingrrrricalendar.attrrr r r r r rrrricalendar.cal.componentricalendar.cal.examplesricalendar.cal.timezonericalendar.errorricalendar.parser.ical.calendarricalendar.versionrcollections.abcrrrpathlibricalendar.cal.availabilityricalendar.cal.eventricalendar.cal.free_busyricalendar.cal.journalr icalendar.cal.todor!icalendar.compatibilityr"icalendar.parser.ical.componentr#rr%__all__r5r:r7rs&" 99   ..+/=)2'7)0-',C.k]$?M yM ` ,r: