Struct DataManager 

pub struct DataManager { /* private fields */ }

Manages downloading and caching of the files ASSIST needs.

Files are stored in a local data directory. Default location is $ASSIST_DATA_DIR if set, otherwise $XDG_CACHE_HOME/assist-rs/ or ~/.cache/assist-rs/.

Implementations

impl DataManager

pub fn new() -> Self

Create a DataManager with the default data directory.

pub fn with_dir(dir: impl Into<PathBuf>) -> Self

Create a DataManager with a custom data directory.

pub fn data_dir(&self) -> &Path

The data directory path.

pub fn offline(&self) -> Result<AssistDataPaths, DataError>

Return paths if all data files exist. No network access.

pub fn ensure_ready(&self) -> Result<AssistDataPaths, DataError>

Ensure all three files exist, downloading any that are missing, locally corrupted, or stale upstream.

For each file:

• If the file is missing → download.
• Else if a sidecar exists, compare the local file’s MD5 against the stored MD5. Mismatch implies local corruption or tampering → re-download. An error computing the MD5 (e.g. unreadable file) is propagated, not swallowed.
• Else if the file is non-static (e.g. obscodes_extended.json), HEAD the remote and re-download if Content-Length or Last-Modified differs from the sidecar. Network failures here are propagated — callers that need offline-tolerant behavior should use Self::offline instead.
• Else (static file, MD5 matches, or no sidecar to check against) → keep the cached copy.

pub fn clean(&self) -> Result<(), DataError>

Remove the data directory and all its contents.

Trait Implementations

impl Default for DataManager

fn default() -> Self

Returns the “default value” for a type.