Ics.py : Calendar for Humans
============================

Release |version|.

Ics.py is a pythonic iCalendar library which follows the `RFC5545 <https://tools.ietf.org/html/rfc5545>`_ specification. Its goals are to read and write ics data in a developer-friendly way.

It is written in Python 3 (version 3.6 and above) and is licensed under the
:ref:`LICENSE`.

If you do not want to deal with the complex iCalendar specification,
then ics.py is for you!


First Steps
===========

New to our ics.py library? This is the place to start!

.. toctree::
   :maxdepth: 2

   howtos/quickstart
   howtos/installation


Tutorials
=========

If you search for something specific after you have read the *First Steps*,
find it here.

.. toctree::
   :maxdepth: 1

   tutorials/create-ics-with-cal-prog
   tutorials/contributing

Examples for tutorials:

* Create your first calendar
* TBD


Details
=======

Want to learn some details? Find here the relevant information.

.. toctree::
   :maxdepth: 2
   :glob:

   explanation/*

Reference
=========

If you want to dig a bit deeper in ics.py, here is the place to go.

.. toctree::
   :maxdepth: 2

   reference/api
   reference/changelog


Indices and Tables
==================

* :ref:`genindex`
* :ref:`search`