Struct AppInfo 

#[non_exhaustive]
pub struct AppInfo {
    pub name: String,
    pub bundle_id: Option<String>,
    pub pid: Option<u32>,
    pub path: Option<PathBuf>,
    pub is_running: bool,
    pub is_active: bool,
    pub window_title: Option<String>,
}

An application that is running or installed.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

name: String

Human-readable name, e.g. TextEdit.

bundle_id: Option<String>

Platform identifier: a bundle ID on macOS, an AUMID or executable name on Windows, a desktop-file ID on Linux.

pid: Option<u32>

Process ID, when running.

path: Option<PathBuf>

Path to the app bundle or executable.

is_running: bool

Whether the app currently has a process.

is_active: bool

Whether the app is the frontmost (focused) app.

window_title: Option<String>

Title of the app’s main window, when the platform reports one. Queries also match it.

Implementations

impl AppInfo

pub fn new(name: impl Into<String>) -> Self

Creates a record for an app with only a name; fill the rest with the builder methods.

pub fn with_bundle_id(self, bundle_id: impl Into<String>) -> Self

Sets the platform identifier.

pub const fn with_pid(self, pid: u32) -> Self

Marks the app as running with pid.

pub fn with_path(self, path: impl Into<PathBuf>) -> Self

Sets the bundle or executable path.

pub const fn with_active(self, active: bool) -> Self

Marks the app as frontmost.

pub fn with_window_title(self, title: impl Into<String>) -> Self

Sets the main window title.

pub fn reference(&self) -> &str

The identifier shown to callers: bundle ID when known, otherwise the name.

Examples found in repository

examples/list_apps.rs (line 15)

fn main() -> computer_use::Result<()> {
    let computer = computer_use::Computer::new()?;
    for app in computer.list_apps()? {
        let status = match (app.is_running, app.is_active) {
            (true, true) => "active",
            (true, false) => "running",
            _ => "installed",
        };
        let pid = app.pid.map(|p| format!(" pid {p}")).unwrap_or_default();
        println!("{:<9} {} [{}]{pid}", status, app.name, app.reference());
    }
    Ok(())
}

pub fn match_score(&self, query: &str) -> Option<u8>

How well this app matches a user query; None means no match.

Queries may be a name, bundle ID, path, or pid:<n>. Lower scores are better.

Trait Implementations

impl Clone for AppInfo

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AppInfo

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for AppInfo

fn default() -> Self

Returns the “default value” for a type.

impl Eq for AppInfo

impl PartialEq for AppInfo

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for AppInfo