makcu 0.1.4__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.4.dist-info/METADATA

@@ -1,274 +0,0 @@
-Metadata-Version: 2.4
-Name: makcu
-Version: 0.1.4
-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 |
-
----
-
-## 🧠 Quickstart (Python)
-
-```python
-from makcu import create_controller, MouseButton
-
-makcu = create_controller("COM1")
-makcu.click(MouseButton.LEFT)
-makcu.move(100, 50)
-makcu.scroll(-1)
-makcu.disconnect()
-```
-
----
-
-## 🧩 API Reference
-
-### 🔧 Initialization
-
-```python
-makcu = create_controller(fallback_com_port="COM1", debug=True, send_init=True)
-```
-
----
-
-### 🎮 Mouse Control
-
-#### Button Actions
-
-```python
-makcu.click(MouseButton.LEFT)
-makcu.press(MouseButton.RIGHT)
-makcu.release(MouseButton.RIGHT)
-```
-
-#### Movement
-
-```python
-makcu.move(30, 20)
-makcu.move_smooth(100, 40, segments=10)
-makcu.move_bezier(50, 50, 15, ctrl_x=25, ctrl_y=25)
-```
-
-#### Scroll Wheel
-
-```python
-makcu.scroll(-3)
-makcu.scroll(3)
-```
-
----
-
-### 🔒 Locking
-
-```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 State Query
-
-```python
-makcu.is_locked(MouseButton.LEFT)
-makcu.get_all_lock_states()
-```
-
----
-
-### 👤 Human-like Click Simulation
-
-```python
-makcu.click_human_like(
-    button=MouseButton.LEFT,
-    count=5,
-    profile="normal",  # or "fast", "slow"
-    jitter=3
-)
-```
-
----
-
-### 🔍 Device Info & Firmware
-
-```python
-info = makcu.get_device_info()
-version = makcu.get_firmware_version()
-```
-
----
-
-### 🔐 Serial Spoofing
-
-```python
-makcu.spoof_serial("FAKE123456")
-makcu.reset_serial()
-```
-
----
-
-## 🧪 Button Monitoring
-
-### Enable Monitoring
-
-```python
-makcu.enable_button_monitoring(True)
-```
-
-### Set Event Callback
-
-```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 Fix)
-
-```python
-makcu.mouse.lock_right(True)
-makcu.mouse.begin_capture("RIGHT")
-
-# Simulated user input...
-
-makcu.mouse.lock_right(False)
-count = makcu.mouse.stop_capturing_clicks("RIGHT")
-print(f"Captured clicks: {count}")
-```
-
-> ⚠️ Not fully supported yet — firmware must be updated to complete this feature.
-
----
-
-## 🔢 Bitmask & Button States
-
-```python
-mask = makcu.get_button_mask()
-states = makcu.get_button_states()
-
-if makcu.is_pressed(MouseButton.RIGHT):
-    print("Right button is currently pressed")
-```
-
----
-
-## ⚙️ Low-Level Access
-
-```python
-response = makcu.transport.send_command("km.version()", expect_response=True)
-```
-
----
-
-## 🧪 Test Suite
-
-Run full test suite and generate an 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
-
-- Communicates via CH343 USB serial
-- Automatically finds correct port or uses fallback
-- Switches baud to 4M after initial connect
-- Enables `km.buttons(1)` on init if requested
-- Supports full button state tracking with events
-
----
-
-## 📜 License
-
-GPL License © SleepyTotem
-
----
-
-## 🙋 Support
-
-Open an issue on GitHub if you encounter bugs or need help.
-
-## 🌐 Links
-
-- [GitHub Repo](https://github.com/SleepyTotem/makcu-py-lib)
-- [PyPI Package](https://pypi.org/project/makcu/)

makcu-0.1.4.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=NDo8cmAnsu_-Njc-CacLFTKXkALvSc7E2BXYOY5aljg,12030
-makcu/controller.py,sha256=wBrGlO_mivd7YFRQJ84BVXGIuu3G7ChRos9fucTYWzM,5115
-makcu/enums.py,sha256=VmvCLmpghVHuTAkvCGMfA14MgWTtFVMfsGQQNnJ58Ts,126
-makcu/errors.py,sha256=4CkQ4gKa7GL5-BO3yOAJMMsy3QlUDDL42S1P1clqV4A,562
-makcu/mouse.py,sha256=PkBowk--SSHo13gRwK3jnORSQVQV1YeIF4NWE_Cm4KU,6388
-makcu/test_suite.py,sha256=qHYklwhVCeZbpndlwUrSGnd2a5wQtJwefjlo_ZWXD-Y,2661
-makcu-0.1.4.dist-info/licenses/LICENSE,sha256=IwGE9guuL-ryRPEKi6wFPI_zOhg7zDZbTYuHbSt_SAk,35823
-makcu-0.1.4.dist-info/METADATA,sha256=tZCMI-5J3s4Sp_zAVlrvKiLbGCcFGDCbRkDzzlilQWs,4828
-makcu-0.1.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-makcu-0.1.4.dist-info/top_level.txt,sha256=IRO1UVb5LK_ovjau0g4oObyXQqy00tVEE-yF5lPgw1w,6
-makcu-0.1.4.dist-info/RECORD,,