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`: collective/icalendar#2


3.1

    Make sure parameters to certain properties propagate to the
    ical output. [kanarip]
    Re-include doctests. [rnix]
    endure correct datatype at instance creation time in prop.vCalAddress
    and prop.vText. [rnix]
    Apply TZID parameter to datetimes parsed from RECURRENCE-ID
    [dbstovall]
    Localize datetimes for timezones to avoid DST transition errors.
    [dbstovall]
    Allow UTC-OFFSET property value data types in seconds, which
    follows RFC5545 specification. [nikolaeff]
    Remove utctz and normalized_timezone methods to simplify the
    codebase. The methods were too tiny to be useful and just used
    at one place. [thet]
    When using Component.add() to add icalendar properties, force
    a value conversion to UTC for CREATED, DTSTART and LAST-MODIFIED.
    The RFC expects UTC for those properties. [thet]
    Removed last occurrences of old API (from_string). [Rembane]
    Add
    listing. For example when parsing a text/calendar text including
    multiple components (e.g. a VCALENDAR with 5 VEVENTs), the
    previous situation required us to look over all properties in
    VEVENTs even if we just want the properties under the VCALENDAR
    component (VERSION, PRODID, CALSCALE, METHOD). [dmikurube]
    All unit tests fixed. [mikaelfrykholm]

3.0.1b2 (2012-03-01)

    For all TZID parameters in DATE-TIME properties, use timezone
    identifiers (e.g. Europe/Vienna) instead of timezone names
    (e.g. CET), as required by RFC5545. Timezone names are used
    together with timezone identifiers in the Timezone components.
    [thet]
    Timezone parsing, issues and test fixes. [mikaelfrykholm,
    garbas, tgecho]
    Since we use pytz for timezones, also use UTC tzinfo object
    from the pytz library instead of own implementation. [thet]

3.0.1b1 (2012-02-24)

    Update Release information. [thet]

3.0

    Add API for proper Timezone support. Allow creating ical
    DATE-TIME strings with timezone information from Python datetimes
    with pytz based timezone information and vice versa. [thet]
    Unify API to only use to_ical and from_ical and remove string
    casting as a requirement for Python 3 compatibility: New:
    to_ical. Old: ical, string, as_string and string casting via
    __str__ and str. New: from_ical. Old: from_string. [thet]

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`: collective/icalendar#2


3.1

    Make sure parameters to certain properties propagate to the
    ical output. [kanarip]
    Re-include doctests. [rnix]
    endure correct datatype at instance creation time in prop.vCalAddress
    and prop.vText. [rnix]
    Apply TZID parameter to datetimes parsed from RECURRENCE-ID
    [dbstovall]
    Localize datetimes for timezones to avoid DST transition errors.
    [dbstovall]
    Allow UTC-OFFSET property value data types in seconds, which
    follows RFC5545 specification. [nikolaeff]
    Remove utctz and normalized_timezone methods to simplify the
    codebase. The methods were too tiny to be useful and just used
    at one place. [thet]
    When using Component.add() to add icalendar properties, force
    a value conversion to UTC for CREATED, DTSTART and LAST-MODIFIED.
    The RFC expects UTC for those properties. [thet]
    Removed last occurrences of old API (from_string). [Rembane]
    Add
    listing. For example when parsing a text/calendar text including
    multiple components (e.g. a VCALENDAR with 5 VEVENTs), the
    previous situation required us to look over all properties in
    VEVENTs even if we just want the properties under the VCALENDAR
    component (VERSION, PRODID, CALSCALE, METHOD). [dmikurube]
    All unit tests fixed. [mikaelfrykholm]

3.0.1b2 (2012-03-01)

    For all TZID parameters in DATE-TIME properties, use timezone
    identifiers (e.g. Europe/Vienna) instead of timezone names
    (e.g. CET), as required by RFC5545. Timezone names are used
    together with timezone identifiers in the Timezone components.
    [thet]
    Timezone parsing, issues and test fixes. [mikaelfrykholm,
    garbas, tgecho]
    Since we use pytz for timezones, also use UTC tzinfo object
    from the pytz library instead of own implementation. [thet]

3.0.1b1 (2012-02-24)

    Update Release information. [thet]

3.0

    Add API for proper Timezone support. Allow creating ical
    DATE-TIME strings with timezone information from Python datetimes
    with pytz based timezone information and vice versa. [thet]
    Unify API to only use to_ical and from_ical and remove string
    casting as a requirement for Python 3 compatibility: New:
    to_ical. Old: ical, string, as_string and string casting via
    __str__ and str. New: from_ical. Old: from_string. [thet]

…ssue_345

Jacadzaca test restructure issue 345

reproduce fuzzing error