Struct RibRepl

pub struct RibRepl { /* private fields */ }

The REPL environment for Rib, providing an interactive shell for executing Rib code.

Implementations

impl RibRepl

pub async fn bootstrap( history_file: Option<PathBuf>, dependency_manager: Arc<dyn RibDependencyManager + Sync + Send>, worker_function_invoke: Arc<dyn WorkerFunctionInvoke + Sync + Send>, printer: Option<Box<dyn ReplPrinter>>, component_source: Option<ComponentSource>, ) -> Result<RibRepl, ReplBootstrapError>

Bootstraps and initializes the Rib REPL environment and returns a RibRepl instance, which can be used to run the REPL.

Arguments

• history_file: Optional path to a file where the REPL history will be stored and loaded from. If None, it will be loaded from ~/.rib_history.
• dependency_manager: This is responsible for how to load all the components or a specific custom component.
• worker_function_invoke: An implementation of the WorkerFunctionInvoke trait,
• printer: Optional custom printer for displaying results and errors in the REPL. If None a default printer will be used.
• component_source: Optional details about the component to be loaded, including its name and source file path. If None, the REPL will try to load all the components using the dependency_manager, otherwise, dependency_manager will load only the specified component.

pub fn read_line(&mut self) -> Result<String>

Reads a single line of input from the REPL prompt.

This method is exposed for users who want to manage their own REPL loop instead of using the built-in Self::run method.

pub async fn execute_rib( &mut self, rib: &str, ) -> Result<Option<RibResult>, RibError>

Executes a single line of Rib code and returns the result.

This function is exposed for users who want to implement custom REPL loops or integrate Rib execution into other workflows. For a built-in REPL loop, see Self::run.

pub fn update_component_dependency(&mut self, dependency: RibComponentMetadata)

Dynamically updates the REPL session with a new component dependency.

This method is intended for use in interactive or user-controlled REPL loops, allowing runtime replacement of active component metadata.

Note: Currently, only a single component is supported per session. Multi-component support is planned but not yet implemented.

pub async fn run(&mut self)

Starts the default REPL loop for executing Rib code interactively.

This is a convenience method that repeatedly reads user input and executes it using Self::execute_rib. If you need more control over the REPL behavior, use Self::read_line and Self::execute_rib directly.