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
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
97
98
99
100
101
102
103
104
105
106
107

use crate::VboxErrorType;
use std::fmt::Display;

pub(crate) mod vbox_error_type;
#[derive(Debug, Eq, PartialEq)]
pub struct VboxError {
    pub error_type: VboxErrorType,
    pub code: u32,
    pub fn_name: String,
    pub msg: String,
}

impl VboxError {
    pub fn new(code: u32, fn_name: &str, msg: String, error_type: Option<VboxErrorType>) -> Self {
        let error_type = match error_type {
            Some(error_type) => error_type,
            None => VboxErrorType::from(code),
        };

        Self {
            error_type,
            code,
            fn_name: fn_name.to_string(),
            msg,
        }
    }
    pub fn incorrect_version(
        raw_ver: String,
        vbox_sys_ver: String,
        vbox_ver: u32,
        vbox_api_ver: u32,
        build_ver: u32,
    ) -> Self {
        Self {
            error_type: VboxErrorType::IncorrectVersion {
                raw_ver,
                vbox_sys_ver,
                vbox_ver,
                vbox_api_ver,
                build_ver,
            },
            code: 0,
            fn_name: "".to_string(),
            msg: "".to_string(),
        }
    }

    pub fn get_fn_error(fn_name: &str) -> Self {
        Self {
            error_type: VboxErrorType::GetFnError,
            code: 0,
            fn_name: fn_name.to_string(),
            msg: "".to_string(),
        }
    }

    pub fn null_pointer_error(fn_name: &str) -> Self {
        Self {
            error_type: VboxErrorType::NullPointerError,
            code: 0,
            fn_name: fn_name.to_string(),
            msg: "".to_string(),
        }
    }
    pub fn release_error(fn_name: &str) -> Self {
        Self {
            error_type: VboxErrorType::ReleaseError,
            code: 0,
            fn_name: fn_name.to_string(),
            msg: "".to_string(),
        }
    }
    pub fn error_init() -> Self {
        Self {
            error_type: VboxErrorType::ErrorInit,
            code: 0,
            fn_name: "".to_string(),
            msg: "".to_string(),
        }
    }

    pub fn unsupported_in_current_api_version(fn_name: &str, supported_version: &str) -> Self {
        Self {
            error_type: VboxErrorType::UnsupportedInCurrentApiVersion,
            code: 0,
            fn_name: fn_name.to_string(),
            msg: format!("This error occurs when the requested method is not supported by the current API version. Supported from version: {}", supported_version),
        }
    }
    pub fn vectors_length_mismatch(fn_name: &str) -> Self {
        Self {
            error_type: VboxErrorType::VectorsLengthMismatch,
            code: 0,
            fn_name: fn_name.to_string(),
            msg: "".to_string(),
        }
    }
    pub fn is_null(&self) -> bool {
        self.error_type == VboxErrorType::NullPointerError
    }
}

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