makcu 2.1.2__py3-none-any.whl → 2.2.0__py3-none-any.whl

makcu/test_suite.py

@@ -1,145 +1,142 @@
-import pytest
-import time
-from makcu import MouseButton
-
-
-TEST_BUTTONS = (MouseButton.LEFT, MouseButton.RIGHT, MouseButton.MIDDLE)
-BUTTON_STATE_KEYS = ('left', 'right', 'middle', 'mouse4', 'mouse5')
-MOVE_COORDS = ((10, 0), (0, 10), (-10, 0), (0, -10))
-
-def test_connect_to_port(makcu):
-    print("Connecting to port...")
-    makcu.connect()
-    assert makcu.is_connected(), "Failed to connect to the makcu"
-
-def test_press_and_release(makcu):
-    makcu.press(MouseButton.LEFT)
-    makcu.release(MouseButton.LEFT)
-
-def test_firmware_version(makcu):
-    version = makcu.mouse.get_firmware_version()
-    assert version and len(version.strip()) > 0
-
-def test_middle_click(makcu):
-    makcu.press(MouseButton.MIDDLE)
-    makcu.release(MouseButton.MIDDLE)
-
-def test_device_info(makcu):
-    print("Fetching device info...")
-    info = makcu.mouse.get_device_info()
-    print(f"Device Info: {info}")
-    assert info.get("port")
-    assert info.get("isConnected") is True
-
-def test_port_connection(makcu):
-    assert makcu.is_connected()
-
-def test_button_mask(makcu):
-    print("Getting button mask...")
-    mask = makcu.get_button_mask()
-    print(f"Mask value: {mask}")
-    assert isinstance(mask, int)
-
-def test_get_button_states(makcu):
-    states = makcu.get_button_states()
-    assert isinstance(states, dict)
-    for key in BUTTON_STATE_KEYS:
-        assert key in states
-
-def test_lock_state(makcu):
-    print("Locking LEFT button...")
-    makcu.lock_left(True)
-    print("Querying lock state while LEFT is locked...")
-    state = makcu.is_locked(MouseButton.LEFT)
-    print(state)
-    assert state
-
-def test_makcu_behavior(makcu):
-    makcu.move(25, 25)
-    makcu.click(MouseButton.LEFT)
-    makcu.scroll(-2)
-
-def test_batch_commands(makcu):
-    print("Testing batch command execution (10 commands)...")
-    
-    start_time = time.perf_counter()
-    
-
-    makcu.move(10, 0)
-    makcu.click(MouseButton.LEFT)
-    makcu.move(0, 10)
-    makcu.press(MouseButton.RIGHT)
-    makcu.release(MouseButton.RIGHT)
-    makcu.scroll(-1)
-    makcu.move(-10, 0)
-    makcu.click(MouseButton.MIDDLE)
-    makcu.move(0, -10)
-    makcu.scroll(1)
-    
-    end_time = time.perf_counter()
-    elapsed_ms = (end_time - start_time) * 1000
-    
-    print(f"Batch execution time: {elapsed_ms:.2f}ms")
-    print(f"Average per command: {elapsed_ms/10:.2f}ms")
-    
-
-    assert elapsed_ms < 50, f"Batch commands took {elapsed_ms:.2f}ms, expected < 50ms"
-    
-
-    start_time = time.perf_counter()
-    for _ in range(10):
-        makcu.move(5, 5)
-    end_time = time.perf_counter()
-    
-    move_only_ms = (end_time - start_time) * 1000
-    print(f"10 move commands: {move_only_ms:.2f}ms ({move_only_ms/10:.2f}ms per move)")
-
-def test_rapid_moves(makcu):
-    start = time.perf_counter_ns()
-    
-
-    makcu.move(5, 5)
-    makcu.move(5, 5)
-    makcu.move(5, 5)
-    makcu.move(5, 5)
-    makcu.move(5, 5)
-    makcu.move(5, 5)
-    makcu.move(5, 5)
-    makcu.move(5, 5)
-    makcu.move(5, 5)
-    makcu.move(5, 5)
-    
-    elapsed_ms = (time.perf_counter_ns() - start) / 1_000_000
-    print(f"10 rapid moves: {elapsed_ms:.2f}ms")
-    assert elapsed_ms < 30
-
-def test_button_performance(makcu):
-    start = time.perf_counter_ns()
-    
-
-    for button in TEST_BUTTONS:
-        makcu.press(button)
-        makcu.release(button)
-    
-    elapsed_ms = (time.perf_counter_ns() - start) / 1_000_000
-    print(f"Button operations: {elapsed_ms:.2f}ms")
-    assert elapsed_ms < 20
-
-def test_mixed_operations(makcu):
-    start = time.perf_counter_ns()
-    
-
-    makcu.move(20, 20)
-    makcu.press(MouseButton.LEFT)
-    makcu.move(-20, -20)
-    makcu.release(MouseButton.LEFT)
-    makcu.scroll(1)
-    
-    elapsed_ms = (time.perf_counter_ns() - start) / 1_000_000
-    print(f"Mixed operations: {elapsed_ms:.2f}ms")
-    assert elapsed_ms < 15
-
-
-@pytest.mark.skip(reason="Capture test disabled until firmware supports tracking clicks from software input")
-def test_capture_right_clicks(makcu):
+import pytest
+import time
+from makcu import MouseButton
+
+
+TEST_BUTTONS = (MouseButton.LEFT, MouseButton.RIGHT, MouseButton.MIDDLE)
+BUTTON_STATE_KEYS = ('left', 'right', 'middle', 'mouse4', 'mouse5')
+MOVE_COORDS = ((10, 0), (0, 10), (-10, 0), (0, -10))
+
+def test_connect_to_port(makcu):
+    print("Connecting to port...")
+    makcu.connect()
+    assert makcu.is_connected(), "Failed to connect to the makcu"
+
+def test_press_and_release(makcu):
+    makcu.press(MouseButton.LEFT)
+    makcu.release(MouseButton.LEFT)
+
+def test_firmware_version(makcu):
+    version = makcu.get_firmware_version()
+    assert version and len(version.strip()) > 0
+
+def test_middle_click(makcu):
+    makcu.press(MouseButton.MIDDLE)
+    makcu.release(MouseButton.MIDDLE)
+
+def test_device_info(makcu):
+    print("Fetching device info...")
+    info = makcu.mouse.get_device_info()
+    print(f"Device Info: {info}")
+    assert info.get("port")
+    assert info.get("isConnected") is True
+
+def test_port_connection(makcu):
+    assert makcu.is_connected()
+
+def test_button_mask(makcu):
+    print("Getting button mask...")
+    mask = makcu.get_button_mask()
+    print(f"Mask value: {mask}")
+    assert isinstance(mask, int)
+
+def test_get_button_states(makcu):
+    states = makcu.get_button_states()
+    assert isinstance(states, dict)
+    for key in BUTTON_STATE_KEYS:
+        assert key in states
+
+def test_lock_state(makcu):
+    print("Locking LEFT button...")
+    makcu.lock_left(True)
+    print("Querying lock state while LEFT is locked...")
+    state = makcu.is_locked(MouseButton.LEFT)
+    print(state)
+    assert state
+
+def test_makcu_behavior(makcu):
+    makcu.move(25, 25)
+    makcu.click(MouseButton.LEFT)
+    makcu.scroll(-2)
+
+def test_batch_commands(makcu):
+    print("Testing batch command execution (10 commands)...")
+    
+    start_time = time.perf_counter()
+
+    async def combo_actions():
+        await makcu.batch_execute([
+            lambda: makcu.move(5, 5),
+            lambda: makcu.click(MouseButton.LEFT),
+            lambda: makcu.scroll(-1)
+        ])
+
+    combo_actions()
+    
+    end_time = time.perf_counter()
+    elapsed_ms = (end_time - start_time) * 1000
+    
+    print(f"Batch execution time: {elapsed_ms:.2f}ms")
+    print(f"Average per command: {elapsed_ms/10:.2f}ms")
+    
+
+    assert elapsed_ms < 50, f"Batch commands took {elapsed_ms:.2f}ms, expected < 50ms"
+    
+
+    start_time = time.perf_counter()
+    for _ in range(10):
+        makcu.move(5, 5)
+    end_time = time.perf_counter()
+    
+    move_only_ms = (end_time - start_time) * 1000
+    print(f"10 move commands: {move_only_ms:.2f}ms ({move_only_ms/10:.2f}ms per move)")
+
+def test_rapid_moves(makcu):
+    start = time.perf_counter_ns()
+    
+
+    makcu.move(5, 5)
+    makcu.move(5, 5)
+    makcu.move(5, 5)
+    makcu.move(5, 5)
+    makcu.move(5, 5)
+    makcu.move(5, 5)
+    makcu.move(5, 5)
+    makcu.move(5, 5)
+    makcu.move(5, 5)
+    makcu.move(5, 5)
+    
+    elapsed_ms = (time.perf_counter_ns() - start) / 1_000_000
+    print(f"10 rapid moves: {elapsed_ms:.2f}ms")
+    assert elapsed_ms < 30
+
+def test_button_performance(makcu):
+    start = time.perf_counter_ns()
+    
+
+    for button in TEST_BUTTONS:
+        makcu.press(button)
+        makcu.release(button)
+    
+    elapsed_ms = (time.perf_counter_ns() - start) / 1_000_000
+    print(f"Button operations: {elapsed_ms:.2f}ms")
+    assert elapsed_ms < 20
+
+def test_mixed_operations(makcu):
+    start = time.perf_counter_ns()
+    
+
+    makcu.move(20, 20)
+    makcu.press(MouseButton.LEFT)
+    makcu.move(-20, -20)
+    makcu.release(MouseButton.LEFT)
+    makcu.scroll(1)
+    
+    elapsed_ms = (time.perf_counter_ns() - start) / 1_000_000
+    print(f"Mixed operations: {elapsed_ms:.2f}ms")
+    assert elapsed_ms < 15
+
+
+@pytest.mark.skip(reason="Capture test disabled until firmware supports tracking clicks from software input")
+def test_capture_right_clicks(makcu):
     pass

{makcu-2.1.2.dist-info → makcu-2.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: makcu
-Version: 2.1.2
+Version: 2.2.0
 Summary: Python library for Makcu hardware device control
 Author: SleepyTotem
 License:                     GNU GENERAL PUBLIC LICENSE
@@ -708,7 +708,7 @@ Requires-Dist: twine>=4.0
 Requires-Dist: rich>=14.0
 Dynamic: license-file
 
-# 🖱️ Makcu Python Library v2.1.2
+# 🖱️ Makcu Python Library v2.2.0
 
 [![PyPI Version](https://img.shields.io/pypi/v/makcu.svg)](https://pypi.org/project/makcu/)
 [![Python Support](https://img.shields.io/pypi/pyversions/makcu.svg)](https://pypi.org/project/makcu/)
@@ -716,16 +716,6 @@ Dynamic: license-file
 
 Makcu Py Lib is a high-performance Python library for controlling Makcu devices — now with **async/await support**, **zero-delay command execution**, and **automatic reconnection**!
 
-## What's New in v2.0
-
-- **Async/Await Support**: Full async API for modern Python applications
-- **Zero-Delay Commands**: Removed all `sleep()` calls with proper command tracking
-- **Auto-Reconnection**: Automatic device reconnection on disconnect
-- **Parallel Operations**: Execute multiple commands simultaneously
-- **Enhanced Debugging**: Better logging and error tracking
-- **Gaming-Optimized**: Sub-3ms command execution for 240Hz+ gaming
-- **Ultra-Fast Performance**: 10-50x faster than >=v1.4
-
 ---
 
 ## 📦 Installation
@@ -950,17 +940,6 @@ python -m makcu --runtest
 
 ---
 
-## ⚠️ Sync vs Async Limitations
-
-Some methods such as `lock()`, `unlock()`, and `click_human_like()` are currently only implemented in synchronous form. To use them in async workflows, run via thread executor:
-
-```python
-loop = asyncio.get_running_loop()
-await loop.run_in_executor(None, makcu.lock, MouseButton.LEFT)
-```
-
-> Note: `drag` and `get_all_lock_states` are supported only in the synchronous interface as of v2.0.
-
 ### Test Suite
 
 - File: `test_suite.py`
@@ -1027,9 +1006,6 @@ Based on the measured test suite, v2.0 is on average **~17× faster** than v1.3
 ### Tips for Maximum Performance
 
 ```python
-# Use gaming profile for fastest clicks
-makcu.click_human_like(MouseButton.LEFT, profile="gaming")
-
 # Disable debug mode in production
 makcu = create_controller(debug=False)
 
@@ -1126,11 +1102,9 @@ GPL License © SleepyTotem
 
 ---
 
-## 🙋 Support & Contributing
+## 🙋 Support
 
 - **Issues**: [GitHub Issues](https://github.com/SleepyTotem/makcu-py-lib/issues)
-- **Discussions**: [GitHub Discussions](https://github.com/SleepyTotem/makcu-py-lib/discussions)
-- **Pull Requests**: Welcome! Please read CONTRIBUTING.md
 
 ---
 

makcu-2.2.0.dist-info/RECORD

@@ -0,0 +1,17 @@
+makcu/README.md,sha256=FrZkK3T6m42s1D61WN8f7rVMWMbr9nPwMgQaXcYWKzQ,11125
+makcu/__init__.py,sha256=rfBNEd2V5vwfX4dHQzEowF3z0T6CoObYSsKculIgCnI,427
+makcu/__main__.py,sha256=WYf8QKcgMNHh0GP7szXZdnoeExT55Aokkflj-u1IaJc,14030
+makcu/conftest.py,sha256=BqPx6ywYONYGyKH11Bam9aV5zSGXR6odE5Z8hGFrn4U,863
+makcu/connection.py,sha256=LkvzPwT1Er9JblGR8pZRMLTTCBBd6a1F62X_FkLaXEg,20179
+makcu/controller.py,sha256=EBtiScaOU0CV7NmwVdR3CwFpbT5RymdrNveRKo5ehFU,13242
+makcu/enums.py,sha256=1SvIv5IoMIfXyoMAq8I5r_aKMVKjYR-L_hXkFLJ_5mw,119
+makcu/errors.py,sha256=hXdeUCHvbzfqWX3uotG12Xv8EPwWs-5aHQ12xpgwx3Y,229
+makcu/makcu.pyi,sha256=UfbX7774u_a9oyIa1rweWqIRoQxVAjhhHUuukDp3jiA,237
+makcu/mouse.py,sha256=YZQDA5OGQlCxCDu3Huzwp5bjH__9yb867iLSVTYOKP4,8157
+makcu/py.typed,sha256=lI_IPBO6A6a5eY5kRQDNsdSydUb3sFWtcC_ML8FNftU,111
+makcu/test_suite.py,sha256=VkEsloTX8ozprwDhWVJ5GFS5qeIxJxXz47xCcZKNIVY,3889
+makcu-2.2.0.dist-info/licenses/LICENSE,sha256=IwGE9guuL-ryRPEKi6wFPI_zOhg7zDZbTYuHbSt_SAk,35823
+makcu-2.2.0.dist-info/METADATA,sha256=_6_IPbDGcLgm5Xb0ES6dB2dpMDb_t99Ju7WvXqidYk0,53836
+makcu-2.2.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+makcu-2.2.0.dist-info/top_level.txt,sha256=IRO1UVb5LK_ovjau0g4oObyXQqy00tVEE-yF5lPgw1w,6
+makcu-2.2.0.dist-info/RECORD,,

makcu-2.1.2.dist-info/RECORD

@@ -1,16 +0,0 @@
-makcu/__init__.py,sha256=HyjxvhE5feNyh4ZMY5U0U_X-7BzltSh_gOsX_o5mSLA,1745
-makcu/__main__.py,sha256=9zqNog6Ugh1QjsZUOh7ZDTa1KwiOxLfDoOiBw2neiCo,14385
-makcu/conftest.py,sha256=9BAV65DARtS4rELiMI5Gb6I-shxdnzCBA4g1lOYjG5s,896
-makcu/connection.py,sha256=OT3cB7T8eJT4boCqajdPQtlTEMy-W9n9dqIIIVbL3Xc,15135
-makcu/controller.py,sha256=csQMJ97zSv-i6sI8EHkqosFByS859B-hg2unvjHPKcA,13059
-makcu/enums.py,sha256=VmvCLmpghVHuTAkvCGMfA14MgWTtFVMfsGQQNnJ58Ts,126
-makcu/errors.py,sha256=X_eWPKkVgcyryT6-_7jjVkcHKtrAZAsarbfMRpIcz58,242
-makcu/makcu.pyi,sha256=tSmJ3zs6zFClZll5DcWd17ZQr9nvDDJqhKXDR1hr7dk,247
-makcu/mouse.py,sha256=CzUI3vr_IrvYuEfGzDWgtm6wSUl9kYimvmHaR2azuL0,8406
-makcu/py.typed,sha256=lI_IPBO6A6a5eY5kRQDNsdSydUb3sFWtcC_ML8FNftU,111
-makcu/test_suite.py,sha256=7Rsq5sKeR4zvCMTNZDv6TCYMKs7B3EVTuwyIDgHfdk8,4092
-makcu-2.1.2.dist-info/licenses/LICENSE,sha256=IwGE9guuL-ryRPEKi6wFPI_zOhg7zDZbTYuHbSt_SAk,35823
-makcu-2.1.2.dist-info/METADATA,sha256=B_TaI8tz6CQi6ERMvtIbGxfokjjZY-Z5-hrJDCO8jps,55063
-makcu-2.1.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-makcu-2.1.2.dist-info/top_level.txt,sha256=IRO1UVb5LK_ovjau0g4oObyXQqy00tVEE-yF5lPgw1w,6
-makcu-2.1.2.dist-info/RECORD,,