//! Rhai wrappers for Nerdctl module functions //! //! This module provides Rhai wrappers for the functions in the Nerdctl module. use rhai::{Engine, EvalAltResult, Array, Dynamic, Map}; use std::collections::HashMap; use crate::virt::nerdctl::{self, NerdctlError, Image, Container}; use crate::process::CommandResult; // Helper functions for error conversion with improved context fn nerdctl_error_to_rhai_error(result: Result) -> Result> { result.map_err(|e| { // Create a more detailed error message based on the error type let error_message = match &e { NerdctlError::CommandExecutionFailed(io_err) => { format!("Failed to execute nerdctl command: {}. This may indicate nerdctl is not installed or not in PATH.", io_err) }, NerdctlError::CommandFailed(msg) => { format!("Nerdctl command failed: {}. Check container status and logs for more details.", msg) }, NerdctlError::JsonParseError(msg) => { format!("Failed to parse nerdctl JSON output: {}. This may indicate an incompatible nerdctl version.", msg) }, NerdctlError::ConversionError(msg) => { format!("Data conversion error: {}. This may indicate unexpected output format from nerdctl.", msg) }, NerdctlError::Other(msg) => { format!("Nerdctl error: {}. This is an unexpected error.", msg).. }, }; Box::new(EvalAltResult::ErrorRuntime( error_message.into(), rhai::Position::NONE )) }) } // // Container Builder Pattern Implementation // /// Create a new Container pub fn container_new(name: &str) -> Result> { nerdctl_error_to_rhai_error(Container::new(name)) } /// Create a Container from an image pub fn container_from_image(name: &str, image: &str) -> Result> { nerdctl_error_to_rhai_error(Container::from_image(name, image)) } /// Add a port mapping to a Container pub fn container_with_port(mut container: Container, port: &str) -> Container { container.with_port(port) } /// Add a volume mount to a Container pub fn container_with_volume(mut container: Container, volume: &str) -> Container { container.with_volume(volume) } /// Add an environment variable to a Container pub fn container_with_env(mut container: Container, key: &str, value: &str) -> Container { container.with_env(key, value) } /// Set the network for a Container pub fn container_with_network(mut container: Container, network: &str) -> Container { container.with_network(network) } /// Add a network alias to a Container pub fn container_with_network_alias(mut container: Container, alias: &str) -> Container { container.with_network_alias(alias) } /// Set CPU limit for a Container pub fn container_with_cpu_limit(mut container: Container, cpus: &str) -> Container { container.with_cpu_limit(cpus) } /// Set memory limit for a Container pub fn container_with_memory_limit(mut container: Container, memory: &str) -> Container { container.with_memory_limit(memory) } /// Set restart policy for a Container pub fn container_with_restart_policy(mut container: Container, policy: &str) -> Container { container.with_restart_policy(policy) } /// Set health check for a Container pub fn container_with_health_check(mut container: Container, cmd: &str) -> Container { container.with_health_check(cmd) } /// Set detach mode for a Container pub fn container_with_detach(mut container: Container, detach: bool) -> Container { container.with_detach(detach) } /// Build and run the Container pub fn container_build(container: Container) -> Result> { nerdctl_error_to_rhai_error(container.build()) } /// Start the Container and verify it's running /// /// This function starts the container and verifies that it's actually running. /// It returns detailed error information if the container fails to start or /// if it starts but stops immediately. pub fn container_start(container: &mut Container) -> Result> { // Get container details for better error reporting let container_name = container.name.clone(); let container_id = container.container_id.clone().unwrap_or_else(|| "unknown".to_string()); // Try to start the container let start_result = container.start(); // Handle the result with improved error context match start_result { Ok(result) => { // Container started successfully Ok(result) }, Err(err) => { // Add more context to the error let enhanced_error = match err { NerdctlError::CommandFailed(msg) => { // Check if this is a "container already running" error, which is not really an error if msg.contains("already running") { return Ok(CommandResult { stdout: format!("Container {} is already running", container_name), stderr: "".to_string(), success: true, code: 0, }); } // Try to get more information about why the container might have failed to start let mut enhanced_msg = format!("Failed to start container '{}' (ID: {}): {}", container_name, container_id, msg); // Try to check if the image exists if let Some(image) = &container.image { enhanced_msg.push_str(&format!("\nContainer was using image: {}", image)); } NerdctlError::CommandFailed(enhanced_msg) }, _ => err }; nerdctl_error_to_rhai_error(Err(enhanced_error)) } } } /// Stop the Container pub fn container_stop(container: &mut Container) -> Result> { nerdctl_error_to_rhai_error(container.stop()) } /// Remove the Container pub fn container_remove(container: &mut Container) -> Result> { nerdctl_error_to_rhai_error(container.remove()) } /// Execute a command in the Container pub fn container_exec(container: &mut Container, command: &str) -> Result> { nerdctl_error_to_rhai_error(container.exec(command)) } /// Copy files between the Container and local filesystem pub fn container_copy(container: &mut Container, source: &str, dest: &str) -> Result> { nerdctl_error_to_rhai_error(container.copy(source, dest)) } /// Create a new Map with default run options pub fn new_run_options() -> Map { let mut map = Map::new(); map.insert("name".into(), Dynamic::UNIT); map.insert("detach".into(), Dynamic::from(true)); map.insert("ports".into(), Dynamic::from(Array::new())); map.insert("snapshotter".into(), Dynamic::from("native")); map } // // Container Function Wrappers // /// Wrapper for nerdctl::run /// /// Run a container from an image. pub fn nerdctl_run(image: &str) -> Result> { nerdctl_error_to_rhai_error(nerdctl::run(image, None, true, None, None)) } /// Run a container with a name pub fn nerdctl_run_with_name(image: &str, name: &str) -> Result> { nerdctl_error_to_rhai_error(nerdctl::run(image, Some(name), true, None, None)) } /// Run a container with a port mapping pub fn nerdctl_run_with_port(image: &str, name: &str, port: &str) -> Result> { let ports = vec![port]; nerdctl_error_to_rhai_error(nerdctl::run(image, Some(name), true, Some(&ports), None)) } /// Wrapper for nerdctl::exec /// /// Execute a command in a container. pub fn nerdctl_exec(container: &str, command: &str) -> Result> { nerdctl_error_to_rhai_error(nerdctl::exec(container, command)) } /// Wrapper for nerdctl::copy /// /// Copy files between container and local filesystem. pub fn nerdctl_copy(source: &str, dest: &str) -> Result> { nerdctl_error_to_rhai_error(nerdctl::copy(source, dest)) } /// Wrapper for nerdctl::stop /// /// Stop a container. pub fn nerdctl_stop(container: &str) -> Result> { nerdctl_error_to_rhai_error(nerdctl::stop(container)) } /// Wrapper for nerdctl::remove /// /// Remove a container. pub fn nerdctl_remove(container: &str) -> Result> { nerdctl_error_to_rhai_error(nerdctl::remove(container)) } /// Wrapper for nerdctl::list /// /// List containers. pub fn nerdctl_list(all: bool) -> Result> { nerdctl_error_to_rhai_error(nerdctl::list(all)) } // // Image Function Wrappers // /// Wrapper for nerdctl::images /// /// List images in local storage. pub fn nerdctl_images() -> Result> { nerdctl_error_to_rhai_error(nerdctl::images()) } /// Wrapper for nerdctl::image_remove /// /// Remove one or more images. pub fn nerdctl_image_remove(image: &str) -> Result> { nerdctl_error_to_rhai_error(nerdctl::image_remove(image)) } /// Wrapper for nerdctl::image_push /// /// Push an image to a registry. pub fn nerdctl_image_push(image: &str, destination: &str) -> Result> { nerdctl_error_to_rhai_error(nerdctl::image_push(image, destination)) } /// Wrapper for nerdctl::image_tag /// /// Add an additional name to a local image. pub fn nerdctl_image_tag(image: &str, new_name: &str) -> Result> { nerdctl_error_to_rhai_error(nerdctl::image_tag(image, new_name)) } /// Wrapper for nerdctl::image_pull /// /// Pull an image from a registry. pub fn nerdctl_image_pull(image: &str) -> Result> { nerdctl_error_to_rhai_error(nerdctl::image_pull(image)) } /// Wrapper for nerdctl::image_commit /// /// Commit a container to an image. pub fn nerdctl_image_commit(container: &str, image_name: &str) -> Result> { nerdctl_error_to_rhai_error(nerdctl::image_commit(container, image_name)) } /// Wrapper for nerdctl::image_build /// /// Build an image using a Dockerfile. pub fn nerdctl_image_build(tag: &str, context_path: &str) -> Result> { nerdctl_error_to_rhai_error(nerdctl::image_build(tag, context_path)) } /// Register Nerdctl module functions with the Rhai engine /// /// # Arguments /// /// * `engine` - The Rhai engine to register the functions with /// /// # Returns /// /// * `Result<(), Box>` - Ok if registration was successful, Err otherwise pub fn register_nerdctl_module(engine: &mut Engine) -> Result<(), Box> { // Register types register_nerdctl_types(engine)?; // Register Container constructor engine.register_fn("nerdctl_container_new", container_new); engine.register_fn("nerdctl_container_from_image", container_from_image); // Register Container instance methods engine.register_fn("with_port", container_with_port); engine.register_fn("with_volume", container_with_volume); engine.register_fn("with_env", container_with_env); engine.register_fn("with_network", container_with_network); engine.register_fn("with_network_alias", container_with_network_alias); engine.register_fn("with_cpu_limit", container_with_cpu_limit); engine.register_fn("with_memory_limit", container_with_memory_limit); engine.register_fn("with_restart_policy", container_with_restart_policy); engine.register_fn("with_health_check", container_with_health_check); engine.register_fn("with_detach", container_with_detach); engine.register_fn("build", container_build); engine.register_fn("start", container_start); engine.register_fn("stop", container_stop); engine.register_fn("remove", container_remove); engine.register_fn("exec", container_exec); engine.register_fn("copy", container_copy); // Register legacy container functions (for backward compatibility) engine.register_fn("nerdctl_run", nerdctl_run); engine.register_fn("nerdctl_run_with_name", nerdctl_run_with_name); engine.register_fn("nerdctl_run_with_port", nerdctl_run_with_port); engine.register_fn("new_run_options", new_run_options); engine.register_fn("nerdctl_exec", nerdctl_exec); engine.register_fn("nerdctl_copy", nerdctl_copy); engine.register_fn("nerdctl_stop", nerdctl_stop); engine.register_fn("nerdctl_remove", nerdctl_remove); engine.register_fn("nerdctl_list", nerdctl_list); // Register image functions engine.register_fn("nerdctl_images", nerdctl_images); engine.register_fn("nerdctl_image_remove", nerdctl_image_remove); engine.register_fn("nerdctl_image_push", nerdctl_image_push); engine.register_fn("nerdctl_image_tag", nerdctl_image_tag); engine.register_fn("nerdctl_image_pull", nerdctl_image_pull); engine.register_fn("nerdctl_image_commit", nerdctl_image_commit); engine.register_fn("nerdctl_image_build", nerdctl_image_build); Ok(()) } /// Register Nerdctl module types with the Rhai engine fn register_nerdctl_types(engine: &mut Engine) -> Result<(), Box> { // Register Container type engine.register_type_with_name::("NerdctlContainer"); // Register getters for Container properties engine.register_get("name", |container: &mut Container| container.name.clone()); engine.register_get("container_id", |container: &mut Container| { match &container.container_id { Some(id) => id.clone(), None => "".to_string(), } }); engine.register_get("image", |container: &mut Container| { match &container.image { Some(img) => img.clone(), None => "".to_string(), } }); engine.register_get("ports", |container: &mut Container| { let mut array = Array::new(); for port in &container.ports { array.push(Dynamic::from(port.clone())); } array }); engine.register_get("volumes", |container: &mut Container| { let mut array = Array::new(); for volume in &container.volumes { array.push(Dynamic::from(volume.clone())); } array }); engine.register_get("detach", |container: &mut Container| container.detach); // Register Image type and methods engine.register_type_with_name::("NerdctlImage"); // Register getters for Image properties engine.register_get("id", |img: &mut Image| img.id.clone()); engine.register_get("repository", |img: &mut Image| img.repository.clone()); engine.register_get("tag", |img: &mut Image| img.tag.clone()); engine.register_get("size", |img: &mut Image| img.size.clone()); engine.register_get("created", |img: &mut Image| img.created.clone()); Ok(()) }