axterminator 0.6.1

macOS GUI testing framework with background testing, sub-millisecond element access, and self-healing locators
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

//! Error types for `AXTerminator`

use pyo3::exceptions::PyRuntimeError;
use pyo3::prelude::*;
use thiserror::Error;

/// `AXTerminator` error types
#[derive(Error, Debug)]
pub enum AXError {
    #[error("Accessibility not enabled. Enable in System Preferences > Privacy > Accessibility")]
    AccessibilityNotEnabled,

    #[error("Application not found: {0}")]
    AppNotFound(String),

    #[error("Application not running: {0}")]
    AppNotRunning(String),

    #[error("Element not found: {0}")]
    ElementNotFound(String),

    #[error("Element not found after healing attempts: {0}")]
    ElementNotFoundAfterHealing(String),

    #[error("Action failed: {0}")]
    ActionFailed(String),

    #[error("Action not supported in background mode: {0}")]
    BackgroundNotSupported(String),

    #[error("Timeout waiting for element: {0}")]
    Timeout(String),

    #[error("Invalid query: {0}")]
    InvalidQuery(String),

    #[error("macOS API error: {0}")]
    SystemError(String),
}

impl From<AXError> for PyErr {
    fn from(err: AXError) -> PyErr {
        PyRuntimeError::new_err(err.to_string())
    }
}

/// Result type for `AXTerminator` operations
pub type AXResult<T> = Result<T, AXError>;