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

makcu-0.2.0.dist-info/RECORD

@@ -0,0 +1,16 @@
+makcu/__init__.py,sha256=_uWl1sH4M9_NFKUPZAeq3A9np-6nZwSUOX_hJVv9Wck,2111
+makcu/__main__.py,sha256=kJu5wuuMrHxTcESUEEGxuDHcd71RdRygDSoydxfW9ug,12063
+makcu/conftest.py,sha256=OsGIlt593H8AzY5BhCHHW8BmjD1yc1z2wqvyZvFiUdk,936
+makcu/connection.py,sha256=57VerGwpGZVhuLlAgs2HAHl1RHI9hGa8OBImv2GmDr8,18331
+makcu/controller.py,sha256=LeRxbPT69_rrS7C8moNXKy9AdCGq0Le9exM2g-Y3jmU,15758
+makcu/enums.py,sha256=VmvCLmpghVHuTAkvCGMfA14MgWTtFVMfsGQQNnJ58Ts,126
+makcu/errors.py,sha256=4CkQ4gKa7GL5-BO3yOAJMMsy3QlUDDL42S1P1clqV4A,562
+makcu/makcu.pyi,sha256=a8_vQ43MAqVxcASQiCHoYYG_LkfM5NEBAab5dgxcVK4,424
+makcu/mouse.py,sha256=pdHU4oqfmD1OzQLBbcIvJt9U9fLVQMYUBJKip_N8vPw,10083
+makcu/py.typed,sha256=lI_IPBO6A6a5eY5kRQDNsdSydUb3sFWtcC_ML8FNftU,111
+makcu/test_suite.py,sha256=cUhmP3_wniANiV1B5xGu7n3WHaBj3zsQBxcOW5LPRtY,5105
+makcu-0.2.0.dist-info/licenses/LICENSE,sha256=IwGE9guuL-ryRPEKi6wFPI_zOhg7zDZbTYuHbSt_SAk,35823
+makcu-0.2.0.dist-info/METADATA,sha256=msDAfKdpsWtJO-WqPxg87GZds2Rgjct7wE0AkI_2dQg,55161
+makcu-0.2.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+makcu-0.2.0.dist-info/top_level.txt,sha256=IRO1UVb5LK_ovjau0g4oObyXQqy00tVEE-yF5lPgw1w,6
+makcu-0.2.0.dist-info/RECORD,,

makcu-0.1.3.dist-info/METADATA

@@ -1,310 +0,0 @@
-Metadata-Version: 2.4
-Name: makcu
-Version: 0.1.3
-Summary: Python library to interact with Makcu devices.
-Author: SleepyTotem
-License: GPL
-Project-URL: Homepage, https://github.com/SleepyTotem/makcu-py-lib
-Requires-Python: >=3.7
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Dynamic: license-file
-
-# 🖱️ Makcu Python Library
-
-Makcu Py Lib is a Python library for controlling Makcu devices — enabling software-driven mouse input, movement simulation, locking, monitoring, and more.
-
----
-
-## 📦 Installation
-
-### ✅ Recommended: PyPI
-
-```bash
-pip install makcu
-```
-
-### 🧪 Alternative: Install from Source
-
-```bash
-git clone https://github.com/SleepyTotem/makcu-py-lib
-cd makcu-py-lib
-pip install .
-```
-
----
-
-## 🚀 Command-Line Usage
-
-After installation, use:
-
-```bash
-python -m makcu [command]
-```
-
-### Available Commands
-
-| Command | Description |
-|---------|-------------|
-| `--debug` | Opens interactive console to send raw `km.*` commands |
-| `--testPort COM3` | Tests a specific COM port for connectivity |
-| `--runtest` | Runs all automated tests and opens a test report |
-
-### Examples
-
-```bash
-python -m makcu --debug
-python -m makcu --testPort COM3
-python -m makcu --runtest
-```
-
----
-
-## 🧠 Quickstart (Python)
-
-```python
-from makcu import create_controller, MouseButton
-
-makcu = create_controller("COM1") # Fallback port
-makcu.click(MouseButton.LEFT)
-makcu.move(100, 50)
-makcu.scroll(-1)
-makcu.disconnect()
-```
-
----
-
-## 🧩 API Reference
-
-### 🔧 Initialization
-
-```python
-makcu = create_controller(debug=True, send_init=True)
-```
-
-#### Set fallback port manually
-
-```python
-makcu = create_controller("COM4")  # Optional fallback com port
-```
-
----
-
-### 🎮 Mouse Control
-
-#### Clicks
-
-```python
-makcu.click(MouseButton.LEFT)
-makcu.press(MouseButton.RIGHT)
-makcu.release(MouseButton.RIGHT)
-```
-
-#### Movement
-
-```python
-makcu.move(dx=30, dy=20)
-makcu.move_smooth(100, 40, segments=10)
-makcu.move_bezier(50, 50, 15, ctrl_x=25, ctrl_y=25)
-```
-
-#### Scrolling
-
-```python
-makcu.scroll(-3)  # Scroll down
-makcu.scroll(3)   # Scroll up
-```
-
----
-
-### 🔒 Locking and Unlocking
-
-```python
-makcu.lock_left(True)
-makcu.lock_right(True)
-makcu.lock_middle(False)
-makcu.lock_side1(True)
-makcu.lock_side2(False)
-makcu.lock_mouse_x(True)
-makcu.lock_mouse_y(False)
-```
-
-#### Lock Status
-
-```python
-makcu.is_button_locked(MouseButton.LEFT)
-makcu.get_all_lock_states()
-```
-
----
-
-### 👤 Human-like Click Simulation
-
-```python
-makcu.click_human_like(
-    button=MouseButton.LEFT,
-    count=5,
-    profile="normal",  # "fast", "slow" also available
-    jitter=3
-)
-```
-
----
-
-### 🔍 Device Info & Firmware
-
-```python
-info = makcu.get_device_info()
-print(info)
-
-version = makcu.get_firmware_version()
-print(version)
-```
-
----
-
-### 🔐 Serial Spoofing
-
-```python
-makcu.spoof_serial("FAKE123456")
-makcu.reset_serial()
-```
-
----
-
-## 🧪 Button Monitoring & Capture
-
-### Enable Real-time Monitoring
-
-```python
-makcu.enable_button_monitoring(True)
-```
-
-### Set Callback Function
-
-```python
-def on_button_event(button, pressed):
-    print(f"{button.name} is {'pressed' if pressed else 'released'}")
-
-makcu.set_button_callback(on_button_event)
-```
-
----
-
-## ❌ Click Capturing (Pending Firmware Update)
-
-Click capturing will allow you to detect and count click events in software.
-
-```python
-makcu.mouse.lock_right(True)
-makcu.capture(MouseButton.RIGHT)
-
-# User clicks however many times
-
-makcu.mouse.lock_right(False)
-count = makcu.get_captured_clicks(MouseButton.RIGHT)
-print(f"Captured clicks: {count}")
-```
-
-> ⚠️ This feature is currently broken in firmware. Do not rely on it yet.
-
----
-
-## 🔢 Bitmask & Button States
-
-### Get Bitmask of Active Buttons
-
-```python
-mask = makcu.get_button_mask()
-print(f"Button mask: {mask}")
-```
-
-### Get Raw Button State Map
-
-```python
-states = makcu.get_button_states()
-print(states)  # {'left': False, 'right': True, ...}
-```
-
-### Check if a Specific Button Is Pressed
-
-```python
-if makcu.is_button_pressed(MouseButton.RIGHT):
-    print("Right button is pressed")
-```
-
----
-
-## ⚙️ Low-Level Command Access
-
-### Send raw serial commands
-
-```python
-from makcu import create_controller
-makcu = create_controller()
-response = makcu.transport.send_command("km.version()", expect_response=True)
-print(response)
-```
-
----
-
-## 🧪 Test Suite
-
-Run all tests and generate HTML report:
-
-```bash
-python -m makcu --runtest
-```
-
----
-
-## 📚 Enumerations
-
-```python
-from makcu import MouseButton
-
-MouseButton.LEFT
-MouseButton.RIGHT
-MouseButton.MIDDLE
-MouseButton.MOUSE4
-MouseButton.MOUSE5
-```
-
----
-
-## 🧯 Exception Handling
-
-```python
-from makcu import MakcuError, MakcuConnectionError
-
-try:
-    makcu = create_controller()
-except MakcuConnectionError as e:
-    print("Connection failed:", e)
-```
-
----
-
-## 🛠️ Developer Notes
-
-- Uses CH343 USB Serial
-- Auto-connects to correct port or fallback
-- Supports baud rate switching to 4M
-- Automatically enables `km.buttons(1)` monitoring if `send_init=True`
-- Supports raw button state polling
-
----
-
-## 📜 License
-
-GPL License © SleepyTotem
-
----
-
-## Support
-Please open an issue on the project repository and I will get to it asap
-
-## 🌐 Links
-
-- 🔗 [Project Homepage](https://github.com/SleepyTotem/makcu-py-lib)
-- 🔗 [PyPI Homepage](https://pypi.org/project/makcu/)

makcu-0.1.3.dist-info/RECORD

@@ -1,14 +0,0 @@
-makcu/__init__.py,sha256=hCP6COi14T4C0V35crnbBEzJPa9hnwGb-gDPoxs_H6E,459
-makcu/__main__.py,sha256=wjRtr7V6qd54w43lHmXQldlVffKMW27nkhKa4E5B9t8,2830
-makcu/conftest.py,sha256=TQibb01_1OfzDrDU5u3IDlrfehXyr7E7jx3g0VySZmU,560
-makcu/connection.py,sha256=QObUZ-iNH-LaC7hamgXDH5p2wH_VfJ6OEAv5qJ1RwVE,10208
-makcu/controller.py,sha256=u2BeScKqQI19nSXQzRZqNL9rIj7_AyGDRcawdHvQtxM,5776
-makcu/enums.py,sha256=VmvCLmpghVHuTAkvCGMfA14MgWTtFVMfsGQQNnJ58Ts,126
-makcu/errors.py,sha256=4CkQ4gKa7GL5-BO3yOAJMMsy3QlUDDL42S1P1clqV4A,562
-makcu/mouse.py,sha256=vvJ88r9tOLaGT6evHHx_K45wwTa_bxc9c0S6wj7gX6o,4686
-makcu/test_suite.py,sha256=kmsLRv00mWLu3cUW5iAWL3QAhdqOL-rUwAWn6Rs1_ME,3104
-makcu-0.1.3.dist-info/licenses/LICENSE,sha256=IwGE9guuL-ryRPEKi6wFPI_zOhg7zDZbTYuHbSt_SAk,35823
-makcu-0.1.3.dist-info/METADATA,sha256=hIYmeM8Qd9IWNCEfE_tbZ4DHqe-ttU9uvE8247ih2w0,5588
-makcu-0.1.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-makcu-0.1.3.dist-info/top_level.txt,sha256=IRO1UVb5LK_ovjau0g4oObyXQqy00tVEE-yF5lPgw1w,6
-makcu-0.1.3.dist-info/RECORD,,