cyberdesk 0.2.5__tar.gz → 0.2.7__tar.gz

{cyberdesk-0.2.5 → cyberdesk-0.2.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cyberdesk
-Version: 0.2.5
+Version: 0.2.7
 Summary: The official Python SDK for Cyberdesk
 Author-email: Cyberdesk Team <dev@cyberdesk.io>
 License-Expression: MIT
@@ -71,9 +71,9 @@ print('Desktop info:', info)
 ### Perform a Computer Action (e.g., Mouse Click)
 
 ```python
-from cyberdesk.actions import click_mouse
+from cyberdesk.actions import click_mouse, ClickMouseButton
 
-action = click_mouse(x=100, y=150, button="left")
+action = click_mouse(x=100, y=150, button=ClickMouseButton.LEFT)
 action_result = client.execute_computer_action("your-desktop-id", action)
 
 if hasattr(action_result, 'error') and action_result.error:
@@ -106,9 +106,9 @@ To create computer actions (mouse, keyboard, etc.), use the factory functions in
 
 **Example:**
 ```python
-from cyberdesk.actions import click_mouse, type_text
+from cyberdesk.actions import click_mouse, type_text, ClickMouseButton
 
-action1 = click_mouse(x=100, y=200, button="left")
+action1 = click_mouse(x=100, y=200, button=ClickMouseButton.LEFT)
 action2 = type_text(text="Hello, world!")
 
 client.execute_computer_action("your-desktop-id", action1)
@@ -136,14 +136,14 @@ All methods are also available as async variants (prefixed with `async_`). Examp
 ```python
 import asyncio
 from cyberdesk import CyberdeskClient
-from cyberdesk.actions import click_mouse
+from cyberdesk.actions import click_mouse, ClickMouseButton
 
 async def main():
     client = CyberdeskClient(api_key="YOUR_API_KEY")
     result = await client.async_launch_desktop(timeout_ms=10000)
     print(result)
     # Example async computer action
-    action = click_mouse(x=100, y=200)
+    action = click_mouse(x=100, y=200, button=ClickMouseButton.LEFT)
     await client.async_execute_computer_action("your-desktop-id", action)
     # ... use other async_ methods as needed
 
@@ -157,9 +157,11 @@ asyncio.run(main())
 All request/response types are available from the generated models, and all computer actions are available as factory functions in `cyberdesk.actions` for ergonomic, type-safe usage.
 
 ```python
-from cyberdesk.actions import click_mouse, drag_mouse, type_text, wait, scroll, move_mouse, press_keys, screenshot, get_cursor_position
+from cyberdesk.actions import click_mouse, drag_mouse, type_text, wait, scroll, move_mouse, press_keys, screenshot, get_cursor_position, ClickMouseButton, ClickMouseActionType, PressKeyActionType, ScrollDirection
 ```
 
+# Note: All action enums (e.g., ClickMouseButton, ClickMouseActionType, PressKeyActionType, ScrollDirection, etc.) are available from cyberdesk.actions for type-safe usage.
+
 ---
 
 ## For Cyberdesk Team: Publishing to PyPI

{cyberdesk-0.2.5 → cyberdesk-0.2.7}/README.md

@@ -55,9 +55,9 @@ print('Desktop info:', info)
 ### Perform a Computer Action (e.g., Mouse Click)
 
 ```python
-from cyberdesk.actions import click_mouse
+from cyberdesk.actions import click_mouse, ClickMouseButton
 
-action = click_mouse(x=100, y=150, button="left")
+action = click_mouse(x=100, y=150, button=ClickMouseButton.LEFT)
 action_result = client.execute_computer_action("your-desktop-id", action)
 
 if hasattr(action_result, 'error') and action_result.error:
@@ -90,9 +90,9 @@ To create computer actions (mouse, keyboard, etc.), use the factory functions in
 
 **Example:**
 ```python
-from cyberdesk.actions import click_mouse, type_text
+from cyberdesk.actions import click_mouse, type_text, ClickMouseButton
 
-action1 = click_mouse(x=100, y=200, button="left")
+action1 = click_mouse(x=100, y=200, button=ClickMouseButton.LEFT)
 action2 = type_text(text="Hello, world!")
 
 client.execute_computer_action("your-desktop-id", action1)
@@ -120,14 +120,14 @@ All methods are also available as async variants (prefixed with `async_`). Examp
 ```python
 import asyncio
 from cyberdesk import CyberdeskClient
-from cyberdesk.actions import click_mouse
+from cyberdesk.actions import click_mouse, ClickMouseButton
 
 async def main():
     client = CyberdeskClient(api_key="YOUR_API_KEY")
     result = await client.async_launch_desktop(timeout_ms=10000)
     print(result)
     # Example async computer action
-    action = click_mouse(x=100, y=200)
+    action = click_mouse(x=100, y=200, button=ClickMouseButton.LEFT)
     await client.async_execute_computer_action("your-desktop-id", action)
     # ... use other async_ methods as needed
 
@@ -141,9 +141,11 @@ asyncio.run(main())
 All request/response types are available from the generated models, and all computer actions are available as factory functions in `cyberdesk.actions` for ergonomic, type-safe usage.
 
 ```python
-from cyberdesk.actions import click_mouse, drag_mouse, type_text, wait, scroll, move_mouse, press_keys, screenshot, get_cursor_position
+from cyberdesk.actions import click_mouse, drag_mouse, type_text, wait, scroll, move_mouse, press_keys, screenshot, get_cursor_position, ClickMouseButton, ClickMouseActionType, PressKeyActionType, ScrollDirection
 ```
 
+# Note: All action enums (e.g., ClickMouseButton, ClickMouseActionType, PressKeyActionType, ScrollDirection, etc.) are available from cyberdesk.actions for type-safe usage.
+
 ---
 
 ## For Cyberdesk Team: Publishing to PyPI

{cyberdesk-0.2.5 → cyberdesk-0.2.7}/cyberdesk/__init__.py

@@ -3,6 +3,5 @@ from .types import (
     GetDesktopParams,
     LaunchDesktopParams,
     TerminateDesktopParams,
-    ExecuteComputerActionParams,
     ExecuteBashActionParams,
 ) 

cyberdesk-0.2.7/cyberdesk/actions.py

@@ -0,0 +1,118 @@
+from typing import Union, List, Optional
+
+from openapi_client.api_reference_client.types import UNSET
+from openapi_client.api_reference_client.models import (
+    PostV1DesktopIdComputerActionClickMouseAction,
+    PostV1DesktopIdComputerActionClickMouseActionType,
+    PostV1DesktopIdComputerActionClickMouseActionButton as ClickMouseButton,
+    PostV1DesktopIdComputerActionClickMouseActionClickType as ClickMouseActionType,
+    PostV1DesktopIdComputerActionDragMouseAction,
+    PostV1DesktopIdComputerActionDragMouseActionType,
+    PostV1DesktopIdComputerActionDragMouseActionStart,
+    PostV1DesktopIdComputerActionDragMouseActionEnd,
+    PostV1DesktopIdComputerActionGetCursorPositionAction,
+    PostV1DesktopIdComputerActionGetCursorPositionActionType,
+    PostV1DesktopIdComputerActionMoveMouseAction,
+    PostV1DesktopIdComputerActionMoveMouseActionType,
+    PostV1DesktopIdComputerActionPressKeysAction,
+    PostV1DesktopIdComputerActionPressKeysActionType,
+    PostV1DesktopIdComputerActionPressKeysActionKeyActionType as PressKeyActionType,
+    PostV1DesktopIdComputerActionScreenshotAction,
+    PostV1DesktopIdComputerActionScreenshotActionType,
+    PostV1DesktopIdComputerActionScrollAction,
+    PostV1DesktopIdComputerActionScrollActionType,
+    PostV1DesktopIdComputerActionScrollActionDirection as ScrollDirection,
+    PostV1DesktopIdComputerActionTypeTextAction,
+    PostV1DesktopIdComputerActionTypeTextActionType,
+    PostV1DesktopIdComputerActionWaitAction,
+    PostV1DesktopIdComputerActionWaitActionType,
+)
+
+# Re-export the original Enum types under their aliased names for user convenience if they need to import them
+# This makes `from cyberdesk.actions import ClickMouseButton` possible.
+
+def click_mouse(
+    x: Optional[int] = None,
+    y: Optional[int] = None,
+    button: Optional[ClickMouseButton] = None,
+    num_of_clicks: Optional[int] = None,
+    click_type: Optional[ClickMouseActionType] = None,
+) -> PostV1DesktopIdComputerActionClickMouseAction:
+    return PostV1DesktopIdComputerActionClickMouseAction(
+        type_=PostV1DesktopIdComputerActionClickMouseActionType.CLICK_MOUSE,
+        x=x if x is not None else UNSET,
+        y=y if y is not None else UNSET,
+        button=button if button is not None else UNSET,
+        num_of_clicks=num_of_clicks if num_of_clicks is not None else UNSET,
+        click_type=click_type if click_type is not None else UNSET
+    )
+
+def drag_mouse(
+    start_x: int,
+    start_y: int,
+    end_x: int,
+    end_y: int
+) -> PostV1DesktopIdComputerActionDragMouseAction:
+    start_model = PostV1DesktopIdComputerActionDragMouseActionStart(x=start_x, y=start_y)
+    end_model = PostV1DesktopIdComputerActionDragMouseActionEnd(x=end_x, y=end_y)
+    return PostV1DesktopIdComputerActionDragMouseAction(
+        type_=PostV1DesktopIdComputerActionDragMouseActionType.DRAG_MOUSE,
+        start=start_model,
+        end=end_model
+    )
+
+def get_cursor_position() -> PostV1DesktopIdComputerActionGetCursorPositionAction:
+    return PostV1DesktopIdComputerActionGetCursorPositionAction(
+        type_=PostV1DesktopIdComputerActionGetCursorPositionActionType.GET_CURSOR_POSITION
+    )
+
+def move_mouse(
+    x: int,
+    y: int
+) -> PostV1DesktopIdComputerActionMoveMouseAction:
+    return PostV1DesktopIdComputerActionMoveMouseAction(
+        type_=PostV1DesktopIdComputerActionMoveMouseActionType.MOVE_MOUSE,
+        x=x,
+        y=y
+    )
+
+def press_keys(
+    keys: Optional[Union[str, List[str]]] = None,
+    key_action_type: Optional[PressKeyActionType] = None
+) -> PostV1DesktopIdComputerActionPressKeysAction:
+    return PostV1DesktopIdComputerActionPressKeysAction(
+        type_=PostV1DesktopIdComputerActionPressKeysActionType.PRESS_KEYS,
+        keys=keys if keys is not None else UNSET,
+        key_action_type=key_action_type if key_action_type is not None else UNSET
+    )
+
+def screenshot() -> PostV1DesktopIdComputerActionScreenshotAction:
+    return PostV1DesktopIdComputerActionScreenshotAction(
+        type_=PostV1DesktopIdComputerActionScreenshotActionType.SCREENSHOT
+    )
+
+def scroll(
+    direction: ScrollDirection,
+    amount: int
+) -> PostV1DesktopIdComputerActionScrollAction:
+    return PostV1DesktopIdComputerActionScrollAction(
+        type_=PostV1DesktopIdComputerActionScrollActionType.SCROLL,
+        direction=direction,
+        amount=amount
+    )
+
+def type_text(
+    text: str
+) -> PostV1DesktopIdComputerActionTypeTextAction:
+    return PostV1DesktopIdComputerActionTypeTextAction(
+        type_=PostV1DesktopIdComputerActionTypeTextActionType.TYPE,
+        text=text
+    )
+
+def wait(
+    ms: int
+) -> PostV1DesktopIdComputerActionWaitAction:
+    return PostV1DesktopIdComputerActionWaitAction(
+        type_=PostV1DesktopIdComputerActionWaitActionType.WAIT,
+        ms=ms
+    ) 

{cyberdesk-0.2.5 → cyberdesk-0.2.7}/cyberdesk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cyberdesk
-Version: 0.2.5
+Version: 0.2.7
 Summary: The official Python SDK for Cyberdesk
 Author-email: Cyberdesk Team <dev@cyberdesk.io>
 License-Expression: MIT
@@ -71,9 +71,9 @@ print('Desktop info:', info)
 ### Perform a Computer Action (e.g., Mouse Click)
 
 ```python
-from cyberdesk.actions import click_mouse
+from cyberdesk.actions import click_mouse, ClickMouseButton
 
-action = click_mouse(x=100, y=150, button="left")
+action = click_mouse(x=100, y=150, button=ClickMouseButton.LEFT)
 action_result = client.execute_computer_action("your-desktop-id", action)
 
 if hasattr(action_result, 'error') and action_result.error:
@@ -106,9 +106,9 @@ To create computer actions (mouse, keyboard, etc.), use the factory functions in
 
 **Example:**
 ```python
-from cyberdesk.actions import click_mouse, type_text
+from cyberdesk.actions import click_mouse, type_text, ClickMouseButton
 
-action1 = click_mouse(x=100, y=200, button="left")
+action1 = click_mouse(x=100, y=200, button=ClickMouseButton.LEFT)
 action2 = type_text(text="Hello, world!")
 
 client.execute_computer_action("your-desktop-id", action1)
@@ -136,14 +136,14 @@ All methods are also available as async variants (prefixed with `async_`). Examp
 ```python
 import asyncio
 from cyberdesk import CyberdeskClient
-from cyberdesk.actions import click_mouse
+from cyberdesk.actions import click_mouse, ClickMouseButton
 
 async def main():
     client = CyberdeskClient(api_key="YOUR_API_KEY")
     result = await client.async_launch_desktop(timeout_ms=10000)
     print(result)
     # Example async computer action
-    action = click_mouse(x=100, y=200)
+    action = click_mouse(x=100, y=200, button=ClickMouseButton.LEFT)
     await client.async_execute_computer_action("your-desktop-id", action)
     # ... use other async_ methods as needed
 
@@ -157,9 +157,11 @@ asyncio.run(main())
 All request/response types are available from the generated models, and all computer actions are available as factory functions in `cyberdesk.actions` for ergonomic, type-safe usage.
 
 ```python
-from cyberdesk.actions import click_mouse, drag_mouse, type_text, wait, scroll, move_mouse, press_keys, screenshot, get_cursor_position
+from cyberdesk.actions import click_mouse, drag_mouse, type_text, wait, scroll, move_mouse, press_keys, screenshot, get_cursor_position, ClickMouseButton, ClickMouseActionType, PressKeyActionType, ScrollDirection
 ```
 
+# Note: All action enums (e.g., ClickMouseButton, ClickMouseActionType, PressKeyActionType, ScrollDirection, etc.) are available from cyberdesk.actions for type-safe usage.
+
 ---
 
 ## For Cyberdesk Team: Publishing to PyPI

{cyberdesk-0.2.5 → cyberdesk-0.2.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "cyberdesk"
-version = "0.2.5"
+version = "0.2.7"
 description = "The official Python SDK for Cyberdesk"
 authors = [{name = "Cyberdesk Team", email = "dev@cyberdesk.io"}]
 readme = "README.md"

cyberdesk-0.2.5/cyberdesk/actions.py

@@ -1,38 +0,0 @@
-from .types import (
-    PostV1DesktopIdComputerActionClickMouseAction,
-    PostV1DesktopIdComputerActionDragMouseAction,
-    PostV1DesktopIdComputerActionGetCursorPositionAction,
-    PostV1DesktopIdComputerActionMoveMouseAction,
-    PostV1DesktopIdComputerActionPressKeysAction,
-    PostV1DesktopIdComputerActionScreenshotAction,
-    PostV1DesktopIdComputerActionScrollAction,
-    PostV1DesktopIdComputerActionTypeTextAction,
-    PostV1DesktopIdComputerActionWaitAction,
-)
-
-def click_mouse(x: int, y: int, button: str = "left") -> PostV1DesktopIdComputerActionClickMouseAction:
-    return PostV1DesktopIdComputerActionClickMouseAction(type="click_mouse", x=x, y=y, button=button)
-
-def drag_mouse(start_x: int, start_y: int, end_x: int, end_y: int, button: str = "left") -> PostV1DesktopIdComputerActionDragMouseAction:
-    return PostV1DesktopIdComputerActionDragMouseAction(type="drag_mouse", start_x=start_x, start_y=start_y, end_x=end_x, end_y=end_y, button=button)
-
-def get_cursor_position() -> PostV1DesktopIdComputerActionGetCursorPositionAction:
-    return PostV1DesktopIdComputerActionGetCursorPositionAction(type="get_cursor_position")
-
-def move_mouse(x: int, y: int) -> PostV1DesktopIdComputerActionMoveMouseAction:
-    return PostV1DesktopIdComputerActionMoveMouseAction(type="move_mouse", x=x, y=y)
-
-def press_keys(keys: list[str]) -> PostV1DesktopIdComputerActionPressKeysAction:
-    return PostV1DesktopIdComputerActionPressKeysAction(type="press_keys", keys=keys)
-
-def screenshot() -> PostV1DesktopIdComputerActionScreenshotAction:
-    return PostV1DesktopIdComputerActionScreenshotAction(type="screenshot")
-
-def scroll(dx: int, dy: int) -> PostV1DesktopIdComputerActionScrollAction:
-    return PostV1DesktopIdComputerActionScrollAction(type="scroll", dx=dx, dy=dy)
-
-def type_text(text: str) -> PostV1DesktopIdComputerActionTypeTextAction:
-    return PostV1DesktopIdComputerActionTypeTextAction(type="type", text=text)
-
-def wait(ms: int) -> PostV1DesktopIdComputerActionWaitAction:
-    return PostV1DesktopIdComputerActionWaitAction(type="wait", ms=ms)