auv-cli 0.0.25

AUV core command-line frontend
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
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118

use clap::{Args, Subcommand};

#[derive(Clone, Debug, Args)]
pub struct SetupArgs {
  #[command(subcommand)]
  command: SetupCommand,
}

#[derive(Clone, Debug, Subcommand)]
enum SetupCommand {
  /// Manage the signed helper used for locked macOS sessions.
  MacosHelper(MacosHelperArgs),
}

#[derive(Clone, Debug, Args)]
struct MacosHelperArgs {
  /// Manage this unpacked, notarized helper app shipped by an application
  /// embedding AUV instead of the official AUV Helper.
  #[arg(long, global = true, value_name = "PATH", env = "AUV_MACOS_HELPER_APP")]
  helper_app: Option<std::path::PathBuf>,
  #[command(subcommand)]
  command: MacosHelperCommand,
}

#[derive(Clone, Debug, Subcommand)]
enum MacosHelperCommand {
  /// Report the installed helper identity and current-user readiness.
  Status {
    /// Emit a stable machine-readable result.
    #[arg(long)]
    json: bool,
  },
  /// Install and register the signed helper embedded in this AUV build, or the
  /// app named by `--helper-app`.
  Install {
    /// Emit a stable machine-readable result after installation.
    #[arg(long)]
    json: bool,
  },
  /// Unregister the helper, reset Accessibility, and remove its app bundle.
  Uninstall {
    /// Emit a stable machine-readable result after removal.
    #[arg(long)]
    json: bool,
  },
  /// Open System Settings at Privacy & Security > Accessibility.
  OpenAccessibilitySettings,
  /// Open System Settings at General > Login Items & Extensions.
  OpenBackgroundItemsSettings,
}

pub fn run(args: SetupArgs) -> Result<i32, String> {
  #[cfg(target_os = "macos")]
  {
    match args.command {
      SetupCommand::MacosHelper(args) => {
        let options = auv_device_helper_macos::setup::Options {
          helper_app: args.helper_app,
        };
        match args.command {
          MacosHelperCommand::Status { json } => {
            print_status(&auv_device_helper_macos::setup::status(&options), json)?;
            Ok(0)
          }
          MacosHelperCommand::Install { json } => {
            let status = auv_device_helper_macos::setup::install(&options).map_err(|error| error.to_string())?;
            print_status(&status, json)?;
            Ok(0)
          }
          MacosHelperCommand::Uninstall { json } => {
            let status = auv_device_helper_macos::setup::uninstall(&options).map_err(|error| error.to_string())?;
            print_status(&status, json)?;
            Ok(0)
          }
          MacosHelperCommand::OpenAccessibilitySettings => {
            auv_device_helper_macos::setup::open_accessibility_settings().map_err(|error| error.to_string())?;
            println!("opened macOS Accessibility settings for helper authorization");
            Ok(0)
          }
          MacosHelperCommand::OpenBackgroundItemsSettings => {
            auv_device_helper_macos::setup::open_background_items_settings(&options).map_err(|error| error.to_string())?;
            println!("opened macOS Login Items settings for helper authorization");
            Ok(0)
          }
        }
      }
    }
  }

  #[cfg(not(target_os = "macos"))]
  {
    let _ = args;
    Err("macOS helper setup is available only on macOS".to_string())
  }
}

#[cfg(target_os = "macos")]
fn print_status(status: &auv_device_helper_macos::setup::Status, json: bool) -> Result<(), String> {
  if json {
    println!(
      "{}",
      serde_json::to_string_pretty(&serde_json::json!({
        "state": status.state.as_str(),
        "detail": status.detail,
        "helper_embedded": status.helper_embedded,
      }))
      .map_err(|error| format!("failed to encode helper status: {error}"))?
    );
  } else {
    println!("state\t{}", status.state.as_str());
    println!("helper_embedded\t{}", status.helper_embedded);
    if let Some(detail) = &status.detail {
      println!("detail\t{detail}");
    }
  }

  Ok(())
}