recurring-ical-events

What it is and what it does

This package solves the complexity of iCalendar recurrence by taking raw RFC 5545 calendar data and expanding recurring events, todos, journals, and alarms into their individual occurrences. It handles the full lifecycle: repetitions defined by RRULE, removals via EXDATE, and later edits to specific instances. You pass it a Calendar object from the icalendar library and query for events at a specific date or date range; it returns the expanded list of actual occurrences.

The package wraps six runtime dependencies—icalendar for parsing, python-dateutil for date math, tzdata and x-wr-timezone for timezone handling, typing-extensions for type hints, and backports-zoneinfo for older Python versions. It supports Python 3.8 through 3.14 and is actively maintained. There are no known security vulnerabilities.

Use it for:

• Expand a calendar feed to show all occurrences of a weekly meeting over the next month.
• Retrieve all instances of a recurring todo item to display in a task list.
• Build a scheduling UI that needs to show individual alarm times for a repeating event series.
• Export calendar data to a format that requires flat event lists instead of recurrence rules.
• Query a calendar for all events on a specific date, including those from recurring series.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Expands recurring iCalendar events (RFC 5545) into individual occurrences, handling repetitions, removals, and edits across events, todos, journals, and alarms.

Yes. The package is production-stable, actively maintained, has no known vulnerabilities, and solves a genuine RFC 5545 complexity that most calendar applications need. The LGPL-3.0-or-later license is permissive for most use cases (including proprietary software that doesn't modify the library itself). Install it if you work with iCalendar data and need to expand recurrence rules.

Install

recurring-ical-events on PyPI

pip install recurring-ical-events

uv add recurring-ical-events

poetry add recurring-ical-events

Installing recurring-ical-events

Before you install

Low friction: pure Python wheel, active maintenance (last commit 2026-07-20), production-stable status. Six runtime dependencies are all well-established calendar/timezone libraries.

License in practice

LGPL-3.0-or-later (copyleft): you may use this package freely, but any modifications you distribute must be released under the same or compatible license, and you must disclose the source.

Quickstart

pip install recurring-ical-events

import recurring_ical_events
from icalendar import Calendar

cal = Calendar.from_ics(ics_string)
events = recurring_ical_events.of(cal).at("2026-08-14")

Requires Python 3.8 or later; depends on icalendar and python-dateutil being installed.

Verify before relying

• Whether the package handles edge cases in RFC 5545 recurrence rules (RRULE) comprehensively or has known limitations.
• Performance characteristics when expanding events with complex recurrence patterns or very long time ranges.

Package facts

Evidence: recurring_ical_events-3.8.2-py3-none-any.whl

Keywords: alarm, calendar, events, icalendar, ics, journal, rfc5545, scheduling, todo

Tags

More Python Modules packages