ics-query 0.4.35__py3-none-any.whl → 0.4.37__py3-none-any.whl

ics_query/_version.py

@@ -17,5 +17,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '0.4.35'
-__version_tuple__ = version_tuple = (0, 4, 35)
+__version__ = version = '0.4.37'
+__version_tuple__ = version_tuple = (0, 4, 37)

ics_query/cli.py

@@ -402,12 +402,25 @@ def cli():
     Components
     ----------
 
-    We support different types of recurring components: VEVENT, VTODO, VJOURNAL.
+    We support different types of recurring components:
+    VEVENT, VTODO, VJOURNAL, VALARM
     You can specify which can be in the result using the --component parameter.
 
-    You can also set the environment variable ICS_QUERY_COMPONENT to the timezone
+    You can also set the environment variable ICS_QUERY_COMPONENT to the component
     instead of passing --component.
 
+    For VALARM, please consider the following:
+
+    (1) If you query a time span, the component might actually happen outside of
+    the time span but the alarm happens within the time span.
+
+    (2) Absolute alarms may only be included once and not for every occurrence.
+
+    (3) Each resulting occurrence only has one alarm in them.
+
+    (4) Do not mix `-c VEVENT` and others with `-c VALARM` or you might not know if the
+    alarm or the component is inside the time span.
+
     """  # noqa: D301
 
 

ics_query/tests/runs/all -c VALARM alarm_1_week_before_event.ics -.run

@@ -0,0 +1,40 @@
+BEGIN:VEVENT
+SUMMARY:Event with an alarm 1 week before this starts
+DTSTART;TZID=Europe/London:20241209T110000
+DTEND;TZID=Europe/London:20241209T120000
+DTSTAMP:20241002T120908Z
+UID:a26289e0-8739-488b-b706-77c9364193c1
+RECURRENCE-ID;TZID=Europe/London:20241209T110000
+CREATED:20241002T120758Z
+DESCRIPTION:Event
+LAST-MODIFIED:20241002T120908Z
+TRANSP:OPAQUE
+X-MOZ-GENERATION:4
+X-MOZ-LASTACK:20241002T120844Z
+BEGIN:VALARM
+ACTION:DISPLAY
+DESCRIPTION:Alarm One Week Before
+REPEAT:0
+TRIGGER;TZID=Europe/London:20241202T110000
+END:VALARM
+END:VEVENT
+BEGIN:VEVENT
+SUMMARY:Event with an alarm 1 week before this starts
+DTSTART;TZID=Europe/London:20241209T110000
+DTEND;TZID=Europe/London:20241209T120000
+DTSTAMP:20241002T120908Z
+UID:a26289e0-8739-488b-b706-77c9364193c1
+RECURRENCE-ID;TZID=Europe/London:20241209T110000
+CREATED:20241002T120758Z
+DESCRIPTION:Event
+LAST-MODIFIED:20241002T120908Z
+TRANSP:OPAQUE
+X-MOZ-GENERATION:4
+X-MOZ-LASTACK:20241002T120844Z
+BEGIN:VALARM
+ACTION:DISPLAY
+DESCRIPTION:Alarm Two Days Before
+REPEAT:0
+TRIGGER;TZID=Europe/London:20241207T110000
+END:VALARM
+END:VEVENT

ics_query/tests/runs/calendars/alarm_1_week_before_event.ics

@@ -0,0 +1,626 @@
+BEGIN:VCALENDAR
+PRODID:-//Mozilla.org/NONSGML Mozilla Calendar V1.1//EN
+VERSION:2.0
+BEGIN:VTIMEZONE
+TZID:Europe/London
+X-TZINFO:Europe/London[2024a]
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:-000115
+TZNAME:Europe/London(STD)
+DTSTART:18471201T000000
+RDATE:18471201T000000
+END:STANDARD
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19160521T020000
+RDATE:19160521T020000
+END:DAYLIGHT
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(STD)
+DTSTART:19161001T030000
+RDATE:19161001T030000
+END:STANDARD
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19170408T020000
+RDATE:19170408T020000
+END:DAYLIGHT
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(STD)
+DTSTART:19170917T030000
+RDATE:19170917T030000
+END:STANDARD
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19180324T020000
+RDATE:19180324T020000
+END:DAYLIGHT
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(STD)
+DTSTART:19180930T030000
+RRULE:FREQ=YEARLY;BYMONTH=9;BYDAY=-1MO;UNTIL=19190929T030000
+END:STANDARD
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19190330T020000
+RRULE:FREQ=YEARLY;BYMONTH=3;BYDAY=-1SU;UNTIL=19200328T020000
+END:DAYLIGHT
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(STD)
+DTSTART:19201025T030000
+RDATE:19201025T030000
+END:STANDARD
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19210403T020000
+RDATE:19210403T020000
+END:DAYLIGHT
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(STD)
+DTSTART:19211003T030000
+RDATE:19211003T030000
+END:STANDARD
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19220326T020000
+RDATE:19220326T020000
+END:DAYLIGHT
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(STD)
+DTSTART:19221008T030000
+RDATE:19221008T030000
+END:STANDARD
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19230422T020000
+RDATE:19230422T020000
+END:DAYLIGHT
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19240413T020000
+RDATE:19240413T020000
+END:DAYLIGHT
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(STD)
+DTSTART:19230916T030000
+RRULE:FREQ=YEARLY;BYMONTH=9;BYDAY=3SU;UNTIL=19240921T030000
+END:STANDARD
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19250419T020000
+RRULE:FREQ=YEARLY;BYMONTH=4;BYDAY=3SU;UNTIL=19260418T020000
+END:DAYLIGHT
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19270410T020000
+RDATE:19270410T020000
+END:DAYLIGHT
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19280422T020000
+RDATE:19280422T020000
+END:DAYLIGHT
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19290421T020000
+RDATE:19290421T020000
+END:DAYLIGHT
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19300413T020000
+RDATE:19300413T020000
+END:DAYLIGHT
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19310419T020000
+RRULE:FREQ=YEARLY;BYMONTH=4;BYDAY=3SU;UNTIL=19320417T020000
+END:DAYLIGHT
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(STD)
+DTSTART:19251004T030000
+RRULE:FREQ=YEARLY;BYMONTH=10;BYDAY=1SU;UNTIL=19321002T030000
+END:STANDARD
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19330409T020000
+RDATE:19330409T020000
+END:DAYLIGHT
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(STD)
+DTSTART:19331008T030000
+RDATE:19331008T030000
+END:STANDARD
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19340422T020000
+RDATE:19340422T020000
+END:DAYLIGHT
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19350414T020000
+RDATE:19350414T020000
+END:DAYLIGHT
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19360419T020000
+RRULE:FREQ=YEARLY;BYMONTH=4;BYDAY=3SU;UNTIL=19370418T020000
+END:DAYLIGHT
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19380410T020000
+RDATE:19380410T020000
+END:DAYLIGHT
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(STD)
+DTSTART:19341007T030000
+RRULE:FREQ=YEARLY;BYMONTH=10;BYDAY=1SU;UNTIL=19381002T030000
+END:STANDARD
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19390416T020000
+RDATE:19390416T020000
+END:DAYLIGHT
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19400225T020000
+RDATE:19400225T020000
+END:DAYLIGHT
+BEGIN:DAYLIGHT
+TZOFFSETTO:+020000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(DST)
+DTSTART:19410504T020000
+RDATE:19410504T020000
+END:DAYLIGHT
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+020000
+TZNAME:Europe/London(DST)
+DTSTART:19410810T030000
+RDATE:19410810T030000
+END:DAYLIGHT
+BEGIN:DAYLIGHT
+TZOFFSETTO:+020000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(DST)
+DTSTART:19420405T020000
+RDATE:19420405T020000
+END:DAYLIGHT
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+020000
+TZNAME:Europe/London(DST)
+DTSTART:19420809T030000
+RDATE:19420809T030000
+END:DAYLIGHT
+BEGIN:DAYLIGHT
+TZOFFSETTO:+020000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(DST)
+DTSTART:19430404T020000
+RDATE:19430404T020000
+END:DAYLIGHT
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+020000
+TZNAME:Europe/London(DST)
+DTSTART:19430815T030000
+RDATE:19430815T030000
+END:DAYLIGHT
+BEGIN:DAYLIGHT
+TZOFFSETTO:+020000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(DST)
+DTSTART:19440402T020000
+RDATE:19440402T020000
+END:DAYLIGHT
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+020000
+TZNAME:Europe/London(DST)
+DTSTART:19440917T030000
+RDATE:19440917T030000
+END:DAYLIGHT
+BEGIN:DAYLIGHT
+TZOFFSETTO:+020000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(DST)
+DTSTART:19450402T020000
+RDATE:19450402T020000
+END:DAYLIGHT
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(STD)
+DTSTART:19391119T030000
+RDATE:19391119T030000
+END:STANDARD
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+020000
+TZNAME:Europe/London(DST)
+DTSTART:19450715T030000
+RDATE:19450715T030000
+END:DAYLIGHT
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19460414T020000
+RDATE:19460414T020000
+END:DAYLIGHT
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19470316T020000
+RDATE:19470316T020000
+END:DAYLIGHT
+BEGIN:DAYLIGHT
+TZOFFSETTO:+020000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(DST)
+DTSTART:19470413T020000
+RDATE:19470413T020000
+END:DAYLIGHT
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(STD)
+DTSTART:19451007T030000
+RRULE:FREQ=YEARLY;BYMONTH=10;BYDAY=1SU;UNTIL=19461006T030000
+END:STANDARD
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+020000
+TZNAME:Europe/London(DST)
+DTSTART:19470810T030000
+RDATE:19470810T030000
+END:DAYLIGHT
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(STD)
+DTSTART:19471102T030000
+RDATE:19471102T030000
+END:STANDARD
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19480314T020000
+RDATE:19480314T020000
+END:DAYLIGHT
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19490403T020000
+RDATE:19490403T020000
+END:DAYLIGHT
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(STD)
+DTSTART:19481031T030000
+RRULE:FREQ=YEARLY;BYMONTH=10;BYDAY=-1SU;UNTIL=19491030T030000
+END:STANDARD
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(STD)
+DTSTART:19501022T030000
+RDATE:19501022T030000
+END:STANDARD
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(STD)
+DTSTART:19511021T030000
+RDATE:19511021T030000
+END:STANDARD
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(STD)
+DTSTART:19521026T030000
+RDATE:19521026T030000
+END:STANDARD
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19500416T020000
+RRULE:FREQ=YEARLY;BYMONTH=4;BYDAY=3SU;UNTIL=19530419T020000
+END:DAYLIGHT
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19540411T020000
+RDATE:19540411T020000
+END:DAYLIGHT
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19550417T020000
+RDATE:19550417T020000
+END:DAYLIGHT
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19560422T020000
+RDATE:19560422T020000
+END:DAYLIGHT
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19570414T020000
+RDATE:19570414T020000
+END:DAYLIGHT
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19580420T020000
+RRULE:FREQ=YEARLY;BYMONTH=4;BYDAY=3SU;UNTIL=19590419T020000
+END:DAYLIGHT
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19600410T020000
+RDATE:19600410T020000
+END:DAYLIGHT
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(STD)
+DTSTART:19531004T030000
+RRULE:FREQ=YEARLY;BYMONTH=10;BYDAY=1SU;UNTIL=19601002T030000
+END:STANDARD
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19610326T020000
+RRULE:FREQ=YEARLY;BYMONTH=3;BYDAY=-1SU;UNTIL=19630331T020000
+END:DAYLIGHT
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19640322T020000
+RDATE:19640322T020000
+END:DAYLIGHT
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(STD)
+DTSTART:19611029T030000
+RRULE:FREQ=YEARLY;BYMONTH=10;BYDAY=-1SU;UNTIL=19641025T030000
+END:STANDARD
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(STD)
+DTSTART:19651024T030000
+RRULE:FREQ=YEARLY;BYMONTH=10;BYDAY=4SU;UNTIL=19661023T030000
+END:STANDARD
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19650321T020000
+RRULE:FREQ=YEARLY;BYMONTH=3;BYDAY=3SU;UNTIL=19670319T020000
+END:DAYLIGHT
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(STD)
+DTSTART:19671029T030000
+RDATE:19671029T030000
+END:STANDARD
+BEGIN:STANDARD
+TZOFFSETTO:+010000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(STD)
+DTSTART:19681027T000000
+RDATE:19681027T000000
+END:STANDARD
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19680218T020000
+RDATE:19680218T020000
+END:DAYLIGHT
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(STD)
+DTSTART:19711031T030000
+RRULE:FREQ=YEARLY;BYMONTH=10;BYDAY=-1SU;UNTIL=19751026T030000
+END:STANDARD
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(STD)
+DTSTART:19761024T030000
+RRULE:FREQ=YEARLY;BYMONTH=10;BYDAY=4SU;UNTIL=19771023T030000
+END:STANDARD
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19720319T020000
+RRULE:FREQ=YEARLY;BYMONTH=3;BYDAY=3SU;UNTIL=19800316T020000
+END:DAYLIGHT
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(STD)
+DTSTART:19781029T030000
+RRULE:FREQ=YEARLY;BYMONTH=10;BYDAY=-1SU;UNTIL=19801026T030000
+END:STANDARD
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(STD)
+DTSTART:19811025T020000
+RDATE:19811025T020000
+END:STANDARD
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(STD)
+DTSTART:19821024T020000
+RRULE:FREQ=YEARLY;BYMONTH=10;BYDAY=4SU;UNTIL=19831023T020000
+END:STANDARD
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(STD)
+DTSTART:19841028T020000
+RRULE:FREQ=YEARLY;BYMONTH=10;BYDAY=-1SU;UNTIL=19871025T020000
+END:STANDARD
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(STD)
+DTSTART:19881023T020000
+RDATE:19881023T020000
+END:STANDARD
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(STD)
+DTSTART:19891029T020000
+RRULE:FREQ=YEARLY;BYMONTH=10;BYDAY=-1SU;UNTIL=19921025T020000
+END:STANDARD
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(STD)
+DTSTART:19931024T020000
+RRULE:FREQ=YEARLY;BYMONTH=10;BYDAY=4SU;UNTIL=19951022T020000
+END:STANDARD
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:Europe/London(DST)
+DTSTART:19810329T010000
+RRULE:FREQ=YEARLY;BYMONTH=3;BYDAY=-1SU;UNTIL=19960331T010000
+END:DAYLIGHT
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:+010000
+TZNAME:Europe/London(STD)
+DTSTART:19961027T020000
+RDATE:19961027T020000
+END:STANDARD
+BEGIN:DAYLIGHT
+TZOFFSETTO:+010000
+TZOFFSETFROM:+000000
+TZNAME:(DST)
+DTSTART:19970330T010000
+RRULE:FREQ=YEARLY;BYMONTH=3;BYDAY=-1SU
+END:DAYLIGHT
+BEGIN:STANDARD
+TZOFFSETTO:+000000
+TZOFFSETFROM:+010000
+TZNAME:(STD)
+DTSTART:19971026T020000
+RRULE:FREQ=YEARLY;BYMONTH=10;BYDAY=-1SU
+END:STANDARD
+END:VTIMEZONE
+BEGIN:VEVENT
+CREATED:20241002T120758Z
+LAST-MODIFIED:20241002T120908Z
+DTSTAMP:20241002T120908Z
+UID:a26289e0-8739-488b-b706-77c9364193c1
+SUMMARY:Event with an alarm 1 week before this starts
+X-MOZ-LASTACK:20241002T120844Z
+DTSTART;TZID=Europe/London:20241209T110000
+DTEND;TZID=Europe/London:20241209T120000
+TRANSP:OPAQUE
+X-MOZ-GENERATION:4
+DESCRIPTION:Event
+BEGIN:VALARM
+ACTION:DISPLAY
+TRIGGER:-P1W
+DESCRIPTION:Alarm One Week Before
+END:VALARM
+BEGIN:VALARM
+ACTION:DISPLAY
+TRIGGER:-P2D
+DESCRIPTION:Alarm Two Days Before
+END:VALARM
+END:VEVENT
+END:VCALENDAR

{ics_query-0.4.35.dist-info → ics_query-0.4.37.dist-info}/METADATA

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: ics-query
-Version: 0.4.35
+Version: 0.4.37
 Summary: Find out what happens in ICS calendar files - query and filter RFC 5545 compatible .ics files for events, journals, TODOs and more.
 Project-URL: Homepage, https://github.com/niccokunzmann/ics-query/
 Project-URL: Repository, https://github.com/niccokunzmann/ics-query/
-Project-URL: source_archive, https://github.com/niccokunzmann/ics-query/archive/79b42f339dba9778a8e3cb2b872af925ee3be43d.zip
+Project-URL: source_archive, https://github.com/niccokunzmann/ics-query/archive/7d5b884b37e6e821e8b473c7ac1e5cfd2e59f811.zip
 Project-URL: Issues, https://github.com/niccokunzmann/ics-query/issues
 Project-URL: Documentation, https://github.com/niccokunzmann/ics-query/
 Project-URL: Changelog, https://github.com/niccokunzmann/ics-query/#changelog
@@ -694,6 +694,7 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Office/Business :: Scheduling
 Requires-Python: >=3.9
 Requires-Dist: click==8.1.8
@@ -971,6 +972,7 @@ You can specify which components you would like to get using the
 -c VEVENT   # only events
 -c VTODO    # only TODOs
 -c VJOURNAL # only journal entries
+-c VALARM   # only components with the calculated alarm
 -c VEVENT -c VTODO # only events and journal entries
 ```
 
@@ -994,6 +996,30 @@ Please see the command documentation for more help:
 ics-query --help
 ```
 
+### Alarms
+
+Alarms are special because they do not occur alone.
+They are located inside another component like a VEVENT or VTODO.
+
+Considerations:
+
+- If you query a time span, the component might actually happen outside of the time span
+  but the alarm happens within the timespan.
+- Absolute alarms may only be included once and not for every occurrence.
+- Each resulting occurrence only has one alarm in them.
+- Do not mix `-c VEVENT` and others with `-c VALARM` or you might not know if
+  the alarm or the component is inside the time span.
+
+As an example, if you want to get all alarms and the event summary that they are for,
+you would be interested in the `SUMMARY` of the event and the `TRIGGER` of the alarm.
+
+```sh
+$ ics-query all -c VALARM --tz Europe/London alarm_1_week_before_event.ics - | grep -E 'TRIGGER|SUMMARY'
+SUMMARY:Event with an alarm 1 week before this starts        <-- Event summary
+TRIGGER;TZID=Europe/London:20241202T110000                   <-- Time of the alarm
+SUMMARY:Event with an alarm 1 week before this starts        <-- Event summary
+TRIGGER;TZID=Europe/London:20241207T110000                   <-- Time of the alarm
+```
 
 ### Timezones
 
@@ -1136,6 +1162,14 @@ We automatically release the versions that only update dependencies.
 If the version you installed does not show up here, only the dependencies
 have been updated.
 
+- v0.4.37
+
+  - Test and support Python 3.13. See [Issue 9](https://github.com/niccokunzmann/ics-query/issues/9).
+
+- v0.4.36
+
+  - Test and document `VALARM`. See [Issue 16](https://github.com/niccokunzmann/ics-query/issues/16).
+
 - v0.4.33
 
   - Add `--as-calendar` parameter.

{ics_query-0.4.35.dist-info → ics_query-0.4.37.dist-info}/RECORD

@@ -1,7 +1,7 @@
 ics_query/__init__.py,sha256=BBd-FYDFf3jY_ApkMRkivqGti2uMeP4OT6KtgZDixic,917
 ics_query/__main__.py,sha256=1rFDbZZcd6llmQ-X_611jWdrua4HMOnpOclKRvf03Us,737
-ics_query/_version.py,sha256=Q6oE2ySfgQ7xfFILumnlWHR-RGZwtV1Rh5ScIWhJiIw,513
-ics_query/cli.py,sha256=sXk2iQD2qCQ4kHfWmEjXzrtHfk2Jmrsi9FwXDNg_E68,22774
+ics_query/_version.py,sha256=yXYDiJxAOhEjnXY-OlqzC1M1BbntF4LeyKyPfnneQ-E,513
+ics_query/cli.py,sha256=91VZOreaP42YKN7zQG_0S8SlSZuBOsA8pK9PAQpColk,23263
 ics_query/parse.py,sha256=AO2TBoe98exzfzTKsoF5ZAvJOg3hN2qRpP15DAQKZaM,2415
 ics_query/query.py,sha256=9HSSWJ1y7avU6mRDXBQKKTkk9oeG9qEwhr3k0piHbaU,2692
 ics_query/version.py,sha256=ByXlZC-vAOZfkpZfh05KiLVnOH8IcSrQzylVZmjcnpA,1518
@@ -12,6 +12,7 @@ ics_query/tests/test_issue_40_valid_calendar.py,sha256=tRC9s4MN_0uMuVwzkjpVWxfgw
 ics_query/tests/test_parse_date.py,sha256=EGD06AtO_kNDcYEY7vhI9rN45HiZPbRm2LkGZoVW6iw,2785
 ics_query/tests/test_parse_timedelta.py,sha256=EpM013rw-G61wI0hyWjtFOtE7xXo2DNsU3vSIULGZ1k,1469
 ics_query/tests/runs/all --tz Singapore one-event.ics -.run,sha256=0eX6yRqVK1b_ZEwrDy1AM3O69UHhpV35da6DjpGqBn4,263
+ics_query/tests/runs/all -c VALARM alarm_1_week_before_event.ics -.run,sha256=tzfSJiJrcG-w5v7td6e6H5FRyM-nNzYc1sIpphQ3uEY,1080
 ics_query/tests/runs/all three-events.ics -.run,sha256=p47kuGwMvx748zP5viAhWzRP7jPKw5DKC8MCejzIDgg,915
 ics_query/tests/runs/at 2014-05-03 x-wr-timezone-rdate-hackerpublicradio.ics -.run,sha256=-XQkaf85KGgUOi4lmrD_cYfHs1J7BXQ231NGNIpE_xI,330
 ics_query/tests/runs/at 2019-03-04 multiple-calendars.ics -.run,sha256=NSOHYgfKs6Cyz3P2VL3JXKctF1TH8m2BiphOAi9uJpY,580
@@ -29,6 +30,7 @@ ics_query/tests/runs/first empty-calendar.ics -.run,sha256=47DEQpj8HBSa-_TImW-5J
 ics_query/tests/runs/first empty-file.ics -.run,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 ics_query/tests/runs/first recurring-work-events.ics -.run,sha256=8fa75wHxdVtnau1R39dnaDRZKlvclRd34P1Wr8i849U,336
 ics_query/tests/runs/calendars/Berlin-Los-Angeles.ics,sha256=_FFRUurDU_q7G8d8lSvfbCy3y1XvujaclLXei6GrW5U,9107
+ics_query/tests/runs/calendars/alarm_1_week_before_event.ics,sha256=I-6zIv1nnCpt6JIdE45fL0boTq3oFic_aUb71Pp_Rak,14262
 ics_query/tests/runs/calendars/empty-calendar.ics,sha256=78162P3KYUj6Qhbdnjsm3E84jv--_--p5U0h_jovrpw,153
 ics_query/tests/runs/calendars/empty-file.ics,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 ics_query/tests/runs/calendars/multiple-calendars.ics,sha256=lS1Q9eSPpzLs2TRDKUiwF9HmpnJMw8xqjLudA0-KtY4,1516
@@ -40,8 +42,8 @@ ics_query/tests/runs/calendars/simple-journal.ics,sha256=U6_YMQM6EHwPDaszWgJDo-p
 ics_query/tests/runs/calendars/simple-todo.ics,sha256=l9uHQD4eyiCE8STvd2tj5lAVaBrqUtpF_M8Pv6yf1es,327
 ics_query/tests/runs/calendars/three-events.ics,sha256=YvPfthOzMCR0DQhGR6uj_1Bltgax3uA1ETlkI4JUI08,828
 ics_query/tests/runs/calendars/x-wr-timezone-rdate-hackerpublicradio.ics,sha256=QysB6tI9yfl4jDmaqEY2Jyv6ziu7YfKdfiK0zscd1Tw,839
-ics_query-0.4.35.dist-info/METADATA,sha256=9ZEaJEN64mpSbVv9Lt5mKImS9L92jUDZGYVE-ACdds0,55984
-ics_query-0.4.35.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-ics_query-0.4.35.dist-info/entry_points.txt,sha256=Jq_39vCKVOkNZjL7Wngf_04V_n_QRszLgLT2CbJKiH4,49
-ics_query-0.4.35.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-ics_query-0.4.35.dist-info/RECORD,,
+ics_query-0.4.37.dist-info/METADATA,sha256=mkIKJODKbwD-YWJxCAFr-kjjOUwO1uvj4EDzdgmTmIA,57476
+ics_query-0.4.37.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+ics_query-0.4.37.dist-info/entry_points.txt,sha256=Jq_39vCKVOkNZjL7Wngf_04V_n_QRszLgLT2CbJKiH4,49
+ics_query-0.4.37.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+ics_query-0.4.37.dist-info/RECORD,,