Original repository <https://github.com/C4ptainCrunch/ics.py> (GitHub) -
Bugtracker and issues <https://github.com/C4ptainCrunch/ics.py/issues> (GitHub) -
PyPi package <https://pypi.python.org/pypi/ics/> (ics) -
Documentation <http://icspy.readthedocs.org/> (Read The Docs).
.. image:: https://img.shields.io/github/license/c4ptaincrunch/ics.py.svg :target: https://pypi.python.org/pypi/ics/ :alt: 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 <http://tools.ietf.org/html/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.
.. code-block:: bash
pip install ics
.. code-block:: python
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) # and it's done !
More examples are available in the
documentation <http://icspy.readthedocs.org/> is hosted on
readthedocs.org <http://readthedocs.org/> and is updated automatically
at every commit.
Contribution are welcome of course! For more information, see
.. code-block:: bash
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
Vulgarised RFC <http://www.kanzaki.com/docs/ical/>_