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
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96

//! Provides an [`flagset`] implementation for [`WSLUserConfiguration`] flags.
use super::WSLUserConfiguration;
use flagset::{flags, FlagSet};

flags! {
    /// Represents the user configuration flags for Windows Subsystem for Linux (WSL) as
    /// [flagset]
    ///
    /// These flags are used to customize the behavior of WSL instances based on user configuration.
    /// The values correspond to the definitions in the WSL Plugin API provided by Microsoft.
    ///
    /// # Variants
    ///
    /// - `CustomKernel`: Indicates that the WSL instance use use a custom Linux kernel instead of the default kernel.
    /// - `CustomKernelCommandLine`: Specifies that the WSL instance use use a custom kernel command-line during boot.
    ///
    /// # References
    ///
    /// See [WSL Configuration](https://learn.microsoft.com/windows/wsl/wsl-config)
    /// for additional details on WSL user configurations.
    #[derive(Hash)]
    pub enum WSLUserConfigurationFlags: i32 {
        /// A custom Linux kernel is used for the WSL instance.
        CustomKernel = wslpluginapi_sys::WSLUserConfiguration_WSLUserConfigurationCustomKernel,
        /// A custom kernel command-line is used for the WSL instance.
        CustomKernelCommandLine =
            wslpluginapi_sys::WSLUserConfiguration_WSLUserConfigurationCustomKernelCommandLine,
    }
}

impl From<WSLUserConfiguration> for FlagSet<WSLUserConfigurationFlags> {
    #[inline]
    fn from(value: WSLUserConfiguration) -> Self {
        Self::new_truncated(value.0)
    }
}

impl From<FlagSet<WSLUserConfigurationFlags>> for WSLUserConfiguration {
    #[inline]
    fn from(value: FlagSet<WSLUserConfigurationFlags>) -> Self {
        Self::from(value.bits())
    }
}

impl WSLUserConfiguration {
    /// Converts the [`WSLUserConfiguration`] into a [`FlagSet`] of (`WSLUserConfigurationFlags`).
    #[inline]
    #[must_use]
    pub fn into_flagset(self) -> FlagSet<WSLUserConfigurationFlags> {
        FlagSet::from(self)
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_default_flagset() {
        let default_config = FlagSet::<WSLUserConfigurationFlags>::default();
        assert_eq!(default_config, FlagSet::default());
        assert!(default_config.is_empty());
    }

    #[test]
    fn test_set_and_clear_flagset() {
        let mut config = FlagSet::<WSLUserConfigurationFlags>::default();
        config |= WSLUserConfigurationFlags::CustomKernel;
        assert!(config.contains(WSLUserConfigurationFlags::CustomKernel));
        config &= !WSLUserConfigurationFlags::CustomKernel;
        assert!(!config.contains(WSLUserConfigurationFlags::CustomKernel));
    }

    #[test]
    fn test_multiple_flags_flagset() {
        let mut config = FlagSet::<WSLUserConfigurationFlags>::default();
        config |= WSLUserConfigurationFlags::CustomKernel
            | WSLUserConfigurationFlags::CustomKernelCommandLine;
        assert!(config.contains(WSLUserConfigurationFlags::CustomKernel));
        assert!(config.contains(WSLUserConfigurationFlags::CustomKernelCommandLine));
        config &= !WSLUserConfigurationFlags::CustomKernel;
        assert!(!config.contains(WSLUserConfigurationFlags::CustomKernel));
        assert!(config.contains(WSLUserConfigurationFlags::CustomKernelCommandLine));
    }

    #[test]
    fn test_conversion_between_flags_and_configuration() {
        let config = WSLUserConfiguration(3); // Assuming 3 = CustomKernel | CustomKernelCommandLine
        let flags: FlagSet<WSLUserConfigurationFlags> = config.into();
        assert!(flags.contains(WSLUserConfigurationFlags::CustomKernel));
        assert!(flags.contains(WSLUserConfigurationFlags::CustomKernelCommandLine));

        let back_to_config: WSLUserConfiguration = flags.into();
        assert_eq!(back_to_config, WSLUserConfiguration(3));
    }
}