Struct UpdateChecker 

pub struct UpdateChecker { /* private fields */ }

A lightweight update checker for crates.io.

Example

use tiny_update_check::UpdateChecker;

let checker = UpdateChecker::new("my-crate", "1.0.0");
match checker.check() {
    Ok(Some(update)) => println!("Update available: {}", update.latest),
    Ok(None) => println!("Already on latest version"),
    Err(e) => eprintln!("Failed to check for updates: {}", e),
}

Implementations

impl UpdateChecker

pub fn new( crate_name: impl Into<String>, current_version: impl Into<String>, ) -> Self

Create a new update checker for the given crate.

Arguments

• crate_name - The name of your crate on crates.io
• current_version - The currently running version (typically from env!("CARGO_PKG_VERSION"))

pub const fn cache_duration(self, duration: Duration) -> Self

Set the cache duration. Defaults to 24 hours.

Set to Duration::ZERO to disable caching.

pub const fn timeout(self, timeout: Duration) -> Self

Set the HTTP request timeout. Defaults to 5 seconds.

pub fn cache_dir(self, dir: Option<PathBuf>) -> Self

Set a custom cache directory. Defaults to system cache directory.

Set to None to disable caching.

pub fn check(&self) -> Result<Option<UpdateInfo>, Error>

Check for updates.

Returns Ok(Some(UpdateInfo)) if a newer version is available, Ok(None) if already on the latest version, or Err if the check failed.

Errors

Returns an error if the HTTP request fails, the response cannot be parsed, or version comparison fails.

Trait Implementations

impl Clone for UpdateChecker

fn clone(&self) -> UpdateChecker

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for UpdateChecker

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.