Provider-sync example

.gitignore

@@ -1,2 +1,3 @@
 /target
 /test_cache
+/example_cache

examples/provider-sync.rs

@@ -1,11 +1,17 @@
 use std::path::Path;
 
 use my_tasks::{client::Client, traits::CalDavSource};
+use my_tasks::calendar::{CalendarId, cached_calendar::CachedCalendar, remote_calendar::RemoteCalendar};
+use my_tasks::Item;
+use my_tasks::Task;
 use my_tasks::cache::Cache;
 use my_tasks::Provider;
+use my_tasks::traits::BaseCalendar;
 use my_tasks::settings::URL;
 use my_tasks::settings::USERNAME;
 use my_tasks::settings::PASSWORD;
+use my_tasks::settings::EXAMPLE_CALENDAR_URL;
+use my_tasks::utils::pause;
 
 const CACHE_FOLDER: &str = "example_cache";
 
@@ -14,7 +20,10 @@ const CACHE_FOLDER: &str = "example_cache";
 async fn main() {
     env_logger::init();
 
-    println!("This examples show how to sync a remote server with a local cache, using a Provider");
+    println!("This examples show how to sync a remote server with a local cache, using a Provider.");
+    println!("Make sure you have edited your settings.rs to include correct URLs and credentials.");
+    println!("You can also set the RUST_LOG environment variable to display more info about the sync.");
+    pause();
 
     let cache_path = Path::new(CACHE_FOLDER);
 
@@ -32,11 +41,36 @@ async fn main() {
     println!("---- before sync -----");
     my_tasks::utils::print_calendar_list(&cals).await;
 
+    println!("Starting a sync...");
     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!("---- after sync -----");
     let cals = provider.local().get_calendars().await.unwrap();
     my_tasks::utils::print_calendar_list(&cals).await;
+
+    add_items_and_sync_again(&mut provider).await;
+}
+
+async fn add_items_and_sync_again(provider: &mut Provider<Cache, CachedCalendar, Client, RemoteCalendar>) {
+    println!("Now, we'll add a task and run the sync again.");
+    pause();
+
+    let changed_calendar_id: CalendarId = EXAMPLE_CALENDAR_URL.parse().unwrap();
+    let changed_calendar = provider.local().get_calendar(&changed_calendar_id).await.unwrap();
+
+    let new_name = "New example task";
+    let new_task = Task::new(String::from(new_name), false, &changed_calendar_id);
+    changed_calendar.lock().unwrap().add_item(Item::Task(new_task)).await.unwrap();
+
+    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. The new task may not have been synced.");
+    } else {
+        println!("Done syncing the new task '{}'", new_name);
+    }
+    provider.local().save_to_folder().unwrap();
+
+    println!("Done. You can start this example again to see the cache being restored from its current saved state")
 }

src/utils.rs

@@ -3,6 +3,7 @@
 use std::collections::{HashMap, HashSet};
 use std::sync::{Arc, Mutex};
 use std::hash::Hash;
+use std::io::{stdin, stdout, Read, Write};
 
 use minidom::Element;
 
@@ -50,7 +51,6 @@ pub fn find_elem<S: AsRef<str>>(root: &Element, searched_name: S) -> Option<&Ele
 
 
 pub fn print_xml(element: &Element) {
-    use std::io::Write;
     let mut writer = std::io::stdout();
 
     let mut xml_writer = minidom::quick_xml::Writer::new_with_indent(
@@ -139,3 +139,12 @@ where
     }
     result
 }
+
+
+/// Wait for the user to press enter
+pub fn pause() {
+    let mut stdout = stdout();
+    stdout.write_all(b"Press Enter to continue...").unwrap();
+    stdout.flush().unwrap();
+    stdin().read_exact(&mut [0]).unwrap();
+}