pyautogui-zzy 0.9.54__tar.gz

pyautogui_zzy-0.9.54/CHANGELOG.md

@@ -0,0 +1,42 @@
+# Changelog
+
+## [0.9.54] — unreleased
+
+First release published under the `pyautogui-zzy` distribution name. The code
+is the same Rust/CUDA-accelerated fork of PyAutoGUI 0.9.54 that was previously
+published as `pyautogui-rust 0.9.54.1`, plus the packaging fixes below.
+
+### Changed
+
+- Distribution renamed from `PyAutoGUI` to `pyautogui-zzy`, and the import
+  package from `pyautogui` to `pyautogui_zzy`. The wheel no longer installs a
+  top-level `pyautogui` module, so it can no longer overwrite or be overwritten
+  by the upstream PyAutoGUI distribution.
+- The console script is now `pyautogui-zzy` and the entry point is
+  `pyautogui_zzy._cli:main`.
+- Rust crate renamed to `pyautogui_zzy_rust`; `rust-version = "1.88"` is now
+  declared because `slice::as_chunks` is used.
+- `slice::chunks_exact` replaced with `slice::as_chunks` in `src/vision.rs` and
+  `src/tinylocate.rs` (`clippy::chunks_exact_to_as_chunks`).
+- Project authorship metadata now names the fork maintainer. Upstream
+  attribution moved to `NOTICE`, which is shipped alongside `LICENSE.txt`.
+
+### Fixed
+
+- The `pyautogui -gui` console entry point imported `._gui`, a module that was
+  never included in any wheel, so it raised `ImportError` on every install. The
+  switch is removed until a GUI is actually packaged.
+- Removed stale `PKG-INFO` and `PyAutoGUI.egg-info/` build residue from the
+  source tree.
+- Removed the Sphinx `automodule` reference to the non-existent
+  `pyautogui.keynames` submodule.
+
+### Removed
+
+- The `-gui` console switch (see above).
+
+## [0.9.54] — 2026-07-15
+
+Snapshot of the Rust/CUDA-accelerated fork of PyAutoGUI 0.9.54 by Al Sweigart:
+Win32 `SendInput` batching, DPI-aware GDI capture, parallel hierarchical
+template matching, and the external TinyLocate neural locator.

pyautogui_zzy-0.9.54/Cargo.lock

@@ -0,0 +1,370 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "autocfg"
+version = "1.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f2032f911046de80f0a198e0901378627c33f59ea0ac00e363d481118bd70a53"
+
+[[package]]
+name = "cfg-if"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
+
+[[package]]
+name = "crossbeam-deque"
+version = "0.8.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5181e0de7b61eb03a81e347d6dd8797bae9da5146707b51077e2d71a54ec0ceb"
+dependencies = [
+ "crossbeam-epoch",
+ "crossbeam-utils",
+]
+
+[[package]]
+name = "crossbeam-epoch"
+version = "0.9.20"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2d6914041f254d6e9176c01941b21115dcfb7089e55135a35411081bd106ef3f"
+dependencies = [
+ "crossbeam-utils",
+]
+
+[[package]]
+name = "crossbeam-utils"
+version = "0.8.22"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "61803da095bee82a81bb1a452ecc25d3b2f1416d1897eb86430c6159ef717c17"
+
+[[package]]
+name = "crunchy"
+version = "0.2.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "460fbee9c2c2f33933d720630a6a0bac33ba7053db5344fac858d4b8952d77d5"
+
+[[package]]
+name = "cudarc"
+version = "0.19.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "42310153e06cf4cd532901f7096beb27504d681736a29ee90728ae4e2d93b2a8"
+dependencies = [
+ "libloading",
+]
+
+[[package]]
+name = "either"
+version = "1.16.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "91622ff5e7162018101f2fea40d6ebf4a78bbe5a49736a2020649edf9693679e"
+
+[[package]]
+name = "half"
+version = "2.7.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6ea2d84b969582b4b1864a92dc5d27cd2b77b622a8d79306834f1be5ba20d84b"
+dependencies = [
+ "cfg-if",
+ "crunchy",
+ "zerocopy",
+]
+
+[[package]]
+name = "heck"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
+
+[[package]]
+name = "indoc"
+version = "2.0.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "79cf5c93f93228cf8efb3ba362535fb11199ac548a09ce117c9b1adc3030d706"
+dependencies = [
+ "rustversion",
+]
+
+[[package]]
+name = "libc"
+version = "0.2.186"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "68ab91017fe16c622486840e4c83c9a37afeff978bd239b5293d61ece587de66"
+
+[[package]]
+name = "libloading"
+version = "0.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "754ca22de805bb5744484a5b151a9e1a8e837d5dc232c2d7d8c2e3492edc8b60"
+dependencies = [
+ "cfg-if",
+ "windows-link",
+]
+
+[[package]]
+name = "memoffset"
+version = "0.9.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "488016bfae457b036d996092f6cb448677611ce4449e970ceaf42695203f218a"
+dependencies = [
+ "autocfg",
+]
+
+[[package]]
+name = "once_cell"
+version = "1.21.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
+
+[[package]]
+name = "portable-atomic"
+version = "1.13.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c33a9471896f1c69cecef8d20cbe2f7accd12527ce60845ff44c153bb2a21b49"
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.106"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8fd00f0bb2e90d81d1044c2b32617f68fcb9fa3bb7640c23e9c748e53fb30934"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "pyautogui_zzy_rust"
+version = "0.9.54"
+dependencies = [
+ "cudarc",
+ "half",
+ "pyo3",
+ "rayon",
+ "windows-sys",
+]
+
+[[package]]
+name = "pyo3"
+version = "0.23.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7778bffd85cf38175ac1f545509665d0b9b92a198ca7941f131f85f7a4f9a872"
+dependencies = [
+ "cfg-if",
+ "indoc",
+ "libc",
+ "memoffset",
+ "once_cell",
+ "portable-atomic",
+ "pyo3-build-config",
+ "pyo3-ffi",
+ "pyo3-macros",
+ "unindent",
+]
+
+[[package]]
+name = "pyo3-build-config"
+version = "0.23.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "94f6cbe86ef3bf18998d9df6e0f3fc1050a8c5efa409bf712e661a4366e010fb"
+dependencies = [
+ "once_cell",
+ "target-lexicon",
+]
+
+[[package]]
+name = "pyo3-ffi"
+version = "0.23.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e9f1b4c431c0bb1c8fb0a338709859eed0d030ff6daa34368d3b152a63dfdd8d"
+dependencies = [
+ "libc",
+ "pyo3-build-config",
+]
+
+[[package]]
+name = "pyo3-macros"
+version = "0.23.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fbc2201328f63c4710f68abdf653c89d8dbc2858b88c5d88b0ff38a75288a9da"
+dependencies = [
+ "proc-macro2",
+ "pyo3-macros-backend",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "pyo3-macros-backend"
+version = "0.23.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fca6726ad0f3da9c9de093d6f116a93c1a38e417ed73bf138472cf4064f72028"
+dependencies = [
+ "heck",
+ "proc-macro2",
+ "pyo3-build-config",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.45"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "41f2619966050689382d2b44f664f4bc593e129785a36d6ee376ddf37259b924"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "rayon"
+version = "1.12.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fb39b166781f92d482534ef4b4b1b2568f42613b53e5b6c160e24cfbfa30926d"
+dependencies = [
+ "either",
+ "rayon-core",
+]
+
+[[package]]
+name = "rayon-core"
+version = "1.13.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "22e18b0f0062d30d4230b2e85ff77fdfe4326feb054b9783a3460d8435c8ab91"
+dependencies = [
+ "crossbeam-deque",
+ "crossbeam-utils",
+]
+
+[[package]]
+name = "rustversion"
+version = "1.0.22"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b39cdef0fa800fc44525c84ccb54a029961a8215f9619753635a9c0d2538d46d"
+
+[[package]]
+name = "syn"
+version = "2.0.117"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e665b8803e7b1d2a727f4023456bbbbe74da67099c585258af0ad9c5013b9b99"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "target-lexicon"
+version = "0.12.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "61c41af27dd6d1e27b1b16b489db798443478cef1f06a660c96db617ba5de3b1"
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.24"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"
+
+[[package]]
+name = "unindent"
+version = "0.2.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7264e107f553ccae879d21fbea1d6724ac785e8c3bfc762137959b5802826ef3"
+
+[[package]]
+name = "windows-link"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5"
+
+[[package]]
+name = "windows-sys"
+version = "0.52.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "282be5f36a8ce781fad8c8ae18fa3f9beff57ec1b52cb3de0789201425d9a33d"
+dependencies = [
+ "windows-targets",
+]
+
+[[package]]
+name = "windows-targets"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9b724f72796e036ab90c1021d4780d4d3d648aca59e491e6b98e725b84e99973"
+dependencies = [
+ "windows_aarch64_gnullvm",
+ "windows_aarch64_msvc",
+ "windows_i686_gnu",
+ "windows_i686_gnullvm",
+ "windows_i686_msvc",
+ "windows_x86_64_gnu",
+ "windows_x86_64_gnullvm",
+ "windows_x86_64_msvc",
+]
+
+[[package]]
+name = "windows_aarch64_gnullvm"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "32a4622180e7a0ec044bb555404c800bc9fd9ec262ec147edd5989ccd0c02cd3"
+
+[[package]]
+name = "windows_aarch64_msvc"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "09ec2a7bb152e2252b53fa7803150007879548bc709c039df7627cabbd05d469"
+
+[[package]]
+name = "windows_i686_gnu"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8e9b5ad5ab802e97eb8e295ac6720e509ee4c243f69d781394014ebfe8bbfa0b"
+
+[[package]]
+name = "windows_i686_gnullvm"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0eee52d38c090b3caa76c563b86c3a4bd71ef1a819287c19d586d7334ae8ed66"
+
+[[package]]
+name = "windows_i686_msvc"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "240948bc05c5e7c6dabba28bf89d89ffce3e303022809e73deaefe4f6ec56c66"
+
+[[package]]
+name = "windows_x86_64_gnu"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "147a5c80aabfbf0c7d901cb5895d1de30ef2907eb21fbbab29ca94c5b08b1a78"
+
+[[package]]
+name = "windows_x86_64_gnullvm"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "24d5b23dc417412679681396f2b49f3de8c1473deb516bd34410872eff51ed0d"
+
+[[package]]
+name = "windows_x86_64_msvc"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "589f6da84c646204747d1270a2a5661ea66ed1cced2631d546fdfb155959f9ec"
+
+[[package]]
+name = "zerocopy"
+version = "0.8.54"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b7cbbc0a705a0fd05cc3676525980d2bf5a9bc4adac6d6475209a7887cf59d19"
+dependencies = [
+ "zerocopy-derive",
+]
+
+[[package]]
+name = "zerocopy-derive"
+version = "0.8.54"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e2e817b7b52d0c7358d3246da9d69935ebb18116b2b102b4230dac079b4862f5"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]

pyautogui_zzy-0.9.54/Cargo.toml

@@ -0,0 +1,30 @@
+[package]
+name = "pyautogui_zzy_rust"
+version = "0.9.54"
+edition = "2021"
+rust-version = "1.88"
+
+[lib]
+name = "_rust_core"
+crate-type = ["cdylib", "rlib"]
+
+[dependencies]
+pyo3 = { version = "0.23", features = ["extension-module", "abi3-py37"] }
+rayon = "1.10"
+half = "2.6"
+
+[target.'cfg(target_os = "windows")'.dependencies]
+cudarc = { version = "0.19.8", default-features = false, features = ["std", "driver", "nvrtc", "fallback-dynamic-loading", "cuda-13000"] }
+windows-sys = { version = "0.52", features = [
+    "Win32_UI_WindowsAndMessaging",
+    "Win32_UI_Input_KeyboardAndMouse",
+    "Win32_Foundation",
+    "Win32_System_SystemInformation",
+    "Win32_UI_HiDpi",
+    "Win32_Graphics_Gdi",
+] }
+
+[profile.release]
+opt-level = 3
+lto = "thin"
+codegen-units = 1

pyautogui_zzy-0.9.54/DEVELOPING.md

@@ -0,0 +1,112 @@
+# 开发与发布
+
+本项目的首要兼容目标是：现有 PyAutoGUI 调用代码无需修改。Rust 快速路径属于内部实现，失败时由 Python/Win32 兼容层处理。
+
+## API 兼容规则
+
+- 保留既有公共函数、常量和别名，例如 `move`/`moveRel`、`write`/`typewrite`。
+- 保留原参数名称、位置参数顺序与默认行为；新增能力使用可选关键字或独立对象。
+- Python 层继续负责参数规范化、暂停、failsafe 和跨平台语义。
+- Rust 优化不得要求调用方导入 `_rust_core`。
+- 每次修改公共函数前更新 `tests/unit/test_api_contract.py`，先证明旧调用仍可绑定。
+
+## 环境准备
+
+Windows 建议使用 PowerShell 7、Python 3.12、稳定版 Rust、MSVC Build Tools 和 Windows SDK：
+
+```powershell
+python -m venv .venv
+.\.venv\Scripts\Activate.ps1
+python -m pip install --upgrade pip
+python -m pip install -e ".[dev,benchmark]"
+```
+
+需要对 OpenCV/MSS 图像路径做性能测试时，再安装可选依赖：
+
+```powershell
+python -m pip install -e ".[dev,benchmark,vision]"
+```
+
+## 无副作用测试
+
+默认测试目录是 `tests/unit`。`conftest.py` 会在导入 PyAutoGUI 前注入原生模块替身，再将平台适配器换成内存后端。因此测试期间不会移动鼠标、发送按键、滚轮输入、调整系统计时器或安装鼠标钩子。
+
+```powershell
+python -m pytest
+python -m pytest --cov=pyautogui_zzy --cov-report=term-missing
+python -m pytest tests/unit/test_windows_backend_fallback.py
+```
+
+`tests/unit/test_windows_backend_fallback.py` 模拟 User32 失败分支，只读取内存替身状态，不发送输入。上游遗留的 `tests/test_pyautogui.py` 和 `tests/test_automateboringstuff.py` 包含交互式及真实桌面操作，只用于人工兼容检查，不在默认收集范围。
+
+完整本地门禁：
+
+```powershell
+python tools/check.py
+```
+
+只检查一侧：
+
+```powershell
+python tools/check.py --python-only
+python tools/check.py --rust-only
+```
+
+## Rust 检查
+
+```powershell
+cargo fmt --all -- --check
+cargo test --locked --all-targets
+cargo clippy --locked --all-targets -- -D warnings
+```
+
+Rust 单元测试应优先覆盖纯算法、坐标换算、输入批次编译和错误分支；系统 API 集成测试必须避免真实输入，并单独标记。
+
+## 性能基准
+
+```powershell
+python -m pytest benchmarks --benchmark-only
+```
+
+参见 `benchmarks/README.md`。提交性能结论时记录 CPU、Windows 版本、Python/Rust 版本、电源计划、构建类型和样本 JSON。默认对比中位数，超过 10% 的变化需复核。
+
+只读的实际桌面截图与找图基准：
+
+```powershell
+python tools/benchmark_native.py --iterations 30 --json .benchmarks/native.json
+```
+
+该工具只读取桌面像素，不发送键鼠事件。执行时应使用 Release Wheel 或 Release 扩展。
+
+## 构建与校验
+
+```powershell
+Remove-Item -Recurse -Force build, dist -ErrorAction SilentlyContinue
+python -m build
+python tools/verify_dist.py dist
+```
+
+也可以执行整套流程：
+
+```powershell
+python tools/check.py --build
+```
+
+Windows wheel 使用 CPython 3.7 ABI3 标签，可由受支持的较新 CPython 复用。发布前还应在源码目录之外安装 wheel 并运行只读冒烟测试：
+
+```powershell
+$wheel = (Get-ChildItem dist\*.whl).FullName
+python -m pip install --force-reinstall --no-deps $wheel
+Push-Location $env:TEMP
+python C:\path\to\project\tools\smoke_installed.py
+Pop-Location
+```
+
+## 发布清单
+
+1. 工作树干净，`Cargo.lock` 已提交。
+2. `python tools/check.py --build` 全部通过。
+3. wheel 名称包含 `cp37-abi3`，且只包含一个 `_rust_core` 原生扩展。
+4. sdist 包含 Rust 源码、Cargo 锁文件、许可证和构建配置，不包含 `target/`。
+5. 在源码目录外执行 `tools/smoke_installed.py`。
+6. 记录基准结果并检查主要 API 契约。

pyautogui_zzy-0.9.54/LICENSE.txt

@@ -0,0 +1,27 @@
+Copyright (c) 2014, Al Sweigart
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the name of the PyAutoGUI nor the names of its
+  contributors may be used to endorse or promote products derived from
+  this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

pyautogui_zzy-0.9.54/MANIFEST.in

@@ -0,0 +1,16 @@
+include *.md
+include LICENSE.txt
+recursive-include docs *.bat
+recursive-include docs *.py
+recursive-include docs *.rst
+recursive-include docs Makefile
+recursive-include pyautogui_zzy *.py
+recursive-include tests *.py
+recursive-include tests *.json *.png
+include Cargo.toml
+include Cargo.lock
+recursive-include src *.rs *.cu *.ptx
+recursive-include benchmarks *.py
+recursive-include tools *.py
+recursive-include training *.py
+include DEVELOPING.md

pyautogui_zzy-0.9.54/NOTICE

@@ -0,0 +1,18 @@
+pyautogui-zzy
+=============
+
+This project is a modified fork of PyAutoGUI.
+
+Original work:
+    PyAutoGUI
+    Copyright (c) 2014, Al Sweigart
+    https://github.com/asweigart/pyautogui
+    BSD-3-Clause; the original notice is retained verbatim in LICENSE.txt.
+
+Modifications in this fork:
+    Copyright (c) 2026, zzy
+
+The original copyright notice is retained as required by clause 1 of the
+BSD-3-Clause licence.  This project is an independent fork: it is not
+endorsed by, sponsored by, or affiliated with Al Sweigart or the PyAutoGUI
+project.  The name "pyautogui-zzy" identifies this fork only.