[skip ci] Release new versions

Author: github-actions[bot]

.changeset/clean-mugs-say.md

@@ -1,7 +1,7 @@
 {
   "name": "@e2b/desktop-python",
   "private": true,
-  "version": "1.7.1",
+  "version": "1.7.2",
   "scripts": {
     "test": "poetry run pytest -n 4 --verbose -x",
     "example": "poetry run python3 example.py",

packages/python-sdk/package.json

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "e2b-desktop"
-version = "1.7.1"
+version = "1.7.2"
 description = "E2B Desktop Sandbox - Deskstop sandbox in cloud powered by E2B"
 authors = ["e2b <hello@e2b.dev>"]
 license = "Apache-2.0"

packages/python-sdk/pyproject.toml

@@ -0,0 +1,302 @@
+
+
+
+
+
+## Sandbox
+
+```python
+class Sandbox(SandboxBase)
+```
+
+
+### \_\_init\_\_
+
+```python
+def __init__(resolution: Optional[Tuple[int, int]] = None,
+             dpi: Optional[int] = None,
+             display: Optional[str] = None,
+             template: Optional[str] = None,
+             timeout: Optional[int] = None,
+             metadata: Optional[Dict[str, str]] = None,
+             envs: Optional[Dict[str, str]] = None,
+             api_key: Optional[str] = None,
+             domain: Optional[str] = None,
+             debug: Optional[bool] = None,
+             sandbox_id: Optional[str] = None,
+             request_timeout: Optional[float] = None,
+             proxy: Optional[ProxyTypes] = None)
+```
+
+Create a new desktop sandbox.
+
+By default, the sandbox is created from the `desktop` template.
+
+**Arguments**:
+
+- `resolution`: Startup the desktop with custom screen resolution. Defaults to (1024, 768)
+- `dpi`: Startup the desktop with custom DPI. Defaults to 96
+- `display`: Startup the desktop with custom display. Defaults to ":0"
+- `template`: Sandbox template name or ID
+- `timeout`: Timeout for the sandbox in **seconds**, default to 300 seconds. Maximum time a sandbox can be kept alive is 24 hours (86_400 seconds) for Pro users and 1 hour (3_600 seconds) for Hobby users
+- `metadata`: Custom metadata for the sandbox
+- `envs`: Custom environment variables for the sandbox
+- `api_key`: E2B API Key to use for authentication, defaults to `E2B_API_KEY` environment variable
+- `domain`: E2B domain to use for authentication, defaults to `E2B_DOMAIN` environment variable
+- `debug`: If True, the sandbox will be created in debug mode, defaults to `E2B_DEBUG` environment variable
+- `sandbox_id`: Sandbox ID to connect to, defaults to `E2B_SANDBOX_ID` environment variable
+- `request_timeout`: Timeout for the request in **seconds**
+- `proxy`: Proxy to use for the request and for the requests made to the returned sandbox
+
+**Returns**:
+
+sandbox instance for the new sandbox
+
+
+### screenshot
+
+```python
+@overload
+def screenshot(format: Literal["stream"]) -> Iterator[bytes]
+```
+
+Take a screenshot and return it as a stream of bytes.
+
+
+### screenshot
+
+```python
+@overload
+def screenshot(format: Literal["bytes"]) -> bytearray
+```
+
+Take a screenshot and return it as a bytearray.
+
+
+### screenshot
+
+```python
+def screenshot(format: Literal["bytes", "stream"] = "bytes")
+```
+
+Take a screenshot and return it in the specified format.
+
+**Arguments**:
+
+- `format`: The format of the screenshot. Can be 'bytes', 'blob', or 'stream'.
+
+**Returns**:
+
+The screenshot in the specified format.
+
+
+### left\_click
+
+```python
+def left_click(x: Optional[int] = None, y: Optional[int] = None)
+```
+
+Left click on the mouse position.
+
+
+### double\_click
+
+```python
+def double_click(x: Optional[int] = None, y: Optional[int] = None)
+```
+
+Double left click on the mouse position.
+
+
+### middle\_click
+
+```python
+def middle_click(x: Optional[int] = None, y: Optional[int] = None)
+```
+
+Middle click on the mouse position.
+
+
+### scroll
+
+```python
+def scroll(direction: Literal["up", "down"] = "down", amount: int = 1)
+```
+
+Scroll the mouse wheel by the given amount.
+
+**Arguments**:
+
+- `direction`: The direction to scroll. Can be "up" or "down".
+- `amount`: The amount to scroll.
+
+
+### move\_mouse
+
+```python
+def move_mouse(x: int, y: int)
+```
+
+Move the mouse to the given coordinates.
+
+**Arguments**:
+
+- `x`: The x coordinate.
+- `y`: The y coordinate.
+
+
+### mouse\_press
+
+```python
+def mouse_press(button: Literal["left", "right", "middle"] = "left")
+```
+
+Press the mouse button.
+
+
+### mouse\_release
+
+```python
+def mouse_release(button: Literal["left", "right", "middle"] = "left")
+```
+
+Release the mouse button.
+
+
+### get\_cursor\_position
+
+```python
+def get_cursor_position() -> tuple[int, int]
+```
+
+Get the current cursor position.
+
+**Raises**:
+
+- `RuntimeError`: If the cursor position cannot be determined
+
+**Returns**:
+
+A tuple with the x and y coordinates
+
+
+### get\_screen\_size
+
+```python
+def get_screen_size() -> tuple[int, int]
+```
+
+Get the current screen size.
+
+**Raises**:
+
+- `RuntimeError`: If the screen size cannot be determined
+
+**Returns**:
+
+A tuple with the width and height
+
+
+### write
+
+```python
+def write(text: str, *, chunk_size: int = 25, delay_in_ms: int = 75) -> None
+```
+
+Write the given text at the current cursor position.
+
+**Arguments**:
+
+- `text`: The text to write.
+- `chunk_size`: The size of each chunk of text to write.
+- `delay_in_ms`: The delay between each chunk of text.
+
+
+### press
+
+```python
+def press(key: Union[str, list[str]])
+```
+
+Press a key.
+
+**Arguments**:
+
+- `key`: The key to press (e.g. "enter", "space", "backspace", etc.).
+
+
+### drag
+
+```python
+def drag(fr: tuple[int, int], to: tuple[int, int])
+```
+
+Drag the mouse from the given position to the given position.
+
+**Arguments**:
+
+- `from`: The starting position.
+- `to`: The ending position.
+
+
+### wait
+
+```python
+def wait(ms: int)
+```
+
+Wait for the given amount of time.
+
+**Arguments**:
+
+- `ms`: The amount of time to wait in milliseconds.
+
+
+### open
+
+```python
+def open(file_or_url: str)
+```
+
+Open a file or a URL in the default application.
+
+**Arguments**:
+
+- `file_or_url`: The file or URL to open.
+
+
+### get\_current\_window\_id
+
+```python
+def get_current_window_id() -> str
+```
+
+Get the current window ID.
+
+
+### get\_application\_windows
+
+```python
+def get_application_windows(application: str) -> list[str]
+```
+
+Get the window IDs of all windows for the given application.
+
+
+### get\_window\_title
+
+```python
+def get_window_title(window_id: str) -> str
+```
+
+Get the title of the window with the given ID.
+
+
+### launch
+
+```python
+def launch(application: str, uri: Optional[str] = None)
+```
+
+Launch an application.
+