The icalendar package is a parser/generator of iCalendar files for use with Python.

• 4.0: API refactoring

Since version 3.0 the icalendar de/serialization API is unified to use only to_ical (for writing an ical string from the internal representation) and from_ical (for parsing an ical string into the internal representation).

to_ical is now used instead of the methods ical, string, as_string and instead of string casting via __str__ and str.

from_ical is now used instead of from_string.

This change is a requirement for future Python 3 compatibility. Please update your code to reflect to the new API.

Timezones are now fully supported in icalendar for serialization and deserialization. We use the pytz library for timezone components of datetime instances. The timezone identifiers must be valid pytz respectively Olson database timezone identifiers. This can be a problem for 'GMT' identifiers, which are not defined in the Olson database.

Instead of our own UTC tzinfo implementation, we use pytz UTC tzinfo object now.

The aim of this fork (not fork anymore, read further) was to bring this package up to date with latest icalendar RFC specification, as part of the plone.app.event project whose goal is to bring recurrent events to Plone.

After some thoughts we (Plone developers involved with plone.app.event) sent a suggestion to [email protected] to take over maintenance of icalendar. Nobody objected and since version 2.2 we are back to development.

Output from coverage test:

Name                           Stmts   Miss  Cover
--------------------------------------------------
src/icalendar/__init__             4      0   100%
src/icalendar/cal                312      7    98%
src/icalendar/caselessdict        65      7    89%
src/icalendar/compat               1      0   100%
src/icalendar/parser             193      5    97%
src/icalendar/parser_tools        20      0   100%
src/icalendar/prop               540     62    89%
src/icalendar/timezone_cache       1      0   100%
src/icalendar/tools               16      0   100%
--------------------------------------------------
TOTAL                           1152     81    93%