django-ical

django-ical is a simple library/framework for creating iCal feeds based in Django's syndication feed framework.

This documentation is modeled after the documentation for the syndication feed framework so you can think of it as a simple extension.

If you are familiar with the Django syndication feed framework you should be able to be able to use django-ical fairly quickly. It works the same way as the Django syndication framework but adds a few extension properties to support iCalendar feeds.

django-ical uses the icalendar library under the hood to generate iCalendar feeds.

Documentation

Documentation is hosted on Read the Docs:

Changes

1.9.2 (2023-06-12)

• Support all properties specified in RFC 5545 [magicbrothers]

1.9.1 (2023-05-01)

• Fix multiple CATEGORIES and add tests [mjfinney]

1.9.0 (2023-04-04)

• Support for iCalendar VTODO elements [wetneb]

1.8.4 (2023-04-02)

• Fix content-type charset declarations. [lchanouha]
• Update test matrix. Add Python 3.11 and Django 4.1 support. Deprecate Python 3.7 support. [aleksihakli]

1.8.3 (2022-01-25)

• Enable Python 3.10 and Django 4.0 support. [aleksihakli]

1.8.2 (2022-01-13)

• Deprecate universal Python 2 wheels. [aleksihakli]

1.8.1 (2022-01-08)

• Drop Python 3.6 support and add Python 3.10 support. [aleksihakli]

1.8.0 (2021-05-21)

• Add VALARM support and documentation. [malteger]

1.7.3 (2021-05-03)

• Fix calendar Content-Type headers. Previous configuration included multiple comma separated values in the header, which is incompatible with the HTTP header specification. [aleksihakli]

1.7.2 (2020-12-16)

• Add support for Python 3.9. [aleksihakli]
• Add support for Django 3.1. [aleksihakli]
• Add tox QA with black and prospector. [aleksihakli]
• Migrate from Travis to GitHub Actions. [aleksihakli]

1.7.1 (2020-05-09)

• Drop support for Django 1.11 LTS. [aleksihakli]
• Fix string comparison in tests. [aleksihakli]

1.7.0 (2019-10-09)

• Add calendar MIME types for feeds. [xkill]
• Add attendees for calendar events. [webaholik]

1.6.2 (2019-08-30)

• Language and documentation improvements.

1.6.1 (2019-08-30)

• Python 3.8 and PyPy support.

1.6 (2019-08-27)

• Drop support for old Python and Django versions. This enables support for new Django versions which do not have Python 2 compatibility shims.
• Add continuous delivery via Jazzband.
• Add SCM versioning via setuptools_scm.

1.5 (2018-10-10)

• Add support for Django 1.11. Thanks, Martin Bächtold
• Drop support for Python 2.6. Thanks, Martin Bächtold
• Add support for categories, rrule, exrule, rrdate, exdate. Thanks, Armin Leuprecht
• Fix a documentation typo. Thanks, Giorgos Logiotatidis
• Add documentation and testing around recurring events. Thanks, Christian Ledermann
• Remove tests for Django versions < 1.8 Thanks, Christian Ledermann

1.4 (2016-05-08)

• Django up to 1.9 is supported.
• Added new ttl parameter. Thanks, Diaz-Gutierrez
• Added support for Python 3. Thanks, Ben Lopatin
• Fixed LAST-MODIFIED support. Thanks, Brad Bell

1.3 (2014-11-26)

• Django up to 1.7 is supported.
• Added a new file_name parameter. Thanks, browniebroke
• Added support for the ORGANIZER field. Thanks, browniebroke

1.2 (2012-12-12)

• Removed support for Django 1.2. It should still work, but it's not supported.
• We now require icalendar 3.1.
• Added support for the GEO field. Thanks, null_radix!

1.1 (2012-10-26)

• Fixed issues running tests on Django 1.2 and Django 1.5.

1.0 (2012-05-06)

• Initial Release