Struct BinaryManager 

pub struct BinaryManager { /* private fields */ }

Service for managing node binary downloads and caching

find_cached, find_cached_version, binary_name(_with_version), tarball_name(_with_version), and download are structurally similar to mecha10-node-resolver::NodeResolver’s equivalents (LAB-2762). Re-reviewed under LAB-2803 with a shared-trait/module extraction specifically in mind: that’s intentionally still not addressed by merging the two. Each is already a thin delegate to the shared mecha10-binary-naming crate (the actual single source of truth for naming/caching logic), and unifying the two callers further would require node-resolver to depend on this crate or mecha10-cli-core, which violates its documented zero-dependency-on-mecha10-cli-core design goal (minimal binary size for embedding in robot binaries - see NodeResolver’s doc comment). This service also does more than NodeResolver ever should (progress-bar rendering, a cargo install fallback for unsupported platforms, Windows symlink support), so a shared trait would either dilute NodeResolver’s minimal surface or force it to grow the dependency footprint it’s designed to avoid. cargo-dupes no longer flags this pair at all under the workspace’s tuned thresholds (dupes.toml) - only the unavoidable thin per-crate wrapper methods remain. See .dupes-ignore.toml for the per-fingerprint reasoning on other groups.

Implementations

impl BinaryManager

pub fn new() -> Result<BinaryManager, Error>

Create a new binary manager

pub fn with_version(version: String) -> Result<BinaryManager, Error>

Create a binary manager with a specific version

pub fn is_prebuilt_available(&self) -> bool

Check if pre-built binaries are available for current platform

pub fn cache_dir(&self) -> &PathBuf

Get the binary cache directory

pub fn version(&self) -> &str

Get the current version

pub fn target(&self) -> &str

Get the current target

pub async fn resolve(&self, node_name: &str) -> Result<PathBuf, Error>

Resolve binary path for a node, downloading if needed

Resolution strategy:

1. Check if cached binary exists for current version/target
2. If not, try to download from GitHub releases
3. If download fails and platform unsupported, fall back to cargo install

Arguments

• node_name - Name of the node (e.g., “speaker”, “motor”)

Returns

Path to the executable binary

pub async fn resolve_with_version( &self, node_name: &str, version: Option<&str>, ) -> Result<PathBuf, Error>

Resolve binary path for a node with a specific version

Arguments

• node_name - Name of the node (e.g., “speaker”, “motor”)
• version - Optional specific version to download (e.g., “0.1.48”). If None, downloads the latest available version.

Returns

Path to the executable binary

pub async fn remove(&self, node_name: &str) -> Result<(), Error>

Remove a cached binary

pub async fn clear_cache(&self) -> Result<(), Error>

Clear all cached binaries

Trait Implementations

impl Default for BinaryManager

fn default() -> BinaryManager

Returns the “default value” for a type.