platform.rs

   1use super::{events::key_to_native, BoolExt};
   2use crate::{
   3    Action, AnyWindowHandle, BackgroundExecutor, ClipboardItem, CursorStyle, DisplayId,
   4    ForegroundExecutor, Keymap, MacDispatcher, MacDisplay, MacDisplayLinker, MacTextSystem,
   5    MacWindow, Menu, MenuItem, PathPromptOptions, Platform, PlatformDisplay, PlatformInput,
   6    PlatformTextSystem, PlatformWindow, Result, SemanticVersion, VideoTimestamp, WindowOptions,
   7};
   8use anyhow::anyhow;
   9use block::ConcreteBlock;
  10use cocoa::{
  11    appkit::{
  12        NSApplication, NSApplicationActivationPolicy::NSApplicationActivationPolicyRegular,
  13        NSEventModifierFlags, NSMenu, NSMenuItem, NSModalResponse, NSOpenPanel, NSPasteboard,
  14        NSPasteboardTypeString, NSSavePanel, NSWindow,
  15    },
  16    base::{id, nil, selector, BOOL, YES},
  17    foundation::{
  18        NSArray, NSAutoreleasePool, NSBundle, NSData, NSInteger, NSProcessInfo, NSString,
  19        NSUInteger, NSURL,
  20    },
  21};
  22use core_foundation::{
  23    base::{CFType, CFTypeRef, OSStatus, TCFType as _},
  24    boolean::CFBoolean,
  25    data::CFData,
  26    dictionary::{CFDictionary, CFDictionaryRef, CFMutableDictionary},
  27    string::{CFString, CFStringRef},
  28};
  29use ctor::ctor;
  30use futures::channel::oneshot;
  31use objc::{
  32    class,
  33    declare::ClassDecl,
  34    msg_send,
  35    runtime::{Class, Object, Sel},
  36    sel, sel_impl,
  37};
  38use parking_lot::Mutex;
  39use ptr::null_mut;
  40use std::{
  41    cell::Cell,
  42    convert::TryInto,
  43    ffi::{c_void, CStr, OsStr},
  44    os::{raw::c_char, unix::ffi::OsStrExt},
  45    path::{Path, PathBuf},
  46    process::Command,
  47    ptr,
  48    rc::Rc,
  49    slice, str,
  50    sync::Arc,
  51    time::Duration,
  52};
  53use time::UtcOffset;
  54
  55#[allow(non_upper_case_globals)]
  56const NSUTF8StringEncoding: NSUInteger = 4;
  57
  58const MAC_PLATFORM_IVAR: &str = "platform";
  59static mut APP_CLASS: *const Class = ptr::null();
  60static mut APP_DELEGATE_CLASS: *const Class = ptr::null();
  61
  62#[ctor]
  63unsafe fn build_classes() {
  64    APP_CLASS = {
  65        let mut decl = ClassDecl::new("GPUIApplication", class!(NSApplication)).unwrap();
  66        decl.add_ivar::<*mut c_void>(MAC_PLATFORM_IVAR);
  67        decl.add_method(
  68            sel!(sendEvent:),
  69            send_event as extern "C" fn(&mut Object, Sel, id),
  70        );
  71        decl.register()
  72    };
  73
  74    APP_DELEGATE_CLASS = {
  75        let mut decl = ClassDecl::new("GPUIApplicationDelegate", class!(NSResponder)).unwrap();
  76        decl.add_ivar::<*mut c_void>(MAC_PLATFORM_IVAR);
  77        decl.add_method(
  78            sel!(applicationDidFinishLaunching:),
  79            did_finish_launching as extern "C" fn(&mut Object, Sel, id),
  80        );
  81        decl.add_method(
  82            sel!(applicationShouldHandleReopen:hasVisibleWindows:),
  83            should_handle_reopen as extern "C" fn(&mut Object, Sel, id, bool),
  84        );
  85        decl.add_method(
  86            sel!(applicationDidBecomeActive:),
  87            did_become_active as extern "C" fn(&mut Object, Sel, id),
  88        );
  89        decl.add_method(
  90            sel!(applicationDidResignActive:),
  91            did_resign_active as extern "C" fn(&mut Object, Sel, id),
  92        );
  93        decl.add_method(
  94            sel!(applicationWillTerminate:),
  95            will_terminate as extern "C" fn(&mut Object, Sel, id),
  96        );
  97        decl.add_method(
  98            sel!(handleGPUIMenuItem:),
  99            handle_menu_item as extern "C" fn(&mut Object, Sel, id),
 100        );
 101        // Add menu item handlers so that OS save panels have the correct key commands
 102        decl.add_method(
 103            sel!(cut:),
 104            handle_menu_item as extern "C" fn(&mut Object, Sel, id),
 105        );
 106        decl.add_method(
 107            sel!(copy:),
 108            handle_menu_item as extern "C" fn(&mut Object, Sel, id),
 109        );
 110        decl.add_method(
 111            sel!(paste:),
 112            handle_menu_item as extern "C" fn(&mut Object, Sel, id),
 113        );
 114        decl.add_method(
 115            sel!(selectAll:),
 116            handle_menu_item as extern "C" fn(&mut Object, Sel, id),
 117        );
 118        decl.add_method(
 119            sel!(undo:),
 120            handle_menu_item as extern "C" fn(&mut Object, Sel, id),
 121        );
 122        decl.add_method(
 123            sel!(redo:),
 124            handle_menu_item as extern "C" fn(&mut Object, Sel, id),
 125        );
 126        decl.add_method(
 127            sel!(validateMenuItem:),
 128            validate_menu_item as extern "C" fn(&mut Object, Sel, id) -> bool,
 129        );
 130        decl.add_method(
 131            sel!(menuWillOpen:),
 132            menu_will_open as extern "C" fn(&mut Object, Sel, id),
 133        );
 134        decl.add_method(
 135            sel!(application:openURLs:),
 136            open_urls as extern "C" fn(&mut Object, Sel, id, id),
 137        );
 138        decl.register()
 139    }
 140}
 141
 142pub struct MacPlatform(Mutex<MacPlatformState>);
 143
 144pub struct MacPlatformState {
 145    background_executor: BackgroundExecutor,
 146    foreground_executor: ForegroundExecutor,
 147    text_system: Arc<MacTextSystem>,
 148    display_linker: MacDisplayLinker,
 149    pasteboard: id,
 150    text_hash_pasteboard_type: id,
 151    metadata_pasteboard_type: id,
 152    become_active: Option<Box<dyn FnMut()>>,
 153    resign_active: Option<Box<dyn FnMut()>>,
 154    reopen: Option<Box<dyn FnMut()>>,
 155    quit: Option<Box<dyn FnMut()>>,
 156    event: Option<Box<dyn FnMut(PlatformInput) -> bool>>,
 157    menu_command: Option<Box<dyn FnMut(&dyn Action)>>,
 158    validate_menu_command: Option<Box<dyn FnMut(&dyn Action) -> bool>>,
 159    will_open_menu: Option<Box<dyn FnMut()>>,
 160    menu_actions: Vec<Box<dyn Action>>,
 161    open_urls: Option<Box<dyn FnMut(Vec<String>)>>,
 162    finish_launching: Option<Box<dyn FnOnce()>>,
 163}
 164
 165impl Default for MacPlatform {
 166    fn default() -> Self {
 167        Self::new()
 168    }
 169}
 170
 171impl MacPlatform {
 172    pub fn new() -> Self {
 173        let dispatcher = Arc::new(MacDispatcher::new());
 174        Self(Mutex::new(MacPlatformState {
 175            background_executor: BackgroundExecutor::new(dispatcher.clone()),
 176            foreground_executor: ForegroundExecutor::new(dispatcher),
 177            text_system: Arc::new(MacTextSystem::new()),
 178            display_linker: MacDisplayLinker::new(),
 179            pasteboard: unsafe { NSPasteboard::generalPasteboard(nil) },
 180            text_hash_pasteboard_type: unsafe { ns_string("zed-text-hash") },
 181            metadata_pasteboard_type: unsafe { ns_string("zed-metadata") },
 182            become_active: None,
 183            resign_active: None,
 184            reopen: None,
 185            quit: None,
 186            event: None,
 187            menu_command: None,
 188            validate_menu_command: None,
 189            will_open_menu: None,
 190            menu_actions: Default::default(),
 191            open_urls: None,
 192            finish_launching: None,
 193        }))
 194    }
 195
 196    unsafe fn read_from_pasteboard(&self, pasteboard: *mut Object, kind: id) -> Option<&[u8]> {
 197        let data = pasteboard.dataForType(kind);
 198        if data == nil {
 199            None
 200        } else {
 201            Some(slice::from_raw_parts(
 202                data.bytes() as *mut u8,
 203                data.length() as usize,
 204            ))
 205        }
 206    }
 207
 208    unsafe fn create_menu_bar(
 209        &self,
 210        menus: Vec<Menu>,
 211        delegate: id,
 212        actions: &mut Vec<Box<dyn Action>>,
 213        keymap: &Keymap,
 214    ) -> id {
 215        let application_menu = NSMenu::new(nil).autorelease();
 216        application_menu.setDelegate_(delegate);
 217
 218        for menu_config in menus {
 219            let menu = NSMenu::new(nil).autorelease();
 220            menu.setTitle_(ns_string(menu_config.name));
 221            menu.setDelegate_(delegate);
 222
 223            for item_config in menu_config.items {
 224                menu.addItem_(Self::create_menu_item(
 225                    item_config,
 226                    delegate,
 227                    actions,
 228                    keymap,
 229                ));
 230            }
 231
 232            let menu_item = NSMenuItem::new(nil).autorelease();
 233            menu_item.setSubmenu_(menu);
 234            application_menu.addItem_(menu_item);
 235
 236            if menu_config.name == "Window" {
 237                let app: id = msg_send![APP_CLASS, sharedApplication];
 238                app.setWindowsMenu_(menu);
 239            }
 240        }
 241
 242        application_menu
 243    }
 244
 245    unsafe fn create_menu_item(
 246        item: MenuItem,
 247        delegate: id,
 248        actions: &mut Vec<Box<dyn Action>>,
 249        keymap: &Keymap,
 250    ) -> id {
 251        match item {
 252            MenuItem::Separator => NSMenuItem::separatorItem(nil),
 253            MenuItem::Action {
 254                name,
 255                action,
 256                os_action,
 257            } => {
 258                let keystrokes = keymap
 259                    .bindings_for_action(action.as_ref())
 260                    .next()
 261                    .map(|binding| binding.keystrokes());
 262
 263                let selector = match os_action {
 264                    Some(crate::OsAction::Cut) => selector("cut:"),
 265                    Some(crate::OsAction::Copy) => selector("copy:"),
 266                    Some(crate::OsAction::Paste) => selector("paste:"),
 267                    Some(crate::OsAction::SelectAll) => selector("selectAll:"),
 268                    Some(crate::OsAction::Undo) => selector("undo:"),
 269                    Some(crate::OsAction::Redo) => selector("redo:"),
 270                    None => selector("handleGPUIMenuItem:"),
 271                };
 272
 273                let item;
 274                if let Some(keystrokes) = keystrokes {
 275                    if keystrokes.len() == 1 {
 276                        let keystroke = &keystrokes[0];
 277                        let mut mask = NSEventModifierFlags::empty();
 278                        for (modifier, flag) in &[
 279                            (
 280                                keystroke.modifiers.command,
 281                                NSEventModifierFlags::NSCommandKeyMask,
 282                            ),
 283                            (
 284                                keystroke.modifiers.control,
 285                                NSEventModifierFlags::NSControlKeyMask,
 286                            ),
 287                            (
 288                                keystroke.modifiers.alt,
 289                                NSEventModifierFlags::NSAlternateKeyMask,
 290                            ),
 291                            (
 292                                keystroke.modifiers.shift,
 293                                NSEventModifierFlags::NSShiftKeyMask,
 294                            ),
 295                        ] {
 296                            if *modifier {
 297                                mask |= *flag;
 298                            }
 299                        }
 300
 301                        item = NSMenuItem::alloc(nil)
 302                            .initWithTitle_action_keyEquivalent_(
 303                                ns_string(name),
 304                                selector,
 305                                ns_string(key_to_native(&keystroke.key).as_ref()),
 306                            )
 307                            .autorelease();
 308                        item.setKeyEquivalentModifierMask_(mask);
 309                    }
 310                    // For multi-keystroke bindings, render the keystroke as part of the title.
 311                    else {
 312                        use std::fmt::Write;
 313
 314                        let mut name = format!("{name} [");
 315                        for (i, keystroke) in keystrokes.iter().enumerate() {
 316                            if i > 0 {
 317                                name.push(' ');
 318                            }
 319                            write!(&mut name, "{}", keystroke).unwrap();
 320                        }
 321                        name.push(']');
 322
 323                        item = NSMenuItem::alloc(nil)
 324                            .initWithTitle_action_keyEquivalent_(
 325                                ns_string(&name),
 326                                selector,
 327                                ns_string(""),
 328                            )
 329                            .autorelease();
 330                    }
 331                } else {
 332                    item = NSMenuItem::alloc(nil)
 333                        .initWithTitle_action_keyEquivalent_(
 334                            ns_string(name),
 335                            selector,
 336                            ns_string(""),
 337                        )
 338                        .autorelease();
 339                }
 340
 341                let tag = actions.len() as NSInteger;
 342                let _: () = msg_send![item, setTag: tag];
 343                actions.push(action);
 344                item
 345            }
 346            MenuItem::Submenu(Menu { name, items }) => {
 347                let item = NSMenuItem::new(nil).autorelease();
 348                let submenu = NSMenu::new(nil).autorelease();
 349                submenu.setDelegate_(delegate);
 350                for item in items {
 351                    submenu.addItem_(Self::create_menu_item(item, delegate, actions, keymap));
 352                }
 353                item.setSubmenu_(submenu);
 354                item.setTitle_(ns_string(name));
 355                item
 356            }
 357        }
 358    }
 359}
 360
 361impl Platform for MacPlatform {
 362    fn background_executor(&self) -> BackgroundExecutor {
 363        self.0.lock().background_executor.clone()
 364    }
 365
 366    fn foreground_executor(&self) -> crate::ForegroundExecutor {
 367        self.0.lock().foreground_executor.clone()
 368    }
 369
 370    fn text_system(&self) -> Arc<dyn PlatformTextSystem> {
 371        self.0.lock().text_system.clone()
 372    }
 373
 374    fn run(&self, on_finish_launching: Box<dyn FnOnce()>) {
 375        self.0.lock().finish_launching = Some(on_finish_launching);
 376
 377        unsafe {
 378            let app: id = msg_send![APP_CLASS, sharedApplication];
 379            let app_delegate: id = msg_send![APP_DELEGATE_CLASS, new];
 380            app.setDelegate_(app_delegate);
 381
 382            let self_ptr = self as *const Self as *const c_void;
 383            (*app).set_ivar(MAC_PLATFORM_IVAR, self_ptr);
 384            (*app_delegate).set_ivar(MAC_PLATFORM_IVAR, self_ptr);
 385
 386            let pool = NSAutoreleasePool::new(nil);
 387            app.run();
 388            pool.drain();
 389
 390            (*app).set_ivar(MAC_PLATFORM_IVAR, null_mut::<c_void>());
 391            (*app.delegate()).set_ivar(MAC_PLATFORM_IVAR, null_mut::<c_void>());
 392        }
 393    }
 394
 395    fn quit(&self) {
 396        // Quitting the app causes us to close windows, which invokes `Window::on_close` callbacks
 397        // synchronously before this method terminates. If we call `Platform::quit` while holding a
 398        // borrow of the app state (which most of the time we will do), we will end up
 399        // double-borrowing the app state in the `on_close` callbacks for our open windows. To solve
 400        // this, we make quitting the application asynchronous so that we aren't holding borrows to
 401        // the app state on the stack when we actually terminate the app.
 402
 403        use super::dispatcher::{dispatch_get_main_queue, dispatch_sys::dispatch_async_f};
 404
 405        unsafe {
 406            dispatch_async_f(dispatch_get_main_queue(), ptr::null_mut(), Some(quit));
 407        }
 408
 409        unsafe extern "C" fn quit(_: *mut c_void) {
 410            let app = NSApplication::sharedApplication(nil);
 411            let _: () = msg_send![app, terminate: nil];
 412        }
 413    }
 414
 415    fn restart(&self) {
 416        use std::os::unix::process::CommandExt as _;
 417
 418        let app_pid = std::process::id().to_string();
 419        let app_path = self
 420            .app_path()
 421            .ok()
 422            // When the app is not bundled, `app_path` returns the
 423            // directory containing the executable. Disregard this
 424            // and get the path to the executable itself.
 425            .and_then(|path| (path.extension()?.to_str()? == "app").then_some(path))
 426            .unwrap_or_else(|| std::env::current_exe().unwrap());
 427
 428        // Wait until this process has exited and then re-open this path.
 429        let script = r#"
 430            while kill -0 $0 2> /dev/null; do
 431                sleep 0.1
 432            done
 433            open "$1"
 434        "#;
 435
 436        let restart_process = Command::new("/bin/bash")
 437            .arg("-c")
 438            .arg(script)
 439            .arg(app_pid)
 440            .arg(app_path)
 441            .process_group(0)
 442            .spawn();
 443
 444        match restart_process {
 445            Ok(_) => self.quit(),
 446            Err(e) => log::error!("failed to spawn restart script: {:?}", e),
 447        }
 448    }
 449
 450    fn activate(&self, ignoring_other_apps: bool) {
 451        unsafe {
 452            let app = NSApplication::sharedApplication(nil);
 453            app.activateIgnoringOtherApps_(ignoring_other_apps.to_objc());
 454        }
 455    }
 456
 457    fn hide(&self) {
 458        unsafe {
 459            let app = NSApplication::sharedApplication(nil);
 460            let _: () = msg_send![app, hide: nil];
 461        }
 462    }
 463
 464    fn hide_other_apps(&self) {
 465        unsafe {
 466            let app = NSApplication::sharedApplication(nil);
 467            let _: () = msg_send![app, hideOtherApplications: nil];
 468        }
 469    }
 470
 471    fn unhide_other_apps(&self) {
 472        unsafe {
 473            let app = NSApplication::sharedApplication(nil);
 474            let _: () = msg_send![app, unhideAllApplications: nil];
 475        }
 476    }
 477
 478    // fn add_status_item(&self, _handle: AnyWindowHandle) -> Box<dyn platform::Window> {
 479    //     Box::new(StatusItem::add(self.fonts()))
 480    // }
 481
 482    fn displays(&self) -> Vec<Rc<dyn PlatformDisplay>> {
 483        MacDisplay::all()
 484            .map(|screen| Rc::new(screen) as Rc<_>)
 485            .collect()
 486    }
 487
 488    fn display(&self, id: DisplayId) -> Option<Rc<dyn PlatformDisplay>> {
 489        MacDisplay::find_by_id(id).map(|screen| Rc::new(screen) as Rc<_>)
 490    }
 491
 492    fn active_window(&self) -> Option<AnyWindowHandle> {
 493        MacWindow::active_window()
 494    }
 495
 496    fn open_window(
 497        &self,
 498        handle: AnyWindowHandle,
 499        options: WindowOptions,
 500    ) -> Box<dyn PlatformWindow> {
 501        Box::new(MacWindow::open(handle, options, self.foreground_executor()))
 502    }
 503
 504    fn set_display_link_output_callback(
 505        &self,
 506        display_id: DisplayId,
 507        callback: Box<dyn FnMut(&VideoTimestamp, &VideoTimestamp) + Send>,
 508    ) {
 509        self.0
 510            .lock()
 511            .display_linker
 512            .set_output_callback(display_id, callback);
 513    }
 514
 515    fn start_display_link(&self, display_id: DisplayId) {
 516        self.0.lock().display_linker.start(display_id);
 517    }
 518
 519    fn stop_display_link(&self, display_id: DisplayId) {
 520        self.0.lock().display_linker.stop(display_id);
 521    }
 522
 523    fn open_url(&self, url: &str) {
 524        unsafe {
 525            let url = NSURL::alloc(nil)
 526                .initWithString_(ns_string(url))
 527                .autorelease();
 528            let workspace: id = msg_send![class!(NSWorkspace), sharedWorkspace];
 529            msg_send![workspace, openURL: url]
 530        }
 531    }
 532
 533    fn on_open_urls(&self, callback: Box<dyn FnMut(Vec<String>)>) {
 534        self.0.lock().open_urls = Some(callback);
 535    }
 536
 537    fn prompt_for_paths(
 538        &self,
 539        options: PathPromptOptions,
 540    ) -> oneshot::Receiver<Option<Vec<PathBuf>>> {
 541        unsafe {
 542            let panel = NSOpenPanel::openPanel(nil);
 543            panel.setCanChooseDirectories_(options.directories.to_objc());
 544            panel.setCanChooseFiles_(options.files.to_objc());
 545            panel.setAllowsMultipleSelection_(options.multiple.to_objc());
 546            panel.setResolvesAliases_(false.to_objc());
 547            let (done_tx, done_rx) = oneshot::channel();
 548            let done_tx = Cell::new(Some(done_tx));
 549            let block = ConcreteBlock::new(move |response: NSModalResponse| {
 550                let result = if response == NSModalResponse::NSModalResponseOk {
 551                    let mut result = Vec::new();
 552                    let urls = panel.URLs();
 553                    for i in 0..urls.count() {
 554                        let url = urls.objectAtIndex(i);
 555                        if url.isFileURL() == YES {
 556                            if let Ok(path) = ns_url_to_path(url) {
 557                                result.push(path)
 558                            }
 559                        }
 560                    }
 561                    Some(result)
 562                } else {
 563                    None
 564                };
 565
 566                if let Some(done_tx) = done_tx.take() {
 567                    let _ = done_tx.send(result);
 568                }
 569            });
 570            let block = block.copy();
 571            let _: () = msg_send![panel, beginWithCompletionHandler: block];
 572            done_rx
 573        }
 574    }
 575
 576    fn prompt_for_new_path(&self, directory: &Path) -> oneshot::Receiver<Option<PathBuf>> {
 577        unsafe {
 578            let panel = NSSavePanel::savePanel(nil);
 579            let path = ns_string(directory.to_string_lossy().as_ref());
 580            let url = NSURL::fileURLWithPath_isDirectory_(nil, path, true.to_objc());
 581            panel.setDirectoryURL(url);
 582
 583            let (done_tx, done_rx) = oneshot::channel();
 584            let done_tx = Cell::new(Some(done_tx));
 585            let block = ConcreteBlock::new(move |response: NSModalResponse| {
 586                let mut result = None;
 587                if response == NSModalResponse::NSModalResponseOk {
 588                    let url = panel.URL();
 589                    if url.isFileURL() == YES {
 590                        result = ns_url_to_path(panel.URL()).ok()
 591                    }
 592                }
 593
 594                if let Some(done_tx) = done_tx.take() {
 595                    let _ = done_tx.send(result);
 596                }
 597            });
 598            let block = block.copy();
 599            let _: () = msg_send![panel, beginWithCompletionHandler: block];
 600            done_rx
 601        }
 602    }
 603
 604    fn reveal_path(&self, path: &Path) {
 605        unsafe {
 606            let path = path.to_path_buf();
 607            self.0
 608                .lock()
 609                .background_executor
 610                .spawn(async move {
 611                    let full_path = ns_string(path.to_str().unwrap_or(""));
 612                    let root_full_path = ns_string("");
 613                    let workspace: id = msg_send![class!(NSWorkspace), sharedWorkspace];
 614                    let _: BOOL = msg_send![
 615                        workspace,
 616                        selectFile: full_path
 617                        inFileViewerRootedAtPath: root_full_path
 618                    ];
 619                })
 620                .detach();
 621        }
 622    }
 623
 624    fn on_become_active(&self, callback: Box<dyn FnMut()>) {
 625        self.0.lock().become_active = Some(callback);
 626    }
 627
 628    fn on_resign_active(&self, callback: Box<dyn FnMut()>) {
 629        self.0.lock().resign_active = Some(callback);
 630    }
 631
 632    fn on_quit(&self, callback: Box<dyn FnMut()>) {
 633        self.0.lock().quit = Some(callback);
 634    }
 635
 636    fn on_reopen(&self, callback: Box<dyn FnMut()>) {
 637        self.0.lock().reopen = Some(callback);
 638    }
 639
 640    fn on_event(&self, callback: Box<dyn FnMut(PlatformInput) -> bool>) {
 641        self.0.lock().event = Some(callback);
 642    }
 643
 644    fn on_app_menu_action(&self, callback: Box<dyn FnMut(&dyn Action)>) {
 645        self.0.lock().menu_command = Some(callback);
 646    }
 647
 648    fn on_will_open_app_menu(&self, callback: Box<dyn FnMut()>) {
 649        self.0.lock().will_open_menu = Some(callback);
 650    }
 651
 652    fn on_validate_app_menu_command(&self, callback: Box<dyn FnMut(&dyn Action) -> bool>) {
 653        self.0.lock().validate_menu_command = Some(callback);
 654    }
 655
 656    fn os_name(&self) -> &'static str {
 657        "macOS"
 658    }
 659
 660    fn double_click_interval(&self) -> Duration {
 661        unsafe {
 662            let double_click_interval: f64 = msg_send![class!(NSEvent), doubleClickInterval];
 663            Duration::from_secs_f64(double_click_interval)
 664        }
 665    }
 666
 667    fn os_version(&self) -> Result<SemanticVersion> {
 668        unsafe {
 669            let process_info = NSProcessInfo::processInfo(nil);
 670            let version = process_info.operatingSystemVersion();
 671            Ok(SemanticVersion {
 672                major: version.majorVersion as usize,
 673                minor: version.minorVersion as usize,
 674                patch: version.patchVersion as usize,
 675            })
 676        }
 677    }
 678
 679    fn app_version(&self) -> Result<SemanticVersion> {
 680        unsafe {
 681            let bundle: id = NSBundle::mainBundle();
 682            if bundle.is_null() {
 683                Err(anyhow!("app is not running inside a bundle"))
 684            } else {
 685                let version: id = msg_send![bundle, objectForInfoDictionaryKey: ns_string("CFBundleShortVersionString")];
 686                let len = msg_send![version, lengthOfBytesUsingEncoding: NSUTF8StringEncoding];
 687                let bytes = version.UTF8String() as *const u8;
 688                let version = str::from_utf8(slice::from_raw_parts(bytes, len)).unwrap();
 689                version.parse()
 690            }
 691        }
 692    }
 693
 694    fn app_path(&self) -> Result<PathBuf> {
 695        unsafe {
 696            let bundle: id = NSBundle::mainBundle();
 697            if bundle.is_null() {
 698                Err(anyhow!("app is not running inside a bundle"))
 699            } else {
 700                Ok(path_from_objc(msg_send![bundle, bundlePath]))
 701            }
 702        }
 703    }
 704
 705    fn set_menus(&self, menus: Vec<Menu>, keymap: &Keymap) {
 706        unsafe {
 707            let app: id = msg_send![APP_CLASS, sharedApplication];
 708            let mut state = self.0.lock();
 709            let actions = &mut state.menu_actions;
 710            app.setMainMenu_(self.create_menu_bar(menus, app.delegate(), actions, keymap));
 711        }
 712    }
 713
 714    fn local_timezone(&self) -> UtcOffset {
 715        unsafe {
 716            let local_timezone: id = msg_send![class!(NSTimeZone), localTimeZone];
 717            let seconds_from_gmt: NSInteger = msg_send![local_timezone, secondsFromGMT];
 718            UtcOffset::from_whole_seconds(seconds_from_gmt.try_into().unwrap()).unwrap()
 719        }
 720    }
 721
 722    fn path_for_auxiliary_executable(&self, name: &str) -> Result<PathBuf> {
 723        unsafe {
 724            let bundle: id = NSBundle::mainBundle();
 725            if bundle.is_null() {
 726                Err(anyhow!("app is not running inside a bundle"))
 727            } else {
 728                let name = ns_string(name);
 729                let url: id = msg_send![bundle, URLForAuxiliaryExecutable: name];
 730                if url.is_null() {
 731                    Err(anyhow!("resource not found"))
 732                } else {
 733                    ns_url_to_path(url)
 734                }
 735            }
 736        }
 737    }
 738
 739    /// Match cursor style to one of the styles available
 740    /// in macOS's [NSCursor](https://developer.apple.com/documentation/appkit/nscursor).
 741    fn set_cursor_style(&self, style: CursorStyle) {
 742        unsafe {
 743            let new_cursor: id = match style {
 744                CursorStyle::Arrow => msg_send![class!(NSCursor), arrowCursor],
 745                CursorStyle::IBeam => msg_send![class!(NSCursor), IBeamCursor],
 746                CursorStyle::Crosshair => msg_send![class!(NSCursor), crosshairCursor],
 747                CursorStyle::ClosedHand => msg_send![class!(NSCursor), closedHandCursor],
 748                CursorStyle::OpenHand => msg_send![class!(NSCursor), openHandCursor],
 749                CursorStyle::PointingHand => msg_send![class!(NSCursor), pointingHandCursor],
 750                CursorStyle::ResizeLeft => msg_send![class!(NSCursor), resizeLeftCursor],
 751                CursorStyle::ResizeRight => msg_send![class!(NSCursor), resizeRightCursor],
 752                CursorStyle::ResizeLeftRight => msg_send![class!(NSCursor), resizeLeftRightCursor],
 753                CursorStyle::ResizeUp => msg_send![class!(NSCursor), resizeUpCursor],
 754                CursorStyle::ResizeDown => msg_send![class!(NSCursor), resizeDownCursor],
 755                CursorStyle::ResizeUpDown => msg_send![class!(NSCursor), resizeUpDownCursor],
 756                CursorStyle::DisappearingItem => {
 757                    msg_send![class!(NSCursor), disappearingItemCursor]
 758                }
 759                CursorStyle::IBeamCursorForVerticalLayout => {
 760                    msg_send![class!(NSCursor), IBeamCursorForVerticalLayout]
 761                }
 762                CursorStyle::OperationNotAllowed => {
 763                    msg_send![class!(NSCursor), operationNotAllowedCursor]
 764                }
 765                CursorStyle::DragLink => msg_send![class!(NSCursor), dragLinkCursor],
 766                CursorStyle::DragCopy => msg_send![class!(NSCursor), dragCopyCursor],
 767                CursorStyle::ContextualMenu => msg_send![class!(NSCursor), contextualMenuCursor],
 768            };
 769
 770            let old_cursor: id = msg_send![class!(NSCursor), currentCursor];
 771            if new_cursor != old_cursor {
 772                let _: () = msg_send![new_cursor, set];
 773            }
 774        }
 775    }
 776
 777    fn should_auto_hide_scrollbars(&self) -> bool {
 778        #[allow(non_upper_case_globals)]
 779        const NSScrollerStyleOverlay: NSInteger = 1;
 780
 781        unsafe {
 782            let style: NSInteger = msg_send![class!(NSScroller), preferredScrollerStyle];
 783            style == NSScrollerStyleOverlay
 784        }
 785    }
 786
 787    fn write_to_clipboard(&self, item: ClipboardItem) {
 788        let state = self.0.lock();
 789        unsafe {
 790            state.pasteboard.clearContents();
 791
 792            let text_bytes = NSData::dataWithBytes_length_(
 793                nil,
 794                item.text.as_ptr() as *const c_void,
 795                item.text.len() as u64,
 796            );
 797            state
 798                .pasteboard
 799                .setData_forType(text_bytes, NSPasteboardTypeString);
 800
 801            if let Some(metadata) = item.metadata.as_ref() {
 802                let hash_bytes = ClipboardItem::text_hash(&item.text).to_be_bytes();
 803                let hash_bytes = NSData::dataWithBytes_length_(
 804                    nil,
 805                    hash_bytes.as_ptr() as *const c_void,
 806                    hash_bytes.len() as u64,
 807                );
 808                state
 809                    .pasteboard
 810                    .setData_forType(hash_bytes, state.text_hash_pasteboard_type);
 811
 812                let metadata_bytes = NSData::dataWithBytes_length_(
 813                    nil,
 814                    metadata.as_ptr() as *const c_void,
 815                    metadata.len() as u64,
 816                );
 817                state
 818                    .pasteboard
 819                    .setData_forType(metadata_bytes, state.metadata_pasteboard_type);
 820            }
 821        }
 822    }
 823
 824    fn read_from_clipboard(&self) -> Option<ClipboardItem> {
 825        let state = self.0.lock();
 826        unsafe {
 827            if let Some(text_bytes) =
 828                self.read_from_pasteboard(state.pasteboard, NSPasteboardTypeString)
 829            {
 830                let text = String::from_utf8_lossy(text_bytes).to_string();
 831                let hash_bytes = self
 832                    .read_from_pasteboard(state.pasteboard, state.text_hash_pasteboard_type)
 833                    .and_then(|bytes| bytes.try_into().ok())
 834                    .map(u64::from_be_bytes);
 835                let metadata_bytes = self
 836                    .read_from_pasteboard(state.pasteboard, state.metadata_pasteboard_type)
 837                    .and_then(|bytes| String::from_utf8(bytes.to_vec()).ok());
 838
 839                if let Some((hash, metadata)) = hash_bytes.zip(metadata_bytes) {
 840                    if hash == ClipboardItem::text_hash(&text) {
 841                        Some(ClipboardItem {
 842                            text,
 843                            metadata: Some(metadata),
 844                        })
 845                    } else {
 846                        Some(ClipboardItem {
 847                            text,
 848                            metadata: None,
 849                        })
 850                    }
 851                } else {
 852                    Some(ClipboardItem {
 853                        text,
 854                        metadata: None,
 855                    })
 856                }
 857            } else {
 858                None
 859            }
 860        }
 861    }
 862
 863    fn write_credentials(&self, url: &str, username: &str, password: &[u8]) -> Result<()> {
 864        let url = CFString::from(url);
 865        let username = CFString::from(username);
 866        let password = CFData::from_buffer(password);
 867
 868        unsafe {
 869            use security::*;
 870
 871            // First, check if there are already credentials for the given server. If so, then
 872            // update the username and password.
 873            let mut verb = "updating";
 874            let mut query_attrs = CFMutableDictionary::with_capacity(2);
 875            query_attrs.set(kSecClass as *const _, kSecClassInternetPassword as *const _);
 876            query_attrs.set(kSecAttrServer as *const _, url.as_CFTypeRef());
 877
 878            let mut attrs = CFMutableDictionary::with_capacity(4);
 879            attrs.set(kSecClass as *const _, kSecClassInternetPassword as *const _);
 880            attrs.set(kSecAttrServer as *const _, url.as_CFTypeRef());
 881            attrs.set(kSecAttrAccount as *const _, username.as_CFTypeRef());
 882            attrs.set(kSecValueData as *const _, password.as_CFTypeRef());
 883
 884            let mut status = SecItemUpdate(
 885                query_attrs.as_concrete_TypeRef(),
 886                attrs.as_concrete_TypeRef(),
 887            );
 888
 889            // If there were no existing credentials for the given server, then create them.
 890            if status == errSecItemNotFound {
 891                verb = "creating";
 892                status = SecItemAdd(attrs.as_concrete_TypeRef(), ptr::null_mut());
 893            }
 894
 895            if status != errSecSuccess {
 896                return Err(anyhow!("{} password failed: {}", verb, status));
 897            }
 898        }
 899        Ok(())
 900    }
 901
 902    fn read_credentials(&self, url: &str) -> Result<Option<(String, Vec<u8>)>> {
 903        let url = CFString::from(url);
 904        let cf_true = CFBoolean::true_value().as_CFTypeRef();
 905
 906        unsafe {
 907            use security::*;
 908
 909            // Find any credentials for the given server URL.
 910            let mut attrs = CFMutableDictionary::with_capacity(5);
 911            attrs.set(kSecClass as *const _, kSecClassInternetPassword as *const _);
 912            attrs.set(kSecAttrServer as *const _, url.as_CFTypeRef());
 913            attrs.set(kSecReturnAttributes as *const _, cf_true);
 914            attrs.set(kSecReturnData as *const _, cf_true);
 915
 916            let mut result = CFTypeRef::from(ptr::null());
 917            let status = SecItemCopyMatching(attrs.as_concrete_TypeRef(), &mut result);
 918            match status {
 919                security::errSecSuccess => {}
 920                security::errSecItemNotFound | security::errSecUserCanceled => return Ok(None),
 921                _ => return Err(anyhow!("reading password failed: {}", status)),
 922            }
 923
 924            let result = CFType::wrap_under_create_rule(result)
 925                .downcast::<CFDictionary>()
 926                .ok_or_else(|| anyhow!("keychain item was not a dictionary"))?;
 927            let username = result
 928                .find(kSecAttrAccount as *const _)
 929                .ok_or_else(|| anyhow!("account was missing from keychain item"))?;
 930            let username = CFType::wrap_under_get_rule(*username)
 931                .downcast::<CFString>()
 932                .ok_or_else(|| anyhow!("account was not a string"))?;
 933            let password = result
 934                .find(kSecValueData as *const _)
 935                .ok_or_else(|| anyhow!("password was missing from keychain item"))?;
 936            let password = CFType::wrap_under_get_rule(*password)
 937                .downcast::<CFData>()
 938                .ok_or_else(|| anyhow!("password was not a string"))?;
 939
 940            Ok(Some((username.to_string(), password.bytes().to_vec())))
 941        }
 942    }
 943
 944    fn delete_credentials(&self, url: &str) -> Result<()> {
 945        let url = CFString::from(url);
 946
 947        unsafe {
 948            use security::*;
 949
 950            let mut query_attrs = CFMutableDictionary::with_capacity(2);
 951            query_attrs.set(kSecClass as *const _, kSecClassInternetPassword as *const _);
 952            query_attrs.set(kSecAttrServer as *const _, url.as_CFTypeRef());
 953
 954            let status = SecItemDelete(query_attrs.as_concrete_TypeRef());
 955
 956            if status != errSecSuccess {
 957                return Err(anyhow!("delete password failed: {}", status));
 958            }
 959        }
 960        Ok(())
 961    }
 962}
 963
 964unsafe fn path_from_objc(path: id) -> PathBuf {
 965    let len = msg_send![path, lengthOfBytesUsingEncoding: NSUTF8StringEncoding];
 966    let bytes = path.UTF8String() as *const u8;
 967    let path = str::from_utf8(slice::from_raw_parts(bytes, len)).unwrap();
 968    PathBuf::from(path)
 969}
 970
 971unsafe fn get_mac_platform(object: &mut Object) -> &MacPlatform {
 972    let platform_ptr: *mut c_void = *object.get_ivar(MAC_PLATFORM_IVAR);
 973    assert!(!platform_ptr.is_null());
 974    &*(platform_ptr as *const MacPlatform)
 975}
 976
 977extern "C" fn send_event(this: &mut Object, _sel: Sel, native_event: id) {
 978    unsafe {
 979        if let Some(event) = PlatformInput::from_native(native_event, None) {
 980            let platform = get_mac_platform(this);
 981            let mut lock = platform.0.lock();
 982            if let Some(mut callback) = lock.event.take() {
 983                drop(lock);
 984                let result = callback(event);
 985                platform.0.lock().event.get_or_insert(callback);
 986                if !result {
 987                    return;
 988                }
 989            }
 990        }
 991        msg_send![super(this, class!(NSApplication)), sendEvent: native_event]
 992    }
 993}
 994
 995extern "C" fn did_finish_launching(this: &mut Object, _: Sel, _: id) {
 996    unsafe {
 997        let app: id = msg_send![APP_CLASS, sharedApplication];
 998        app.setActivationPolicy_(NSApplicationActivationPolicyRegular);
 999
1000        let platform = get_mac_platform(this);
1001        let callback = platform.0.lock().finish_launching.take();
1002        if let Some(callback) = callback {
1003            callback();
1004        }
1005    }
1006}
1007
1008extern "C" fn should_handle_reopen(this: &mut Object, _: Sel, _: id, has_open_windows: bool) {
1009    if !has_open_windows {
1010        let platform = unsafe { get_mac_platform(this) };
1011        let mut lock = platform.0.lock();
1012        if let Some(mut callback) = lock.reopen.take() {
1013            drop(lock);
1014            callback();
1015            platform.0.lock().reopen.get_or_insert(callback);
1016        }
1017    }
1018}
1019
1020extern "C" fn did_become_active(this: &mut Object, _: Sel, _: id) {
1021    let platform = unsafe { get_mac_platform(this) };
1022    let mut lock = platform.0.lock();
1023    if let Some(mut callback) = lock.become_active.take() {
1024        drop(lock);
1025        callback();
1026        platform.0.lock().become_active.get_or_insert(callback);
1027    }
1028}
1029
1030extern "C" fn did_resign_active(this: &mut Object, _: Sel, _: id) {
1031    let platform = unsafe { get_mac_platform(this) };
1032    let mut lock = platform.0.lock();
1033    if let Some(mut callback) = lock.resign_active.take() {
1034        drop(lock);
1035        callback();
1036        platform.0.lock().resign_active.get_or_insert(callback);
1037    }
1038}
1039
1040extern "C" fn will_terminate(this: &mut Object, _: Sel, _: id) {
1041    let platform = unsafe { get_mac_platform(this) };
1042    let mut lock = platform.0.lock();
1043    if let Some(mut callback) = lock.quit.take() {
1044        drop(lock);
1045        callback();
1046        platform.0.lock().quit.get_or_insert(callback);
1047    }
1048}
1049
1050extern "C" fn open_urls(this: &mut Object, _: Sel, _: id, urls: id) {
1051    let urls = unsafe {
1052        (0..urls.count())
1053            .filter_map(|i| {
1054                let url = urls.objectAtIndex(i);
1055                match CStr::from_ptr(url.absoluteString().UTF8String() as *mut c_char).to_str() {
1056                    Ok(string) => Some(string.to_string()),
1057                    Err(err) => {
1058                        log::error!("error converting path to string: {}", err);
1059                        None
1060                    }
1061                }
1062            })
1063            .collect::<Vec<_>>()
1064    };
1065    let platform = unsafe { get_mac_platform(this) };
1066    let mut lock = platform.0.lock();
1067    if let Some(mut callback) = lock.open_urls.take() {
1068        drop(lock);
1069        callback(urls);
1070        platform.0.lock().open_urls.get_or_insert(callback);
1071    }
1072}
1073
1074extern "C" fn handle_menu_item(this: &mut Object, _: Sel, item: id) {
1075    unsafe {
1076        let platform = get_mac_platform(this);
1077        let mut lock = platform.0.lock();
1078        if let Some(mut callback) = lock.menu_command.take() {
1079            let tag: NSInteger = msg_send![item, tag];
1080            let index = tag as usize;
1081            if let Some(action) = lock.menu_actions.get(index) {
1082                let action = action.boxed_clone();
1083                drop(lock);
1084                callback(&*action);
1085            }
1086            platform.0.lock().menu_command.get_or_insert(callback);
1087        }
1088    }
1089}
1090
1091extern "C" fn validate_menu_item(this: &mut Object, _: Sel, item: id) -> bool {
1092    unsafe {
1093        let mut result = false;
1094        let platform = get_mac_platform(this);
1095        let mut lock = platform.0.lock();
1096        if let Some(mut callback) = lock.validate_menu_command.take() {
1097            let tag: NSInteger = msg_send![item, tag];
1098            let index = tag as usize;
1099            if let Some(action) = lock.menu_actions.get(index) {
1100                let action = action.boxed_clone();
1101                drop(lock);
1102                result = callback(action.as_ref());
1103            }
1104            platform
1105                .0
1106                .lock()
1107                .validate_menu_command
1108                .get_or_insert(callback);
1109        }
1110        result
1111    }
1112}
1113
1114extern "C" fn menu_will_open(this: &mut Object, _: Sel, _: id) {
1115    unsafe {
1116        let platform = get_mac_platform(this);
1117        let mut lock = platform.0.lock();
1118        if let Some(mut callback) = lock.will_open_menu.take() {
1119            drop(lock);
1120            callback();
1121            platform.0.lock().will_open_menu.get_or_insert(callback);
1122        }
1123    }
1124}
1125
1126unsafe fn ns_string(string: &str) -> id {
1127    NSString::alloc(nil).init_str(string).autorelease()
1128}
1129
1130unsafe fn ns_url_to_path(url: id) -> Result<PathBuf> {
1131    let path: *mut c_char = msg_send![url, fileSystemRepresentation];
1132    if path.is_null() {
1133        Err(anyhow!(
1134            "url is not a file path: {}",
1135            CStr::from_ptr(url.absoluteString().UTF8String()).to_string_lossy()
1136        ))
1137    } else {
1138        Ok(PathBuf::from(OsStr::from_bytes(
1139            CStr::from_ptr(path).to_bytes(),
1140        )))
1141    }
1142}
1143
1144mod security {
1145    #![allow(non_upper_case_globals)]
1146    use super::*;
1147
1148    #[link(name = "Security", kind = "framework")]
1149    extern "C" {
1150        pub static kSecClass: CFStringRef;
1151        pub static kSecClassInternetPassword: CFStringRef;
1152        pub static kSecAttrServer: CFStringRef;
1153        pub static kSecAttrAccount: CFStringRef;
1154        pub static kSecValueData: CFStringRef;
1155        pub static kSecReturnAttributes: CFStringRef;
1156        pub static kSecReturnData: CFStringRef;
1157
1158        pub fn SecItemAdd(attributes: CFDictionaryRef, result: *mut CFTypeRef) -> OSStatus;
1159        pub fn SecItemUpdate(query: CFDictionaryRef, attributes: CFDictionaryRef) -> OSStatus;
1160        pub fn SecItemDelete(query: CFDictionaryRef) -> OSStatus;
1161        pub fn SecItemCopyMatching(query: CFDictionaryRef, result: *mut CFTypeRef) -> OSStatus;
1162    }
1163
1164    pub const errSecSuccess: OSStatus = 0;
1165    pub const errSecUserCanceled: OSStatus = -128;
1166    pub const errSecItemNotFound: OSStatus = -25300;
1167}
1168
1169#[cfg(test)]
1170mod tests {
1171    use crate::ClipboardItem;
1172
1173    use super::*;
1174
1175    #[test]
1176    fn test_clipboard() {
1177        let platform = build_platform();
1178        assert_eq!(platform.read_from_clipboard(), None);
1179
1180        let item = ClipboardItem::new("1".to_string());
1181        platform.write_to_clipboard(item.clone());
1182        assert_eq!(platform.read_from_clipboard(), Some(item));
1183
1184        let item = ClipboardItem::new("2".to_string()).with_metadata(vec![3, 4]);
1185        platform.write_to_clipboard(item.clone());
1186        assert_eq!(platform.read_from_clipboard(), Some(item));
1187
1188        let text_from_other_app = "text from other app";
1189        unsafe {
1190            let bytes = NSData::dataWithBytes_length_(
1191                nil,
1192                text_from_other_app.as_ptr() as *const c_void,
1193                text_from_other_app.len() as u64,
1194            );
1195            platform
1196                .0
1197                .lock()
1198                .pasteboard
1199                .setData_forType(bytes, NSPasteboardTypeString);
1200        }
1201        assert_eq!(
1202            platform.read_from_clipboard(),
1203            Some(ClipboardItem::new(text_from_other_app.to_string()))
1204        );
1205    }
1206
1207    fn build_platform() -> MacPlatform {
1208        let platform = MacPlatform::new();
1209        platform.0.lock().pasteboard = unsafe { NSPasteboard::pasteboardWithUniqueName(nil) };
1210        platform
1211    }
1212}