axterminator 0.10.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
49
50
51

#!/usr/bin/env python3
"""Basic usage example for axterminator.

Demonstrates:
- Connecting to an application
- Finding elements
- Clicking buttons
- Reading values
- Background operation (no focus steal)
"""

import axterminator


def main():
    # Check accessibility permissions first
    if not axterminator.is_accessibility_enabled():
        print("ERROR: Accessibility permissions not granted.")
        print("Go to System Preferences > Privacy & Security > Accessibility")
        print("and add your terminal/IDE to the allowed list.")
        return

    # Connect to Calculator (must be running)
    print("Connecting to Calculator...")
    app = axterminator.app(name="Calculator")
    print(f"Connected! PID: {app.pid}")

    # Find and click number buttons (background operation - won't steal focus)
    print("\nPerforming calculation: 5 + 3 = ")

    # These operations happen in the background
    button_5 = app.find("5", timeout_ms=2000)
    button_5.click()

    button_plus = app.find("+", timeout_ms=2000)
    button_plus.click()

    button_3 = app.find("3", timeout_ms=2000)
    button_3.click()

    button_equals = app.find("=", timeout_ms=2000)
    button_equals.click()

    # Read the result
    # Note: Calculator display accessibility varies by macOS version
    print("Calculation performed!")
    print("\nNote: This script ran in the background without stealing focus.")


if __name__ == "__main__":
    main()