Struct InputFetcher 

pub struct InputFetcher { /* private fields */ }

A content-addressed input fetcher that downloads and caches flake inputs.

Inputs are cached under ~/.cache/sui/inputs/ (or a custom directory) keyed by their narHash from the lock file. Cache hits skip network access entirely.

Implementations

impl InputFetcher

pub fn new() -> Self

Create a fetcher using the default cache directory (~/.cache/sui/inputs/).

pub fn with_cache_dir(cache_dir: PathBuf) -> Self

Create a fetcher with a custom cache directory.

pub fn cache_dir(&self) -> &Path

Return the cache directory path.

pub fn is_cached(&self, locked: &LockedInput) -> bool

Whether this input would be served from cache without any network access.

Deliberately shares Self::cache_probe with Self::fetch rather than re-deriving the cache path: two independent notions of “cached” drift, and the drift is invisible — a reporter would announce “already present” for an entry the fetcher then re-downloads. Note it applies the same non-empty requirement, so a directory left behind by a fetch that died mid-extract counts as a miss here exactly as it does there.

pub fn fetch(&self, locked: &LockedInput) -> Result<PathBuf, FetchError>

Fetch a locked input and return the local filesystem path.

Uses content-addressed caching by narHash — if the hash is present and a cached directory exists, returns immediately without network access.

pub fn github_archive_url(owner: &str, repo: &str, rev: &str) -> String

Construct the GitHub archive URL for a locked input.

pub fn gitlab_archive_url( host: Option<&str>, owner: &str, repo: &str, rev: &str, ) -> String

GitLab archive URL. Shape differs from GitHub — the file name embeds the repo + rev and lives under /-/archive/{rev}/. Honors host so self-hosted gitlab instances (e.g. gitlab.gnome.org, git.example.com) work; defaults to gitlab.com when host is None.

pub fn sourcehut_archive_url(owner: &str, repo: &str, rev: &str) -> String

Sourcehut archive URL. Owners carry the ~ prefix on the platform; the flake-ref parser stores them without the prefix, so we prepend here.

Trait Implementations

impl Default for InputFetcher

fn default() -> Self

Returns the “default value” for a type.