Federated_Computer/federated-calendar
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

core: Add "expand-recurrences" property to GcalCalendarMonitor and GcalTimeline

Browse Source 
Add an "expand-recurrences" boolean property (defaulting to TRUE) to both
GcalCalendarMonitor and GcalTimeline. When set to FALSE:
- Recurring master components are kept as single events without expanding
  each recurrence instance.
- Detached recurrence instances are ignored.
- Pruning outside range retains recurring master events so they are not
  prematurely removed.
- Subscriber filtering permits recurring master events within the
  subscriber model.

This allows consumers like search providers to avoid expanding all recurrence
instances when searching, improving performance and avoiding duplicate hits.

Part-of: <https://gitlab.gnome.org/GNOME/gnome-calendar/-/merge_requests/808>
This commit is contained in:
John Cardullo
2026-10-27 11:10:58 -07:00
parent 4defb0019b
commit 9d29a7a34e
4 changed files with 102 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files
src/core/gcal-calendar-monitor.c
+58 -8
View File
@@ -81,6 +81,7 @@ struct _GcalCalendarMonitor
GHashTable *events; /* gchar* -> GcalEvent* */
GcalRange *range;
gchar *filter;
gboolean expand_recurrences;
} shared;
};
@@ -98,6 +99,7 @@ enum
PROP_0,
PROP_CALENDAR,
PROP_COMPLETE,
PROP_EXPAND_RECURRENCES,
N_PROPS
};
@@ -383,14 +385,26 @@ on_client_view_objects_added_cb (ECalClientView *view,
if (!icomponent || !i_cal_component_get_uid (icomponent))
continue;
/* Recurrent events will be processed later */
if (e_cal_util_component_has_recurrences (icomponent) &&
!e_cal_util_component_is_instance (icomponent))
if (self->shared.expand_recurrences)
{
GCAL_TRACE_MSG ("Component %s (%s) needs to be expanded",
i_cal_component_get_summary (icomponent),
i_cal_component_get_uid (icomponent));
g_ptr_array_add (components_to_expand, icomponent);
/* Recurrent events will be processed later */
if (e_cal_util_component_has_recurrences (icomponent) &&
!e_cal_util_component_is_instance (icomponent))
{
GCAL_TRACE_MSG ("Component %s (%s) needs to be expanded",
i_cal_component_get_summary (icomponent),
i_cal_component_get_uid (icomponent));
g_ptr_array_add (components_to_expand, icomponent);
continue;
}
}
else if (e_cal_util_component_is_instance (icomponent))
{
/*
* When recurrence expansion is disabled, ignore detached recurrence
* instances (components with a RECURRENCE-ID) returned by EDS so
* only the master recurring component is processed.
*/
continue;
}
@@ -528,12 +542,17 @@ on_client_view_objects_modified_cb (ECalClientView *view,
if (!icomponent || !i_cal_component_get_uid (icomponent))
continue;
/* Ignore modified detached recurrence instances when expansion is disabled */
if (!self->shared.expand_recurrences && e_cal_util_component_is_instance (icomponent))
continue;
ecomponent = e_cal_component_new_from_icalcomponent (i_cal_component_clone (icomponent));
if (!ecomponent)
continue;
recurrence_main = e_cal_util_component_has_recurrences (icomponent) &&
recurrence_main = self->shared.expand_recurrences &&
e_cal_util_component_has_recurrences (icomponent) &&
!e_cal_util_component_is_instance (icomponent);
/*
@@ -1047,6 +1066,9 @@ remove_events_outside_range (GcalCalendarMonitor *self,
{
GcalRange *event_range = gcal_event_get_range (event);
if (!self->shared.expand_recurrences && gcal_event_has_recurrence (event))
continue;
if (gcal_range_calculate_overlap (range, event_range, NULL) != GCAL_RANGE_NO_OVERLAP)
continue;
@@ -1326,6 +1348,10 @@ gcal_calendar_monitor_get_property (GObject *object,
g_value_set_boolean (value, self->complete);
break;
case PROP_EXPAND_RECURRENCES:
g_value_set_boolean (value, gcal_calendar_monitor_get_expand_recurrences (self));
break;
default:
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
}
@@ -1350,6 +1376,10 @@ gcal_calendar_monitor_set_property (GObject *object,
self);
break;
case PROP_EXPAND_RECURRENCES:
self->shared.expand_recurrences = g_value_get_boolean (value);
break;
case PROP_COMPLETE:
default:
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
@@ -1374,12 +1404,24 @@ gcal_calendar_monitor_class_init (GcalCalendarMonitorClass *klass)
FALSE,
G_PARAM_READABLE | G_PARAM_EXPLICIT_NOTIFY | G_PARAM_STATIC_STRINGS);
/**
* GcalCalendarMonitor:expand-recurrences:
*
* Whether to expand recurrences into multiple instances.
*/
properties[PROP_EXPAND_RECURRENCES] = g_param_spec_boolean ("expand-recurrences",
NULL,
NULL,
TRUE,
G_PARAM_READWRITE | G_PARAM_CONSTRUCT_ONLY | G_PARAM_STATIC_STRINGS);
g_object_class_install_properties (object_class, N_PROPS, properties);
}
static void
gcal_calendar_monitor_init (GcalCalendarMonitor *self)
{
self->shared.expand_recurrences = TRUE;
self->shared.events = g_hash_table_new_full (g_str_hash, g_str_equal, g_free, g_object_unref);
self->thread_context = g_main_context_new ();
self->main_context = g_main_context_ref_thread_default ();
@@ -1502,3 +1544,11 @@ gcal_calendar_monitor_is_complete (GcalCalendarMonitor *self)
return self->complete;
}
gboolean
gcal_calendar_monitor_get_expand_recurrences (GcalCalendarMonitor *self)
{
g_return_val_if_fail (GCAL_IS_CALENDAR_MONITOR (self), TRUE);
return self->shared.expand_recurrences;
}