holodeck-simctl 0.4.0

A CLI and TUI companion for the iOS Simulator's simctl — boot, record, screenshot, and manage simulators
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
119
120
121
122
123

//! Lowercased-string-to-enum conversions for `clap` `value_parser`s. The
//! Rust analogue of Swift's `ExpressibleByArgument`/`LowercasedRawArgument`
//! conformances in `ArgumentParserSupport.swift`.
//!
//! These live in the CLI crate rather than as `clap::ValueEnum` impls on the
//! `holodeck-core` types because Rust's orphan rules forbid implementing a
//! foreign trait (`ValueEnum`, from `clap`) for a foreign type from a third
//! crate — free parser functions sidestep that without adding a `clap`
//! dependency to `holodeck-core`.

use holodeck_core::models::{Appearance, BatteryState, Platform, PrivacyAction, PrivacyPermission, ScreenshotType, VideoCodec};

pub fn parse_platform(raw: &str) -> Result<Platform, String> {
    match raw.to_lowercase().as_str() {
        "ios" => Ok(Platform::IOS),
        "watchos" => Ok(Platform::WatchOS),
        "tvos" => Ok(Platform::TvOS),
        "visionos" => Ok(Platform::VisionOS),
        other => Err(format!("invalid platform '{other}' (expected ios, watchos, tvos, visionos)")),
    }
}

pub fn parse_video_codec(raw: &str) -> Result<VideoCodec, String> {
    match raw.to_lowercase().as_str() {
        "h264" => Ok(VideoCodec::H264),
        "hevc" => Ok(VideoCodec::Hevc),
        other => Err(format!("invalid codec '{other}' (expected h264, hevc)")),
    }
}

pub fn parse_screenshot_type(raw: &str) -> Result<ScreenshotType, String> {
    match raw.to_lowercase().as_str() {
        "png" => Ok(ScreenshotType::Png),
        "jpeg" => Ok(ScreenshotType::Jpeg),
        "tiff" => Ok(ScreenshotType::Tiff),
        "bmp" => Ok(ScreenshotType::Bmp),
        other => Err(format!("invalid image type '{other}' (expected png, jpeg, tiff, bmp)")),
    }
}

pub fn parse_appearance(raw: &str) -> Result<Appearance, String> {
    match raw.to_lowercase().as_str() {
        "light" => Ok(Appearance::Light),
        "dark" => Ok(Appearance::Dark),
        other => Err(format!("invalid appearance '{other}' (expected light, dark)")),
    }
}

pub fn parse_battery_state(raw: &str) -> Result<BatteryState, String> {
    match raw.to_lowercase().as_str() {
        "charging" => Ok(BatteryState::Charging),
        "charged" => Ok(BatteryState::Charged),
        "discharging" => Ok(BatteryState::Discharging),
        other => Err(format!("invalid battery state '{other}' (expected charging, charged, discharging)")),
    }
}

pub fn parse_privacy_action(raw: &str) -> Result<PrivacyAction, String> {
    match raw.to_lowercase().as_str() {
        "grant" => Ok(PrivacyAction::Grant),
        "revoke" => Ok(PrivacyAction::Revoke),
        "reset" => Ok(PrivacyAction::Reset),
        other => Err(format!("invalid action '{other}' (expected grant, revoke, reset)")),
    }
}

pub fn parse_privacy_permission(raw: &str) -> Result<PrivacyPermission, String> {
    match raw.to_lowercase().as_str() {
        "all" => Ok(PrivacyPermission::All),
        "calendar" => Ok(PrivacyPermission::Calendar),
        "contacts-limited" => Ok(PrivacyPermission::ContactsLimited),
        "contacts" => Ok(PrivacyPermission::Contacts),
        "location" => Ok(PrivacyPermission::Location),
        "location-always" => Ok(PrivacyPermission::LocationAlways),
        "photos-add" => Ok(PrivacyPermission::PhotosAdd),
        "photos" => Ok(PrivacyPermission::Photos),
        "media-library" => Ok(PrivacyPermission::MediaLibrary),
        "microphone" => Ok(PrivacyPermission::Microphone),
        "motion" => Ok(PrivacyPermission::Motion),
        "reminders" => Ok(PrivacyPermission::Reminders),
        "siri" => Ok(PrivacyPermission::Siri),
        other => Err(format!(
            "invalid permission '{other}' (expected all, calendar, contacts, contacts-limited, location, location-always, photos, photos-add, media-library, microphone, motion, reminders, siri)"
        )),
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn platform_parsing_is_case_insensitive() {
        assert_eq!(parse_platform("IOS").unwrap(), Platform::IOS);
        assert_eq!(parse_platform("VisionOS").unwrap(), Platform::VisionOS);
    }

    #[test]
    fn platform_rejects_xros_unlike_the_simctl_name_parser() {
        assert!(parse_platform("xros").is_err());
    }

    #[test]
    fn privacy_permission_parses_all_thirteen_values() {
        for raw in [
            "all",
            "calendar",
            "contacts-limited",
            "contacts",
            "location",
            "location-always",
            "photos-add",
            "photos",
            "media-library",
            "microphone",
            "motion",
            "reminders",
            "siri",
        ] {
            assert!(parse_privacy_permission(raw).is_ok(), "{raw} should parse");
        }
    }
}