Struct VersionChecker 

pub struct VersionChecker { /* private fields */ }

Version checking and caching system with automatic update notifications.

VersionChecker provides intelligent caching of version information and automatic update checking based on user configuration. It manages notification state to avoid alert fatigue while ensuring users are aware of updates.

Features

• Automatic Checking: Checks for updates based on configured intervals
• Smart Caching: Reduces GitHub API calls with intelligent cache management
• Notification Tracking: Avoids repeated notifications for the same update
• Configurable Behavior: Respects user preferences for update checking

Caching Strategy

The version checker implements a sophisticated caching strategy:

• Stores version information with timestamps
• Tracks notification state to avoid alert fatigue
• Uses configurable intervals for cache expiration
• Implements exponential backoff for re-notifications

Implementations

impl VersionChecker

pub async fn new() -> Result<Self>

Create a new VersionChecker with configuration from global settings.

Loads the global configuration and sets up the version checker with appropriate cache paths and update settings.

Returns

• Ok(VersionChecker) - Successfully created with loaded configuration
• Err(error) - Failed to load configuration or determine cache path

Cache Location

The cache file is stored at:

• Unix/macOS: ~/.agpm/.version_cache
• Windows: %LOCALAPPDATA%\agpm\.version_cache

pub fn with_cache_dir(self, cache_dir: PathBuf) -> Self

Create a new VersionChecker with custom cache directory.

Arguments

• cache_dir - Directory where the version cache file will be stored

pub async fn check_for_updates_if_needed(&self) -> Result<Option<String>>

Check for updates automatically based on configuration.

This is the main entry point for automatic update checking. It:

1. Checks if automatic updates are enabled in configuration
2. Loads and validates the cache
3. Performs a new check if cache is expired
4. Returns version info if user should be notified

Returns

• Ok(Some(version)) - Update available and user should be notified
• Ok(None) - No update or notification not needed
• Err(error) - Error during check (non-fatal, logged)

pub async fn check_now(&self) -> Result<Option<String>>

Perform an explicit update check, bypassing the cache.

This method always queries GitHub for the latest version, regardless of cache state. Used for manual update checks.

Returns

• Ok(Some(version)) - New version available
• Ok(None) - Already on latest version
• Err(error) - Check failed

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

Clear the version cache by removing the cache file.

Removes cached version information, forcing subsequent version checks to fetch fresh data from GitHub.

pub fn display_update_notification(latest_version: &str)

Display a user-friendly update notification.

Shows an attractive notification banner informing the user about the available update with instructions on how to upgrade.

Arguments

• latest_version - The new version available for upgrade

pub fn format_version_info(current: &str, latest: Option<&str>) -> String

Format version information for status display.

Creates a human-readable string showing the current version and, if available, the latest version with update availability.