heel 0.1.1

Cross-platform native sandboxing library for running untrusted code
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

use std::io;
use std::path::PathBuf;
use thiserror::Error;

use crate::ipc::IpcError;

/// Result type for sandbox operations
pub type Result<T> = std::result::Result<T, Error>;

/// Errors that can occur during sandbox operations
#[derive(Error, Debug)]
pub enum Error {
    #[error("unsupported platform")]
    UnsupportedPlatform,

    #[error("platform {platform} requires version {minimum}, found {current}")]
    UnsupportedPlatformVersion {
        platform: &'static str,
        minimum: &'static str,
        current: String,
    },

    #[error("sandbox initialization failed: {0}")]
    InitFailed(String),

    #[error("sandbox not enforced: {0}")]
    NotEnforced(&'static str),

    #[error("sandbox only partially enforced: {0}")]
    PartialEnforcement(&'static str),

    #[error("invalid sandbox profile: {0}")]
    InvalidProfile(String),

    #[error("path does not exist: {0}")]
    PathNotFound(PathBuf),

    #[error("python not found on system")]
    PythonNotFound,

    #[error("python venv not found at: {0}")]
    VenvNotFound(PathBuf),

    #[error("python venv creation failed: {0}")]
    VenvCreationFailed(String),

    #[error("package installation failed: {0}")]
    PackageInstallFailed(String),

    #[error("network proxy error: {0}")]
    ProxyError(String),

    #[error("process execution failed: {0}")]
    ProcessError(#[from] io::Error),

    #[error("command failed with exit code {code}: {message}")]
    CommandFailed { code: i32, message: String },

    #[error("configuration error: {0}")]
    ConfigError(String),

    #[error("FFI error: {0}")]
    FfiError(String),

    #[error("I/O error: {0}")]
    IoError(String),

    #[error("IPC error: {0}")]
    IpcError(#[from] IpcError),

    #[error("PTY error: {0}")]
    PtyError(String),
}