v0.10.1

Author: ahqsoftwares

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "win32_notif"
-version = "0.10.0"
+version = "0.10.1"
 edition = "2021"
 description = "Wrapper around Windows UWP XAML (WinRT) Notification api"
 license = "MIT"

Cargo.toml

@@ -13,29 +13,42 @@ You declare your own style, however you like as long as the XML Supports it.
 ## Basic Usage
 
 ```rust
-use win32_notif::{Notif, NotifIcon, NotifState, NotifType, NotifFlags};
+use std::{path::absolute, thread::sleep, time::Duration};
+
+use win32_notif::{
+  NotificationBuilder, NotificationDataSet, notification::visual::{Image, Placement, Text, image::{AdaptiveImageAlign, ImageCrop}, text::HintStyle}, notifier::ToastsNotifier
+};
 
 fn main() {
-  let notifier = ToastsNotifier::new("windows app user model id").unwrap();
+  let notifier = ToastsNotifier::new("Microsoft.Windows.Explorer").unwrap();
 
-  // Not correct, undergoing massive rewrite
   let notif = NotificationBuilder::new()
-    .visual(Text::new(2, None, None, string!("Hello There 👋🏼")))
-    .action(ActionButton::new(
-      string!("Yes"),
-      string!("yes"),
-      ActivationType::Foreground,
-      AfterActivationBehavior::Default,
-      None,
-      string!("yes"),
-      HintButtonStyle::Success,
-      string!("Yes"),
-      false
-    ))
-    .build(2, &*NOTIFIER, "tag", "group")
+    .visual(
+      Text::create(0, "Welcome to \"win32_notif\"!! 👋")
+        .align_center(true)
+        .wrap(true)
+        .with_style(HintStyle::Title)
+    )
+    .visual(
+      Text::create_binded(1, "desc")
+        .align_center(true)
+        .wrap(true)
+        .with_style(HintStyle::Body)
+    )
+    .value("desc", "Data binding works as well {WOW}!")
+    .build(0, &notifier, "01", "readme")
+    .unwrap();
+
+  notif.show()
     .unwrap();
 
-  notif.show().unwrap();
+  sleep(Duration::from_secs(1));
+
+  let data = NotificationDataSet::new().unwrap();
+
+  data.insert("desc", "Hello, the message is edited").unwrap();
+
+  notifier.update(&data, "readme", "01").unwrap();
 }
 ```
 
@@ -68,8 +81,9 @@ We've actually implemented a lot of the Notification APIs
 - Inputs
 - Selections
 - Visual
+- **_Idiomatic Rust Builder Style (with\_... methods)_**
 
-and a lot of other things... 🎉
+**_and a lot of other things... 🎉_**
 
 ## Future Project Plan
 

README.md

@@ -6,17 +6,15 @@ use win32_notif::{
       action::{ActivationType, AfterActivationBehavior},
       ActionButton,
     },
-    group::{Group, SubGroup},
     visual::{
       text::{HintAlign, HintStyle},
       Text,
     },
-    AdaptiveText, Scenario,
   },
   NotificationBuilder, ToastsNotifier,
 };
 
-const GUID: u128 = 23885548255760334674942869530154890271u128;
+const _GUID: u128 = 23885548255760334674942869530154890271u128;
 
 pub fn main() {
   let notifier = ToastsNotifier::new("com.ahqstore.app").unwrap();

examples/ahq.png

@@ -11,7 +11,7 @@ use win32_notif::{
     visual::{Image, Placement, Text},
     ToastDuration,
   },
-  ManageNotification, NotificationActivatedEventHandler, NotificationBuilder, ToastsNotifier,
+  NotificationActivatedEventHandler, NotificationBuilder, ToastsNotifier,
 };
 
 fn main() {
@@ -29,7 +29,7 @@ fn main() {
       Some(HeaderActivationType::Foreground),
     ))
     .visual(
-      Image::create(20, format!("file:///{path}"))
+      Image::create(20, format!("file:///{path}").as_str())
         .with_placement(Placement::Hero)
         .without_image_query(),
     )

examples/bind.rs

@@ -0,0 +1,47 @@
+use std::{path::absolute, thread::sleep, time::Duration};
+
+use win32_notif::{
+  NotificationBuilder, NotificationDataSet, notification::visual::{Image, Placement, Text, image::{AdaptiveImageAlign, ImageCrop}, text::HintStyle}, notifier::ToastsNotifier
+};
+
+fn main() {
+  let path = absolute("./examples/ahq.png").unwrap();
+  let path = path.to_string_lossy();
+
+  let notifier = ToastsNotifier::new("Microsoft.Windows.Explorer").unwrap();
+
+  let notif = NotificationBuilder::new()
+    .visual(
+      Text::create(0, "Welcome to \"win32_notif\"!! 👋")
+        .align_center(true)
+        .wrap(true)
+        .with_style(HintStyle::Title)
+    )
+    .visual(
+      Text::create_binded(1, "desc")
+        .align_center(true)
+        .wrap(true)
+        .with_style(HintStyle::Body)
+    )
+    .visual(
+      Image::create(2, format!("file:///{path}").as_str())
+        .with_align(AdaptiveImageAlign::Default)
+        .with_alt("AHQ Logo")
+        .with_crop(ImageCrop::Circle)
+        .with_placement(Placement::AppLogoOverride)
+    )
+    .value("desc", "Data binding works as well {WOW}!")
+    .build(0, &notifier, "01", "readme")
+    .unwrap();
+
+  notif.show()
+    .unwrap();
+
+  sleep(Duration::from_secs(1));
+
+  let data = NotificationDataSet::new().unwrap();
+
+  data.insert("desc", "Hello, the message is edited").unwrap();
+
+  notifier.update(&data, "readme", "01").unwrap();
+}

examples/lunch.rs

@@ -31,7 +31,7 @@ impl ToXML for Header {
   fn to_xml(&self) -> String {
     format!(
       r#"
-      <header title=\"{}\" arguments=\"{}\" id=\"{}\" activationType="{}" />
+      <header title="{}" arguments="{}" id="{}" activationType="{}" />
     "#,
       self.title, self.arguments, self.id, self.activation_type
     )

examples/readme.rs

@@ -1,3 +1,5 @@
+use quick_xml::escape::escape;
+
 use crate::{notification::ToastVisualableXML, ToXML};
 
 use super::{TextOrImageElement, VisualElement};
@@ -98,10 +100,10 @@ impl Image {
   /// - `file:///path/to/file`
   ///
   /// If none of the above is provided, the `src` will be set to `file:///path/to/file`
-  pub fn create<T: Into<String>>(id: u64, src: T) -> Self {
+  pub fn create(id: u64, src: &str) -> Self {
     Self::new(
       id,
-      src.into(),
+      escape(src).into(),
       None,
       false,
       Placement::None,