Ics.py : Calendar for Humans

Release 0.8.0.dev0.

Ics.py is a pythonic iCalendar library which follows the RFC5545 specification. Its goals are to read and write ics data in a developer-friendly way.

It is written in Python 3 (version 3.6 and above) and is licensed under the Apache License.

If you do not want to deal with the complex iCalendar specification, then ics.py is for you!

First Steps

New to our ics.py library? This is the place to start!

• Quickstart
  • Conventions
  • Importing a Calendar from a URL
  • Creating a new Calendar and Add Events
  • Get event datetime object details
  • Converting to all-day event
  • Exporting a calendar to a file
  • Managing attendees
• Installing ics.py
  • Checking your Python & pip version
  • Installing with pip

Tutorials

If you search for something specific after you have read the First Steps, find it here.

• Create a ICS File with Thunderbird
• Contributing to ics.py

Examples for tutorials:

• Create your first calendar

• TBD

Details

Want to learn some details? Find here the relevant information.

• Authors
• Custom properties
• Low level API
  • Container
• Event
• Equality
• Ordering
  • Implementation
  • Comparison Caveats
  • Comparing datetimes with and without timezones
• How to ?
  • Is there a way to export to format X ?
  • ics.py does not support the property Y, i’m stuck
  • Known bugs
• About the iCalendar Format
• Known Limitations
  • Missing support for recurrent events
  • Coverage of the rfc5545 is not 100%
  • ics.py too is strict when parsing input
• vTimezone Handling
  • Do I get my tzinfo objects back?
  • Interpreting TZIDs and tzinfo objects
  • Converting to the builtin vTimezone definition

Reference

If you want to dig a bit deeper in ics.py, here is the place to go.

• API description
  • Calendar
  • Event
  • Alarms
  • Attendee
  • Timeline
• Changelog
  • 0.8 (in dev) - Grace Hopper
  • 0.7.2
  • 0.7.1
  • 0.7 - Katherine Johnson
  • 0.6 - Sophie Wilson
  • 0.5 - Adele Goldberg
  • 0.4 - Elizabeth J. Feinler
  • 0.3.1
  • 0.3
  • 0.1.3
  • 0.1.2
  • 0.1.1
  • 0.1

Indices and Tables

• Index

• Search Page