kasl-cli 1.0.0

kasl is a comprehensive command-line utility 🛠️ designed to streamline the tracking of work activities 📊, including start times ⏰, pauses ⏸, and task completion
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80

//! Application self-update command.
//!
//! Handles checking for and installing newer versions of kasl from GitHub releases with automatic binary replacement and backup capabilities.
//!
//! ## Features
//!
//! - **GitHub Integration**: Checks latest releases via GitHub API
//! - **Cross-Platform Support**: Works on Windows, macOS, and Linux
//! - **Safe Updates**: Creates backups before replacing binaries
//! - **Watcher Management**: Automatically stops and restarts monitoring daemon
//! - **Version Detection**: Compares current version with latest available
//!
//! ## Usage
//!
//! ```bash
//! # Check for and install updates
//! kasl update
//! ```

use crate::{
    libs::{daemon, messages::Message, update::Updater},
    msg_info, msg_success,
};
use anyhow::Result;

/// Executes the application update process.
///
/// Performs a complete update workflow including version check, platform detection,
/// download, extraction, and safe replacement of the current executable.
///
/// # Returns
///
/// Returns `Ok(())` on successful update or if no update is needed.
/// Returns an error if the update process fails.
pub async fn cmd() -> Result<()> {
    // Check if watcher is currently running before update
    let watcher_was_running = daemon::is_running();

    if watcher_was_running {
        msg_info!(Message::WatcherStoppingForUpdate);
        daemon::stop()?;
    }

    // Create a new Updater instance with GitHub API configuration
    let mut updater = Updater::new()?;

    // Check GitHub API for the latest release version
    let needs_update = updater.check_for_latest_release().await?;

    if !needs_update {
        msg_info!(Message::NoUpdateRequired);

        // If watcher was running before update check, restart it
        if watcher_was_running {
            msg_info!(Message::WatcherRestartingAfterUpdate);
            daemon::spawn()?;
        }

        return Ok(());
    }

    // Download and install the latest version
    // This includes downloading the archive, extracting the binary,
    // backing up the current executable, and replacing it
    updater.perform_update().await?;

    // Restart watcher if it was running before the update
    if watcher_was_running {
        msg_info!(Message::WatcherRestartingAfterUpdate);
        daemon::spawn()?;
    }

    // Confirm successful update with version information
    msg_success!(Message::UpdateCompleted {
        app_name: updater.name,
        version: updater.latest_version.as_deref().unwrap_or("unknown").to_string()
    });

    Ok(())
}