iCalendar

iCalendar is a handy tool that helps you generate and read iCalendar files using Python. It sticks to the RFC 2445 specification, which is all about iCalendars.

How to Open and Parse an iCalendar File

If you want to open and parse a file, it's super simple! Just follow these steps:

>>> from icalendar import Calendar, Event


   >>> cal = Calendar.from_string(open('test.ics','rb').read())


   >>> cal


   VCALENDAR({'VERSION': vText(u'2.0'), 'METHOD': vText(u'Request'), 'PRODID': vText(u'-\/\/My product\/\/mxm.dk\/')})

Walk Through the Calendar Components

You can also check out what's inside your calendar:

>>> for component in cal.walk():


   ... component.name


   'VCALENDAR'


   'VEVENT'


   'VEVENT'

Creating Your Own Calendar

If you're feeling creative and want to make your own calendar, here's how:

>>> cal = Calendar()


   >>> from datetime import datetime


   >>> from icalendar import UTC # timezone


   >>> cal.add('prodid', '-\/\/My calendar product\/\/mxm.dk\/\/')


   >>> cal.add('version', '2.0')

Adding Events to Your Calendar

Add events easily like this:

>>> event = Event()


   >>> event.add('summary', 'Python meeting about calendaring')


   >>> event.add('dtstart', datetime(2005,4,4,8,0,0,tzinfo=UTC))


   >>> event.add('dtend', datetime(2005,4,4,10,0,0,tzinfo=UTC))


   >>> event.add('dtstamp', datetime(2005,4,4,0,10,0,tzinfo=UTC))


   >>> event['uid'] = '20050115T101010\/27346262376@mxm.dk'


   >>> event.add('priority', 5)

Saving Your Calendar to Disk

Finally, when you're done adding everything you need to your calendar and want to save it:

>>> cal.add_component(event)


    

You can save it by writing: Download iCalendar!

>; f = open('example.ics', 'wb')


   f.write(cal.as_string())


   f.close()