ui-automation 0.1.1

Control the User Interface, cross-platform.
Documentation 
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
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

// Copyright (C) 2024 Tristan Gerritsen <tristan@thewoosh.org>
// All Rights Reserved.

use std::sync::Arc;

use crate::{create_backend, Application, Backend, Position, UIResult};

/// The top-level access to the UI.
///
/// ```
/// # use ui_automation::UIAutomation;
/// let automation = UIAutomation::new();
///
/// for app in automation.applications() {
///     println!("Window \"{}\"", app.name());
/// }
/// ```
#[derive(Debug, Clone)]
pub struct UIAutomation {
    backend: Arc<dyn Backend>,
}

impl UIAutomation {
    pub fn new() -> Self {
        Self::try_new().unwrap()
    }

    #[must_use]
    pub fn backend_name(&self) -> &str {
        self.backend.name()
    }

    pub fn mouse_position(&self) -> Position {
        self.backend.get_mouse_position().unwrap_or_default()
    }

    pub fn set_cursor_position(&self, position: impl Into<Position>) {
        self.backend.set_mouse_position(position.into()).unwrap();
    }

    pub fn applications(&self) -> Vec<Application> {
        self.try_applications().unwrap()
    }

    pub fn try_new() -> UIResult<Self> {
        Ok(Self {
            backend: create_backend()?,
        })
    }

    pub fn try_mouse_position(&self) -> UIResult<Position> {
        self.backend.get_mouse_position()
    }

    pub fn try_set_cursor_position(&self, position: impl Into<Position>) -> UIResult<()> {
        self.backend.set_mouse_position(position.into())
    }

    pub fn try_applications(&self) -> UIResult<Vec<Application>> {
        self.backend.applications(self.backend.clone())
    }
}