From 31e562c685d59c22fa1f241aa549bf8867042657 Mon Sep 17 00:00:00 2001 From: Federico Mena Quintero Date: Thu, 29 Jun 2000 07:16:19 +0000 Subject: New files for the new iCalendar component object. Today's properties: 2000-06-28 Federico Mena Quintero * cal-util/cal-component.[ch]: New files for the new iCalendar component object. Today's properties: basic component type, UID, SUMMARY. * cal-util/Makefile.am: Added cal-component.[ch] to the list of sources. svn path=/trunk/; revision=3786 --- calendar/cal-util/Makefile.am | 3 +- calendar/cal-util/cal-component.c | 386 ++++++++++++++++++++++++++++++++++++++ calendar/cal-util/cal-component.h | 89 +++++++++ calendar/cal-util/icalendar.c | 3 +- 4 files changed, 478 insertions(+), 3 deletions(-) create mode 100644 calendar/cal-util/cal-component.c create mode 100644 calendar/cal-util/cal-component.h (limited to 'calendar/cal-util') diff --git a/calendar/cal-util/Makefile.am b/calendar/cal-util/Makefile.am index 92302f9e1b..ae12943411 100644 --- a/calendar/cal-util/Makefile.am +++ b/calendar/cal-util/Makefile.am @@ -1,4 +1,3 @@ - noinst_PROGRAMS = test-recur icalendar-test INCLUDES = \ @@ -16,6 +15,7 @@ INCLUDES = \ lib_LTLIBRARIES = libcal-util.la libcal_util_la_SOURCES = \ + cal-component.c \ cal-recur.c \ cal-util.c \ calobj.c \ @@ -28,6 +28,7 @@ libcal_util_la_SOURCES = \ libcal_utilincludedir = $(includedir)/evolution/cal-util libcal_utilinclude_HEADERS = \ + cal-component.h \ cal-recur.h \ cal-util.h \ calobj.h \ diff --git a/calendar/cal-util/cal-component.c b/calendar/cal-util/cal-component.c new file mode 100644 index 0000000000..bb2fd1a50e --- /dev/null +++ b/calendar/cal-util/cal-component.c @@ -0,0 +1,386 @@ +/* Evolution calendar - iCalendar component object + * + * Copyright (C) 2000 Helix Code, Inc. + * + * Author: Federico Mena-Quintero + * + * 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA. + */ + +#include +#include +#include "cal-component.h" +#include "timeutil.h" + + + +/* Private part of the CalComponent structure */ +typedef struct { + /* Type of this component */ + CalComponentVType type; + + /* Summary string, optional */ + char *summary; + + /* Unique identifier, MUST be present */ + char *uid; +} CalComponentPrivate; + + + +static void cal_component_class_init (CalComponentClass *class); +static void cal_component_init (CalComponent *comp); +static void cal_component_destroy (GtkObject *object); + +static GtkObjectClass *parent_class; + + + +/** + * cal_component_get_type: + * @void: + * + * Registers the #CalComponent class if necessary, and returns the type ID + * associated to it. + * + * Return value: The type ID of the #CalComponent class. + **/ +GtkType +cal_component_get_type (void) +{ + static GtkType cal_component_type = 0; + + if (!cal_component_type) { + static const GtkTypeInfo cal_component_info = { + "CalComponent", + sizeof (CalComponent), + sizeof (CalComponentClass), + (GtkClassInitFunc) cal_component_class_init, + (GtkObjectInitFunc) cal_component_init, + NULL, /* reserved_1 */ + NULL, /* reserved_2 */ + (GtkClassInitFunc) NULL + }; + + cal_component_type = gtk_type_unique (GTK_TYPE_OBJECT, &cal_component_info); + } + + return cal_component_type; +} + +/* Class initialization function for the calendar component object */ +static void +cal_component_class_init (CalComponentClass *class) +{ + GtkObjectClass *object_class; + + object_class = (GtkObjectClass *) class; + + parent_class = gtk_type_class (GTK_TYPE_OBJECT); + + object_class->destroy = cal_component_destroy; +} + +/* Object initialization function for the calendar component object */ +static void +cal_component_init (CalComponent *comp) +{ + CalComponentPrivate *priv; + + priv = g_new0 (CalComponentPrivate, 1); + comp->priv = priv; + + priv->uid = cal_component_gen_uid (); +} + +/* Destroy handler for the calendar component object */ +static void +cal_component_destroy (GtkObject *object) +{ + CalComponent *comp; + CalComponentPrivate *priv; + + g_return_if_fail (object != NULL); + g_return_if_fail (IS_CAL_COMPONENT (object)); + + comp = CAL_COMPONENT (object); + priv = comp->priv; + + if (priv->uid) { + g_free (priv->uid); + priv->uid = NULL; + } + + g_free (priv); + comp->priv = NULL; + + if (GTK_OBJECT_CLASS (parent_class)->destroy) + (* GTK_OBJECT_CLASS (parent_class)->destroy) (object); +} + + + +/** + * cal_component_gen_uid: + * @void: + * + * Generates a unique identifier suitable for calendar components. + * + * Return value: A unique identifier string. Every time this function is called + * a different string is returned. + **/ +char * +cal_component_gen_uid (void) +{ + static char *hostname; + time_t t = time (NULL); + static int serial; + + if (!hostname) { + static char buffer [512]; + + if ((gethostname (buffer, sizeof (buffer) - 1) == 0) && + (buffer [0] != 0)) + hostname = buffer; + else + hostname = "localhost"; + } + + return g_strdup_printf ( + "%s-%d-%d-%d-%d@%s", + isodate_from_time_t (t), + getpid (), + getgid (), + getppid (), + serial++, + hostname); +} + +/** + * cal_component_new: + * @void: + * + * Creates a new empty calendar component object whose only set field is the + * unique identifier. You should set the type of this component as soon as + * possible by using cal_component_set_vtype(). + * + * Return value: A newly-created calendar component object. + **/ +CalComponent * +cal_component_new (void) +{ + return CAL_COMPONENT (gtk_type_new (CAL_COMPONENT_TYPE)); +} + +/* Parses a property and stores it in the calendar component */ +static void +load_property (CalComponent *comp, icalproperty *prop) +{ + icalproperty_kind kind; + + kind = icalproperty_isa (prop); + + /* FIXME */ +} + +/** + * cal_component_new_from_icalcomponent: + * @ical: An #icalcomponent structure with the component to parse. + * + * Creates a new calendar component object from an #icalcomponent from libical. + * This function only deals with VEVENT, VTODO, VJOURNAL, VFREEBUSY, AND + * VTIMEZONE components. + * + * Return value: A newly-created calendar component object. + **/ +CalComponent * +cal_component_new_from_icalcomponent (icalcomponent *ical) +{ + CalComponent *comp; + icalcomponent_kind kind; + CalComponentVType type; + icalproperty *prop; + + g_return_val_if_fail (ical != NULL, NULL); + + kind = icalcomponent_isa (ical); + + switch (kind) { + case ICAL_VEVENT_COMPONENT: + type = CAL_COMPONENT_EVENT; + break; + + case ICAL_VTODO_COMPONENT: + type = CAL_COMPONENT_TODO; + break; + + case ICAL_VJOURNAL_COMPONENT: + type = CAL_COMPONENT_JOURNAL; + break; + + case ICAL_VFREEBUSY_COMPONENT: + type = CAL_COMPONENT_FREEBUSY; + break; + + case ICAL_VTIMEZONE_COMPONENT: + type = CAL_COMPONENT_TIMEZONE; + break; + + default: + g_message ("cal_component_new_from_icalcomponent(): Unsupported component type %d", + kind); + return NULL; + } + + comp = cal_component_new (); + cal_component_set_vtype (comp, type); + + for (prop = icalcomponent_get_first_property (ical, ICAL_ANY_PROPERTY); + prop; + prop = icalcomponent_get_next_property (ical, ICAL_ANY_PROPERTY)) + load_property (comp, prop); + + /* FIXME: parse ALARM subcomponents */ + + return comp; +} + +/** + * cal_component_get_vtype: + * @comp: A calendar component object. + * + * Queries the type of a calendar component object. + * + * Return value: The type of the component, as defined by RFC 2445. + **/ +CalComponentVType +cal_component_get_vtype (CalComponent *comp) +{ + CalComponentPrivate *priv; + + g_return_val_if_fail (comp != NULL, CAL_COMPONENT_NO_TYPE); + g_return_val_if_fail (IS_CAL_COMPONENT (comp), CAL_COMPONENT_NO_TYPE); + + priv = comp->priv; + return priv->type; +} + +/** + * cal_component_set_vtype: + * @comp: A calendar component object. + * @type: Type of the component, as defined by RFC 2445. + * + * Sets the type of a calendar component object. This function should be used + * as soon as possible after creating a new calendar component so that its type + * can be known to the rest of the program. + **/ +void +cal_component_set_vtype (CalComponent *comp, CalComponentVType type) +{ + CalComponentPrivate *priv; + + g_return_if_fail (comp != NULL); + g_return_if_fail (IS_CAL_COMPONENT (comp)); + g_return_if_fail (type != CAL_COMPONENT_NO_TYPE); + + priv = comp->priv; + priv->type = type; +} + +/** + * cal_component_get_uid: + * @comp: A calendar component object. + * + * Queries the unique identifier of a calendar component object. + * + * Return value: The unique identifier string. + **/ +const char * +cal_component_get_uid (CalComponent *comp) +{ + CalComponentPrivate *priv; + + g_return_val_if_fail (comp != NULL, NULL); + g_return_val_if_fail (IS_CAL_COMPONENT (comp), NULL); + + priv = comp->priv; + return priv->uid; +} + +/** + * cal_component_set_uid: + * @comp: A calendar component object. + * @uid: Unique identifier. + * + * Sets the unique identifier string of a calendar component object. + **/ +void +cal_component_set_uid (CalComponent *comp, const char *uid) +{ + CalComponentPrivate *priv; + + g_return_if_fail (comp != NULL); + g_return_if_fail (IS_CAL_COMPONENT (comp)); + g_return_if_fail (uid != NULL); + + priv = comp->priv; + g_assert (priv->uid != NULL); + + g_free (priv->uid); + priv->uid = g_strdup (uid); +} + +/** + * cal_component_get_summary: + * @comp: A calendar component object. + * + * Queries the summary of a calendar component object. + * + * Return value: Summary string. + **/ +const char * +cal_component_get_summary (CalComponent *comp) +{ + CalComponentPrivate *priv; + + g_return_val_if_fail (comp != NULL, NULL); + g_return_val_if_fail (IS_CAL_COMPONENT (comp), NULL); + + priv = comp->priv; + return priv->summary; +} + +/** + * cal_component_set_summary: + * @comp: A calendar component object. + * @summary: Summary string. + * + * Sets the summary of a calendar component object. + **/ +void +cal_component_set_summary (CalComponent *comp, const char *summary) +{ + CalComponentPrivate *priv; + + g_return_if_fail (comp != NULL); + g_return_if_fail (IS_CAL_COMPONENT (comp)); + + priv = comp->priv; + + if (priv->summary) + g_free (priv->summary); + + priv->summary = g_strdup (summary); +} diff --git a/calendar/cal-util/cal-component.h b/calendar/cal-util/cal-component.h new file mode 100644 index 0000000000..1a5a271d9b --- /dev/null +++ b/calendar/cal-util/cal-component.h @@ -0,0 +1,89 @@ +/* Evolution calendar - iCalendar component object + * + * Copyright (C) 2000 Helix Code, Inc. + * + * Author: Federico Mena-Quintero + * + * 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA. + */ + +#ifndef CAL_COMPONENT_H +#define CAL_COMPONENT_H + +#include +#include +#include +#include + +BEGIN_GNOME_DECLS + + + +#define CAL_COMPONENT_TYPE (cal_component_get_type ()) +#define CAL_COMPONENT(obj) (GTK_CHECK_CAST ((obj), CAL_COMPONENT_TYPE, CalComponent)) +#define CAL_COMPONENT_CLASS(klass) (GTK_CHECK_CLASS_CAST ((klass), CAL_COMPONENT_TYPE, \ + CalComponentClass)) +#define IS_CAL_COMPONENT(obj) (GTK_CHECK_TYPE ((obj), CAL_COMPONENT_TYPE)) +#define IS_CAL_COMPONENT_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((klass), CAL_COMPONENT_TYPE)) + +/* Types of calendar components to be stored by a CalComponent, as per RFC 2445. + * We don't put the alarm component type here since we store alarms as separate + * structures inside the other "real" components. + */ +typedef enum { + CAL_COMPONENT_NO_TYPE, + CAL_COMPONENT_EVENT, + CAL_COMPONENT_TODO, + CAL_COMPONENT_JOURNAL, + CAL_COMPONENT_FREEBUSY, + CAL_COMPONENT_TIMEZONE +} CalComponentVType; + +typedef struct _CalComponent CalComponent; +typedef struct _CalComponentClass CalComponentClass; + +struct _CalComponent { + GtkObject object; + + /* Private data */ + gpointer priv; +}; + +struct _CalComponentClass { + GtkObjectClass parent_class; +}; + +GtkType cal_component_get_type (void); + +char *cal_component_gen_uid (void); + +CalComponent *cal_component_new (void); + +CalComponent *cal_component_new_from_icalcomponent (icalcomponent *ical); + +CalComponentVType cal_component_get_vtype (CalComponent *comp); +void cal_component_set_vtype (CalComponent *comp, CalComponentVType type); + +const char *cal_component_get_uid (CalComponent *comp); +void cal_component_set_uid (CalComponent *comp, const char *uid); + +const char *cal_component_get_summary (CalComponent *comp); +void cal_component_set_summary (CalComponent *comp, const char *summary); + + + +END_GNOME_DECLS + +#endif diff --git a/calendar/cal-util/icalendar.c b/calendar/cal-util/icalendar.c index eedb732617..c43d0fba77 100644 --- a/calendar/cal-util/icalendar.c +++ b/calendar/cal-util/icalendar.c @@ -330,8 +330,7 @@ ical_object_create_from_icalcomponent (icalcomponent* comp) /* nothing to do for this property */ break; default: - g_warning ("Unsupported property: %s", icalproperty_as_ical_string -(prop)); + g_warning ("Unsupported property: %s", icalproperty_as_ical_string (prop)); break; } -- cgit v1.2.3