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>,
    pub needs_restart: bool,
}

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.

needs_restart: bool

The app is running but does not expose its UI to accessibility, so it cannot be inspected or controlled until it is quit and started again.

Only set on Linux, for browser-engine apps started before desktop accessibility was turned on.

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 const fn with_needs_restart(self, needs_restart: bool) -> Self

Marks the app as running without an accessibility tree (see AppInfo::needs_restart).

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 16)

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, app.needs_restart) {
            (true, _, true) => "restart",
            (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