### Navigation

- index
- next |
- icalendar 3.0dev documentation »

# Internet Calendaring and Scheduling (iCalendar) for Python

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

> Homepage: | http://icalendar.readthedocs.org
> Code: | http://github.com/collective/icalendar
> Mailing list: | http://github.com/collective/icalendar/issues
> Dependencies: | setuptools and since version 3.0 we depend on pytz.
> Compatible with:
> | Python 2.6, 2.7 and 3.3+
> License: | BSD

## Roadmap

- 3.6: Python 3 support (current version)
- 4.0: API refactoring

## Changes in version 3.0

### API Change

Since version we unified to icalendar de/serialization API 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.

### Timezone support

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 the own UTC tzinfo implementation we use pytz UTC tzinfo object now.

## About this fork which is not a fork anymore

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 plone.app.event project which goal is to bring recurrent evens to Plone.

After some thoughts we (Plone developers involved with plone.app.event) send a suggestion to icalendar-dev@codespeak.net to take over mainaining of icalendar. Nobody object and since version 2.2 we are back to development.

## Test Coverage Report

Output from coverage test:

    Name                                                           Stmts   Miss  Cover
    ----------------------------------------------------------------------------------
    .tox/py27/lib/python2.7/site-packages/icalendar/__init__           5      0   100%
    .tox/py27/lib/python2.7/site-packages/icalendar/cal              234      7    97%
    .tox/py27/lib/python2.7/site-packages/icalendar/caselessdict      55      5    91%
    .tox/py27/lib/python2.7/site-packages/icalendar/compat             1      0   100%
    .tox/py27/lib/python2.7/site-packages/icalendar/parser           189      6    97%
    .tox/py27/lib/python2.7/site-packages/icalendar/parser_tools      20      0   100%
    .tox/py27/lib/python2.7/site-packages/icalendar/prop             533     62    88%
    .tox/py27/lib/python2.7/site-packages/icalendar/tools             16      0   100%
    ----------------------------------------------------------------------------------
    TOTAL                                                           1053     80    92%

## Contents

- About
- Installing iCalendar
- iCalendar package
  - File structure
  - Overview
  - Components
  - Subcomponents
  - Value types
  - Property parameters
  - Example
- More documentation
- Changelog
  - 3.6.1 (2014-01-13)
  - 3.6 (2014-01-06)
  - 3.5 (2013-07-03)
  - 3.4 (2013-04-24)
  - 3.3 (2013-02-08)
  - 3.2 (2012-11-27)
  - 3.1 (2012-09-05)
  - 3.0.1b2 (2012-03-01)
  - 3.0.1b1 (2012-02-24)
  - 3.0
  - 2.2 (2011-08-24)
  - 2.1 (2009-12-14)
  - 2.0.1 (2008-07-11)
  - 2.0 (2008-07-11)
  - 1.2 (2006-11-25)
  - 1.1 (2006-11-23)
  - 1.0 (2006-08-03)
  - 0.11 (2005-11-08)
  - 0.10 (2005-04-28)
- icalendar contributors
- License

### Navigation

- index
- next |
- icalendar 3.0dev documentation »