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
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]
1.9724nb1 to 1.9725.
upstream changes:
1.9725 [2012-02-01]
- Correct stack discipline in stat(), which was screwing up list
operations in expressions containing calls to it [rt.cpan.org
#72926].
- Add missing OUTPUT sections to the XS code [rt.cpan.org #70930].
- Skip itimer tests on GNU/Hurd, which has the API but lacks
the implementation [rt.cpan.org #72754].
- Fix a doubled word in the documentation [rt.cpan.org #72763].
version 2.03.2, 2012-06-26:
===========================
o [Compilation] Compatibility with OCaml 4
version 2.03.1, 2011-03-24:
===========================
* [Calendar] Fixed bug in Calendar.prev and Fcalendar.prev: mostly raised
exception Date.Out_of_bounds before.
* [Printer] `Thurday' was printed instead of `Thursday'
version 2.03, 2010-07-05:
=========================
o [Date] new function Date.precise_sub
o [Calendar] new function Calendar.precise_sub
(from Dario Teixeira's suggestion)
* [Compilation] detect whether native dynlink works
(prevents compilation bug on Mac OS X)
version 2.02, 2009-12-11:
=========================
o [License] add the usual Ocaml linking exception in the license
o [Calendar] Calendar_sig.Period.to_time is deprecated.
Replaced by a new function Calendar_sig.Period.safe_to_time
o [Date] Date.Period.nb_days is deprecated.
Replaced by a new function Date.Period.safe_nb_days
o [Compilation] calendarLib.cmxs provided if ocaml >= 3.11 is installed
(patch of Mehdi Dogguy)
o [Date] new functions Date.make_year and Date.make_year_month
o [Date] improve memory representation of Date.Period.t
* [Compilation] remove installation of packed *.cmi
* [Compilation] bug fixed under Cygwin
* [Compilation] META files was incorrect, so "ocamlfind ocamlopt" did not work
* [Compilation] file date_sig.mli, time_sig.mli and calendar_sig.mli was not
properly linked
version 2.01.1, 2009-02-23:
===========================
o [Date] add a missing coercion rule for months
(e.g. "Date.make 2008 18 1" is now equal to "Date.make 2009 6 1")
* [Date] bug fixed in date arithmetic operations due to the missing above
feature
version 2.01, 2009-01-26:
=========================
o [Printer] new formats available for printers and parsers
- %C century: as %Y without the two last digits
- %F replace %i which is now deprecated
- %P am or pm
- %R shortcut for %H:%M
- %s number of seconds since 1970/1/1
- %z time zone in the form +hhmm (from Warren Harris' suggestion)
- %:z time zone in the form +hh:mm (from Warren Harris' suggestion)
- %::z time zone in the form +hh:mm:ss (from Warren Harris' suggestion)
- %:::z time zone in the form +hh (from Warren Harris' suggestion)
o [Printer] new paddings available for printers
- 0 (zero): pad fields with zeroes like by default
- ^: use uppercase if possible
o [Compilation] calendarLib.cma and calendarLib.cmxa are now installed
(Janne Hellsten and Guillaume Yziquel's suggestion)
* [Tests] test suite now uses Utils.Float.equal if required
(patch of Richard Jones)
* [Compilation] small bug fixed in make install
* [Compilation] support of win64 (patch of David Allsopp)
time/p5-DateTime-Format-Strptime from 1.5000 to 1.5200.
pkgsrc changes:
- Update comment and homepage
- append 00 to upstream version to avoid comparing conflicts in pkgsrc
Upstream changes:
1.52 2012-07-01
- Shut up "unescaped braces in regex" warning from 5.17.0. RT #77514. Patch by
Zefram.
1.51 2012-05-27
- Packaging cleanup, including listing Test::More as a test prereq, not a
runtime prereq. RT #76128.
to 0.7600.
Upstream changes:
0.76 2012-07-01
- The DateTime->subtract method ignored the end_of_month parameter. Patch by
Chris Reinhardt. RT #77844.
0.75 2012-06-11
- The epoch for years 1-999 was broken because Time::Local is "clever". A pox
on all clever APIs, I say! Reported by Christian Hansen. RT #77719.
- Shut up compilation warning from 5.17.x. Reported by Tom Wyant. RT #77490.
Changes from 3.2.3 to 3.2.4
Fixed a possible double deallocation in the mxDateTime C API
import helper. Thanks to Daniele Varrazzo for reporting this.
Changes from 3.2.2 to 3.2.3
Fixed a possible segfault when using the .pydate(), .pydatetime()
and .pytime() methods. Thanks to Daniel Szoska for reporting
this.
Changes from 3.2.1 to 3.2.2
mxDateTime seconds rounding is now more careful to not show
60.00 or 61.00 as second value.
mxDateTime will now correctly work with numeric arrays (numpy)
again. Thanks to Christian Marquardt for reporting the problem.
mxDateTime's DateTimeFromAbsDateTime() now accepts leap second
values (86400.0 - <86401.0) as well. Thanks to Christian
Marquardt for reporting the problem.
mxDateTime range errors did not always format the wrong value.
Made mxDateTime compile again on Python 2.1 and 2.2.
Changes from 3.2.0 to 3.2.1
Fixed a segfault when comparing DateTime/DateTimeDelta with
None objects. Thanks to Mark Matthews for reporting this.
Changes from 3.1.2 to 3.2.0
Added new .rebuild() methods to both DateTime and DateTimeDelta
objects, making it easier creating new objects from existing
ones by just replacing some of the parameters (akin to the
mxURL .rebuild() method).
Greatly enhanced the interoperability with the Python datetime
module objects:
Added support for handling mixed type operations with
datetime.time objects.
Added new constructor methods to DateTime and DateTimeDelta
objects which aid in combining them with Python datetime
module objects: .pytime(), .pytimedelta(), .pydatetime()
and .pydate() as appropriate.
Added support for Python datetime module objects to the
generic mxDateTime constructors DateTimeFrom(), DateFrom(),
DateTimeDeltaFrom() (and their aliases).
The Python datetime module's C API is now loaded on demand
whenever mxDateTime needs to work with PyDateTime objects.
mxDateTime was updated to use mixed type number slots, a
feature which was added to Python in version 2.1 (by the
author of mxDateTime, Marc-André Lemburg). This has made
working with DateTime and DateTimeDelta objects and other
date/time types a lot more orbust.
mxDateTime's gmtime() now also works for ticks values beyond
2038 on 32-bit platforms that implement a POSIX confirm gmtime(),
but cannot handle post 2038 dates due to data type restrictions,
e.g. older 32-bit Linux platforms. As side-effect, this also
speeds up the gmtime() implementation on all platforms with
POSIX conform date/time handling.
mxDateTime will try to use the most accurate clock available
on the system for now(). For most POSIX systems, this is a
nanosecond resolution clock. A new global now_resolution allows
checking the resolution reported by the system. The performance
of now() was enhanced by directly interfacing to the various
platform C APIs.
Changed: mxDateTime will now format the seconds value in the
repr() and the str() output rounded to two decimal places. In
previous versions, it used to truncate the fraction after two
decimal places.
Known problem: mxDateTime doesn't build on FreeBSD with Python
2.7 and 2.7.1. This is a known problem with Python 2.7 and will
be fixed in Python 2.7.2. See http://bugs.python.org/issue10547
for details.
DateTimeFrom() now accepts a defaultdate parameter when parsing
strings or keyword-only arguments. defaultdate provides the
defaults to assume when pars of the date/time are not given.
It defaults to today().
DateFrom() will now only parse the date parts of a string and
only accept date-related keyword arguments.
Fixed a bug in the mxDateTime parser that triggered with some
ISO formats using second fractions. Thanks to Francesco
Pierfederici for bringing this to our attention.
Added support for more US AM/PM date formats such as "5:08pm"
(without space), "5:08 p.m." (with additional dots) to the
mxDateTime parser. Thanks to Tom at TicketStumbler for bringing
this to our attention.
Changed C API: mxDateTime now uses C longs for years internally
and in the C API. Note that the published C API has changed
because of this: mxDateTime.DateTime_FromDateAndTime() now
expects a long as year instead of an int. This change will
require a recompile of the applications using the mxDateTime
C API, but should only be noticeable on 64-bit platforms.
Added new C API DateTime_FromAbsDateTime to the mxDateTime C
API.
Added version number to C API object: Due to the changes in
the C API, the name of the C API object "mxDateTimeAPI" was
changed to "mxDateTimeAPI2", so that applications relying on
the old API don't import the changed API by accident.
Added optional calendar parameter to DateTimeFromAbsDateTime().
This allows creating DateTime instances with a given calendar.
Default is to use the Gregorian calendar.
Added BST to mx.DateTime.Timezone.
Fixed problem with now() resolution on Windows. It now provides
millisecond resolution again.
Fixed a bug in mx.DateTime.DateTimeFromAbsDateTime() which
caused an endless loop on 64-bit platforms for very large year
values.
Fixed Debian bug#494792: Incorrect subtraction with regular
Python datetime. This was actually a side-effect of the coercion
logic previously used in mxDateTime and not really a bug. The
new mixed type number slot implementations made it possible
to Darko Zurman for pointing this out.
Removed left-over debug code which caused the builtin strptime()
never to get used. Thanks to Alok Singhal for this one.
Fixed a bug in the mxDateTime .ticks() method which causes it
to raise an error for vahe Epoch.
xfce4-orage depends on x11/xfce4-panel which takes care of creating
the plugins directory. Remove the redundant directory creation which
can lead to directories being removed prematurely.
* libXp was used by Xaw8, but it had been obsolated, and in pkgsrc,
x11/libXaw/buildlink3.mk had been switched to pick up Xaw7 by default.
* With x11/xorg-cf-files, libXp was offered with XawClientLibs,
but updated to 1.0.4, it was removed.
* And pkgsrc had been switched to use always xorg-cf-files and imake from pkgsrc,
so all platforms should not require libXp from libXaw with Imake.
Bump PKGREVISION.
0.74 2012-03-22
- Small packaging fix for metacpan's benefit. No need to upgrade.
0.73 2012-03-17
- Change tests to work with Zefram's entirely rebuilt DateTime::TimeZone
distribution, which will replace the current implementation. Patch by
Zefram. RT #75757.
0.72 2012-01-05
- Remove Test::DependentModules from the dep list. This is used by some
author-only tests. Reported by Zefram.
0.71 2012-01-05
- There will be a new leap second on June 30, 2012.
0.70 2011-05-09
- Really fix %N, finally. This was breaking the DateTime::Event::Recurrence
test suite. Patch by Dagfinn Ilmari Mannsåker.
0.69 2011-05-03
- When a DateTime object had nanoseconds == 0, the %N strftime specifier
always returned "0" regardless of the precision requested. Reported by John
Siracusa. RT #67928.
0.68 2011-04-25
- The tests for %N in the last release relied on the vagaries of floating
point math on a 64-bit system. Now the from_epoch() method just uses string
operations to separate the epoch into an integer value and a mantissa. This
avoids floating point insanity. Reported by zefram. RT #67736.
0.67 2011-04-24
- The %N strftime specifier simply truncated nanoseconds, rather than rounding
them. Reported by Michael R. Davis. RT #66744.
- The %U strftime specifier was off by one in years where January 1st was a
Sunday. Patch by Christian Hansen. RT #67631.
- The %W strftime specifier was off by one in years where January 1st was a
Sunday or Monday. Patch by Christian Hansen. RT #67631.
- Some small optimizations from Christian Hansen. The biggest impact is for
calculating week_of_month, week_number, and week_year.
- This distro now requires Perl 5.8.1+ (it implicitly did this anyway now that
Params::Validate is 5.8.1+).
1.46 2012-04-02
- This release is based on version 2012c of the Olson database. This release
includes contemporary changes for Morocco, Palestine, Syria, and Haiti.
1.45 2012-03-03
- Remove the dependency on DateTime and DateTime::Duration which was
accidentally added in 1.43. Reported by Slaven Rezic. RT #75508.
1.44 2012-03-02
- This release is based on version 2012b of the Olson database. This release
includes contemporary changes for Cuba.
1.43 2012-03-01
- This release is based on version 2012a of the Olson database. This release
includes contemporary changes for Armenia, Chile, the Falkland Islands, and
Tokelau.
1.42 2011-11-07
- This release is based on version 2011n of the Olson database. This release
includes contemporary changes for Fiji, Moldova (reversing the 2011m
changes), and Cuba. The Moldova change removes the Europe/Tiraspol zone
added in the previous release.
1.41 2011-10-24
- This release is based on version 2011m of the Olson database. This release
includes contemporary changes for Brazil, Moldova, and Ukraine.
1.40 2011-10-10
- This release is based on version 2011l of the Olson database. This release
includes contemporary changes for Palestine, Fiji, Russia, Belarus, Ukraine,
and several other post-Soviet states.
1.39 2011-09-26
- This release is based on version 2011k of the Olson database. This release
includes contemporary changes for Palestine, Belarus, and Ukraine.
1.38 2011-09-19
- Removed code matching /^package/ in tools/parse_olson. This was confusing
the metacpan indexer.
1.37 2011-09-12
- This release is based on version 2011j of the Olson database. This release
includes contemporary changes for Samoa and historical changes for Kenya,
Uganda, and Tanzania.
1.36 2011-08-29
- This release is based on version 2011i of the Olson database. This release
includes a new zone for South Sudan (Africa/Juba) and changes for Samoa,
Kaliningrad (Russia), Alaska, Hawaii, Newfoundland/Labrador (Canada), and
Resolute Bay.
- Require ExtUtils::MakeMaker 6.58+. This fixes an installation problem on
Windows.
1.35 2011-07-03
- This release is based on version 2011h of the Olson database. This release
includes changes for Russia.
- Include UTC in the list of all time zone names. RT #67070.
1.34 2011-04-25
- This release is based on version 2011g of the Olson database. This release
includes changes for Egypt.
- DateTime::TimeZone::Floating and DateTime::TimeZone::UTC are now singletons,
since their internal state never changes.
1.33 2011-04-11
- This release is based on version 2011f of the Olson database. This release
includes changes for the Falkland Islands.
1.32 2011-04-01
- This release is based on version 2011e of the Olson database. This release
includes changes for Morocco and Chile.
1.31 2011-03-18
- Updates for Win32 time zones. Patch by David Pinkowitz.
1.30 2011-03-14
- This release is based on version 2011d of the Olson database. This release
includes changes for Samoa, Turkey, and Cuba.
1.29 2011-03-07
- This release is based on version 2011c of the Olson database. This release
includes new zones, America/Sitka and America/Metlakatla, as well as changes
for Alaska and Chile.
1.28 2011-02-07
- This release is based on version 2011b of the Olson database. This release
includes a new zone, America/North_Dakota/Beulah.
1.27 2011-01-19
- This release is based on version 2011a of the Olson database. This release
includes historical updates for Australia and Hawaii.
1.26 2010-11-20
- Fix release engineering bugs. The last release had both a Build.PL and
Makefile.PL, but the former did not list all the prereqs. Also, dynamic
prereqs for Win32 and HPUX were not being added properly.
1.25 2010-11-20
- Attempting to determine the local time zone while inside a sort subroutine
could cause an error "Can't return outside a subroutine". This was caused by
stack corruption that happens when an eval "use $module" fails. Reported by
Andy Jones. RT #63106.
1.24 2010-10-25
- This release is based on version 2010n of the Olson database. This release
includes updates for Fiji.
- All modules in the distro now have the same $VERSION.
1.23 2010-10-25
- This release is based on version 2010n of the Olson database. This release
includes updates for Fiji.
1.22 2010-09-27
- This release is based on version 2010m of the Olson database. This release
includes historical updates for Hong Kong.
