========================================================== Internet Calendaring and Scheduling (iCalendar) for Python ==========================================================
The icalendar _ package is an :rfc:5545 compatible parser and generator of iCalendar files.
icalendar can create, inspect, and modify calendaring information with Python.
icalendar supports multiple timezone implementations, including zoneinfo _, dateutil.tz _, and pytz _.
----
:Homepage: https://icalendar.readthedocs.io/en/stable/
:Discussions: https://github.com/collective/icalendar/discussions
:Issues: https://github.com/collective/icalendar/issues
:Code: https://github.com/collective/icalendar
:Dependencies: python-dateutil _ and tzdata _.
:License: 2-Clause BSD License _
:Contribute: Contribute to icalendar _
:Funding: Open Collective _
:icalendar chat: https://matrix.to/#/%23icalendar:chat.pycal.org
:PyCal chat: https://matrix.to/#/%23pycal:chat.pycal.org
:Python Calendaring Ecosystem: https://pycal.org
----
.. image:: https://img.shields.io/pypi/v/icalendar :target: https://pypi.org/project/icalendar/ :alt: Python package version on PyPI
.. image:: https://img.shields.io/github/v/release/collective/icalendar :target: https://pypi.org/project/icalendar/#history :alt: Latest release
.. image:: https://img.shields.io/pypi/pyversions/icalendar :target: https://pypi.org/project/icalendar/ :alt: Supported Python versions
.. image:: https://static.pepy.tech/personalized-badge/icalendar?period=total&units=INTERNATIONAL_SYSTEM&left_color=GREY&right_color=GREEN&left_text=downloads :target: https://pypistats.org/packages/icalendar :alt: Downloads from PyPI
.. image:: https://img.shields.io/github/actions/workflow/status/collective/icalendar/tests.yml?branch=main&label=main&logo=github :target: https://github.com/collective/icalendar/actions/workflows/tests.yml?query=branch%3Amain :alt: GitHub Actions build status for main
.. image:: https://readthedocs.org/projects/icalendar/badge/?version=latest :target: https://icalendar.readthedocs.io/en/latest/ :alt: Documentation status
.. image:: https://coveralls.io/repos/github/collective/icalendar/badge.svg?branch=main :target: https://coveralls.io/github/collective/icalendar?branch=main :alt: Test coverage
.. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json :target: https://github.com/astral-sh/ruff :alt: Ruff
.. image:: https://img.shields.io/badge/%F0%9F%A4%91-Funding-brightgreen :target: https://opencollective.com/python-icalendar :alt: Funding
Install icalendar =================
See how to install icalendar _.
Usage =====
For how to use icalendar, including how to read, modify, and write iCalendar files, see the Usage _ guide.
Related projects ================
VObject _
VObject is intended to be a full-featured Python package for parsing and generating Card and Calendar files.
iCalEvents _
iCalEvents is built on top of icalendar, and allows you to query iCalendar files to get the events happening on specific dates.
It manages recurrent events as well.
recurring-ical-events _
Library to query an `icalendar.Calendar object for events and other components happening at a certain date or within a certain time.
x-wr-timezone _
Library and command line tool to make icalendar.Calendar objects and files from Google Calendar, using the non-standard X-WR-TIMEZONE property, compliant with the :rfc:5545 standard.
ics-query _
Command line tool to query iCalendar files for occurrences of events and other components.
icalendar-compatibility _
Access event data compatible with :rfc:5545 and different implementations.
caldav _
CalDAV is a :rfc:4791 client library for Python based on icalendar.
icalendar-anonymizer _
Anonymize iCalendar files by stripping personal data while preserving technical properties for bug reproduction.
ical2jcal _
Convert between iCalendar and jCalendar.
sphinx-icalendar _
Provides calendar code blocks and syntax highlighting in a tabbed interface for documentation as an extension to Sphinx.
Python Calendaring Ecosystem _
The standards compliant, integrated Python calendar packages.
Change log ==========
See the change log