+ jgRt^RIHt^RIHtHtHt^RIHtHt^RI H t H t H t H t HtHtHtHtHtHtHtHtHtHtHt^RIHt^RIHt^RIHt^RIH t ]'d^R I!t!^R I"H#t#^R I$H%t%^R I&H't'!R R]4t(R.t)R #)z:rfc:`5545` VALARM component.) annotations)datedatetime timedelta) TYPE_CHECKING NamedTuple)CONCEPTS_TYPE_SETTERLINKS_TYPE_SETTERRELATED_TO_TYPE_SETTERattendees_propertycreate_single_propertydescription_propertyproperty_del_durationproperty_get_durationproperty_set_durationrepeat_propertysingle_int_propertysingle_string_propertysingle_utc_propertysummary_property uid_property) Component) get_example)InvalidCalendar)vBinaryN)Sequence)Self) vCalAddressca]tRt^&tRtRtR&tR'tR(tR)t ] !R^R^R 7t ] !] ]]R 4t]!RR 4t]!RR ]]3]],R ,R4t] RRl4t]P0RRl4t!RR]4t] R4t]t]!RR4t]!R] PRR.4t!]"t#]$t%]&t'](R*RV3Rlll4t)RRlt*](R+RRll4t+](R*RR ll4t,](R*R!R"ll4t-](R,R#R$ll4t.R%t/V;t0#)-Alarma A "VALARM" calendar component is a grouping of component properties that defines an alarm or reminder for an event or a to-do. For example, it may be used to define a reminder for a pending event or an overdue to-do. Example: The following example creates an alarm which uses an audio file from an FTP server. .. code-block:: pycon >>> from icalendar import Alarm >>> alarm = Alarm.example() >>> print(alarm.to_ical().decode()) BEGIN:VALARM ACTION:AUDIO ATTACH;FMTTYPE=audio/basic:ftp://example.com/pub/sounds/bell-01.aud DURATION:PT15M REPEAT:4 TRIGGER;VALUE=DATE-TIME:19970317T133000Z END:VALARM VALARMACTIONTRIGGERREPEATUID ACKNOWLEDGEDaThe number of additional times the alarm is triggered after the initial trigger. Defaults to ``0``, meaning the alarm fires once. To repeat the alarm, set both :attr:`REPEAT` and :attr:`DURATION`. The :attr:`DURATION` sets the gap between repetitions. :attr:`REPEAT` is the count of *additional* triggers, so a :attr:`REPEAT` of ``2`` produces three alarms in total (the initial trigger plus two repeats). Conforming with :rfc:`5545#section-3.8.6.2`, this property can appear once in an :class:`~icalendar.cal.alarm.Alarm` component and must be paired with :attr:`DURATION`. Example: Build an alarm that fires once and then repeats twice at five-minute intervals. .. code-block:: pycon >>> from datetime import timedelta >>> from icalendar import Alarm >>> alarm = Alarm() >>> alarm.TRIGGER = timedelta(minutes=-15) >>> alarm.DURATION = timedelta(minutes=5) >>> alarm.REPEAT = 2 >>> alarm.REPEAT 2 Raises: TypeError: If the value is not an ``int``. Booleans are rejected, too, even though ``bool`` subclasses ``int``. ~icalendar.error.InvalidCalendar: If the value is negative. .. versionchanged:: 7.2.3 Negative values are no longer accepted. ) min_valueaThe delay between repeated triggers of a repeating alarm. Returns a :class:`datetime.timedelta` or ``None`` when the alarm has no :attr:`DURATION` set. Setting this attribute accepts a :class:`~datetime.timedelta`; deleting it removes the property from the component. :attr:`DURATION` is meaningful only for repeating alarms and must be paired with :attr:`REPEAT`. The two together produce :attr:`REPEAT` additional triggers, each spaced by :attr:`DURATION` after the initial trigger. Conforming with :rfc:`5545#section-3.8.2.5`, the :attr:`DURATION` property can appear once in an :class:`~icalendar.cal.alarm.Alarm` component. Example: Pair :attr:`DURATION` with :attr:`REPEAT` to produce three triggers spaced ten minutes apart. .. code-block:: pycon >>> from datetime import timedelta >>> from icalendar import Alarm >>> alarm = Alarm() >>> alarm.TRIGGER = timedelta(minutes=-30) >>> alarm.DURATION = timedelta(minutes=10) >>> alarm.REPEAT = 2 >>> alarm.DURATION datetime.timedelta(seconds=600) apThis property is the UTC datetime at which this alarm was last sent or acknowledged as defined in :rfc:`9074`. Setting this property allows calendar clients to dismiss or suppress an alarm across multiple devices. Once set to a value greater than or equal to the alarm's computed trigger time, conforming clients will not refire the alarm. Returns ``None`` when no acknowledgment has been recorded. Example: Mark an alarm as acknowledged. Note that the example uses an arbitrary time for the purpose of passing doctests. In actual practice, clients should use the current time in UTC, such as ``datetime.now(UTC)``. .. code-block:: pycon >>> from datetime import timezone, datetime >>> from icalendar import Alarm >>> UTC = timezone.utc >>> alarm = Alarm() >>> alarm.ACKNOWLEDGED = datetime(2024, 1, 15, 10, 0, tzinfo=UTC) >>> alarm.ACKNOWLEDGED datetime.datetime(2024, 1, 15, 10, 0, tzinfo=ZoneInfo(key='UTC')) See also: :attr:`TRIGGER`, the time at which the alarm fires. dtNakThe time at which this alarm fires, per :rfc:`5545#section-3.8.6.3`. The value is either a :class:`~datetime.timedelta` (relative trigger) or a UTC :class:`~datetime.datetime` (absolute trigger). A negative :class:`~datetime.timedelta` fires *before* the related component boundary (start or end); a positive one fires *after* it. Use :attr:`TRIGGER_RELATED` to choose whether the offset is measured from the start or the end of the parent event or to-do. An absolute trigger fires at an exact UTC point in time regardless of the parent component's dates. Examples: Set an alarm to fire 15 minutes before the start of an event. .. code-block:: pycon >>> from datetime import datetime, timedelta, timezone >>> from icalendar import Alarm, Event >>> UTC = timezone.utc >>> event = Event() >>> event.start = datetime(2024, 1, 15, 10, 0, tzinfo=UTC) >>> alarm = Alarm() >>> alarm.TRIGGER = timedelta(minutes=-15) >>> event.add_component(alarm) >>> event.alarms.times[0].trigger datetime.datetime(2024, 1, 15, 9, 45, tzinfo=datetime.timezone.utc) Set an absolute trigger to fire at a specific UTC time. .. code-block:: pycon >>> absolute_alarm = Alarm() >>> absolute_alarm.TRIGGER = datetime(2024, 1, 15, 9, 45, tzinfo=UTC) >>> absolute_alarm.TRIGGER datetime.datetime(2024, 1, 15, 9, 45, tzinfo=datetime.timezone.utc) See also: :attr:`TRIGGER_RELATED`, :attr:`DURATION`, :attr:`REPEAT` cV^8dQhRR/#)returnstr)formats"R/home/ralf/ical-fahrzeuge/venv/lib/python3.14/site-packages/icalendar/cal/alarm.py __annotate__Alarm.__annotate__s666c hVPR4pVfR#VPPRR4#)aThe RELATED parameter of the TRIGGER property. Values are either "START" (default) or "END". A value of START will set the alarm to trigger off the start of the associated event or to-do. A value of END will set the alarm to trigger off the end of the associated event or to-do. In this example, we create an alarm that triggers two hours after the end of its parent component. >>> from icalendar import Alarm >>> from datetime import timedelta >>> alarm = Alarm() >>> alarm.TRIGGER = timedelta(hours=2) >>> alarm.TRIGGER_RELATED = "END" r"STARTRELATED)getparams)selftriggers& r.TRIGGER_RELATEDAlarm.TRIGGER_RELATEDs1&((9% ?~~!!)W55r1cV^8dQhRR/#)r)valuer+r,)r-s"r.r/r0s**S*r1c bVPR4pVf \R4hWPR&R#)zSet "START" or "END".r"Nz>> from icalendar import Alarm >>> from datetime import timedelta >>> alarm = Alarm() >>> alarm.TRIGGER = timedelta(hours=-4) # trigger 4 hours before START >>> alarm.DURATION = timedelta(hours=1) # after 1 hour trigger again >>> alarm.REPEAT = 2 # trigger 2 more times >>> alarm.triggers.start == (timedelta(hours=-4), timedelta(hours=-3), timedelta(hours=-2)) True >>> alarm.triggers.end () >>> alarm.triggers.absolute () r3)rArBrC) r" isinstancerappendr9DURATIONrangerepeatrKtuple)r7rArBrCr8addduration_s& r.triggersAlarm.triggers)s,,,  '4(((%%0 W% 7#}}H#t{{+AJJs2w12,}},E#Jx  r1zThe action invoked when the alarm triggers. Typical values defined by :rfc:`5545#section-3.8.6.1` are ``AUDIO``, ``DISPLAY``, and ``EMAIL``. The empty string is returned when no ``ACTION`` property is present. z X-ALARMUIDzX-EVOLUTION-ALARM-UIDc<V^8dQhRRRRRRRRR R R R R RRRRR/ #)r) attendeeszlist[vCalAddress] | Noneconceptsr descriptionz str | Nonelinksr refidslist[str] | str | None related_tor summaryuidstr | uuid.UUID | Noner*rr,)r-s"r.r/r0jsf--,-' -  - ! -'-+--$- -r1c  ^<\S V`VVVVR7p WynW9nWnWnV #)aECreate a new alarm with all required properties. This creates a new Alarm in accordance with :rfc:`5545`. Parameters: attendees: The :attr:`attendees` of the alarm. concepts: The :attr:`~icalendar.cal.component.Component.concepts` of the alarm. description: The :attr:`description` of the alarm. links: The :attr:`~icalendar.cal.component.Component.links` of the alarm. refids: :attr:`~icalendar.cal.component.Component.refids` of the alarm. related_to: :attr:`~icalendar.cal.component.Component.related_to` of the alarm. summary: The :attr:`summary` of the alarm. uid: The :attr:`uid` of the alarm. Returns: :class:`Alarm` Raises: ~error.InvalidCalendar: If the content is not valid according to :rfc:`5545`. .. warning:: As time progresses, we will be stricter with the validation. )r]r`r^r[)supernewrar\rbrZ) clsrZr[r\r]r^r`rarbalarm __class__s "&&&&&&&& r.rf Alarm.newisAHgk! "   ' # r1c$V^8dQhRRRRRR/#)r)rUtimedelta | NonerR int | Noner*Noner,)r-s"r.r/r0s( ! !" ! !  !r1c XVfVe"VeVf \R4hWnW nR#R#)Nz6DURATION and REPEAT must be set together or not at all)rrPr#)r7rUrRs&&&r._apply_duration_repeatAlarm._apply_duration_repeats:  6#56>%L%M K $6r1c@V^8dQhRRRRRRRRR R R R R RRRRRRR/ #)r)r\r+r8timedelta | datetimerUrlrRrmrbrcr]r r`r r^r_r[rr*rr,)r-s"r.r/r0sz]]]&]# ]  ] $ ]!]+]']'] ]r1c  V'g \R4hVf \R4hVPVVVVVV R7p V PRR4W*nV P W44V #)a Create a new DISPLAY alarm that shows a text reminder. A DISPLAY alarm pops up a text notification at the trigger time. This is the most common alarm type used by calendar clients. Conforms to :rfc:`5545#section-3.6.6`. Parameters: description: Required. The text to display when the alarm fires. Corresponds to the :attr:`description` property. trigger: Required. When the alarm fires, as a :class:`~datetime.timedelta` relative to the event start (negative means before) or as an absolute :class:`~datetime.datetime` (recommend UTC-aware). concepts: The :attr:`~icalendar.cal.component.Component.concepts` of the alarm. duration: Gap between repeated triggers. Must be paired with ``repeat``. Corresponds to the :attr:`DURATION` property. links: The :attr:`~icalendar.cal.component.Component.links` of the alarm. refids: The :attr:`~icalendar.cal.component.Component.refids` of the alarm. related_to: The :attr:`~icalendar.cal.component.Component.related_to` of the alarm. repeat: Number of *additional* times to fire after the initial trigger. Must be paired with ``duration``. Corresponds to the :attr:`REPEAT` property. uid: Unique identifier for the alarm or ``None``. Returns: :class:`Alarm` with ``ACTION:DISPLAY`` set. Raises: ~icalendar.error.InvalidCalendar: If required fields are missing or ``duration`` and ``repeat`` are not both provided together. Example: Create a display alarm that fires 15 minutes before the event: .. code-block:: pycon >>> from datetime import timedelta >>> from icalendar import Alarm >>> alarm = Alarm.new_display( ... description="Team meeting in 15 minutes", ... trigger=timedelta(minutes=-15), ... ) >>> print(alarm.to_ical().decode()) BEGIN:VALARM ACTION:DISPLAY DESCRIPTION:Team meeting in 15 minutes TRIGGER:-PT15M END:VALARM Attach the alarm to an event: .. code-block:: python from datetime import datetime, timedelta, timezone from icalendar import Alarm, Event event = Event.new( summary="Team meeting", start=datetime(2025, 6, 1, 10, 0, tzinfo=timezone.utc), end=datetime(2025, 6, 1, 11, 0, tzinfo=timezone.utc), ) event.add_component(Alarm.new_display( description="Team meeting in 15 minutes", trigger=timedelta(minutes=-15), )) z$DISPLAY alarm requires a descriptionz DISPLAY alarm requires a trigger)r\rbr]r`r^r[r!DISPLAY)rrfrTr"rp) rgr\r8rUrRrbr]r`r^r[rhs &&&&&&&&&& r. new_displayAlarm.new_displaysr^!"HI I ?!"DE Eww#!    (I&  $$X6 r1c@V^8dQhRRRRRRRRR R R R R RRRRRRR/ #)r)r8rsattachzstr | bytes | NonerUrlrRrmrbrcr]r r`r r^r_r[rr*rr,)r-s"r.r/r0szQQ%Q#Q# Q  Q $ Q!Q+Q'Q'Q Qr1c  Vf \R4hVPVVVVV R7p V PRR4WnV'd4T PR\ V\ 4'd \ V4MT4V PW44V #)aCreate a new AUDIO alarm that plays a sound. An AUDIO alarm plays a sound at the trigger time. An optional ``attach`` URI points to the audio file to play; when omitted, the client uses its default alert sound. Conforms to :rfc:`5545#section-3.6.6`. Parameters: trigger: Required. When the alarm fires, as a :class:`~datetime.timedelta` relative to the event start (negative means before) or as an absolute :class:`~datetime.datetime` (recommend UTC-aware). attach: Optional audio attachment. Pass a URI string such as ``"ftp://example.com/pub/sounds/bell.aud"`` for a linked sound file, or :class:`bytes` for inline binary audio data (stored as ``VALUE=BINARY``). When ``None`` the client uses its default sound. concepts: The :attr:`~icalendar.cal.component.Component.concepts` of the alarm. duration: Gap between repeated triggers. Must be paired with ``repeat``. Corresponds to the :attr:`DURATION` property. links: The :attr:`~icalendar.cal.component.Component.links` of the alarm. refids: The :attr:`~icalendar.cal.component.Component.refids` of the alarm. related_to: The :attr:`~icalendar.cal.component.Component.related_to` of the alarm. repeat: Number of *additional* times to fire after the initial trigger. Must be paired with ``duration``. Corresponds to the :attr:`REPEAT` property. uid: Unique identifier for the alarm or ``None``. Returns: :class:`Alarm` with ``ACTION:AUDIO`` set. Raises: ~icalendar.error.InvalidCalendar: If required fields are missing or ``duration`` and ``repeat`` are not both provided together. Example: Create an audio alarm using a custom sound file: .. code-block:: pycon >>> from datetime import timedelta >>> from icalendar import Alarm >>> alarm = Alarm.new_audio( ... trigger=timedelta(minutes=-5), ... attach="ftp://example.com/pub/sounds/bell-01.aud", ... ) >>> print(alarm.to_ical().decode()) BEGIN:VALARM ACTION:AUDIO ATTACH:ftp://example.com/pub/sounds/bell-01.aud TRIGGER:-PT5M END:VALARM zAUDIO alarm requires a trigger)rbr]r`r^r[r!AUDIOATTACH)rrfrTr"rNbytesrrp) rgr8ryrUrRrbr]r`r^r[rhs &&&&&&&&&& r. new_audioAlarm.new_audiosD ?!"BC Cww!    (G$  IIZ-F-F'&/F  $$X6 r1cLV^8dQhRRRRRRRRRR R R R R RRRRRRRRRRRR/ #)r)rar+r\r8rsrZz#Sequence[vCalAddress] | vCalAddress attachmentszSequence[str] | str | NonerUrlrRrmrbrcr]r r`r r^r_r[rr*rr,)r-s"r.r/r0[siiii& i 7 i 0 i#ii$i!i+i'i'i ir1c  \V\4'dV.p\V\4'dV.pV'g \R4hV'g \R4hVf \R4hV'g \R4hVPVVVVV V V V R7p V P RR4W=nV'dVFpV P RV4K V P Wg4V #) a Create a new EMAIL alarm that sends an email notification. An EMAIL alarm sends an email to each address in ``attendees`` when the alarm fires. Conforms to :rfc:`5545#section-3.6.6`. Parameters: attendees: Required. One or more recipient addresses as :class:`~icalendar.prop.cal_address.vCalAddress` instances. A single address or a sequence of addresses. At least one is required. description: Required. Body of the email. Corresponds to the :attr:`description` property. summary: Required. Subject line of the email. Corresponds to the :attr:`summary` property. trigger: Required. When the alarm fires, as a :class:`~datetime.timedelta` relative to the event start (negative means before) or as an absolute :class:`~datetime.datetime` (recommend UTC-aware). attachments: Optional URI or sequence of URIs to attach to the email. concepts: The :attr:`~icalendar.cal.component.Component.concepts` of the alarm. duration: Gap between repeated triggers. Must be paired with ``repeat``. Corresponds to the :attr:`DURATION` property. links: The :attr:`~icalendar.cal.component.Component.links` of the alarm. refids: The :attr:`~icalendar.cal.component.Component.refids` of the alarm. related_to: The :attr:`~icalendar.cal.component.Component.related_to` of the alarm. repeat: Number of *additional* times to fire after the initial trigger. Must be paired with ``duration``. Corresponds to the :attr:`REPEAT` property. uid: Unique identifier for the alarm or ``None``. Returns: :class:`Alarm` with ``ACTION:EMAIL`` set. Raises: ~icalendar.error.InvalidCalendar: If required fields are missing, ``attendees`` is empty, or ``duration`` and ``repeat`` are not both provided together. Example: Create an email alarm sent to two recipients: .. code-block:: pycon >>> from datetime import timedelta >>> from icalendar import Alarm, vCalAddress >>> alarm = Alarm.new_email( ... summary="Meeting reminder", ... description="Your meeting starts in 30 minutes.", ... trigger=timedelta(minutes=-30), ... attendees=[vCalAddress("mailto:user@example.com")], ... ) >>> print(alarm.to_ical().decode()) BEGIN:VALARM ACTION:EMAIL ATTENDEE:mailto:user@example.com DESCRIPTION:Your meeting starts in 30 minutes. SUMMARY:Meeting reminder TRIGGER:-PT30M END:VALARM zEMAIL alarm requires a summaryz"EMAIL alarm requires a descriptionzEMAIL alarm requires a triggerz*EMAIL alarm requires at least one attendee)rar\rbrZr]r`r^r[r!EMAILr|)rNr+rrfrTr"rp)rgrar\r8rZrrUrRrbr]r`r^r[rh attachments&&&&&&&&&&&&& r. new_emailAlarm.new_emailZs\ i % %" I k3 ' '&-K!"BC C!"FG G ?!"BC C!"NO Oww#!    (G$ )  (J/* $$X6 r1c V^8dQhRRRR/#)r)namer+r*rr,)r-s"r.r/r0s::3:u:r1c 8VP\RV44#)z-Return the alarm example with the given name.alarms) from_icalr)rgrs&&r.example Alarm.examples}}[4899r1rPr#)r!r") r! DESCRIPTIONSUMMARYr"rPr#r$ PROXIMITYr%)r)rATTENDEE)rr|z RELATED-TO)NNNNNNNN)NNNNNNN)r)1rDrErFrGrHrrequired singletons inclusivemultiplerr#propertyrrrrPrr%r rrr"r9setterrrKrWrrRrr!rrbrrar r\r rZ classmethodrfrprvr~rrrJ __classcell__)ris@r.rr&s2 DH J I4H  # HO(FT "HH' L>% 9Ht#'  -G^66.** ": ") ) VF # F !  ./ C G&K"I---^ !]]~QQfiiV::r1r)*rH __future__rrrrtypingrricalendar.attrrr r r r r rrrrrrrrricalendar.cal.componentricalendar.cal.examplesricalendar.errorricalendar.prop.binaryruuidcollections.abcricalendar.compatibilityricalendar.proprr__all__r,r1r.rsb#"..,"..+)(,*c :Ic :L )r1