3 releases (breaking)

Uses old Rust 2015

0.3.0 May 24, 2017
0.2.0 Mar 24, 2017
0.1.0 Mar 24, 2017

#123 in macOS and iOS APIs

Download history 2066/week @ 2024-07-22 3281/week @ 2024-07-29 3653/week @ 2024-08-05 2229/week @ 2024-08-12 5811/week @ 2024-08-19 5870/week @ 2024-08-26 6132/week @ 2024-09-02 4553/week @ 2024-09-09 3933/week @ 2024-09-16 4675/week @ 2024-09-23 5592/week @ 2024-09-30 5641/week @ 2024-10-07 5445/week @ 2024-10-14 5092/week @ 2024-10-21 6367/week @ 2024-10-28 6485/week @ 2024-11-04

24,043 downloads per month
Used in 3 crates (2 directly)

BSD-3-Clause

6KB
88 lines

rust-osascript

This library implements a simplified wrapper around the OSA system on OS X to remote control applications with JavaScript.


lib.rs:

This library implements limited functionality for the OSA System on macOS. In particular it allows you to execute JavaScript via the OSA system to script applications. It's particularly useful if you need to tell other applications to execute certain functionality.

Currently only JavaScript is supported. Parameters passed to it show up as $params and the return value from the script (as returned with the return keyword) is deserialized later.

Example

extern crate osascript;
#[macro_use] extern crate serde_derive;

#[derive(Serialize)]
struct AlertParams {
    title: String,
    message: String,
    alert_type: String,
    buttons: Vec<String>,
}

#[derive(Deserialize)]
struct AlertResult {
    #[serde(rename="buttonReturned")]
    button: String,
}

fn main() {
    let script = osascript::JavaScript::new("
        var App = Application('Finder');
        App.includeStandardAdditions = true;
        return App.displayAlert($params.title, {
            message: $params.message,
            'as': $params.alert_type,
            buttons: $params.buttons,
        });
    ");

    let rv: AlertResult = script.execute_with_params(AlertParams {
        title: "Shit is on fire!".into(),
        message: "What is happening".into(),
        alert_type: "critical".into(),
        buttons: vec![
            "Show details".into(),
            "Ignore".into(),
        ]
    }).unwrap();

    println!("You clicked '{}'", rv.button);
}

Dependencies

~0.7–1.6MB
~34K SLoC