Skip to main content

iCalendar parser/generator

Project description

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

Mailing list:
Dependencies:There are no other dependencies.
Tested with:Python 2.4 - 2.7

About this fork which is not a fork anymore

Aim of this fork was to bring this package up to date with latest icalendar RFC specification as part of project which goal is to bring recurrent evens to Plone.

After some thoughts we (Plone developers involved with send a suggestion to to take over mainaining of icalendar. Nobody object and since version 2.2 we are back to development.


2.2 (2011-08-24)

2.1 (2009-12-14)

  • Fix deprecation warnings about object.__init__ taking no parameters.
  • Set the VALUE parameter correctly for date values.
  • Long binary data would be base64 encoded with newlines, which made the iCalendar files incorrect. (This still needs testing).
  • Correctly handle content lines which include newlines.

2.0.1 (2008-07-11)

  • Made the tests run under Python 2.5+
  • Renamed the UTC class to Utc, so it would not clash with the UTC object, since that rendered the UTC object unpicklable.

2.0 (2008-07-11)

  • EXDATE and RDATE now returns a vDDDLists object, which contains a list of vDDDTypes objects. This is do that EXDATE and RDATE can contain lists of dates, as per RFC.

    *Note!*: This change is incompatible with earlier behavior, so if you handle EXDATE and RDATE you will need to update your code.

  • When createing a vDuration of -5 hours (which in itself is nonsensical), the ical output of that was -P1DT19H, which is correct, but ugly. Now it’s ‘-PT5H’, which is prettier.

1.2 (2006-11-25)

  • Fixed a string index out of range error in the new folding code.

1.1 (2006-11-23)

  • Fixed a bug in caselessdicts popitem. (thanks to Michael Smith <>)
  • The RFC 2445 was a bit unclear on how to handle line folding when it happened to be in the middle of a UTF-8 character. This has been clarified in the following discussion: And this is now implemented in iCalendar. It will not fold in the middle of a UTF-8 character, but may fold in the middle of a UTF-8 composing character sequence.

1.0 (2006-08-03)

  • make get_inline and set_inline support non ascii codes.
  • Added support for creating a python egg distribution.

0.11 (2005-11-08)

  • Changed component .from_string to use types_factory instead of hardcoding entries to ‘inline’
  • Changed UTC tzinfo to a singleton so the same one is used everywhere
  • Made the parser more strict by using regular expressions for key name, param name and quoted/unquoted safe char as per the RFC
  • Added some tests from the schooltool icalendar parser for better coverage
  • Be more forgiving on the regex for folding lines
  • Allow for multiple top-level components on .from_string
  • Fix vWeekdays, wasn’t accepting relative param (eg: -3SA vs -SA)
  • vDDDTypes didn’t accept negative period (eg: -P30M)
  • ‘N’ is also acceptable as newline on content lines, per RFC

0.10 (2005-04-28)

  • moved code to subversion.

  • reorganized package structure so that source code is under ‘src’ directory. Non-package files remain in distribution root.

  • redid doc/.py files as doc/.txt, using more modern doctest. Before they were .py files with big docstrings.

  • added testrunner, and tests/ that picks up all doctests in source code and doc directory, and runs them, when typing:

  • renamed iCalendar to lower case package name, lowercased, de-pluralized and shorted module names, which are mostly implementation detail.

  • changed tests so they generate .ics files in a temp directory, not in the structure itself.

Project details

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page