dapctl 1.0.1

TUI/CLI sync tool for HiFi Digital Audio Players
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

//! Execute a `Plan`: copy/delete with temp+rename, emit progress events,
//! and maintain a per-run manifest so interrupted syncs can resume.

pub mod executor;
pub mod manifest;
pub mod verify;

pub use executor::{execute, repair_dest_mtimes, Options, Stats, SyncMode};

use serde::{Deserialize, Serialize};

/// Events consumed by the JSONL manifest (written per-run for auditing).
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(tag = "event", rename_all = "snake_case")]
pub enum Event {
    XferStart { path: String, bytes: u64 },
    XferDone { path: String, bytes: u64 },
    XferFail { path: String, err: String },
    VerifyOk { path: String },
    VerifyFail { path: String, err: String },
    Finish { ok: bool },
}

/// Real-time progress events sent to the TUI over an mpsc channel.
#[derive(Debug, Clone)]
pub enum ProgressEvent {
    /// A new file is about to be copied.
    FileStart { path: String, bytes: u64 },
    /// A chunk was written (incremental bytes).
    FileProgress { bytes: u64 },
    /// File copied and verified successfully.
    FileDone { path: String, bytes: u64 },
    /// File copy or verify failed.
    FileFail { path: String, err: String },
    /// An orphan file was deleted.
    DeleteDone { path: String },
    /// All files processed — final stats.
    Finish { stats: Stats },
}