wehub-resource-sync
91e75e620b
CI: cua-driver distro-compat matrix / debian:12 (glibc 2.36) (push) Has been cancelled
CI: SPDX Headers / Check SPDX headers (warn-only) (push) Has been cancelled
CD: Docs MCP Server / build (linux/amd64) (push) Has been cancelled
CD: Docs MCP Server / build (linux/arm64) (push) Has been cancelled
CD: Docs MCP Server / merge (push) Has been cancelled
CI: cua-driver distro-compat matrix / Resolve release version (push) Has been cancelled
CI: cua-driver distro-compat matrix / fedora:41 (glibc 2.40) (push) Has been cancelled
CI: cua-driver distro-compat matrix / rockylinux:9 (glibc 2.34) (push) Has been cancelled
CI: cua-driver distro-compat matrix / ubuntu:22.04 (glibc 2.35) (push) Has been cancelled
CI: cua-driver distro-compat matrix / ubuntu:24.04 (glibc 2.39) (push) Has been cancelled
CI: cua-driver distro-compat matrix / Distro compat summary (push) Has been cancelled
CI: Rust Linux unit / Rust Linux unit and compile (push) Has been cancelled
CI: Rust Windows unit / Rust Windows unit and compile (push) Has been cancelled
CI: Nix Linux Rust source / Nix / compositor build (push) Has been cancelled
CI: Nix Linux Rust source / Nix / driver package (push) Has been cancelled
CI: Nix Linux Rust source / Nix / Rust unit tests (push) Has been cancelled
63 lines
2.0 KiB
Markdown
63 lines
2.0 KiB
Markdown
# cua-auto
|
|
|
|
`cua-auto` is a lightweight, cross-platform automation library providing a synchronous, MIT-licensed pyautogui-style API for mouse, keyboard, screen, window, clipboard, and shell operations. It runs on Windows, macOS, and Linux using [pynput](https://github.com/moses-palmer/pynput) for input control and [pywinctl](https://github.com/Kalmat/PyWinCtl) for window management.
|
|
|
|
```python
|
|
import cua_auto.mouse as mouse
|
|
import cua_auto.keyboard as keyboard
|
|
import cua_auto.screen as screen
|
|
import cua_auto.window as window
|
|
import cua_auto.clipboard as clipboard
|
|
import cua_auto.shell as shell
|
|
|
|
# Mouse
|
|
mouse.click(100, 200) # left click
|
|
mouse.right_click(100, 200)
|
|
mouse.double_click(100, 200)
|
|
mouse.move_to(500, 300)
|
|
mouse.mouse_down(100, 200)
|
|
mouse.mouse_up(100, 200)
|
|
mouse.drag(100, 200, 400, 500) # start → end
|
|
mouse.scroll_up(3)
|
|
mouse.scroll_down(3)
|
|
x, y = mouse.position()
|
|
|
|
# Keyboard
|
|
keyboard.press_key("enter")
|
|
keyboard.type_text("hello world")
|
|
keyboard.hotkey(["ctrl", "c"])
|
|
keyboard.key_down("shift")
|
|
keyboard.key_up("shift")
|
|
|
|
# Screen
|
|
img = screen.screenshot() # returns PIL.Image
|
|
png = screen.screenshot_bytes() # raw PNG bytes
|
|
b64 = screen.screenshot_b64() # base64 string
|
|
w, h = screen.screen_size()
|
|
x, y = screen.cursor_position()
|
|
|
|
# Window
|
|
title = window.get_active_window_title()
|
|
handle = window.get_active_window_handle()
|
|
handles = window.get_windows_with_title("Chrome")
|
|
name = window.get_window_name(handle)
|
|
x, y = window.get_window_position(handle)
|
|
w, h = window.get_window_size(handle)
|
|
window.activate_window(handle)
|
|
window.minimize_window(handle)
|
|
window.maximize_window(handle)
|
|
window.close_window(handle)
|
|
window.set_window_size(handle, 1280, 800)
|
|
window.set_window_position(handle, 0, 0)
|
|
window.open("https://example.com") # or file path
|
|
pid = window.launch("notepad.exe")
|
|
|
|
# Clipboard
|
|
text = clipboard.get()
|
|
clipboard.set("hello")
|
|
|
|
# Shell
|
|
result = shell.run("echo hi") # CommandResult
|
|
print(result.stdout, result.returncode)
|
|
```
|