Skip to main content

Python icalendar (rfc5545) parser

Project description

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

https://travis-ci.org/C4ptainCrunch/ics.py.png?branch=master Coverage Apache 2 License

Ics.py is a pythonic and easy iCalendar library. It’s goals are to read and write ics data in a developper 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 Sunbird, Google Calendar, Apple Calendar, Android…

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

Quickstart

$ pip install ics
>>> from ics import Calendar, Event
>>> c = Calendar()
>>> e = Event()
>>> e.name = "My cool event"
>>> e.begin = '20140101 00:00:00'
>>> c.events.append(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)
>>> # 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ics-0.3.tar.gz (37.2 kB view hashes)

Uploaded Source

Built Distributions

ics-0.3-py2.py3-none-any.whl (19.1 kB view hashes)

Uploaded Python 2 Python 3

ics-0.3-py2.7.egg (16.4 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page