Struct ManagedTool 

pub struct ManagedTool {
    pub name: &'static str,
    pub version: &'static str,
    pub url: String,
    pub sha256: &'static str,
    pub binary: String,
}

A pinned release archive that unpacks under ~/.water/tools/<name>/<version>/.

Fields

name: &'static str

Directory name under ~/.water/tools.

version: &'static str

Version segment of the install directory.

url: String

Pinned archive URL.

sha256: &'static str

Expected sha256 of the archive, lowercase hex.

binary: String

Path of the tool binary inside the unpacked tree.

Implementations

impl ManagedTool

pub fn install_dir(&self, host: &Host) -> Result<PathBuf, HomeDirError>

The directory this tool unpacks into: ~/.water/tools/<name>/<version>.

Errors

Returns HomeDirError when the host declares no home directory.

pub fn binary_path(&self, host: &Host) -> Option<PathBuf>

The unpacked binary’s path on host, when already installed.

pub fn binary_dir(&self, host: &Host) -> Option<PathBuf>

The directory holding the binary on host, when already installed.

binary is always a multi-component relative path, so None parents collapse to None rather than a panic.

pub async fn install(&self, host: &Host) -> Result<PathBuf, ManagedToolError>

Download the pinned archive, verify its sha256, and unpack it into ~/.water/tools/<name>/<version>/. An already-unpacked install is returned without any network access.

Returns the directory that holds the tool binary.

Errors

Returns ManagedToolError when the download fails, the checksum does not match the pinned value, the archive cannot be unpacked, or the unpacked tree does not contain the expected binary.

Trait Implementations

impl Clone for ManagedTool

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ManagedTool

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.