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.2

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.2
File Size Uploaded
ics-0.7.2.tar.gz 190.6 kB Details

Built distributions (wheels)

Table of built distributions (wheels) for ics 0.7.2
File Interpreter ABI Platform
ics-0.7.2-py3.9.egg Legacy Egg format - - Details
ics-0.7.2-py2.py3-none-any.whl Python 2, Python 3 none any Details

Total release size: 321.4 kB

Release files / ics-0.7.2.tar.gz

Download URL ics-0.7.2.tar.gz
Size 190.6 kB
Tags Source
SHA-256 checksum
How to use checksums
6743539bca10391635249b87d74fcd1094af20b82098bebf7c7521df91209f05
BLAKE2b-256 checksum
How to use checksums
43fa2cb7cbe23566140f011da4fec280d4873da4389c8b838bb3e5ce3fc39b16
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.9.13

Release files / ics-0.7.2-py3.9.egg

Download URL ics-0.7.2-py3.9.egg
Size 90.7 kB
Tags Egg
SHA-256 checksum
How to use checksums
da352bdf8418619dc93611e6d251f3cefbb42664777f6e00b580a722098124b7
BLAKE2b-256 checksum
How to use checksums
61d6117ff9f1a71dcf3eb84ea0e204548b20dda110408fc7e03e51e1226f0e64
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.9.13

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

Download URL ics-0.7.2-py2.py3-none-any.whl
Size 40.1 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
5fcf4d29ec6e7dfcb84120abd617bbba632eb77b097722b7df70e48dbcf26103
BLAKE2b-256 checksum
How to use checksums
0a95e04dea5cf29bdf5005f5aa7ccf0a2f9724b877722d89f8286dc3785a7cdc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.9.13

Release history Release notifications | RSS feed

0.7.3

2 release files

This release

0.7.2 This release

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