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
52
53
54
55
56
57
58
59
60
61

#!/usr/bin/env python3
"""System Preferences automation example.

Demonstrates:
- Navigating complex UI hierarchies
- Working with sidebars and panes
- Background operation
"""

import axterminator
import time


def main():
    if not axterminator.is_accessibility_enabled():
        print("ERROR: Accessibility permissions not granted.")
        return

    # Open System Settings (macOS Ventura+) or System Preferences
    print("Connecting to System Settings...")

    try:
        app = axterminator.app(name="System Settings", launch=True)
    except Exception:
        # Fallback for older macOS
        app = axterminator.app(name="System Preferences", launch=True)

    print(f"Connected! PID: {app.pid}")
    time.sleep(1)  # Wait for UI to load

    # Navigate to Accessibility settings
    print("\nNavigating to Accessibility...")

    # Find and click Accessibility in sidebar
    accessibility = app.find("Accessibility", timeout_ms=5000)
    accessibility.click()
    time.sleep(0.5)

    # Explore the accessibility tree
    print("\nAccessibility panel loaded.")
    print("Available options in this pane:")

    # Find all clickable items in the main content area
    try:
        # Look for common accessibility options
        options = ["VoiceOver", "Zoom", "Display", "Spoken Content"]
        for opt in options:
            try:
                element = app.find(opt, timeout_ms=1000)
                print(f"  - {opt}: Found")
            except Exception:
                print(f"  - {opt}: Not visible")
    except Exception as e:
        print(f"Could not enumerate options: {e}")

    print("\nSystem Settings automation complete!")
    print("Note: All operations ran in the background.")


if __name__ == "__main__":
    main()