calendarcompat.cpp

/*
 *  calendarcompat.cpp -  compatibility for old calendar file formats
 *  Program:  kalarm
 *  Copyright © 2001-2006 by David Jarvie <software@astrojar.org.uk>
 *
 *  This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 2 of the License, or
 *  (at your option) any later version.
 *
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License along
 *  with this program; if not, write to the Free Software Foundation, Inc.,
 *  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */
 
#include "kalarm.h"
 
#include <tqfile.h>
#include <tqtextstream.h>
#include <tqstringlist.h>
 
#include <tdeapplication.h>
#include <tdeaboutdata.h>
#include <kdebug.h>
 
#include <libkcal/calendar.h>
 
#include "alarmevent.h"
#include "functions.h"
#include "preferences.h"
#include "calendarcompat.h"
 
using namespace KCal;
 
 
/******************************************************************************
* Find the version of KAlarm which wrote the calendar file, and do any
* necessary conversions to the current format. The calendar is not saved - any
* conversions will only be saved if changes are made later.
*/
void CalendarCompat::fix(KCal::Calendar& calendar, const TQString& localFile)
{
    bool version057_UTC = false;
    TQString subVersion;
    int version = readKAlarmVersion(calendar, subVersion);
    if (!version)
    {
        // The calendar was created either by the current version of KAlarm,
        // or another program, so don't do any conversions
        return;
    }
    if (version == KAlarm::Version(0,5,7)  &&  !localFile.isEmpty())
    {
        // KAlarm version 0.5.7 - check whether times are stored in UTC, in which
        // case it is the KDE 3.0.0 version, which needs adjustment of summer times.
        version057_UTC = isUTC(localFile);
        kdDebug(5950) << "CalendarCompat::fix(): KAlarm version 0.5.7 (" << (version057_UTC ? "" : "non-") << "UTC)\n";
    }
    else
        kdDebug(5950) << "CalendarCompat::fix(): KAlarm version " << version << endl;
 
    // Convert events to current KAlarm format for when calendar is saved
    KAEvent::convertKCalEvents(calendar, version, version057_UTC);
}
 
/******************************************************************************
* Return the KAlarm version which wrote the calendar which has been loaded.
* The format is, for example, 000507 for 0.5.7.
* Reply = 0 if the calendar was created by the current version of KAlarm,
*           KAlarm pre-0.3.5, or another program.
*/
int CalendarCompat::readKAlarmVersion(KCal::Calendar& calendar, TQString& subVersion)
{
    subVersion = TQString();
    const TQString& prodid = calendar.productId();
 
    // Find the KAlarm identifier
    TQString progname = TQString::fromLatin1(" KAlarm ");
    int i = prodid.find(progname, 0, false);
    if (i < 0)
    {
        // Older versions used KAlarm's translated name in the product ID, which
        // could have created problems using a calendar in different locales.
        progname = TQString(" ") + kapp->aboutData()->programName() + ' ';
        i = prodid.find(progname, 0, false);
        if (i < 0)
            return 0;    // calendar wasn't created by KAlarm
    }
 
    // Extract the KAlarm version string
    TQString ver = prodid.mid(i + progname.length()).stripWhiteSpace();
    i = ver.find('/');
    int j = ver.find(' ');
    if (j >= 0  &&  j < i)
        i = j;
    if (i <= 0)
        return 0;    // missing version string
    ver = ver.left(i);     // ver now contains the KAlarm version string
    if (ver == KAlarm::currentCalendarVersionString())
        return 0;      // the calendar is in the current KAlarm format
    return KAlarm::getVersionNumber(ver, &subVersion);
}
 
/******************************************************************************
 * Check whether the calendar file has its times stored as UTC times,
 * indicating that it was written by the KDE 3.0.0 version of KAlarm 0.5.7.
 * Reply = true if times are stored in UTC
 *       = false if the calendar is a vCalendar, times are not UTC, or any error occurred.
 */
bool CalendarCompat::isUTC(const TQString& localFile)
{
    // Read the calendar file into a TQString
    TQFile file(localFile);
    if (!file.open(IO_ReadOnly))
        return false;
    TQTextStream ts(&file);
    ts.setEncoding(TQTextStream::Latin1);
    TQString text = ts.read();
    file.close();
 
    // Extract the CREATED property for the first VEVENT from the calendar
    TQString VCALENDAR = TQString::fromLatin1("BEGIN:VCALENDAR");
    TQString VEVENT    = TQString::fromLatin1("BEGIN:VEVENT");
    TQString CREATED   = TQString::fromLatin1("CREATED:");
    TQStringList lines = TQStringList::split(TQChar('\n'), text);
    for (TQStringList::ConstIterator it = lines.begin();  it != lines.end(); ++it)
    {
        if ((*it).startsWith(VCALENDAR))
        {
            while (++it != lines.end())
            {
                if ((*it).startsWith(VEVENT))
                {
                    while (++it != lines.end())
                    {
                        if ((*it).startsWith(CREATED))
                            return (*it).endsWith("Z");
                    }
                }
            }
            break;
        }
    }
    return false;
}