Skip to main content

Original repository (GitHub) - Bugtracker and issues (GitHub) - PyPi package (ics) - Documentation (Read The Docs).

Apache 2 License

Ics.py is a pythonic and easy iCalendar library. Its goals are to read and write ics data in a developer friendly way.

iCalendar is a widely-used and useful format but not user friendly. Ics.py is there to give you the ability of creating and reading this format without any knowledge of it.

It should be able to parse every calendar that respects the rfc5545 and maybe some more… It also outputs rfc compliant calendars.

iCalendar (file extension .ics) is used by Google Calendar, Apple Calendar, Android and many more.

Ics.py is available for Python>=3.6 and is Apache2 Licensed.

Quickstart

$ pip install ics
from ics import Calendar, Event
c = Calendar()
e = Event()
e.name = "My cool event"
e.begin = '2014-01-01 00:00:00'
c.events.add(e)
c.events
# [<Event 'My cool event' begin:2014-01-01 00:00:00 end:2014-01-01 00:00:01>]
with open('my.ics', 'w') as my_file:
    my_file.writelines(c.serialize_iter())
# and it's done !

More examples are available in the documentation.

Documentation

All the documentation is hosted on readthedocs.org and is updated automatically at every commit.

Contribute

Contribution are welcome of course! For more information, see contributing.

Testing & Docs

# setup virtual environment
$ sudo pip install virtualenv
$ virtualenv ve
$ source ve/bin/activate

# tests
$ pip install -r requirements.txt
$ pip install -r dev/requirements-test.txt
$ python setup.py test

# tests coverage
$ pip install -r requirements.txt
$ pip install -r dev/requirements-test.txt
$ python setup.py test
$ coverage html
$ firefox htmlcov/index.html

# docs
$ pip install -r requirements.txt
$ pip install -r dev/requirements-doc.txt
$ cd doc
$ make html

Release files for ics 0.7.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ics 0.7.3
File Size Uploaded
ics-0.7.3.tar.gz 191.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ics 0.7.3
File Interpreter ABI Platform
ics-0.7.3-py2.py3-none-any.whl Python 2, Python 3 none any Details

Total release size: 231.2 kB

Release files / ics-0.7.3.tar.gz

Download URL ics-0.7.3.tar.gz
Size 191.0 kB
Tags Source
SHA-256 checksum
How to use checksums
2dcd6876e8c913d40db76f1f1ca47bccd1c162178c73f69fbbedca1b844eface
BLAKE2b-256 checksum
How to use checksums
459df1fa704c153351f679245c0f1dc0099df2d5e3ddb94a06810403a8931bef
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.5

Release files / ics-0.7.3-py2.py3-none-any.whl

Download URL ics-0.7.3-py2.py3-none-any.whl
Size 40.2 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
519f633f2e3d7b1528847e990a58dcb8807a2fffdcfd9dd880d1d5094d456af7
BLAKE2b-256 checksum
How to use checksums
99cdb8b730bd5804554643610d15954c0fe4eac6ddfe8e78b4396a67c3cae93d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.5

Release history Release notifications | RSS feed

This release

0.7.3 This release

2 release files

0.7.2

3 release files

0.7.1

3 release files

0.7

3 release files

0.6

2 release files

0.5

2 release files

0.4

4 release files

0.3.1

4 release files

0.3

3 release files

0.2

4 release files

0.1.3

1 release file

0.1.2

1 release file

0.1.1

1 release file

0.1

indev

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page