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
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103

#!/usr/bin/env python3
"""pytest integration example.

Demonstrates using axterminator with pytest fixtures and markers.

Run with: pytest examples/pytest_example.py -v
"""

import pytest
import axterminator


# Mark all tests to run in background (no focus stealing)
pytestmark = pytest.mark.ax_background


class TestCalculator:
    """Calculator app tests using axterminator fixtures."""

    @pytest.mark.ax_requires_app("Calculator")
    def test_addition(self, ax_app, ax_wait):
        """Test basic addition: 7 + 3 = 10."""
        app = ax_app("Calculator")

        # Perform calculation
        app.find("7").click()
        app.find("+").click()
        app.find("3").click()
        app.find("=").click()

        ax_wait(0.1)  # Small wait for result

        # Verify (actual verification depends on Calculator version)
        print("Addition test completed!")

    @pytest.mark.ax_requires_app("Calculator")
    def test_multiplication(self, ax_app, ax_wait):
        """Test multiplication: 6 x 4 = 24."""
        app = ax_app("Calculator")

        # Clear first
        app.find("C").click()
        ax_wait(0.1)

        # Perform calculation
        app.find("6").click()
        app.find("×").click()  # Note: this is multiplication sign, not x
        app.find("4").click()
        app.find("=").click()

        ax_wait(0.1)
        print("Multiplication test completed!")

    @pytest.mark.ax_requires_app("Calculator")
    def test_clear(self, ax_app):
        """Test clear button resets display."""
        app = ax_app("Calculator")

        # Enter some numbers
        app.find("9").click()
        app.find("9").click()
        app.find("9").click()

        # Clear
        app.find("C").click()

        print("Clear test completed!")


class TestFinder:
    """Finder tests demonstrating menu navigation."""

    @pytest.mark.ax_requires_app("Finder")
    @pytest.mark.ax_slow  # Mark as slow test
    def test_new_window_menu(self, ax_app, ax_wait):
        """Test opening new Finder window via menu."""
        app = ax_app("Finder")

        # Open File menu
        file_menu = app.find("File", role="AXMenuBarItem")
        file_menu.click()
        ax_wait(0.3)

        # Click New Finder Window
        new_window = app.find("New Finder Window")
        new_window.click()
        ax_wait(0.5)

        print("New window test completed!")


# Standalone test function (not in class)
@pytest.mark.ax_requires_app("TextEdit")
def test_textedit_launch(ax_app):
    """Test TextEdit launches successfully."""
    app = ax_app("TextEdit", launch=True)
    assert app.pid > 0
    print(f"TextEdit launched with PID: {app.pid}")


if __name__ == "__main__":
    # Run with pytest
    pytest.main([__file__, "-v", "--tb=short"])