imgclickflow 0.1.0__py3-none-any.whl

imgclickflow/__init__.py

@@ -0,0 +1,97 @@
+# -*- coding: UTF-8 -*-
+"""ImgClickFlow —— 基于图像识别的 Windows 桌面自动化助手。
+
+典型用法::
+
+    import imgclickflow
+    imgclickflow.auto.click("保存")
+
+``import`` 本身零副作用：不会打印任何内容，也不会创建任何目录。
+首次真正需要落盘（截图 / 日志 / 报告 / 采集模板）时，才会在数据目录下
+创建 ``templates`` / ``logs`` / ``error_snapshots`` / ``screenshots_author``。
+
+数据目录解析优先级：
+
+1. 环境变量 ``IMGCLICKFLOW_HOME``
+2. 当前目录已存在 ``templates/`` —— 兼容"脚本与模板同目录"的老用法
+3. ``%LOCALAPPDATA%\\ImgClickFlow``
+
+需要固定数据目录时显式初始化::
+
+    imgclickflow.init(data_dir=r"D:\\my_flows")
+"""
+
+from .core import (
+    Config,
+    Flow,
+    auto,
+    capture_template_simple,
+    find_files,
+    first_last_day,
+    get_real_resolution,
+    get_screen_size,
+    get_scale_factor,
+    init,
+    key_down,
+    key_press,
+    key_press_plus,
+    key_up,
+    logger,
+    logical_to_real,
+    monthends,
+    mouse_left_click,
+    mouse_moveto,
+    mouse_right_click,
+    real_to_logical,
+    saystring,
+    scroll_mouse,
+    search,
+    timer_task,
+    timer_task_once,
+    timer_tasks,
+)
+
+def _resolve_version():
+    """版本号的单一真相源是 pyproject.toml。从已安装元数据读取，源码直跑时回退。"""
+    try:
+        from importlib.metadata import PackageNotFoundError, version
+    except ImportError:            # Python < 3.8
+        return "0.0.0+source"
+    try:
+        return version("imgclickflow")
+    except PackageNotFoundError:
+        return "0.0.0+source"
+
+
+__version__ = _resolve_version()
+
+__all__ = [
+    "__version__",
+    "Config",
+    "Flow",
+    "auto",
+    "init",
+    "logger",
+    "capture_template_simple",
+    "find_files",
+    "first_last_day",
+    "get_real_resolution",
+    "get_screen_size",
+    "get_scale_factor",
+    "key_down",
+    "key_press",
+    "key_press_plus",
+    "key_up",
+    "logical_to_real",
+    "monthends",
+    "mouse_left_click",
+    "mouse_moveto",
+    "mouse_right_click",
+    "real_to_logical",
+    "saystring",
+    "scroll_mouse",
+    "search",
+    "timer_task",
+    "timer_task_once",
+    "timer_tasks",
+]

imgclickflow/__main__.py

@@ -0,0 +1,9 @@
+# -*- coding: UTF-8 -*-
+"""支持 ``python -m imgclickflow``。"""
+
+import sys
+
+from .cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())

imgclickflow/cli.py

@@ -0,0 +1,83 @@
+# -*- coding: UTF-8 -*-
+"""命令行入口。
+
+安装后可直接使用：
+
+    imgclickflow doctor          # 环境诊断
+    imgclickflow capture 保存     # 采集一个按钮模板
+    imgclickflow run my_flow.py  # 运行流程脚本
+    imgclickflow help            # 完整使用手册
+
+也支持 ``python -m imgclickflow``。
+"""
+
+import argparse
+import sys
+
+
+def _build_parser():
+    parser = argparse.ArgumentParser(
+        prog="imgclickflow",
+        description="基于图像识别的 Windows 桌面自动化助手",
+        epilog="数据目录默认位于 %LOCALAPPDATA%\\ImgClickFlow，"
+               "可用环境变量 IMGCLICKFLOW_HOME 覆盖。",
+    )
+    parser.add_argument(
+        "--version", action="version",
+        version="%(prog)s {0}".format(_version()),
+    )
+
+    sub = parser.add_subparsers(dest="command", metavar="<命令>")
+
+    sub.add_parser("doctor", help="环境诊断：分辨率、DPI、依赖、模板目录")
+    sub.add_parser("help", help="打印完整使用手册")
+
+    p_cap = sub.add_parser("capture", help="全屏截图，用于裁剪出按钮模板")
+    p_cap.add_argument("name", help="模板名称，例如：保存")
+
+    p_run = sub.add_parser("run", help="运行一个流程脚本")
+    p_run.add_argument("script", help="Python 脚本路径")
+
+    return parser
+
+
+def _version():
+    from . import __version__
+    return __version__
+
+
+def main(argv=None):
+    parser = _build_parser()
+    args = parser.parse_args(argv)
+
+    if not args.command:
+        parser.print_help()
+        return 0
+
+    if args.command == "doctor":
+        from .core import _EnvChecker, _base_dir, _ensure_ready
+        _ensure_ready()
+        _EnvChecker.check()
+        _EnvChecker.check_templates()
+        return 0
+
+    if args.command == "help":
+        from .core import auto
+        auto.help()
+        return 0
+
+    if args.command == "capture":
+        from .core import capture_template_simple
+        return 0 if capture_template_simple(args.name) else 1
+
+    if args.command == "run":
+        import runpy
+        runpy.run_path(args.script, run_name="__main__")
+        return 0
+
+    parser.print_help()
+    return 2
+
+
+if __name__ == "__main__":
+    sys.exit(main())