==========================================================
Internet Calendaring and Scheduling (iCalendar) for Python
The icalendar <https://pypi.org/project/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 <https://docs.python.org/3/library/zoneinfo.html>, dateutil.tz <https://dateutil.readthedocs.io/en/latest/tz.html>, and pytz <https://pypi.org/project/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 <https://pypi.org/project/python-dateutil/>_ and tzdata <https://pypi.org/project/tzdata/>.
:License: 2-Clause BSD License <https://github.com/collective/icalendar/blob/main/LICENSE.rst>
:Contribute: Contribute to icalendar <https://icalendar.readthedocs.io/en/latest/contribute/index.html>_
:Funding: Open Collective <https://opencollective.com/python-icalendar>_
: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 <https://icalendar.readthedocs.io/en/stable/install.html>_.
Usage
For how to use icalendar, including how to read, modify, and write iCalendar files, see the Usage <https://icalendar.readthedocs.io/en/latest/how-to/usage.html>_ guide.
Related projects
VObject <https://github.com/py-vobject/vobject>_
VObject is intended to be a full-featured Python package for parsing and generating Card and Calendar files.
iCalEvents <https://github.com/jazzband/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 <https://pypi.org/project/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 <https://pypi.org/project/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 <http://pypi.org/project/ics-query>_
Command line tool to query iCalendar files for occurrences of events and other components.
icalendar-compatibility <https://icalendar-compatibility.readthedocs.io/en/latest/>_
Access event data compatible with :rfc:5545 and different implementations.
caldav <https://caldav.readthedocs.io/>_
CalDAV is a :rfc:4791 client library for Python based on icalendar.
icalendar-anonymizer <https://pypi.org/project/icalendar-anonymizer/>_
Anonymize iCalendar files by stripping personal data while preserving technical properties for bug reproduction.
ical2jcal <https://pypi.org/project/ical2jcal>_
Convert between iCalendar and jCalendar.
sphinx-icalendar <https://pypi.org/project/sphinx-icalendar/>_
Provides calendar code blocks and syntax highlighting in a tabbed interface for documentation as an extension to Sphinx.
Python Calendaring Ecosystem <https://pycal.org/>_
The standards compliant, integrated Python calendar packages.
Change log
See the change log <https://icalendar.readthedocs.io/en/latest/reference/changelog.html>_ for the latest updates to icalendar.
