Struct RemoteCache 

pub struct RemoteCache { /* private fields */ }

Remote cache orchestrator.

Handles cache operations and integrates with task execution.

Implementations

impl RemoteCache

pub fn new( backend: Box<dyn RemoteCacheBackend>, config: RemoteCacheConfig, ) -> Self

Creates a new remote cache with the given backend and configuration.

pub fn from_config(config: RemoteCacheConfig) -> Result<Self>

Creates a remote cache from configuration.

Automatically selects the appropriate backend based on the URL.

Errors

Returns an error if backend creation fails.

pub fn disabled() -> Self

Creates a disabled remote cache (no-op).

pub fn is_enabled(&self) -> bool

Checks if remote cache is enabled.

pub async fn fetch_artifact(&self, key: &CacheKey) -> Result<Option<Artifact>>

Fetches an artifact from the remote cache.

Arguments

• key - The cache key to fetch

Returns

Returns Some(artifact) if found, None if not found.

Errors

Returns an error only for unexpected failures. Cache misses return Ok(None).

pub async fn upload_artifact( &self, key: &CacheKey, artifact: &Artifact, ) -> Result<()>

Uploads an artifact to the remote cache.

Arguments

• key - The cache key for this artifact
• artifact - The artifact to upload

Errors

Returns an error if upload fails. Errors are non-fatal.

pub async fn has_artifact(&self, key: &CacheKey) -> Result<bool>

Checks if an artifact exists in the remote cache.

Arguments

• key - The cache key to check

Returns

Returns true if the artifact exists, false otherwise.

Errors

Returns an error only for unexpected failures.

pub async fn build_cache_key( &self, package: &Package, task_name: &str, command: &str, graph: &DependencyGraph, package_path: &Path, ) -> Result<CacheKey>

Builds a cache key for a task execution.

Arguments

• package - The package being executed
• task_name - The task name
• command - The command string
• graph - The dependency graph
• package_path - Path to the package directory

Errors

Returns an error if cache key construction fails.

pub fn config(&self) -> &RemoteCacheConfig

Returns the configuration.