Add serde derives

Author: OpenByteDev

Cargo.toml

@@ -25,6 +25,7 @@ num_enum = { version = "0.7", default-features = false }
 thiserror = { version = "2.0", default-features = false }
 enumflags2 = { version = "0.7", default-features = false }
 dunce = { version = "1.0", default-features = false }
+serde = { version = "1.0", features = ["derive"], optional = true }
 
 [dev-dependencies]
 dunce = { version = "1", default-features = false }
@@ -33,6 +34,7 @@ uuid = { version = "1", features = ["v4"], default-features = false  }
 [features]
 default = ["runas"]
 runas = []
+serde = ["dep:serde"]
 doc-cfg = []
 
 [package.metadata.docs.rs]

src/hotkey.rs

@@ -14,6 +14,7 @@ const fn convert(code: u32) -> u8 {
 #[bitflags]
 #[repr(u8)]
 #[derive(Debug, Clone, Copy, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 pub enum HotkeyModifier {
     /// Shift key modifier.
     Shift = convert(HOTKEYF_SHIFT),
@@ -72,6 +73,7 @@ impl HotkeyModifier {
 ///
 /// See also <https://learn.microsoft.com/en-us/windows/win32/api/shobjidl_core/nf-shobjidl_core-ishelllinkw-gethotkey>.
 #[derive(Debug, Clone, Copy, PartialEq, Eq)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 pub struct Hotkey {
     /// Virtual key code
     key: VirtualKey,

src/icon.rs

@@ -5,6 +5,7 @@ use std::{
 
 /// Icon resource used by a Windows shortcut.
 #[derive(Debug, Clone, Default)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 pub struct Icon {
     /// Path to the file containing the icon resource.
     ///

src/shortcut.rs

@@ -27,6 +27,7 @@ use crate::{
 ///
 /// See also <https://learn.microsoft.com/en-us/windows/win32/api/shobjidl_core/nn-shobjidl_core-ishelllinka>
 #[derive(Debug, Clone, Default)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 pub struct Shortcut {
     /// Path to the target executable or file.
     pub target_path: Option<PathBuf>,

src/virtual_key.rs

@@ -15,7 +15,10 @@ const fn convert(key: VIRTUAL_KEY) -> u8 {
 ///
 /// See: <https://learn.microsoft.com/en-us/windows/win32/inputdev/virtual-key-codes>
 #[repr(u8)]
-#[derive(Debug, Clone, Copy, PartialEq, Eq, FromPrimitive, IntoPrimitive)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[derive(
+    Debug, Clone, Copy, PartialEq, Eq, FromPrimitive, IntoPrimitive, PartialOrd, Ord, Hash,
+)]
 pub enum VirtualKey {
     // 0x01 - 0x06: Mouse buttons (documented order)
     /// Left mouse button

src/window_state.rs

@@ -6,9 +6,12 @@ use windows::Win32::UI::WindowsAndMessaging::{
 
 /// Initial window display state for a launched application.
 ///
-/// See also <https://learn.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-showwindow>
+/// See <https://learn.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-showwindow>
 #[repr(i32)]
-#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, IntoPrimitive, FromPrimitive)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[derive(
+    Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash, IntoPrimitive, FromPrimitive,
+)]
 pub enum WindowState {
     /// Normal window (`SW_SHOWNORMAL`).
     ///