eryx-runtime 0.4.9

Python WASM runtime component for the eryx sandbox
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

#![cfg_attr(docsrs, feature(doc_cfg))]
//! Eryx Python WASM Runtime
//!
//! Contains the WIT definition and builds the eryx sandbox WASM component.
//! The component uses our custom eryx-wasm-runtime (`liberyx_runtime.so`) for Python
//! execution via CPython FFI.
//!
//! ## Features
//!
//! - `preinit` - Pre-initialization support for capturing Python memory state.
//!   Provides ~25x speedup for sandbox creation. Works with or without native
//!   extensions - can pre-import stdlib modules only.
//!
//! - `native-extensions` - Native Python extension support via late-linking.
//!   Allows adding extensions like numpy at sandbox creation time. Implies `preinit`.
//!
//! ## Contents
//!
//! - `runtime.wit` - WIT interface definition
//! - `linker` - Late-linking support for native extensions (requires `preinit`)
//! - `preinit` - Pre-initialization support (requires `preinit` feature)
//!
//! ## See Also
//!
//! - `eryx-wasm-runtime` - The custom runtime that implements the WIT exports

/// The WIT definition as a string constant.
pub const WIT_DEFINITION: &str = include_str!("../wit/runtime.wit");

/// Late-linking support for native Python extensions.
#[cfg(feature = "preinit")]
pub mod linker;

/// Pre-initialization support for capturing Python memory state.
#[cfg(feature = "preinit")]
pub mod preinit;