Struct MontyPythonCodeToolBuilder 

pub struct MontyPythonCodeToolBuilder { /* private fields */ }

Available on crate feature tools only.

Configures a MontyPythonCodeTool: OS-access grants, host functions, and limits are forwarded to MontyExecutorBuilder; the terminal methods select the mode.

Example

use adk_code::PathAccess;
use adk_tool::{MontyPythonCodeTool, Tool};

let tool = MontyPythonCodeTool::builder()
    .environ_var("PROJECT", "acme")
    .system_clock()
    .build_repl()?;
assert!(tool.description().contains("PROJECT"));

Implementations

impl MontyPythonCodeToolBuilder

pub fn new() -> MontyPythonCodeToolBuilder

Available on crate feature code only.

Start with the fully sandboxed defaults.

pub fn allow_path( self, virtual_path: impl Into<String>, host_path: impl Into<PathBuf>, access: PathAccess, ) -> MontyPythonCodeToolBuilder

Available on crate feature code only.

Make a host directory available to scripts at virtual_path. See MontyExecutorBuilder::allow_path.

pub fn environ<K, V>( self, vars: impl IntoIterator<Item = (K, V)>, ) -> MontyPythonCodeToolBuilder

where K: Into<String>, V: Into<String>,

Available on crate feature code only.

Replace the environment map exposed via os.getenv / os.environ. See MontyExecutorBuilder::environ.

pub fn environ_var( self, key: impl Into<String>, value: impl Into<String>, ) -> MontyPythonCodeToolBuilder

Available on crate feature code only.

Add or overwrite a single environment variable. See MontyExecutorBuilder::environ_var.

pub fn system_clock(self) -> MontyPythonCodeToolBuilder

Available on crate feature code only.

Grant host-clock access (date.today() / datetime.now()). See MontyExecutorBuilder::system_clock.

pub fn function( self, function: Arc<dyn HostFunction>, ) -> MontyPythonCodeToolBuilder

Available on crate feature code only.

Register a host function callable from Python by bare name. See MontyExecutorBuilder::function.

pub fn function_fn<F, Fut>( self, name: impl Into<String>, description: impl Into<String>, func: F, ) -> MontyPythonCodeToolBuilder

where F: Fn(Vec<Value>, Map<String, Value>) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<Value, HostFunctionError>> + Send + 'static,

Available on crate feature code only.

Register a closure as a host function. See MontyExecutorBuilder::function_fn.

pub fn max_memory(self, bytes: usize) -> MontyPythonCodeToolBuilder

Available on crate feature code only.

Cap the interpreter’s memory use in bytes. See MontyExecutorBuilder::max_memory.

pub fn host_function_timeout( self, timeout: Duration, ) -> MontyPythonCodeToolBuilder

Available on crate feature code only.

Wall-clock bound for a single host-function call. See MontyExecutorBuilder::host_function_timeout.

pub fn max_sessions(self, max_sessions: usize) -> MontyPythonCodeToolBuilder

Available on crate feature code only.

Cap on concurrently retained REPL sessions (default 100). The least recently used session is evicted at the cap; its next call starts a fresh interpreter. A value of 0 is treated as 1.

pub fn build_one_shot(self) -> Result<MontyPythonCodeTool, MontyBuildError>

Available on crate feature code only.

Build a one-shot tool: each call runs in a fresh interpreter.

Errors

Returns a MontyBuildError when the host-function registry is invalid.

pub fn build_repl(self) -> Result<MontyPythonCodeTool, MontyBuildError>

Available on crate feature code only.

Build a REPL tool: interpreter state persists across calls, scoped per ADK session.

Errors

Returns a MontyBuildError when the host-function registry is invalid.

Trait Implementations

impl Default for MontyPythonCodeToolBuilder

fn default() -> MontyPythonCodeToolBuilder

Returns the “default value” for a type.