pctr 0.3.0__tar.gz → 0.3.2__tar.gz

{pctr-0.3.0/src/pctr.egg-info → pctr-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pctr
-Version: 0.3.0
+Version: 0.3.2
 Summary: Element-based Windows UI Automation CLI for AI agents. Find controls by name/type/id and click, type, hold, drag, and screenshot - no pixel coordinates.
 Author: Space-lab515
 License-Expression: MIT

{pctr-0.3.0 → pctr-0.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pctr"
-version = "0.3.0"
+version = "0.3.2"
 description = "Element-based Windows UI Automation CLI for AI agents. Find controls by name/type/id and click, type, hold, drag, and screenshot - no pixel coordinates."
 readme = "README.md"
 requires-python = ">=3.10"

pctr-0.3.2/src/pctr/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.3.2"

{pctr-0.3.0 → pctr-0.3.2}/src/pctr/cli.py

@@ -16,6 +16,12 @@ from pywinauto import Desktop
 
 DESCRIPTION = "Element-based Windows UI Automation CLI for AI agents."
 
+try:
+    from importlib.metadata import version as _pkg_version
+    _VERSION = _pkg_version("pctr")
+except Exception:
+    _VERSION = "unknown"
+
 
 def _fail(msg, code=2) -> NoReturn:
     """Print a clean one-line error and exit non-zero (no traceback)."""
@@ -36,30 +42,11 @@ def _iter_windows():
 
 
 def _find_window(title_re, process=None, timeout=5.0, index=0):
-    rx_title = _compile(title_re, "title") if title_re else None
-    desktop = Desktop(backend="uia")
-    deadline = time.time() + timeout
-    last = None
-    while time.time() < deadline:
-        matches = []
-        for w in desktop.windows():
-            try:
-                t = w.window_text()
-            except Exception:
-                continue
-            if rx_title and not rx_title.search(t):
-                continue
-            if process is not None and w.process_id() != process:
-                continue
-            matches.append(w)
-        if len(matches) > index:
-            return matches[index]
-        last = matches
-        time.sleep(0.25)
-    raise SystemExit(
-        "window not found: title_re=%r process=%r (saw %d match(es))"
-        % (title_re, process, len(last or []))
-    )
+    # Locate the HWND with Win32 first (fast, and never touches UIA providers of
+    # windows on *other* virtual desktops, which don't answer and can deadlock a
+    # full desktop enumeration). Then bind a UIA wrapper to just that one window.
+    h = _find_hwnd(title_re, process, timeout)
+    return Desktop(backend="uia").window(handle=h)
 
 
 def _enum_top_windows():
@@ -873,7 +860,8 @@ def _validate(args):
 
 def build_parser():
     ap = argparse.ArgumentParser(prog="pctr", description=DESCRIPTION, formatter_class=argparse.RawDescriptionHelpFormatter)
-    sub = ap.add_subparsers(dest="cmd", required=True)
+    ap.add_argument("--version", action="version", version="pctr %s" % _VERSION)
+    sub = ap.add_subparsers(dest="cmd", required=False)
 
     w = sub.add_parser("windows", help="List top-level windows")
     w.add_argument("--filter", default=None)
@@ -1059,7 +1047,11 @@ def build_parser():
 
 
 def main():
-    args = build_parser().parse_args()
+    ap = build_parser()
+    args = ap.parse_args()
+    if not getattr(args, "cmd", None):
+        ap.print_help()
+        return
     _validate(args)
     try:
         args.func(args)
@@ -1069,3 +1061,7 @@ def main():
         raise SystemExit(130)
     except Exception as e:
         _fail("%s: %s" % (type(e).__name__, e))
+
+
+if __name__ == "__main__":
+    main()

{pctr-0.3.0 → pctr-0.3.2/src/pctr.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pctr
-Version: 0.3.0
+Version: 0.3.2
 Summary: Element-based Windows UI Automation CLI for AI agents. Find controls by name/type/id and click, type, hold, drag, and screenshot - no pixel coordinates.
 Author: Space-lab515
 License-Expression: MIT

pctr-0.3.0/src/pctr/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.3.0"