Struct Client 

pub struct Client { /* private fields */ }

A CalDAV data source that fetches its data from a CalDAV server

Implementations

impl Client

pub fn new<S: AsRef<str>, T: ToString, U: ToString>( url: S, username: T, password: U, ) -> Result<Self, Box<dyn Error>>

Create a client. This does not start a connection

Examples found in repository

examples/shared.rs (line 26)

pub async fn initial_sync(cache_folder: &str) -> CalDavProvider {
    let cache_path = Path::new(cache_folder);

    let client = Client::new(URL, USERNAME, PASSWORD).unwrap();
    let cache = match Cache::from_folder(&cache_path) {
        Ok(cache) => cache,
        Err(err) => {
            log::warn!("Invalid cache file: {}. Using a default cache", err);
            Cache::new(&cache_path)
        }
    };
    let mut provider = CalDavProvider::new(client, cache);


    let cals = provider.local().get_calendars().await.unwrap();
    println!("---- Local items, before sync -----");
    kitchen_fridge::utils::print_calendar_list(&cals).await;

    println!("Starting a sync...");
    println!("Depending on your RUST_LOG value, you may see more or less details about the progress.");
    // Note that we could use sync_with_feedback() to have better and formatted feedback
    if provider.sync().await == false {
        log::warn!("Sync did not complete, see the previous log lines for more info. You can safely start a new sync.");
    }
    provider.local().save_to_folder().unwrap();

    println!("---- Local items, after sync -----");
    let cals = provider.local().get_calendars().await.unwrap();
    kitchen_fridge::utils::print_calendar_list(&cals).await;

    provider
}

Trait Implementations

impl CalDavSource<RemoteCalendar> for Client

fn get_calendars<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<HashMap<Url, Arc<Mutex<RemoteCalendar>>>, Box<dyn Error>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Returns the current calendars that this source contains This function may trigger an update (that can be a long process, or that can even fail, e.g. in case of a remote server)

fn get_calendar<'life0, 'life1, 'async_trait>( &'life0 self, url: &'life1 Url, ) -> Pin<Box<dyn Future<Output = Option<Arc<Mutex<RemoteCalendar>>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Returns the calendar matching the URL

fn create_calendar<'life0, 'async_trait>( &'life0 mut self, url: Url, name: String, supported_components: SupportedComponents, color: Option<Color>, ) -> Pin<Box<dyn Future<Output = Result<Arc<Mutex<RemoteCalendar>>, Box<dyn Error>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Create a calendar if it did not exist, and return it

impl Debug for Client

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

Formats the value using the given formatter.