Struct ConfigurableTool

pub struct ConfigurableTool { /* private fields */ }

Configuration-driven tool implementation

This tool uses configuration to determine download URLs and version sources, making it highly configurable without code changes.

Implementations

impl ConfigurableTool

pub fn new( metadata: ToolMetadata, url_builder: Box<dyn UrlBuilder>, version_parser: Box<dyn VersionParser>, ) -> Self

Create a new configurable tool

pub fn metadata(&self) -> &ToolMetadata

Get the tool metadata

Trait Implementations

impl VxTool for ConfigurableTool

fn name(&self) -> &str

Tool name (required)

fn description(&self) -> &str

Tool description (optional, has default)

fn aliases(&self) -> Vec<&str>

Supported aliases for this tool (optional)

fn fetch_versions<'life0, 'async_trait>( &'life0 self, include_prerelease: bool, ) -> Pin<Box<dyn Future<Output = Result<Vec<VersionInfo>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Fetch available versions from the tool’s official source

fn get_download_url<'life0, 'life1, 'async_trait>( &'life0 self, version: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Option<String>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Get download URL for a specific version and current platform

fn metadata(&self) -> HashMap<String, String>

Additional metadata for the tool (optional)

fn install_version<'life0, 'life1, 'async_trait>( &'life0 self, version: &'life1 str, force: bool, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Install a specific version of the tool

fn is_version_installed<'life0, 'life1, 'async_trait>( &'life0 self, version: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<bool>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Check if a version is installed

fn execute<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, args: &'life1 [String], context: &'life2 ToolContext, ) -> Pin<Box<dyn Future<Output = Result<ToolExecutionResult>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Execute the tool with given arguments

fn get_executable_path<'life0, 'life1, 'async_trait>( &'life0 self, install_dir: &'life1 Path, ) -> Pin<Box<dyn Future<Output = Result<PathBuf>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Get the executable path within an installation directory

fn get_version_install_dir(&self, version: &str) -> PathBuf

Get installation directory for a specific version

fn get_base_install_dir(&self) -> PathBuf

Get base installation directory for this tool

fn get_active_version<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Get the currently active version

fn get_installed_versions<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Vec<String>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Get all installed versions

fn remove_version<'life0, 'life1, 'async_trait>( &'life0 self, version: &'life1 str, force: bool, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Remove a specific version of the tool

fn get_status<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<ToolStatus>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Get tool status (installed versions, active version, etc.)

fn default_install_workflow<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, version: &'life1 str, install_dir: &'life2 Path, ) -> Pin<Box<dyn Future<Output = Result<PathBuf>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Default installation workflow (download + extract)