virtualbox_rs 0.4.2

A Rust library for interacting with VirtualBox, providing a safe and idiomatic interface to the VirtualBox API.
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

#[cfg(doc)]
use crate::Machine;
use log::error;
use std::fmt::Display;
use vbox_raw::sys_lib as raw;

/// Cleanup mode, used with [`Machine::unregister`].
#[derive(Debug, Eq, PartialEq)]
pub enum CleanupMode {
    /// Unregister only the machine, but neither delete snapshots nor detach media.
    UnregisterOnly,
    /// Delete all snapshots and detach all media but return none; this will keep all media registered.
    DetachAllReturnNone,
    /// Delete all snapshots, detach all media and return hard disks for closing, but not removable media.
    DetachAllReturnHardDisksOnly,
    /// Delete all snapshots, detach all media and return all media for closing.
    Full,
    /// Delete all snapshots, detach all media and return hard disks and removable media located in the folder of the machine to be deleted and referenced only by this machine, for closing.
    DetachAllReturnHardDisksAndVMRemovable,
}
impl Into<u32> for CleanupMode {
    fn into(self) -> u32 {
        match self {
            CleanupMode::DetachAllReturnNone => raw::CleanupMode_CleanupMode_DetachAllReturnNone,
            CleanupMode::DetachAllReturnHardDisksOnly => {
                raw::CleanupMode_CleanupMode_DetachAllReturnHardDisksOnly
            }
            CleanupMode::Full => raw::CleanupMode_CleanupMode_Full,
            #[cfg(not(is_v_6_1))]
            CleanupMode::DetachAllReturnHardDisksAndVMRemovable => {
                raw::CleanupMode_CleanupMode_DetachAllReturnHardDisksAndVMRemovable
            }
            _ => raw::CleanupMode_CleanupMode_UnregisterOnly,
        }
    }
}

impl From<u32> for CleanupMode {
    fn from(value: u32) -> Self {
        match value {
            raw::CleanupMode_CleanupMode_UnregisterOnly => CleanupMode::UnregisterOnly,
            raw::CleanupMode_CleanupMode_DetachAllReturnNone => CleanupMode::DetachAllReturnNone,
            raw::CleanupMode_CleanupMode_DetachAllReturnHardDisksOnly => {
                CleanupMode::DetachAllReturnHardDisksOnly
            }
            raw::CleanupMode_CleanupMode_Full => CleanupMode::Full,
            #[cfg(not(is_v_6_1))]
            raw::CleanupMode_CleanupMode_DetachAllReturnHardDisksAndVMRemovable => {
                CleanupMode::DetachAllReturnHardDisksAndVMRemovable
            }
            _ => {
                error!("CleanupMode::from. Unknown type: {}", value);
                CleanupMode::UnregisterOnly
            }
        }
    }
}

impl Display for CleanupMode {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "{}", format!("{:?}", self))
    }
}