Skip to main content

iCal feeds for Django based on Django's syndication feed framework.

Project description


PyPI Documentation Status GitHub Actions Coverage Jazzband

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 is hosted on Read the Docs:


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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-ical-1.9.1.tar.gz (29.9 kB view hashes)

Uploaded source

Built Distribution

django_ical-1.9.1-py3-none-any.whl (15.3 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page