rdi_core/
id.rs

1//! Opaque, backend-defined identifiers for desktop icons.
2
3use core::fmt;
4
5/// Stable, opaque identifier for a single desktop icon.
6///
7/// On the Windows backend this is the hex-encoded UTF-16 representation of
8/// the desktop-relative path (or display name for virtual items — *This PC*,
9/// *Recycle Bin*, etc.), byte-identical to the legacy `positioner_c_part`
10/// implementation.
11///
12/// The identifier is designed to survive a JSON round-trip, so it is safe to
13/// return from a Python binding, hand off to an MCP client, and pass back on
14/// a subsequent call.
15#[derive(Clone, Debug, PartialEq, Eq, Hash, PartialOrd, Ord)]
16pub struct IconId(String);
17
18impl IconId {
19    /// Wrap a raw identifier string.
20    ///
21    /// This does **not** validate the format — validation is the backend's
22    /// responsibility.
23    #[inline]
24    pub fn new(id: impl Into<String>) -> Self {
25        Self(id.into())
26    }
27
28    #[inline]
29    pub fn as_str(&self) -> &str {
30        &self.0
31    }
32
33    #[inline]
34    pub fn into_string(self) -> String {
35        self.0
36    }
37}
38
39impl fmt::Display for IconId {
40    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
41        f.write_str(&self.0)
42    }
43}
44
45impl AsRef<str> for IconId {
46    fn as_ref(&self) -> &str {
47        &self.0
48    }
49}
50
51impl From<String> for IconId {
52    fn from(s: String) -> Self {
53        Self(s)
54    }
55}
56
57impl From<&str> for IconId {
58    fn from(s: &str) -> Self {
59        Self(s.to_owned())
60    }
61}
62
63#[cfg(test)]
64mod tests {
65    use super::*;
66
67    #[test]
68    fn round_trip() {
69        let id = IconId::new("0041 0042 0043");
70        assert_eq!(id.as_str(), "0041 0042 0043");
71        assert_eq!(id.clone().into_string(), "0041 0042 0043");
72        assert_eq!(format!("{id}"), "0041 0042 0043");
73    }
74
75    #[test]
76    fn hash_eq() {
77        use std::collections::HashSet;
78        let mut s = HashSet::new();
79        s.insert(IconId::from("x"));
80        assert!(s.contains(&IconId::from("x")));
81        assert!(!s.contains(&IconId::from("y")));
82    }
83}
rdi_core/id.rs

rdi_core/
id.rs
