feat: add cooperation ticket claim automation

tests/test_cooperation.py

@@ -0,0 +1,60 @@
+import unittest
+from pathlib import Path
+
+from PIL import Image
+
+from automation.cooperation import CooperationRunner
+from automation.engine import Matcher, Region, load_flow
+
+ROOT = Path(__file__).resolve().parent.parent
+
+
+class CooperationDesktop:
+    def __init__(self, images):
+        self.images = images
+        self.index = 0
+        self.clicks = []
+
+    def screenshot(self):
+        return self.images[min(self.index, len(self.images) - 1)]
+
+    def click(self, point, region, size, hold=0.2):
+        self.clicks.append((point, hold))
+        self.index += 1
+
+
+class CooperationTests(unittest.TestCase):
+    def setUp(self):
+        self.flow = load_flow(ROOT / 'workflows/cooperation_ticket.json')
+        self.matcher = Matcher(ROOT / 'assets')
+        self.region = Region(0, 0, 562, 1002)
+
+    def image(self, state):
+        image = Image.new('RGB', (562, 1002), (42, 58, 73))
+        for spec in self.flow['states'][state]:
+            template = Image.open(ROOT / 'assets' / spec['template']).convert('RGB')
+            x, y, _, _ = spec['search']
+            image.paste(template, (x + 5, y + 5))
+        return image
+
+    def runner(self, states):
+        desktop = CooperationDesktop([self.image(state) for state in states])
+        return desktop, CooperationRunner(desktop, self.matcher, self.flow,
+                                          lambda _: self.region, log=lambda _: None, timeout=0.8)
+
+    def test_claims_ticket_and_returns_home(self):
+        desktop, runner = self.runner(['home', 'territory', 'selection', 'available', 'reward', 'claimed', 'territory', 'home'])
+        self.assertEqual(runner.run(), 'claimed')
+        expected = ('territory', 'open_cooperation', 'choose_cooperation', 'claim_ticket',
+                    'dismiss_reward', 'cooperation_back', 'territory_back')
+        self.assertEqual([point for point, _ in desktop.clicks], [self.flow['clicks'][name] for name in expected])
+
+    def test_already_claimed_skips_ticket_and_returns_home(self):
+        desktop, runner = self.runner(['home', 'territory', 'selection', 'claimed', 'territory', 'home'])
+        self.assertEqual(runner.run(), 'already_claimed')
+        expected = ('territory', 'open_cooperation', 'choose_cooperation', 'cooperation_back', 'territory_back')
+        self.assertEqual([point for point, _ in desktop.clicks], [self.flow['clicks'][name] for name in expected])
+
+
+if __name__ == '__main__':
+    unittest.main()