Struct LxdClient 

pub struct LxdClient { /* private fields */ }

A specialized LXD client for instance management.

This client provides a consistent interface for LXD operations:

• List instances (containers and virtual machines) and their information
• Retrieve instance IP addresses
• Execute LXD commands with proper error handling

Uses CommandExecutor as a collaborator for actual command execution.

Implementations

impl LxdClient

pub fn new() -> Self

Creates a new LxdClient

pub fn get_instance_ip( &self, instance_name: &InstanceName, ) -> Result<Option<IpAddr>>

Get the IPv4 address of a specific instance

Arguments

• instance_name - Name of the instance to get the IP address for

Returns

• Ok(Some(IpAddr)) - The IPv4 address if found
• Ok(None) - Instance not found or no IPv4 address available
• Err(anyhow::Error) - Error describing what went wrong

Errors

This function will return an error if:

• LXD command execution fails
• JSON parsing fails

pub fn wait_for_instance_ip( &self, instance_name: &InstanceName, timeout_seconds: u64, poll_interval_seconds: u64, ) -> Result<IpAddr>

Wait for an instance to get an IP address (useful for VMs that take time to boot)

Arguments

• instance_name - Name of the instance to wait for
• timeout_seconds - Maximum time to wait in seconds
• poll_interval_seconds - How often to check in seconds

Returns

• Ok(IpAddr) - The IP address when found
• Err(anyhow::Error) - Timeout or other error

Errors

This function will return an error if:

• Timeout is reached without getting an IP
• LXD command execution fails
• JSON parsing fails

pub fn get_instance_by_name( &self, instance_name: &InstanceName, ) -> Result<Option<InstanceInfo>>

Get a specific instance by name

Arguments

• instance_name - Name of the instance to retrieve

Returns

• Ok(Some(InstanceInfo)) - Instance information if found
• Ok(None) - Instance not found
• Err(anyhow::Error) - Error describing what went wrong

Errors

This function will return an error if:

• LXD command execution fails
• JSON parsing fails

pub fn delete_instance( &self, instance_name: &InstanceName, force: bool, ) -> Result<()>

Delete an LXD instance

Arguments

• instance_name - Name of the instance to delete
• force - Whether to force deletion (stop running instances)

Returns

• Ok(()) - Instance deleted successfully or didn’t exist
• Err(anyhow::Error) - Error describing what went wrong

Errors

This function will return an error if:

• The LXD command fails with an unexpected error
• LXD is not installed or accessible

pub fn delete_profile(&self, profile_name: &str) -> Result<()>

Delete an LXD profile

Arguments

• profile_name - Name of the profile to delete

Returns

• Ok(()) - Profile deleted successfully or didn’t exist
• Err(anyhow::Error) - Error describing what went wrong

Errors

This function will return an error if:

• The LXD command fails with an unexpected error
• LXD is not installed or accessible
• Profile is in use by existing instances

Trait Implementations

impl Default for LxdClient

fn default() -> Self

Returns the “default value” for a type.