Struct AppleCalendar 

pub struct AppleCalendar { /* private fields */ }

A connected Apple Calendar, used by tum_apple_sync.

Cloning is cheap (the underlying connection pool is shared), so the handle can be created once and moved into a callback.

Examples

let apple_calendar = AppleCalendar::connect("me@icloud.com", "abcd-efgh-ijkl-mnop", "TUM")
    .await
    .expect("Failed to connect to the Apple Calendar");

Implementations

impl AppleCalendar

pub async fn connect( apple_id: &str, app_password: &str, calendar_name: &str, ) -> Result<Self, Box<dyn Error + Send + Sync>>

Connects to the iCloud calendar named calendar_name.

app_password has to be an app-specific password, your regular Apple ID password won’t be accepted.

pub async fn connect_to( server_url: &str, username: &str, password: &str, calendar_name: &str, ) -> Result<Self, Box<dyn Error + Send + Sync>>

Same as AppleCalendar::connect, but for any other CalDAV server (Fastmail, Nextcloud, Radicale, …).

pub fn from_calendar_url( username: &str, password: &str, calendar_url: &str, ) -> Result<Self, Box<dyn Error + Send + Sync>>

Skips the discovery and uses the calendar collection at calendar_url directly.

pub async fn with_exam_calendar( self, calendar_name: &str, ) -> Result<Self, Box<dyn Error + Send + Sync>>

Puts exams (events with “Prüfung” in their title) into the calendar named calendar_name instead, so that they can have a color of their own - Apple Calendar only colors whole calendars, not single events. It has to belong to the same account.

Exams which are in the main calendar already can be moved over with move_exams_to_exam_calendar.

pub fn with_exam_calendar_url( self, calendar_url: &str, ) -> Result<Self, Box<dyn Error + Send + Sync>>

Same as AppleCalendar::with_exam_calendar, but skips the discovery and uses the calendar collection at calendar_url directly.

pub fn calendar_url(&self) -> &str

pub fn exam_calendar_url(&self) -> Option<&str>

Trait Implementations

impl Clone for AppleCalendar

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AppleCalendar

fn fmt(&self, formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.