premiere-cli 0.3.0__tar.gz → 0.4.0__tar.gz

{premiere_cli-0.3.0 → premiere_cli-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: premiere-cli
-Version: 0.3.0
+Version: 0.4.0
 Summary: Drive Adobe Premiere Pro from the command line: a Python CLI plus a bundled CEP bridge panel exposing Premiere's scripting APIs over local HTTP
 License: CC-BY-SA-4.0
 Project-URL: Repository, https://github.com/stefanwebb/premiere-cli
@@ -9,6 +9,10 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
+Provides-Extra: macos-desktop
+Requires-Dist: pyobjc-framework-Cocoa; extra == "macos-desktop"
+Requires-Dist: pyobjc-framework-ApplicationServices; extra == "macos-desktop"
+Requires-Dist: pyobjc-framework-Quartz; extra == "macos-desktop"
 Dynamic: license-file
 
 # premiere-cli
@@ -53,6 +57,35 @@ targets Premiere Pro 2020+ (CEP 10-12); the API behavior notes in
 **Premiere Pro 26.3.0 (macOS)** — Premiere's undocumented QE APIs vary by
 build, so re-verify build-sensitive commands on other versions.
 
+### macOS desktop automation (optional)
+
+Generic UI-automation primitives for driving Premiere's native UI directly
+(Accessibility API + synthetic key/mouse events) — for actions ExtendScript
+can't do on this build: `desktop-take-screenshot`, `desktop-press-key`,
+`desktop-enter-text`, `desktop-enter-text-with-validate`,
+`desktop-move-mouse`, `desktop-click-mouse` — plus a persistent on-screen
+notification (`desktop-notify` / `desktop-dismiss-notifications`)
+independent of any one command's own process. All confirm Premiere is
+frontmost before sending input. macOS only; needs a separate extra so the
+base CLI stays zero-dependency:
+
+```bash
+pip install "premiere-cli[macos-desktop]"
+```
+
+The terminal (or whatever process runs the CLI) needs the **Accessibility**
+permission: System Settings > Privacy & Security > Accessibility. Grant it
+to the actual process running `premiere-cli` (Terminal, iTerm, etc.), not
+Premiere Pro.
+
+This command **posts real keyboard input to whatever app is frontmost** —
+keep Premiere Pro active and hands off the keyboard/mouse while it runs,
+or the input lands in the wrong app. It refuses to run if it can't confirm
+Premiere is frontmost, or if more than one clip is selected (driving the
+LUT picker with multiple clips selected applies the change to all of
+them). See [docs/DESKTOP_DRIVER_NOTES.md](docs/DESKTOP_DRIVER_NOTES.md)
+for the full set of findings behind how this works.
+
 ## Use from the command line
 
 ```bash

premiere_cli-0.3.0/src/premiere_cli.egg-info/PKG-INFO → premiere_cli-0.4.0/README.md

@@ -1,16 +1,3 @@
-Metadata-Version: 2.4
-Name: premiere-cli
-Version: 0.3.0
-Summary: Drive Adobe Premiere Pro from the command line: a Python CLI plus a bundled CEP bridge panel exposing Premiere's scripting APIs over local HTTP
-License: CC-BY-SA-4.0
-Project-URL: Repository, https://github.com/stefanwebb/premiere-cli
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Provides-Extra: dev
-Requires-Dist: pytest; extra == "dev"
-Dynamic: license-file
-
 # premiere-cli
 
 Drive Adobe Premiere Pro from the command line.
@@ -53,6 +40,35 @@ targets Premiere Pro 2020+ (CEP 10-12); the API behavior notes in
 **Premiere Pro 26.3.0 (macOS)** — Premiere's undocumented QE APIs vary by
 build, so re-verify build-sensitive commands on other versions.
 
+### macOS desktop automation (optional)
+
+Generic UI-automation primitives for driving Premiere's native UI directly
+(Accessibility API + synthetic key/mouse events) — for actions ExtendScript
+can't do on this build: `desktop-take-screenshot`, `desktop-press-key`,
+`desktop-enter-text`, `desktop-enter-text-with-validate`,
+`desktop-move-mouse`, `desktop-click-mouse` — plus a persistent on-screen
+notification (`desktop-notify` / `desktop-dismiss-notifications`)
+independent of any one command's own process. All confirm Premiere is
+frontmost before sending input. macOS only; needs a separate extra so the
+base CLI stays zero-dependency:
+
+```bash
+pip install "premiere-cli[macos-desktop]"
+```
+
+The terminal (or whatever process runs the CLI) needs the **Accessibility**
+permission: System Settings > Privacy & Security > Accessibility. Grant it
+to the actual process running `premiere-cli` (Terminal, iTerm, etc.), not
+Premiere Pro.
+
+This command **posts real keyboard input to whatever app is frontmost** —
+keep Premiere Pro active and hands off the keyboard/mouse while it runs,
+or the input lands in the wrong app. It refuses to run if it can't confirm
+Premiere is frontmost, or if more than one clip is selected (driving the
+LUT picker with multiple clips selected applies the change to all of
+them). See [docs/DESKTOP_DRIVER_NOTES.md](docs/DESKTOP_DRIVER_NOTES.md)
+for the full set of findings behind how this works.
+
 ## Use from the command line
 
 ```bash

{premiere_cli-0.3.0 → premiere_cli-0.4.0}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 name = "premiere-cli"
 # Keep in lockstep with premiere_cli.__version__ and PANEL_VERSION in
 # src/premiere_cli/panel/js/main.js.
-version = "0.3.0"
+version = "0.4.0"
 description = "Drive Adobe Premiere Pro from the command line: a Python CLI plus a bundled CEP bridge panel exposing Premiere's scripting APIs over local HTTP"
 readme = "README.md"
 license = {text = "CC-BY-SA-4.0"}
@@ -24,6 +24,14 @@ premiere-log = "premiere_cli.log:main"
 
 [project.optional-dependencies]
 dev = ["pytest"]
+# Only needed for `desktop-set-input-lut` (macOS only) — kept out of the base
+# install so `pipx install premiere-cli` stays zero-dependency for everyone
+# who doesn't need UI automation.
+macos-desktop = [
+    "pyobjc-framework-Cocoa",
+    "pyobjc-framework-ApplicationServices",
+    "pyobjc-framework-Quartz",
+]
 
 [tool.setuptools.packages.find]
 where = ["src"]

{premiere_cli-0.3.0 → premiere_cli-0.4.0}/src/premiere_cli/__init__.py

@@ -8,4 +8,4 @@ server (port 47823).
 # Kept in lockstep with PANEL_VERSION in panel/js/main.js and the version in
 # pyproject.toml — `premiere-cli doctor` compares the installed panel's
 # version against this one.
-__version__ = "0.3.0"
+__version__ = "0.4.0"

{premiere_cli-0.3.0 → premiere_cli-0.4.0}/src/premiere_cli/cli.py

@@ -2,6 +2,7 @@
 
 import argparse
 import json
+import platform
 import re
 import sys
 import urllib.error
@@ -27,6 +28,32 @@ def _validate_response(parsed_json) -> dict:
 _INTERVAL_LINE_RE = re.compile(r"^(\d{2,3}:\d{2}:\d{2})\s*-\s*(\d{2,3}:\d{2}:\d{2})$")
 
 
+def _load_desktop_driver(subcommand: str):
+    """Import `desktop_driver`, or exit with a well-formed JSON error if
+    this isn't macOS or the `macos-desktop` extra isn't installed — the
+    same two-check preamble every `desktop-*` subcommand needs before it
+    can do anything."""
+    if platform.system() != "Darwin":
+        print(
+            json.dumps({"ok": False, "error": f"{subcommand} is macOS only (drives the native Accessibility API)"}),
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    try:
+        from premiere_cli import desktop_driver
+    except ImportError as exc:
+        print(
+            json.dumps({
+                "ok": False,
+                "error": f"missing the macOS desktop-driver extra ({exc}) — install with: "
+                         "pip install 'premiere-cli[macos-desktop]'",
+            }),
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    return desktop_driver
+
+
 def _parse_intervals_file(path: str) -> list:
     """Parse a remove_pauses.py-style cuts file ("MM:SS:FF - MM:SS:FF" per
     line, blank lines ignored) into [{"start": ..., "end": ...}, ...].
@@ -118,6 +145,73 @@ def main() -> None:
         help="Directory the project (or series) is created under",
     )
 
+    desktop_take_screenshot_parser = subparsers.add_parser(
+        "desktop-take-screenshot",
+        help="Confirm Premiere is frontmost, then save a full-screen screenshot (macOS only)",
+    )
+    desktop_take_screenshot_parser.add_argument("output_path", help="File path to save the screenshot to (e.g. /tmp/frame.png)")
+
+    desktop_press_key_parser = subparsers.add_parser(
+        "desktop-press-key",
+        help="Confirm Premiere is frontmost, then send one synthetic key press (macOS only)",
+    )
+    desktop_press_key_parser.add_argument(
+        "--key", required=True,
+        help="Key name (e.g. 'return', 'escape', 'up', 'a') or a decimal virtual keycode",
+    )
+    desktop_press_key_parser.add_argument(
+        "--modifier", dest="modifiers", action="append", default=[],
+        choices=["command", "cmd", "shift", "option", "alt", "control", "ctrl"],
+        help="Modifier held during the press; repeat for multiple (e.g. --modifier cmd --modifier shift)",
+    )
+
+    desktop_enter_text_parser = subparsers.add_parser(
+        "desktop-enter-text",
+        help="Confirm Premiere is frontmost, then type literal text at the current insertion point, unvalidated (macOS only)",
+    )
+    desktop_enter_text_parser.add_argument("text", help="Text to type")
+
+    desktop_enter_text_with_validate_parser = subparsers.add_parser(
+        "desktop-enter-text-with-validate",
+        help="Confirm Premiere is frontmost, type text into the focused field, and verify it read back correctly (macOS only). "
+             "CAVEAT: Premiere's own panels don't reliably report focus via AX — this often false-fails against them; "
+             "prefer desktop-enter-text + a screenshot for Premiere's own UI",
+    )
+    desktop_enter_text_with_validate_parser.add_argument("text", help="Text to type")
+    desktop_enter_text_with_validate_parser.add_argument(
+        "--attempts", type=int, default=3, help="Retry count if the read-back doesn't match (default: 3)",
+    )
+
+    desktop_move_mouse_parser = subparsers.add_parser(
+        "desktop-move-mouse",
+        help="Confirm Premiere is frontmost, then move the mouse cursor to screen coordinates (macOS only)",
+    )
+    desktop_move_mouse_parser.add_argument("--x", type=float, required=True, help="Target x coordinate")
+    desktop_move_mouse_parser.add_argument("--y", type=float, required=True, help="Target y coordinate")
+
+    desktop_click_mouse_parser = subparsers.add_parser(
+        "desktop-click-mouse",
+        help="Confirm Premiere is frontmost, then click the mouse — at given coordinates, or at the current cursor position (macOS only)",
+    )
+    desktop_click_mouse_parser.add_argument("--x", type=float, default=None, help="Click x coordinate (omit with --y to click at the current cursor position)")
+    desktop_click_mouse_parser.add_argument("--y", type=float, default=None, help="Click y coordinate (omit with --x to click at the current cursor position)")
+    desktop_click_mouse_parser.add_argument("--button", choices=["left", "right"], default="left", help="Mouse button (default: left)")
+
+    desktop_notify_parser = subparsers.add_parser(
+        "desktop-notify",
+        help="Show (or update, if already showing) an always-on-top notification window pinned top-right of the screen (macOS only)",
+    )
+    desktop_notify_parser.add_argument("message", help="Text to display")
+    desktop_notify_parser.add_argument(
+        "--state", choices=["waiting", "driving", "done", "info"], default="info",
+        help="Accent color: waiting=amber, driving=red, done=green, info=slate (default: info)",
+    )
+
+    subparsers.add_parser(
+        "desktop-dismiss-notifications",
+        help="Close the notification window opened by desktop-notify, if one is showing (macOS only)",
+    )
+
     create_sequence_parser = subparsers.add_parser("create-sequence", help="Create a new sequence")
     create_sequence_parser.add_argument("--name", required=True, help="Name of the new sequence")
     create_sequence_parser.add_argument(
@@ -2173,6 +2267,30 @@ def main() -> None:
         from premiere_cli import init_project
 
         sys.exit(init_project.init_project(args.project_name, args.series, args.base_dir))
+    if args.subcommand == "desktop-take-screenshot":
+        desktop_driver = _load_desktop_driver(args.subcommand)
+        sys.exit(desktop_driver.take_screenshot(args.output_path, port=args.port))
+    if args.subcommand == "desktop-press-key":
+        desktop_driver = _load_desktop_driver(args.subcommand)
+        sys.exit(desktop_driver.press_key_by_name(args.key, modifiers=args.modifiers, port=args.port))
+    if args.subcommand == "desktop-enter-text":
+        desktop_driver = _load_desktop_driver(args.subcommand)
+        sys.exit(desktop_driver.enter_text(args.text, port=args.port))
+    if args.subcommand == "desktop-enter-text-with-validate":
+        desktop_driver = _load_desktop_driver(args.subcommand)
+        sys.exit(desktop_driver.enter_text_with_validate(args.text, attempts=args.attempts, port=args.port))
+    if args.subcommand == "desktop-move-mouse":
+        desktop_driver = _load_desktop_driver(args.subcommand)
+        sys.exit(desktop_driver.move_mouse(args.x, args.y, port=args.port))
+    if args.subcommand == "desktop-click-mouse":
+        desktop_driver = _load_desktop_driver(args.subcommand)
+        sys.exit(desktop_driver.click_mouse(x=args.x, y=args.y, button=args.button, port=args.port))
+    if args.subcommand == "desktop-notify":
+        desktop_driver = _load_desktop_driver(args.subcommand)
+        sys.exit(desktop_driver.notify(args.message, state=args.state))
+    if args.subcommand == "desktop-dismiss-notifications":
+        desktop_driver = _load_desktop_driver(args.subcommand)
+        sys.exit(desktop_driver.dismiss_notifications())
 
     if args.subcommand == "create-sequence":
         command_args = {"name": args.name, "bin": args.bin, "fps": args.fps, "width": args.width, "height": args.height}