rustledger-plugin 0.13.0

Beancount plugin system with 20 native plugins and WASM support
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

//! Python plugin support via CPython-WASI.
//!
//! This module enables running Python beancount plugins in a sandboxed WASM
//! environment. The Python runtime (`CPython` compiled to WASI) is downloaded
//! on first use and cached locally.
//!
//! # Features
//!
//! - Runs unmodified Python beancount plugins
//! - Fully sandboxed (no filesystem or network access)
//! - Downloaded on first use (~50MB)
//! - Compatible with most pure-Python plugins
//!
//! # Limitations
//!
//! - No C extensions (numpy, scikit-learn, etc.)
//! - No filesystem access for plugins
//! - No network access for plugins
//! - 10-100x slower than native Rust plugins
//!
//! # Example
//!
//! ```ignore
//! use rustledger_plugin::python::PythonRuntime;
//!
//! let runtime = PythonRuntime::new()?;
//! let output = runtime.execute_plugin(
//!     "beancount.plugins.check_commodity",
//!     &input,
//! )?;
//! ```

mod compat;
mod download;
mod runtime;

pub use runtime::{PythonRuntime, is_python_available, suggest_module_path};

/// Python plugin error types.
#[derive(Debug, thiserror::Error)]
pub enum PythonError {
    /// Failed to download Python runtime.
    #[error("failed to download Python runtime: {0}")]
    Download(String),

    /// Checksum mismatch after download.
    #[error("checksum mismatch: expected {expected}, got {actual}")]
    ChecksumMismatch {
        /// Expected checksum.
        expected: String,
        /// Actual checksum.
        actual: String,
    },

    /// Failed to execute Python code.
    #[error("Python execution failed: {0}")]
    Execution(String),

    /// Failed to serialize/deserialize data.
    #[error("serialization error: {0}")]
    Serialization(String),

    /// IO error.
    #[error("IO error: {0}")]
    Io(#[from] std::io::Error),

    /// WASM runtime error.
    #[error("WASM runtime error: {0}")]
    Wasm(#[from] wasmtime::Error),

    /// Plugin module not found on the system.
    #[error("Python plugin module not found: {0}")]
    ModuleNotFound(String),

    /// Plugin is a C extension (not supported in WASI sandbox).
    #[error("Python plugin '{0}' is a C extension and cannot run in WASI sandbox")]
    CExtensionNotSupported(String),

    /// Python runtime not available (Python interpreter not found).
    #[error("Python runtime unavailable: {0}")]
    RuntimeUnavailable(String),
}