dapctl 1.0.0

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
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
81
82
83
84
85
86
87
88
89
90
91
92
93
94

use std::path::PathBuf;

use clap::{Parser, Subcommand};
use ulid::Ulid;

pub mod audit;
pub mod cover;
pub mod diff;
pub mod export;
pub mod log;
pub mod profile;
pub mod scan;
pub mod sync;

#[derive(Parser, Debug)]
#[command(
    name = "dapctl",
    version,
    about = "TUI/CLI sync for HiFi Digital Audio Players",
    long_about = None,
)]
struct Cli {
    #[command(subcommand)]
    command: Option<Command>,

    /// Write human-readable log to this file in addition to stderr.
    #[arg(long, global = true, value_name = "PATH")]
    log_file: Option<PathBuf>,

    /// Increase verbosity (default: INFO).
    #[arg(short, long, global = true, action = clap::ArgAction::Count)]
    verbose: u8,

    /// Assume yes to all prompts (required for destructive ops without a TTY).
    #[arg(short = 'y', long, global = true)]
    yes: bool,
}

#[derive(Subcommand, Debug)]
enum Command {
    /// Synchronise a profile to its DAP.
    Sync(sync::Args),
    /// Show what a sync would do, without touching the destination.
    Diff(diff::Args),
    /// Detect removable drives and identify DAPs.
    Scan(scan::Args),
    /// Manage sync profiles and inspect DAP profiles.
    Profile(profile::Args),
    /// Tail or query the structured log.
    Log(log::Args),
    /// Export utilities (M3U playlist, …).
    Export(export::Args),
    /// Audit a music library for missing tags, cover art, and format issues.
    Audit(audit::Args),
    /// Download missing cover art for albums in a library.
    Cover(cover::Args),
}

/// Parse argv, initialise logging, and dispatch.
/// When no subcommand is given, launch the TUI.
pub fn run() -> anyhow::Result<()> {
    let cli = Cli::parse();

    let verbosity = match cli.verbose {
        0 => tracing::Level::INFO,
        1 => tracing::Level::DEBUG,
        _ => tracing::Level::TRACE,
    };

    let run_id = Ulid::new();
    let jsonl_dir = crate::logging::default_jsonl_dir()?;
    crate::logging::init(crate::logging::InitOpts {
        run_id,
        human_log_file: cli.log_file,
        jsonl_dir,
        verbosity,
        tui_mode: cli.command.is_none(),
    })?;

    let result = match cli.command {
        None => crate::tui::run(),
        Some(Command::Sync(a)) => sync::run(a, cli.yes),
        Some(Command::Diff(a)) => diff::run(a),
        Some(Command::Scan(a)) => scan::run(a),
        Some(Command::Profile(a)) => profile::run(a),
        Some(Command::Log(a)) => log::run(a),
        Some(Command::Export(a)) => export::run(a),
        Some(Command::Audit(a)) => audit::run(a),
        Some(Command::Cover(a)) => cover::run(a),
    };

    crate::logging::finish(result.is_ok());
    result
}