kasou 0.1.0

Kasou (仮想) — safe Apple Virtualization.framework bindings for macOS VM management
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

//! Shared utilities for Objective-C / Foundation interop.

use objc2::AnyThread;
use objc2::rc::Retained;
use objc2_foundation::{NSError, NSString, NSURL};

use crate::error::FrameworkError;
use crate::KasouError;

/// Convert a filesystem path to an NSURL.
pub(crate) fn path_to_nsurl(path: &std::path::Path) -> Result<Retained<NSURL>, KasouError> {
    let path_str = path.to_str().ok_or_else(|| {
        KasouError::InvalidConfig(format!("path is not valid UTF-8: {}", path.display()))
    })?;
    let ns_path = NSString::from_str(path_str);
    Ok(NSURL::initFileURLWithPath(NSURL::alloc(), &ns_path))
}

/// Walk an NSError and capture its full cause chain into a typed
/// `FrameworkError`. Replaces the old `ns_error_description` which
/// returned only `localizedDescription` and discarded `failureReason`,
/// `recoverySuggestion`, `domain`, `code`, and `underlyingErrors`.
///
/// Cheap — one pass over the NSError tree, the only NSError methods
/// that can fail are guarded inside `FrameworkError::from_ns_error`.
#[must_use]
pub(crate) fn ns_error_chain(error: &NSError) -> FrameworkError {
    FrameworkError::from_ns_error(error)
}