Internet Calendaring and Scheduling (iCalendar) for Python
 
 
Go to file
Victor Varvaryuk 5228902397 Changed a test with with non-ascii chars 2013-03-11 11:12:14 +04:00
docs documentation file layout restructuring 2012-11-23 13:49:07 +01:00
src/icalendar Changed a test with with non-ascii chars 2013-03-11 11:12:14 +04:00
.gitignore updating .gitignore 2012-05-13 03:04:05 +02:00
.travis.yml exclude py2.4 and py3.2 from .travis.yml 2012-08-23 14:30:02 +02:00
CHANGES.rst Support for non-ascii parameter values. 2013-02-20 18:48:04 +01:00
CONTRIBUTING.rst fix ref to CHANGES.rst 2012-11-23 14:37:22 +01:00
LICENSE.rst fix rst 2013-02-08 16:15:57 +01:00
MANIFEST.in exclude py2.4 and py3.2 from .travis.yml 2012-08-23 14:30:02 +02:00
README.rst drop python <2.6 support 2013-02-08 16:05:57 +01:00
TODO.txt one more todo 2012-03-01 23:12:46 +01:00
__init__.py Easy way to install this into Zope, as a Zope product. This will make 2005-04-04 16:50:12 +00:00
bootstrap.py add bootstrap.py 2012-09-05 20:56:35 +02:00
buildout.cfg add buildout.cfg 2012-09-05 20:54:23 +02:00
setup.py Remove python-dateutil version fix. 2013-02-20 18:01:21 +01:00
tox.ini Reflect that dateutil is depended upon by all of the package, 2013-02-18 13:26:35 +01:00

README.rst

==========================================================
Internet Calendaring and Scheduling (iCalendar) for Python
==========================================================

The `icalendar`_ package is a parser/generator of iCalendar files for use
with Python.

----

    :Homepage: http://icalendar.readthedocs.org
    :Code: http://github.com/collective/icalendar
    :Mailing list: http://github.com/collective/icalendar/issues
    :Dependencies: `setuptools`_ and since version 3.0 we depend on `pytz`_.
    :Tested with: Python 2.6, 2.7
    :License: `BSD`_

----


Changes in version 3.0
======================

API Change
----------

Since version we unified to icalendar de/serialization API to use only to_ical
(for writing an ical string from the internal representation) and from_ical
(for parsing an ical string into the internal representation).

to_ical is now used instead of the methods ical, string, as_string and instead
of string casting via __str__ and str.

from_ical is now used instead of from_string.

This change is a requirement for future Python 3 compatibility. Please update
your code to reflect to the new API.

Timezone support
----------------

Timezones are now fully supported in icalendar for serialization and
deserialization. We use the pytz library for timezone components of datetime
instances. The timezone identifiers must be valid pytz respectively Olson
database timezone identifiers. This can be a problem for 'GMT' identifiers,
which are not defined in the Olson database.

Instead of the own UTC tzinfo implementation we use pytz UTC tzinfo object now.


About this fork which is not a fork anymore
===========================================

Aim of this fork (not fork anymore, read further) was to bring this package up
to date with latest icalendar `RFC`_ specification as part of
`plone.app.event`_ project which goal is to bring recurrent evens to `Plone`_.

After some thoughts we (Plone developers involved with `plone.app.event`_) send
a suggestion to icalendar-dev@codespeak.net to take over mainaining of
`icalendar`_. Nobody object and since version 2.2 we are back to development.

.. _`icalendar`: http://pypi.python.org/pypi/icalendar
.. _`plone.app.event`: http://github.com/collective/plone.app.event
.. _`Plone`: http://plone.org
.. _`pytz`: http://pypi.python.org/pypi/pytz
.. _`setuptools`: http://pypi.python.org/pypi/setuptools
.. _`RFC`: http://www.ietf.org/rfc/rfc5545.txt
.. _`BSD`: https://github.com/collective/icalendar/issues/2


Test Coverage Report
====================

Output from coverage test::

    lines   cov%   module   (path)
       13   100%   icalendar.__init__
      227    91%   icalendar.cal
       48    91%   icalendar.caselessdict
      166    92%   icalendar.parser
      667    90%   icalendar.prop
       16   100%   icalendar.tests.test_cases
       25    96%   icalendar.tests.test_doctests
       47   100%   icalendar.tests.test_encoding
       44    34%   icalendar.tests.test_icalendar
       13   100%   icalendar.tests.test_property_params
       51   100%   icalendar.tests.test_timezoned
       53    30%   icalendar.tools