autoxkit 0.2.1

Python library for automating Windows

autoxkit

一个轻量级的 Windows 自动化库，支持鼠标与键盘操作模拟、全局钩子监听、事件回调机制等功能。适用于自动化脚本、软件测试、人机交互等多种场景。

---

✨ 功能特色

• ✅ 全局鼠标和键盘钩子监听
• ✅ 支持鼠标点击、移动、滚轮等操作
• ✅ 支持按键按下、释放、文本输入等模拟
• ✅ 简洁的事件回调机制，便于集成和扩展
• ✅ 完全基于 Python 实现，易于上手和二次开发

---

📦 安装方式

从 PyPI 安装：

pip install autoxkit

或下载源码后本地安装：

pip install .

---

🔧 使用示例

import time
from autoxkit.mousekey import HookListener, KeyEvent, MouseEvent

def key_down(event: KeyEvent):
    print('keydown', event.key_name)

def key_up(event: KeyEvent):
    print('keyup', event.key_name)

def mouse_down(event: MouseEvent):
    print('mousedown', event.button, event.position)

def mouse_up(event: MouseEvent):
    print('mouseup', event.button, event.position)


hook_listener = HookListener()
hook_listener.add_handler('keydown', key_down)
hook_listener.add_handler('keyup', key_up)
hook_listener.add_handler('mousedown', mouse_down)
hook_listener.add_handler('mouseup', mouse_up)
hook_listener.start()

if __name__ == '__main__':
    print("当前鼠标位置:", hook_listener.get_mouse_position())
    print("HookListener 正在运行... 按 Ctrl+C 退出")

    try:
        while True:
            time.sleep(1)
    except Exception:
        hook_listener.stop()

更多示例请参考：examples

---

📁 GitHub 项目地址

👉 https://github.com/YorickFin/autoxkit

---

📃 License

本项目基于 GPL-3.0 许可证开源，欢迎使用与二次开发。