chore: import upstream snapshot with attribution

2026-07-13 13:03:19 +08:00
commit 91e75e620b
3227 changed files with 1307078 additions and 0 deletions
@@ -0,0 +1,62 @@
+# 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)
+```