wslplugins-rs 0.1.0-beta.2

A Rust framework for developing WSL plugins using safe and idiomatic Rust.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

use std::{
    fmt::{LowerHex, UpperHex},
    io::Write,
    str::FromStr,
};

use crate::user_distribution_id::ParseError;
use windows_core::GUID;

use crate::{user_distribution_id::fmt::formatter::Formatter, UserDistributionID};
pub struct GuidFormatter(GUID);

impl GuidFormatter {
    const ENCODE_BUFFER: [u8; 36] = [0u8; 36];
}

impl Formatter for GuidFormatter {}

impl UpperHex for GuidFormatter {
    #[inline]
    #[expect(clippy::use_debug, reason = "Guid debug format is what we expect")]
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "{:?}", self.0)
    }
}

impl LowerHex for GuidFormatter {
    #[inline]
    #[expect(clippy::use_debug, reason = "Guid debug format is what we expect")]
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        let mut buffer = Self::ENCODE_BUFFER;
        write!(&mut buffer[..], "{:?}", self.0).map_err(|_| std::fmt::Error)?;
        for b in &mut buffer {
            *b = b.to_ascii_lowercase();
        }
        // SAFETY: All bytes are valid ASCII characters.
        let s = unsafe { core::str::from_utf8_unchecked(&buffer) };
        f.write_str(s)
    }
}

impl From<GuidFormatter> for UserDistributionID {
    #[inline]
    fn from(value: GuidFormatter) -> Self {
        value.0.into()
    }
}

impl From<UserDistributionID> for GuidFormatter {
    #[inline]
    fn from(value: UserDistributionID) -> Self {
        Self(GUID::from(value))
    }
}

impl FromStr for GuidFormatter {
    type Err = ParseError;
    #[inline]
    fn from_str(s: &str) -> Result<Self, Self::Err> {
        Ok(GUID::try_from(s).map(Self)?)
    }
}