boxlite 0.9.1

Embeddable virtual machine runtime for secure, isolated code execution
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

//! High-level guest session.
//!
//! Thin facade over service interfaces.

use crate::portal::connection::Connection;
use crate::portal::interfaces::FilesInterface;
use crate::portal::interfaces::{ContainerInterface, ExecutionInterface, GuestInterface};
use boxlite_shared::{BoxliteResult, Transport};

/// High-level guest session.
///
/// Provides access to service interfaces.
#[derive(Clone)]
pub struct GuestSession {
    connection: Connection,
}

impl GuestSession {
    /// Create a session (connects lazily on first use).
    pub fn new(transport: Transport) -> Self {
        Self {
            connection: Connection::new(transport),
        }
    }

    /// Get execution interface.
    pub async fn execution(&self) -> BoxliteResult<ExecutionInterface> {
        let channel = self.connection.channel().await?;
        Ok(ExecutionInterface::new(channel))
    }

    /// Get container interface.
    pub async fn container(&self) -> BoxliteResult<ContainerInterface> {
        let channel = self.connection.channel().await?;
        Ok(ContainerInterface::new(channel))
    }

    /// Get guest interface.
    pub async fn guest(&self) -> BoxliteResult<GuestInterface> {
        let channel = self.connection.channel().await?;
        Ok(GuestInterface::new(channel))
    }

    /// Get files interface.
    pub async fn files(&self) -> BoxliteResult<FilesInterface> {
        let channel = self.connection.channel().await?;
        Ok(FilesInterface::new(channel))
    }
}

// ============================================================================
// THREAD SAFETY ASSERTIONS
// ============================================================================

// Compile-time assertions to ensure GuestSession is Send + Sync
const _: () = {
    const fn assert_send_sync<T: Send + Sync>() {}
    let _ = assert_send_sync::<GuestSession>;
};