Support for alarms

[tobixen]

The processing of alarms as described in https://tools.ietf.org/html/rfc4791#section-8.6 is outside the scope of the caldav library, possibly with the exception of sending emails. Anyway, the library should support methods for alarm discovery.

Update: latest status is a bit further down

[newhinton]

will this include setting new alarms?

[tobixen]

Setting new alarms is possible through the library today. It's part of the icalendar data sent to the server, generation of this data is outside the scope of the caldav library.

[tobixen]

generation of this data is outside the scope of the caldav library.

I have reconsidered this a bit.

So, to fully support alarms, I think we may need to support ...

Adding alarms

• It's now possible to add simple alarms through parameters to the save_*-methods.
• Possibility to add simple alarms to an existing Event/Todo-object

Finding alarms

• The search-method now allows searching for alarms by a time range search
• The calendar object should have a method find_next_upcoming_alarm(after=now, before=now+15mins, cnt=1) for finding the first/next upcoming alarm(s). (it will be prioritized if anyone tells me they have a use case for it)

Processing alarms

The RFC defines four kind of alarm actions, it's sound, display, email and procedure. This library is definitively not going to play and sounds or display something for the end user. This library could theoretically send emails or launch procedures. However, since this library does not have any kind of event loop or other means of getting the timing correct, I feel that all kind of processing is out of the scope for this library and should be taken care of by the caller.

Documentation

• All this stuff should be documented, too

[tobixen]

• Adding of alarms (without having to hand-craft the icalendar data) is supported in WiP: Support for alarms #221
• Searching for events/todos based on alarm time is supported in WiP: Support for alarms #221, but not tested
• Searching for "upcoming alarms" not supported yet, procrastinating it

If anyone has a great needs for alarms, I will prioritize this and get it merged, testing it towards a calendar server that supports searching for alarms. It seems like neither radicale nor xandikos supports searching for alarms yet, and those two are my primary test servers.