Add calendar plugins

plugins/sdk/src/main/java/de/mm20/launcher2/sdk/calendar/CalendarEvent.kt

@@ -0,0 +1,41 @@
+package de.mm20.launcher2.sdk.calendar
+
+import android.net.Uri
+
+data class CalendarEvent(
+    val id: String,
+    val title: String,
+    /**
+     * The name of the calendar the event belongs to.
+     */
+    val calendarName: String?,
+    val description: String? = null,
+    /**
+     * The location of the event.
+     */
+    val location: String? = null,
+    /**
+     * The color of the event, as 0xAARRGGBB int.
+     */
+    val color: Int? = null,
+    /**
+     * Start time of the event in milliseconds since epoch.
+     * For tasks, this can be null.
+     */
+    val startTime: Long?,
+    /**
+     * End time of the event in milliseconds since epoch.
+     * For tasks: Due date of the task.
+     */
+    val endTime: Long,
+    /**
+     * If false, only the date will be shown for the event.
+     */
+    val includeTime: Boolean = true,
+    val attendees: List<String> = emptyList(),
+    val uri: Uri,
+    /**
+     * If this is not null, the event is treated as a task, indicated by a checkmark in the UI.
+     */
+    val isCompleted: Boolean? = null,
+)

plugins/sdk/src/main/java/de/mm20/launcher2/sdk/calendar/CalendarList.kt

@@ -0,0 +1,8 @@
+package de.mm20.launcher2.sdk.calendar
+
+data class CalendarList(
+    val id: String,
+    val name: String,
+    val accountName: String? = null,
+    val color: Int? = null,
+)

plugins/sdk/src/main/java/de/mm20/launcher2/sdk/calendar/CalendarProvider.kt

@@ -0,0 +1,110 @@
+package de.mm20.launcher2.sdk.calendar
+
+import android.database.Cursor
+import android.net.Uri
+import android.os.Bundle
+import android.os.CancellationSignal
+import de.mm20.launcher2.plugin.PluginType
+import de.mm20.launcher2.plugin.config.QueryPluginConfig
+import de.mm20.launcher2.plugin.contracts.CalendarPluginContract
+import de.mm20.launcher2.plugin.contracts.CalendarPluginContract.CalendarListColumns
+import de.mm20.launcher2.plugin.contracts.CalendarPluginContract.EventColumns
+import de.mm20.launcher2.plugin.contracts.SearchPluginContract
+import de.mm20.launcher2.plugin.data.buildCursor
+import de.mm20.launcher2.plugin.data.get
+import de.mm20.launcher2.sdk.base.QueryPluginProvider
+import de.mm20.launcher2.sdk.utils.launchWithCancellationSignal
+import de.mm20.launcher2.search.calendar.CalendarQuery
+import java.time.Instant
+import java.time.ZoneId
+import java.time.ZonedDateTime
+
+abstract class CalendarProvider(
+    config: QueryPluginConfig,
+) : QueryPluginProvider<CalendarQuery, CalendarEvent>(
+    config
+) {
+    override fun query(
+        uri: Uri,
+        projection: Array<out String>?,
+        queryArgs: Bundle?,
+        cancellationSignal: CancellationSignal?
+    ): Cursor? {
+        super.query(uri, projection, queryArgs, cancellationSignal)?.let {
+            return it
+        }
+
+        if (uri.pathSegments.size == 1 && uri.pathSegments.first() == CalendarPluginContract.Paths.CalendarLists) {
+            return getCalendarLists(cancellationSignal).toCursor()
+        }
+        return null
+    }
+
+    private fun getCalendarLists(cancellationSignal: CancellationSignal?): List<CalendarList> {
+        return launchWithCancellationSignal(cancellationSignal) {
+            getCalendarLists()
+        }
+    }
+
+    abstract suspend fun getCalendarLists(): List<CalendarList>
+
+    override fun getQuery(uri: Uri): CalendarQuery {
+        val query = uri.getQueryParameter(CalendarPluginContract.Params.Query)
+        val start = uri.getQueryParameter(CalendarPluginContract.Params.StartTime)?.toLongOrNull()
+        val end = uri.getQueryParameter(CalendarPluginContract.Params.EndTime)?.toLongOrNull()
+        val excludedCalendars = uri.getQueryParameter(CalendarPluginContract.Params.Exclude)?.split(",") ?: emptyList()
+
+        return CalendarQuery(
+            query = query,
+            start = start,
+            end = end,
+            excludedCalendars = excludedCalendars,
+        )
+    }
+
+    override fun Bundle.toResult(): CalendarEvent? {
+        return CalendarEvent(
+            id = get(EventColumns.Id) ?: return null,
+            title = get(EventColumns.Title) ?: return null,
+            description = get(EventColumns.Description),
+            location = get(EventColumns.Location),
+            color = get(EventColumns.Color),
+            calendarName = get(EventColumns.CalendarName),
+            startTime = get(EventColumns.StartTime),
+            endTime = get(EventColumns.EndTime) ?: return null,
+            includeTime = get(EventColumns.IncludeTime) ?: true,
+            attendees = get(EventColumns.Attendees) ?: emptyList(),
+            uri = Uri.parse(get(EventColumns.Uri) ?: return null),
+        )
+    }
+
+    override fun List<CalendarEvent>.toCursor(): Cursor {
+        return buildCursor(EventColumns, this) {
+            put(EventColumns.Id, it.id)
+            put(EventColumns.Title, it.title)
+            put(EventColumns.Description, it.description)
+            put(EventColumns.Location, it.location)
+            put(EventColumns.CalendarName, it.calendarName)
+            put(EventColumns.Color, it.color)
+            put(EventColumns.StartTime, it.startTime)
+            put(EventColumns.EndTime, it.endTime)
+            put(EventColumns.IncludeTime, it.includeTime)
+            put(EventColumns.Attendees, it.attendees)
+            put(EventColumns.Uri, it.uri.toString())
+            put(EventColumns.IsCompleted, it.isCompleted)
+        }
+    }
+
+    override fun getPluginType(): PluginType {
+        return PluginType.Calendar
+    }
+
+    private fun List<CalendarList>.toCursor(): Cursor {
+        return buildCursor(CalendarListColumns, this) {
+            put(CalendarListColumns.Id, it.id)
+            put(CalendarListColumns.Name, it.name)
+            put(CalendarListColumns.Color, it.color)
+            put(CalendarListColumns.AccountName, it.accountName)
+        }
+    }
+}