makcu 0.1.4__py3-none-any.whl → 0.2.0__py3-none-any.whl

makcu/controller.py

@@ -1,125 +1,315 @@
+import asyncio
 import random
 import time
+from typing import Optional, Dict, Callable, Union, List, Any
+from concurrent.futures import ThreadPoolExecutor
 from .mouse import Mouse
 from .connection import SerialTransport
 from .errors import MakcuConnectionError
 from .enums import MouseButton
 
 class MakcuController:
-    def __init__(self, fallback_com_port, debug=False, send_init=True):
-        self.transport = SerialTransport(fallback_com_port, debug=debug, send_init=send_init)
+    """Ultra-optimized MakcuController for gaming performance"""
+    
+    # Pre-computed lock mappings for O(1) access
+    _BUTTON_LOCK_MAP = {
+        MouseButton.LEFT: 'lock_left',
+        MouseButton.RIGHT: 'lock_right',
+        MouseButton.MIDDLE: 'lock_middle',
+        MouseButton.MOUSE4: 'lock_side1',
+        MouseButton.MOUSE5: 'lock_side2',
+    }
+    
+    def __init__(self, fallback_com_port: str = "", debug: bool = False, 
+                 send_init: bool = True, auto_reconnect: bool = True, 
+                 override_port: bool = False) -> None:
+        self.transport = SerialTransport(
+            fallback_com_port, 
+            debug=debug, 
+            send_init=send_init,
+            auto_reconnect=auto_reconnect,
+            override_port=override_port
+        )
         self.mouse = Mouse(self.transport)
-
-    def connect(self):
+        self._executor = ThreadPoolExecutor(max_workers=1)
+        self._connection_callbacks: List[Callable[[bool], None]] = []
+        
+        # Cache connection state to avoid repeated checks
+        self._connected = False
+
+    # Connection management
+    def connect(self) -> None:
+        """Connect with state caching"""
         self.transport.connect()
+        self._connected = True
+        self._notify_connection_change(True)
 
-    def disconnect(self):
+    def disconnect(self) -> None:
+        """Disconnect with cleanup"""
         self.transport.disconnect()
+        self._connected = False
+        self._notify_connection_change(False)
+        self._executor.shutdown(wait=False)
+
+    def is_connected(self) -> bool:
+        """Fast cached connection check"""
+        return self._connected and self.transport.is_connected()
 
-    def is_connected(self):
-        return self.transport.is_connected()
+    def _check_connection(self) -> None:
+        """Inline connection check for speed"""
+        if not self._connected:
+            raise MakcuConnectionError("Not connected")
 
-    def _check_connection(self):
-        if not self.transport.serial or not self.transport.serial.is_open:
+    def _notify_connection_change(self, connected: bool) -> None:
+        """Notify callbacks with error suppression"""
+        for callback in self._connection_callbacks:
+            try:
+                callback(connected)
+            except Exception:
+                pass  # Silently ignore for performance
+
+    # Optimized mouse operations
+    def click(self, button: MouseButton) -> None:
+        """Optimized click - direct command"""
+        if not self._connected:
             raise MakcuConnectionError("Not connected")
+        self.mouse.press(button)
+        self.mouse.release(button)
 
-    def click(self, button: MouseButton):
-        self._check_connection()
+    def double_click(self, button: MouseButton) -> None:
+        """Double click with minimal delay"""
+        if not self._connected:
+            raise MakcuConnectionError("Not connected")
+        self.mouse.press(button)
+        self.mouse.release(button)
+        # 1ms delay for double click recognition
+        time.sleep(0.001)
         self.mouse.press(button)
         self.mouse.release(button)
 
-    def move(self, dx: int, dy: int):
-        self._check_connection()
+    def move(self, dx: int, dy: int) -> None:
+        """Direct move"""
+        if not self._connected:
+            raise MakcuConnectionError("Not connected")
         self.mouse.move(dx, dy)
 
-    def scroll(self, delta: int):
-        self._check_connection()
+    def scroll(self, delta: int) -> None:
+        """Direct scroll"""
+        if not self._connected:
+            raise MakcuConnectionError("Not connected")
         self.mouse.scroll(delta)
 
-    def move_smooth(self, dx: int, dy: int, segments: int):
-        self._check_connection()
-        self.mouse.move_smooth(dx, dy, segments)
+    def press(self, button: MouseButton) -> None:
+        """Direct press"""
+        if not self._connected:
+            raise MakcuConnectionError("Not connected")
+        self.mouse.press(button)
 
-    def move_bezier(self, dx: int, dy: int, segments: int, ctrl_x: int, ctrl_y: int):
-        self._check_connection()
-        self.mouse.move_bezier(dx, dy, segments, ctrl_x, ctrl_y)
+    def release(self, button: MouseButton) -> None:
+        """Direct release"""
+        if not self._connected:
+            raise MakcuConnectionError("Not connected")
+        self.mouse.release(button)
 
-    def lock_mouse_x(self, lock: bool):
-        self._check_connection()
-        self.mouse.lock_x(lock)
+    # Advanced movement - unchanged but with connection check optimization
+    def move_smooth(self, dx: int, dy: int, segments: int = 10) -> None:
+        """Smooth movement"""
+        if not self._connected:
+            raise MakcuConnectionError("Not connected")
+        self.mouse.move_smooth(dx, dy, segments)
 
-    def lock_mouse_y(self, lock: bool):
-        self._check_connection()
-        self.mouse.lock_y(lock)
+    def move_bezier(self, dx: int, dy: int, segments: int = 20,
+                    ctrl_x: Optional[int] = None, ctrl_y: Optional[int] = None) -> None:
+        """Bezier curve movement"""
+        if not self._connected:
+            raise MakcuConnectionError("Not connected")
+        if ctrl_x is None:
+            ctrl_x = dx // 2
+        if ctrl_y is None:
+            ctrl_y = dy // 2
+        self.mouse.move_bezier(dx, dy, segments, ctrl_x, ctrl_y)
 
-    def lock_left(self, lock: bool):
-        self._check_connection()
+    # Optimized lock API
+    def lock(self, target: Union[MouseButton, str]) -> None:
+        """Lock with fast lookup"""
+        if not self._connected:
+            raise MakcuConnectionError("Not connected")
+            
+        if isinstance(target, MouseButton):
+            if target in self._BUTTON_LOCK_MAP:
+                getattr(self.mouse, self._BUTTON_LOCK_MAP[target])(True)
+            else:
+                raise ValueError(f"Unsupported button: {target}")
+        elif target.upper() in ['X', 'Y']:
+            if target.upper() == 'X':
+                self.mouse.lock_x(True)
+            else:
+                self.mouse.lock_y(True)
+        else:
+            raise ValueError(f"Invalid lock target: {target}")
+
+    def unlock(self, target: Union[MouseButton, str]) -> None:
+        """Unlock with fast lookup"""
+        if not self._connected:
+            raise MakcuConnectionError("Not connected")
+            
+        if isinstance(target, MouseButton):
+            if target in self._BUTTON_LOCK_MAP:
+                getattr(self.mouse, self._BUTTON_LOCK_MAP[target])(False)
+            else:
+                raise ValueError(f"Unsupported button: {target}")
+        elif target.upper() in ['X', 'Y']:
+            if target.upper() == 'X':
+                self.mouse.lock_x(False)
+            else:
+                self.mouse.lock_y(False)
+        else:
+            raise ValueError(f"Invalid unlock target: {target}")
+
+    # Direct lock methods for backward compatibility
+    def lock_left(self, lock: bool) -> None:
+        if not self._connected:
+            raise MakcuConnectionError("Not connected")
         self.mouse.lock_left(lock)
 
-    def lock_middle(self, lock: bool):
-        self._check_connection()
+    def lock_middle(self, lock: bool) -> None:
+        if not self._connected:
+            raise MakcuConnectionError("Not connected")
         self.mouse.lock_middle(lock)
 
-    def lock_right(self, lock: bool):
-        self._check_connection()
+    def lock_right(self, lock: bool) -> None:
+        if not self._connected:
+            raise MakcuConnectionError("Not connected")
         self.mouse.lock_right(lock)
 
-    def lock_side1(self, lock: bool):
-        self._check_connection()
+    def lock_side1(self, lock: bool) -> None:
+        if not self._connected:
+            raise MakcuConnectionError("Not connected")
         self.mouse.lock_side1(lock)
 
-    def lock_side2(self, lock: bool):
-        self._check_connection()
+    def lock_side2(self, lock: bool) -> None:
+        if not self._connected:
+            raise MakcuConnectionError("Not connected")
         self.mouse.lock_side2(lock)
 
-    def lock_x(self, lock: bool):
-        self._check_connection()
+    def lock_x(self, lock: bool) -> None:
+        if not self._connected:
+            raise MakcuConnectionError("Not connected")
         self.mouse.lock_x(lock)
 
-    def lock_y(self, lock: bool):
-        self._check_connection()
+    def lock_y(self, lock: bool) -> None:
+        if not self._connected:
+            raise MakcuConnectionError("Not connected")
         self.mouse.lock_y(lock)
 
-    def spoof_serial(self, serial: str):
-        self._check_connection()
+    def lock_mouse_x(self, lock: bool) -> None:
+        """Alias for lock_x"""
+        self.lock_x(lock)
+
+    def lock_mouse_y(self, lock: bool) -> None:
+        """Alias for lock_y"""
+        self.lock_y(lock)
+
+    def is_locked(self, button: MouseButton) -> bool:
+        """Check lock state"""
+        if not self._connected:
+            raise MakcuConnectionError("Not connected")
+        return self.mouse.is_locked(button)
+
+    def get_all_lock_states(self) -> Dict[str, bool]:
+        """Get all lock states"""
+        if not self._connected:
+            raise MakcuConnectionError("Not connected")
+        return self.mouse.get_all_lock_states()
+
+    # Device operations
+    def spoof_serial(self, serial: str) -> None:
+        """Spoof device serial"""
+        if not self._connected:
+            raise MakcuConnectionError("Not connected")
         self.mouse.spoof_serial(serial)
 
-    def reset_serial(self):
-        self._check_connection()
+    def reset_serial(self) -> None:
+        """Reset device serial"""
+        if not self._connected:
+            raise MakcuConnectionError("Not connected")
         self.mouse.reset_serial()
 
-    def get_device_info(self):
-        self._check_connection()
+    def get_device_info(self) -> Dict[str, str]:
+        """Get device information"""
+        if not self._connected:
+            raise MakcuConnectionError("Not connected")
         return self.mouse.get_device_info()
 
-    def get_firmware_version(self):
-        self._check_connection()
+    def get_firmware_version(self) -> str:
+        """Get firmware version"""
+        if not self._connected:
+            raise MakcuConnectionError("Not connected")
         return self.mouse.get_firmware_version()
 
+    # Button monitoring - direct transport access for speed
     def get_button_mask(self) -> int:
-        self._check_connection()
+        """Get current button mask"""
+        if not self._connected:
+            raise MakcuConnectionError("Not connected")
         return self.transport.get_button_mask()
 
-    def is_locked(self, button: MouseButton) -> bool:
-        self._check_connection()
-        return self.mouse.is_locked(button)
+    def get_button_states(self) -> Dict[str, bool]:
+        """Get current button states"""
+        if not self._connected:
+            raise MakcuConnectionError("Not connected")
+        return self.transport.get_button_states()
+
+    def is_pressed(self, button: MouseButton) -> bool:
+        """Check if button is pressed"""
+        if not self._connected:
+            raise MakcuConnectionError("Not connected")
+        return self.transport.get_button_states().get(button.name.lower(), False)
+
+    def enable_button_monitoring(self, enable: bool = True) -> None:
+        """Enable/disable button monitoring"""
+        if not self._connected:
+            raise MakcuConnectionError("Not connected")
+        self.transport.enable_button_monitoring(enable)
+
+    def set_button_callback(self, callback: Optional[Callable[[MouseButton, bool], None]]) -> None:
+        """Set button event callback"""
+        if not self._connected:
+            raise MakcuConnectionError("Not connected")
+        self.transport.set_button_callback(callback)
+
+    # Connection management
+    def on_connection_change(self, callback: Callable[[bool], None]) -> None:
+        """Register connection status change callback"""
+        self._connection_callbacks.append(callback)
+
+    def remove_connection_callback(self, callback: Callable[[bool], None]) -> None:
+        """Remove connection status callback"""
+        if callback in self._connection_callbacks:
+            self._connection_callbacks.remove(callback)
 
+    # Human-like interactions with optimized timing
     def click_human_like(self, button: MouseButton, count: int = 1,
-        profile: str = "normal", jitter: int = 0):
-        self._check_connection()
+                        profile: str = "normal", jitter: int = 0) -> None:
+        """Human-like clicking optimized for gaming"""
+        if not self._connected:
+            raise MakcuConnectionError("Not connected")
 
+        # Pre-computed timing profiles (in milliseconds)
         timing_profiles = {
             "normal": (60, 120, 100, 180),
             "fast": (30, 60, 50, 100),
             "slow": (100, 180, 150, 300),
+            "variable": (40, 200, 80, 250),
+            "gaming": (20, 40, 30, 60),  # New gaming profile
         }
 
         if profile not in timing_profiles:
-            raise ValueError(f"Invalid profile: {profile}. Choose from {list(timing_profiles.keys())}")
+            raise ValueError(f"Invalid profile: {profile}")
 
         min_down, max_down, min_wait, max_wait = timing_profiles[profile]
 
-        for _ in range(count):
+        for i in range(count):
             if jitter > 0:
                 dx = random.randint(-jitter, jitter)
                 dy = random.randint(-jitter, jitter)
@@ -128,32 +318,104 @@ class MakcuController:
             self.mouse.press(button)
             time.sleep(random.uniform(min_down, max_down) / 1000.0)
             self.mouse.release(button)
-            time.sleep(random.uniform(min_wait, max_wait) / 1000.0)
-
-    def enable_button_monitoring(self, enable: bool = True):
-        self._check_connection()
-        self.transport.enable_button_monitoring(enable)
-
-    def set_button_callback(self, callback):
-        self._check_connection()
-        self.transport.set_button_callback(callback)
-
-    def get_all_lock_states(self) -> dict:
-        self._check_connection()
-        return self.mouse.get_all_lock_states()
-
-    def press(self, button: MouseButton):
-        self._check_connection()
-        self.mouse.press(button)
-
-    def release(self, button: MouseButton):
-        self._check_connection()
-        self.mouse.release(button)
-
-    def get_button_states(self) -> dict:
-        self._check_connection()
-        return self.transport.get_button_states()
-
-    def is_pressed(self, button: MouseButton) -> bool:
-        self._check_connection()
-        return self.transport.get_button_states().get(button.name.lower(), False)
+            
+            if i < count - 1:
+                time.sleep(random.uniform(min_wait, max_wait) / 1000.0)
+
+    def drag(self, start_x: int, start_y: int, end_x: int, end_y: int,
+             button: MouseButton = MouseButton.LEFT, duration: float = 1.0) -> None:
+        """Optimized drag operation"""
+        if not self._connected:
+            raise MakcuConnectionError("Not connected")
+        
+        # Move to start
+        self.move(start_x, start_y)
+        time.sleep(0.02)  # Reduced from 0.05
+        
+        # Press button
+        self.press(button)
+        time.sleep(0.02)  # Reduced from 0.05
+        
+        # Move to end with smooth motion
+        segments = max(10, int(duration * 30))
+        self.move_smooth(end_x - start_x, end_y - start_y, segments)
+        
+        # Release button
+        time.sleep(0.02)  # Reduced from 0.05
+        self.release(button)
+
+    # Context manager support
+    def __enter__(self):
+        """Context manager entry"""
+        if not self.is_connected():
+            self.connect()
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        """Context manager exit"""
+        self.disconnect()
+
+    # Async methods for forward compatibility
+    async def async_connect(self) -> None:
+        """Async connect"""
+        loop = asyncio.get_running_loop()
+        await loop.run_in_executor(self._executor, self.connect)
+
+    async def async_disconnect(self) -> None:
+        """Async disconnect"""
+        loop = asyncio.get_running_loop()
+        await loop.run_in_executor(self._executor, self.disconnect)
+
+    async def async_click(self, button: MouseButton) -> None:
+        """Async click"""
+        loop = asyncio.get_running_loop()
+        await loop.run_in_executor(self._executor, self.click, button)
+
+    async def async_move(self, dx: int, dy: int) -> None:
+        """Async move"""
+        loop = asyncio.get_running_loop()
+        await loop.run_in_executor(self._executor, self.move, dx, dy)
+
+    async def async_scroll(self, delta: int) -> None:
+        """Async scroll"""
+        loop = asyncio.get_running_loop()
+        await loop.run_in_executor(self._executor, self.scroll, delta)
+
+    # Async context manager
+    async def __aenter__(self):
+        """Async context manager entry"""
+        await self.async_connect()
+        return self
+
+    async def __aexit__(self, exc_type, exc_val, exc_tb):
+        """Async context manager exit"""
+        await self.async_disconnect()
+
+
+# Factory functions with connection optimization
+def create_controller(fallback_com_port: str = "", debug: bool = False, 
+                     send_init: bool = True, auto_reconnect: bool = True) -> MakcuController:
+    """Create and connect a controller"""
+    makcu = MakcuController(
+        fallback_com_port, 
+        debug=debug, 
+        send_init=send_init,
+        auto_reconnect=auto_reconnect
+    )
+    makcu.connect()
+    return makcu
+
+
+async def create_async_controller(fallback_com_port: str = "", debug: bool = False,
+                                 send_init: bool = True, auto_reconnect: bool = True, 
+                                 override_port: bool = False) -> MakcuController:
+    """Create and connect a controller asynchronously"""
+    makcu = MakcuController(
+        fallback_com_port,
+        debug=debug,
+        send_init=send_init,
+        auto_reconnect=auto_reconnect,
+        override_port=override_port
+    )
+    await makcu.async_connect()
+    return makcu

makcu/makcu.pyi

@@ -0,0 +1,13 @@
+from typing import Optional, Dict, Callable, List, Union
+from .controller import MakcuController
+from .enums import MouseButton
+from .errors import MakcuError, MakcuConnectionError, MakcuCommandError, MakcuTimeoutError, MakcuResponseError
+
+__version__: str
+__all__: List[str]
+
+def create_controller(
+    fallback_com_port: str = "", 
+    debug: bool = False, 
+    send_init: bool = True
+) -> MakcuController: ...