automas-maafw-controller-win32 0.1.1__tar.gz

automas_maafw_controller_win32-0.1.1/PKG-INFO

@@ -0,0 +1,15 @@
+Metadata-Version: 2.4
+Name: automas-maafw-controller-win32
+Version: 0.1.1
+Summary: Win32 controller provider for AUTO-MAS MaaFW plugins
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: automas-maafw-interface>=0.1.0
+Requires-Dist: pydantic>=2
+
+# automas-maafw-controller-win32
+
+Win32 controller provider for the AUTO-MAS MaaFW plugin group.
+
+The service exposes window scanning helpers. `maa.toolkit` is imported lazily
+only when Win32 windows are scanned.

automas_maafw_controller_win32-0.1.1/README.md

@@ -0,0 +1,6 @@
+# automas-maafw-controller-win32
+
+Win32 controller provider for the AUTO-MAS MaaFW plugin group.
+
+The service exposes window scanning helpers. `maa.toolkit` is imported lazily
+only when Win32 windows are scanned.

automas_maafw_controller_win32-0.1.1/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "automas-maafw-controller-win32"
+version = "0.1.1"
+description = "Win32 controller provider for AUTO-MAS MaaFW plugins"
+readme = { file = "README.md", content-type = "text/markdown" }
+requires-python = ">=3.10"
+dependencies = [
+    "automas-maafw-interface>=0.1.0",
+    "pydantic>=2",
+]
+
+[project.entry-points."auto_mas.plugins"]
+automas_maafw_controller_win32 = "automas_maafw_controller_win32.plugin:Plugin"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+automas_maafw_controller_win32 = ["py.typed"]

automas_maafw_controller_win32-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

automas_maafw_controller_win32-0.1.1/src/automas_maafw_controller_win32/__init__.py

@@ -0,0 +1,3 @@
+from __future__ import annotations
+
+__all__: list[str] = []

automas_maafw_controller_win32-0.1.1/src/automas_maafw_controller_win32/plugin.py

@@ -0,0 +1,47 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from .service import MaaFWWin32ControllerService
+
+if TYPE_CHECKING:
+    from auto_mas_core import PluginContext
+
+
+DEFAULT_INSTANCE = {
+    "name": "MaaFW Win32 Controller",
+    "enabled": True,
+    "config": {},
+}
+
+schema = {
+    "__no_plugin_config__": {
+        "type": "boolean",
+        "default": True,
+        "hidden": True,
+        "configurable": False,
+        "title": "No plugin-level configuration",
+    },
+}
+
+
+class Plugin:
+    provides = ["maafw.controller.win32"]
+    wants = ["maafw.registry.v1"]
+
+    def __init__(self, ctx: "PluginContext") -> None:
+        self.ctx = ctx
+        self.service = MaaFWWin32ControllerService()
+
+    async def on_start(self) -> None:
+        self.ctx.set("maafw.controller.win32", self.service)
+        registry = self.ctx.get("maafw.registry.v1")
+        if registry is not None and hasattr(registry, "register_controller_provider"):
+            registry.register_controller_provider(self.service.get_provider_definition())
+        self.ctx.logger.info("maafw.controller.win32 ready")
+
+    async def on_stop(self, reason: str) -> None:
+        registry = self.ctx.get("maafw.registry.v1")
+        if registry is not None and hasattr(registry, "unregister_controller_provider"):
+            registry.unregister_controller_provider("win32")
+        self.ctx.logger.info(f"maafw.controller.win32 stopped, reason={reason}")

automas_maafw_controller_win32-0.1.1/src/automas_maafw_controller_win32/py.typed

@@ -0,0 +1 @@
+

automas_maafw_controller_win32-0.1.1/src/automas_maafw_controller_win32/service.py

@@ -0,0 +1,150 @@
+from __future__ import annotations
+
+import re
+import sys
+from dataclasses import dataclass
+from typing import Any, Iterable
+
+from automas_maafw_interface.models import MaaFWController
+from pydantic import BaseModel
+
+MAX_REGEX_PATTERN_LENGTH = 256
+MAX_REGEX_VALUE_LENGTH = 4096
+DANGEROUS_NESTED_QUANTIFIER_RE = re.compile(
+    r"\([^)]*(?:[*+]|\{\d+(?:,\d*)?\})[^)]*\)(?:[*+]|\{\d+(?:,\d*)?\})"
+)
+
+
+@dataclass(frozen=True)
+class MaaFWWin32Window:
+    hWnd: int
+    className: str
+    windowName: str
+
+
+@dataclass(frozen=True)
+class MaaFWWindowMatch(MaaFWWin32Window):
+    controllerName: str
+    controllerType: str
+
+
+class MaaFWWin32ControllerService:
+    """maafw.controller.win32 service."""
+
+    key = "win32"
+    display_name = "Win32"
+    controller_types = ["Win32"]
+
+    def get_provider_definition(self) -> dict[str, Any]:
+        return {
+            "key": self.key,
+            "displayName": self.display_name,
+            "controllerTypes": list(self.controller_types),
+            "capabilities": ["window_scan", "device_spec"],
+        }
+
+    def list_windows(self) -> list[MaaFWWin32Window]:
+        if sys.platform != "win32":
+            raise RuntimeError("Win32 窗口扫描仅支持 Windows")
+
+        from maa.toolkit import Toolkit
+
+        return [
+            MaaFWWin32Window(
+                hWnd=_normalize_hwnd(window.hwnd),
+                className=str(window.class_name or ""),
+                windowName=str(window.window_name or ""),
+            )
+            for window in Toolkit.find_desktop_windows()
+        ]
+
+    def match_controller_windows(
+        self,
+        controller: BaseModel | dict[str, Any],
+        windows: Iterable[MaaFWWin32Window] | None = None,
+    ) -> list[MaaFWWindowMatch]:
+        if isinstance(controller, MaaFWController):
+            controller_model = controller
+        else:
+            controller_payload = (
+                controller.model_dump(mode="json", by_alias=True)
+                if hasattr(controller, "model_dump")
+                else controller
+            )
+            controller_model = MaaFWController.model_validate(controller_payload)
+        if controller_model.type != "Win32":
+            return []
+
+        class_regex, window_regex = _controller_window_regex(controller_model)
+        source_windows = list(windows) if windows is not None else self.list_windows()
+        matched: list[MaaFWWindowMatch] = []
+        seen_hwnds: set[int] = set()
+
+        for window in source_windows:
+            if window.hWnd in seen_hwnds:
+                continue
+            if not _matches_regex(class_regex, window.className):
+                continue
+            if not _matches_regex(window_regex, window.windowName):
+                continue
+
+            seen_hwnds.add(window.hWnd)
+            matched.append(
+                MaaFWWindowMatch(
+                    hWnd=window.hWnd,
+                    className=window.className,
+                    windowName=window.windowName,
+                    controllerName=controller_model.name,
+                    controllerType=controller_model.type,
+                )
+            )
+
+        return matched
+
+    def build_device_spec(
+        self,
+        *,
+        h_wnd: int | None = None,
+        screencap_method: int = 0,
+        mouse_method: int = 0,
+        keyboard_method: int = 0,
+    ) -> dict[str, Any]:
+        return {
+            "type": "Win32",
+            "hWnd": h_wnd,
+            "screencapMethod": screencap_method,
+            "mouseMethod": mouse_method,
+            "keyboardMethod": keyboard_method,
+        }
+
+
+def _controller_window_regex(controller: MaaFWController) -> tuple[str | None, str | None]:
+    if controller.type == "Win32" and controller.win32 is not None:
+        return controller.win32.class_regex, controller.win32.window_regex
+    return None, None
+
+
+def _matches_regex(pattern: str | None, value: str) -> bool:
+    if not pattern:
+        return True
+    try:
+        compiled_pattern = _compile_safe_regex(pattern)
+        return compiled_pattern.search(value[:MAX_REGEX_VALUE_LENGTH]) is not None
+    except re.error as exc:
+        raise RuntimeError(f"interface 窗口匹配正则无效: {pattern}") from exc
+
+
+def _compile_safe_regex(pattern: str) -> re.Pattern[str]:
+    if len(pattern) > MAX_REGEX_PATTERN_LENGTH:
+        raise RuntimeError("interface window regex is too long")
+    if DANGEROUS_NESTED_QUANTIFIER_RE.search(pattern):
+        raise RuntimeError("interface window regex contains nested quantifiers")
+    return re.compile(pattern)
+
+
+def _normalize_hwnd(value: Any) -> int:
+    if hasattr(value, "value"):
+        value = value.value
+    if value is None:
+        return 0
+    return int(value)

automas_maafw_controller_win32-0.1.1/src/automas_maafw_controller_win32.egg-info/PKG-INFO

@@ -0,0 +1,15 @@
+Metadata-Version: 2.4
+Name: automas-maafw-controller-win32
+Version: 0.1.1
+Summary: Win32 controller provider for AUTO-MAS MaaFW plugins
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: automas-maafw-interface>=0.1.0
+Requires-Dist: pydantic>=2
+
+# automas-maafw-controller-win32
+
+Win32 controller provider for the AUTO-MAS MaaFW plugin group.
+
+The service exposes window scanning helpers. `maa.toolkit` is imported lazily
+only when Win32 windows are scanned.

automas_maafw_controller_win32-0.1.1/src/automas_maafw_controller_win32.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+README.md
+pyproject.toml
+src/automas_maafw_controller_win32/__init__.py
+src/automas_maafw_controller_win32/plugin.py
+src/automas_maafw_controller_win32/py.typed
+src/automas_maafw_controller_win32/service.py
+src/automas_maafw_controller_win32.egg-info/PKG-INFO
+src/automas_maafw_controller_win32.egg-info/SOURCES.txt
+src/automas_maafw_controller_win32.egg-info/dependency_links.txt
+src/automas_maafw_controller_win32.egg-info/entry_points.txt
+src/automas_maafw_controller_win32.egg-info/requires.txt
+src/automas_maafw_controller_win32.egg-info/top_level.txt

automas_maafw_controller_win32-0.1.1/src/automas_maafw_controller_win32.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

automas_maafw_controller_win32-0.1.1/src/automas_maafw_controller_win32.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[auto_mas.plugins]
+automas_maafw_controller_win32 = automas_maafw_controller_win32.plugin:Plugin

automas_maafw_controller_win32-0.1.1/src/automas_maafw_controller_win32.egg-info/requires.txt

@@ -0,0 +1,2 @@
+automas-maafw-interface>=0.1.0
+pydantic>=2

automas_maafw_controller_win32-0.1.1/src/automas_maafw_controller_win32.egg-info/top_level.txt

@@ -0,0 +1 @@
+automas_maafw_controller_win32