wsbx 0.1.0

A type-safe Rust API for controlling Windows Sandbox, through the `wsb` CLI
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

use std::{fmt, str::FromStr};

use serde::Deserialize;
use uuid::Uuid;

use crate::SandboxError;

/// The identifier of a Windows Sandbox environment.
///
/// This corresponds to the GUID value used by the `wsb` CLI.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Deserialize)]
#[serde(transparent)]
pub struct SandboxId(Uuid);

impl From<Uuid> for SandboxId {
    fn from(value: Uuid) -> Self {
        SandboxId(value)
    }
}

impl FromStr for SandboxId {
    type Err = SandboxError;

    fn from_str(s: &str) -> Result<Self, Self::Err> {
        let id = Uuid::from_str(s)?;
        Ok(Self(id))
    }
}

impl SandboxId {
    /// Creates a sandbox ID from a UUID value.
    #[must_use]
    pub fn new(uuid: Uuid) -> Self {
        Self(uuid)
    }

    /// Returns the underlying UUID value.
    #[must_use]
    pub fn uuid(&self) -> Uuid {
        self.0
    }
}

impl fmt::Display for SandboxId {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        fmt::Display::fmt(&self.0, f)
    }
}

/// The user context used when executing a command in a sandbox.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub enum RunAs {
    /// Runs the command in the currently active user session.
    ExistingLogin,
    /// Runs the command in the system context.
    System,
}