grasp-sdk 0.2.0b2__tar.gz → 0.2.0b3__tar.gz

{grasp_sdk-0.2.0b2/grasp_sdk.egg-info → grasp_sdk-0.2.0b3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: grasp_sdk
-Version: 0.2.0b2
+Version: 0.2.0b3
 Summary: Python SDK for Grasp E2B - Browser automation and sandbox management
 Home-page: https://github.com/grasp-team/grasp-e2b
 Author: Grasp Team

grasp_sdk-0.2.0b3/examples/grasp-mouse-usage-2.py

@@ -0,0 +1,151 @@
+import asyncio
+import subprocess
+
+import sys
+from pathlib import Path
+from dotenv import load_dotenv
+
+# 添加父目录到 Python 路径，以便导入 grasp_sdk
+sys.path.insert(0, str(Path(__file__).parent.parent))
+
+from grasp_sdk import Grasp
+from playwright.async_api import async_playwright
+import math
+
+# 加载环境变量
+load_dotenv("../.env.grasp")
+
+async def main():
+    grasp = Grasp()
+
+    session = await grasp.launch({
+        "browser": {
+            # "type": "chrome-stable",
+            "headless": False,
+            # "args": [
+            #     "--enable-webgl",
+            #     "--ignore-gpu-blacklist",
+            #     "--use-gl=swiftshader",
+            #     "--headless=false",
+            # ],
+            # "adblock": True,
+            "liveview": True,
+        },
+        "debug": True,
+        "keepAliveMS": 10000,
+        "timeout": 3600000,
+    })
+
+    terminal = session.terminal
+    # response = await terminal.run_command(
+    #     # "node -e \"console.log(process.env)\""
+    #     "Xvfb :1 -screen 0 1024x768x24 & export DISPLAY=:1 && glxinfo | grep \"OpenGL renderer\""
+    # )
+    # response.stdout.pipe(process.stdout)
+    # response.stderr.pipe(process.stderr)
+    # print(await response.json())
+
+    # await session.files.download_file(
+    #     "/home/user/.env.json",
+    #     "./output/.env.json"
+    # )
+
+    ws_url = session.browser.get_endpoint()
+    print(ws_url)
+    
+    async with async_playwright() as p:
+        browser = await p.chromium.connect_over_cdp(ws_url, timeout=150000)
+
+        url = await session.browser.get_liveview_page_url()
+        if url:
+            # 使用 subprocess 打开 URL（替代 Node.js 的 open 包）
+            subprocess.run(["open", url])  # macOS
+            # subprocess.run(["xdg-open", url])  # Linux
+            # subprocess.run(["start", url], shell=True)  # Windows
+
+        page = await browser.new_page()
+
+        # 打开一个可以玩拖拽的网页
+        await page.goto("https://the-internet.herokuapp.com/drag_and_drop")
+
+        box_a = page.locator("#column-a")
+        box_b = page.locator("#column-b")
+
+        box_a_box = await box_a.bounding_box()
+        box_b_box = await box_b.bounding_box()
+        
+        if not box_a_box or not box_b_box:
+            raise Exception("Could not get bounding boxes for elements")
+            
+        mouse = page.mouse
+
+        # 🎯 Step 1: 炫技滑动到 Box A
+        await mouse.move(0, 0, steps=20)
+        await mouse.move(box_a_box["x"] + 30, box_a_box["y"] + 30, steps=40)
+
+        # ⚡ Step 2: 快速点击一次
+        await mouse.click(box_a_box["x"] + 30, box_a_box["y"] + 30)
+
+        # 🧲 Step 3: 拖拽 Box A 到 Box B
+        await mouse.move(box_a_box["x"] + 30, box_a_box["y"] + 30)
+        await mouse.down()
+        await mouse.move(box_b_box["x"] + 30, box_b_box["y"] + 30, steps=50)
+        await mouse.up()
+
+        # 🎡 Step 4: 鼠标绕 Box B 旋转一圈
+        center_x = box_b_box["x"] + box_b_box["width"] / 2
+        center_y = box_b_box["y"] + box_b_box["height"] / 2
+        radius = 40
+        for angle in range(0, 361, 10):
+            rad = (angle * math.pi) / 180
+            x = center_x + radius * math.cos(rad)
+            y = center_y + radius * math.sin(rad)
+            await mouse.move(x, y)
+
+        # 👋 Step 5: 优雅滑出屏幕
+        await mouse.move(center_x + 100, center_y + 500, steps=30)
+
+        # 下载liveview 截屏
+        # screenshots_dir = await session.browser.get_replay_screenshots()
+        # print(screenshots_dir)
+
+        command = await terminal.run_command(
+            "cd /home/user/downloads/grasp-screenshots && ls -1 | grep -v '^filelist.txt$' | sort | awk '{print \"file '\\''\" $0 \"'\\''\"}' > filelist.txt"
+        )
+        await command.end()
+
+        command2 = await terminal.run_command(
+            "cd /home/user/downloads/grasp-screenshots && ffmpeg -r 25 -f concat -safe 0 -i filelist.txt -vsync vfr -pix_fmt yuv420p output.mp4"
+        )
+
+        # Python 中处理流输出的方式
+        def handle_stdout(data):
+            print(data, end="")
+        
+        def handle_stderr(data):
+            print(data, end="")
+        
+        # 注册事件处理器
+        command2.on('stdout', handle_stdout)
+        command2.on('stderr', handle_stderr)
+
+        await command2.end()
+
+        # 创建 ./output 目录
+        Path("./output").mkdir(parents=True, exist_ok=True)
+
+        await asyncio.gather(
+            session.files.download_file(
+                "/home/user/downloads/grasp-screenshots/filelist.txt",
+                "./output/filelist.txt"
+            ),
+            session.files.download_file(
+                "/home/user/downloads/grasp-screenshots/output.mp4",
+                "./output/output.mp4"
+            ),
+        )
+
+        await session.close()
+
+if __name__ == "__main__":
+    asyncio.run(main())

{grasp_sdk-0.2.0b2 → grasp_sdk-0.2.0b3}/examples/test_terminal_updates.py

@@ -111,7 +111,7 @@ async def test_terminal_service():
         mock_sandbox.run_command.return_value = mock_emitter
         
         # Test run_command
-        result = await terminal.run_command('echo "Hello World"', {'timeout_ms': 5000})
+        result = await terminal.run_command('echo "Hello World"', {'timeoutMs': 5000})
         print("✓ run_command executed successfully")
         
         # Verify the command was called with correct options
@@ -152,7 +152,7 @@ async def test_command_options_compatibility():
     # Test that ICommandOptions supports 'inBackground' parameter
     options: ICommandOptions = {
         'inBackground': True,
-        'timeout_ms': 5000,
+        'timeoutMs': 5000,
         'cwd': '/tmp',
         'nohup': False
     }

{grasp_sdk-0.2.0b2 → grasp_sdk-0.2.0b3}/grasp_sdk/__init__.py

@@ -25,7 +25,7 @@ from .grasp import (
 # Import CDPConnection for type annotation
 from .services.browser import CDPConnection
 
-__version__ = "0.2.0b2"
+__version__ = "0.2.0b3"
 __author__ = "Grasp Team"
 __email__ = "team@grasp.dev"
 
@@ -165,7 +165,6 @@ __all__ = [
     'Grasp',
     'GraspSession',
     'GraspBrowser',
-    'GraspTerminal',
     'launch_browser',
     'shutdown',
 ]

{grasp_sdk-0.2.0b2 → grasp_sdk-0.2.0b3}/grasp_sdk/grasp/server.py

@@ -30,6 +30,7 @@ class GraspServer:
         browser_type = sandbox_config.pop('type', 'chromium')
         headless = sandbox_config.pop('headless', True)
         adblock = sandbox_config.pop('adblock', False)
+        liveview = sandbox_config.pop('liveview', False)
         logLevel = sandbox_config.pop('logLevel', '')
         keepAliveMS = sandbox_config.pop('keepAliveMS', 0)
 
@@ -45,6 +46,7 @@ class GraspServer:
             'envs': {
                 'ADBLOCK': 'true' if adblock else 'false',
                 'KEEP_ALIVE_MS': str(keepAliveMS),
+                'ENABLE_LIVEVIEW': 'true' if liveview else 'false',
             }
         }
             

{grasp_sdk-0.2.0b2 → grasp_sdk-0.2.0b3}/grasp_sdk/models/__init__.py

@@ -37,7 +37,7 @@ class IBrowserConfig(TypedDict):
 class ICommandOptions(TypedDict):
     """Command execution options interface."""
     inBackground: NotRequired[bool]  # Whether to run command in background (corresponds to 'background' in TypeScript)
-    timeout_ms: NotRequired[int]  # Timeout in milliseconds (corresponds to 'timeoutMs' in TypeScript)
+    timeoutMs: NotRequired[int]  # Timeout in milliseconds (corresponds to 'timeoutMs' in TypeScript)
     cwd: NotRequired[str]  # Working directory
     user: NotRequired[str]  # User to run the command as (default: 'user')
     envs: NotRequired[Dict[str, str]]  # Environment variables for the command
@@ -49,7 +49,7 @@ class IScriptOptions(TypedDict):
     """Script execution options interface."""
     type: str  # Required: Script type: 'cjs' for CommonJS, 'esm' for ES Modules, 'py' for Python
     cwd: NotRequired[str]  # Working directory
-    timeout_ms: NotRequired[int]  # Timeout in milliseconds
+    timeoutMs: NotRequired[int]  # Timeout in milliseconds
     background: NotRequired[bool]  # Run in background
     user: NotRequired[str]  # User to run the script as (default: 'user')
     nohup: NotRequired[bool]  # Use nohup for background execution (Grasp-specific extension)

{grasp_sdk-0.2.0b2 → grasp_sdk-0.2.0b3}/grasp_sdk/services/browser.py

@@ -186,7 +186,7 @@ class BrowserService:
                 'type': 'esm',
                 'background': True,
                 'nohup': not self.sandbox_service.is_debug,
-                'timeout_ms': 0,
+                'timeoutMs': 0,
                 'preCommand': ''
             }
             

{grasp_sdk-0.2.0b2 → grasp_sdk-0.2.0b3}/grasp_sdk/services/sandbox.py

@@ -286,7 +286,7 @@ class SandboxService:
             options = {}
         
         cwd = options.get('cwd', self.DEFAULT_WORKING_DIRECTORY)
-        timeout_ms = options.get('timeout_ms', 0)
+        timeoutMs = options.get('timeoutMs', 0)
         use_nohup = options.get('nohup', False)
         in_background = options.get('inBackground', False)
         envs = options.get('envs', {})
@@ -299,7 +299,7 @@ class SandboxService:
             self.logger.debug('Running command in sandbox', {
                 'command': command,
                 'cwd': cwd,
-                'timeout': timeout_ms,
+                'timeout': timeoutMs,
                 'nohup': use_nohup,
                 'background': in_background
             })
@@ -319,7 +319,7 @@ class SandboxService:
                     result = await self.sandbox.commands.run(
                         final_command,
                         cwd=cwd,
-                        timeout=timeout_ms // 1000,
+                        timeout=timeoutMs // 1000,
                         envs=envs,
                         background=in_background,
                         user=user,
@@ -345,7 +345,7 @@ class SandboxService:
                     await self.sandbox.commands.run(
                         nohup_command,
                         cwd=cwd,
-                        timeout=timeout_ms // 1000,
+                        timeout=timeoutMs // 1000,
                         envs=envs,
                         background=in_background,
                         user=user,
@@ -365,7 +365,7 @@ class SandboxService:
                             handle = await commands_attr.run(
                                 command,
                                 cwd=cwd,
-                                timeout=timeout_ms // 1000,
+                                timeout=timeoutMs // 1000,
                                 background=True,
                                 envs=envs,
                                 user=user,
@@ -473,7 +473,7 @@ class SandboxService:
             # Prepare command options
             cmd_options: Optional[Any] = {
                 'cwd': options.get('cwd'),
-                'timeout_ms': options.get('timeout_ms', 0),
+                'timeoutMs': options.get('timeoutMs', 0),
                 'inBackground': options.get('background', False),
                 'nohup': options.get('nohup', False),
                 'envs': envs,

{grasp_sdk-0.2.0b2 → grasp_sdk-0.2.0b3/grasp_sdk.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: grasp_sdk
-Version: 0.2.0b2
+Version: 0.2.0b3
 Summary: Python SDK for Grasp E2B - Browser automation and sandbox management
 Home-page: https://github.com/grasp-team/grasp-e2b
 Author: Grasp Team

{grasp_sdk-0.2.0b2 → grasp_sdk-0.2.0b3}/grasp_sdk.egg-info/SOURCES.txt

@@ -12,6 +12,7 @@ setup.py
 ./examples/example_binary_file_support.py
 ./examples/example_grasp_usage.py
 ./examples/example_readfile_usage.py
+./examples/grasp-mouse-usage-2.py
 ./examples/grasp_terminal.py
 ./examples/grasp_usage.py
 ./examples/test_async_context.py
@@ -40,6 +41,7 @@ examples/example_async_context.py
 examples/example_binary_file_support.py
 examples/example_grasp_usage.py
 examples/example_readfile_usage.py
+examples/grasp-mouse-usage-2.py
 examples/grasp_terminal.py
 examples/grasp_usage.py
 examples/test_async_context.py

{grasp_sdk-0.2.0b2 → grasp_sdk-0.2.0b3}/grasp_sdk.egg-info/top_level.txt

@@ -1,3 +1,4 @@
 dist
 examples
 grasp_sdk
+output

{grasp_sdk-0.2.0b2 → grasp_sdk-0.2.0b3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "grasp_sdk"
-version = "0.2.0b2"
+version = "0.2.0b3"
 authors = [
     {name = "Grasp Team", email = "team@grasp.com"},
 ]