grasp-sdk 0.1.0__py3-none-any.whl

grasp_sdk-0.1.0.dist-info/METADATA

@@ -0,0 +1,201 @@
+Metadata-Version: 2.4
+Name: grasp_sdk
+Version: 0.1.0
+Summary: Python SDK for Grasp E2B - Browser automation and sandbox management
+Home-page: https://github.com/grasp-team/grasp-e2b
+Author: Grasp Team
+Author-email: Grasp Team <team@grasp.com>
+Project-URL: Homepage, https://github.com/grasp-team/grasp-e2b
+Project-URL: Bug Reports, https://github.com/grasp-team/grasp-e2b/issues
+Project-URL: Source, https://github.com/grasp-team/grasp-e2b
+Project-URL: Documentation, https://docs.grasp.com
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
+Classifier: Topic :: System :: Emulators
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: aiohttp>=3.9.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: typing-extensions>=4.8.0
+Requires-Dist: e2b>=1.5.0
+Requires-Dist: e2b-code-interpreter>=1.5.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Provides-Extra: browser
+Requires-Dist: playwright>=1.40.0; extra == "browser"
+Provides-Extra: websocket
+Requires-Dist: websockets>=12.0; extra == "websocket"
+Provides-Extra: validation
+Requires-Dist: pydantic>=2.5.0; extra == "validation"
+Dynamic: author
+Dynamic: home-page
+Dynamic: requires-python
+
+# Grasp SDK - Python Implementation
+
+🐍 Python implementation of Grasp SDK for E2B platform providing secure command execution and browser automation in isolated cloud environments.
+
+## 🚀 Features
+
+- **Secure Execution**: Run commands and scripts in isolated E2B sandboxes
+- **Browser Automation**: Control Chromium browsers with Playwright integration
+- **Async/Await Support**: Full async/await support for modern Python development
+- **Type Safety**: Complete type hints with Pydantic models
+- **WebSocket Communication**: Real-time communication with sandbox environments
+- **Multi-language Support**: Compatible with Node.js/TypeScript version
+
+## 📦 Installation
+
+```bash
+# Install from PyPI (when published)
+pip install grasp-sdk
+
+# Install from source
+pip install -e .
+
+# Install with development dependencies
+pip install -e ".[dev]"
+```
+
+## 🔧 Quick Start
+
+```python
+import asyncio
+from grasp_sdk import GraspServer
+
+async def main():
+    # Initialize Grasp server
+    server = GraspServer({
+        "key": api_key,
+        "timeout": 30000,
+    })
+    
+    try:
+        # Start sandbox
+        await server.start()
+        
+        # Execute command
+        result = await server.execute_command("echo 'Hello from Python!'")
+        print(f"Output: {result.stdout}")
+        
+        # Browser automation
+        browser_task = await server.create_browser_task()
+        await browser_task.navigate("https://example.com")
+        screenshot = await browser_task.screenshot("example.png")
+        
+    finally:
+        # Clean up
+        await server.close()
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## 🏗️ Architecture
+
+The Python implementation mirrors the Node.js/TypeScript version:
+
+```
+py-src/
+├── __init__.py              # Main package exports
+├── grasp_server.py          # Main GraspServer class
+├── services/                # Core services
+│   ├── __init__.py
+│   ├── sandbox_service.py   # E2B sandbox management
+│   └── browser_service.py   # Browser automation
+├── types/                   # Type definitions
+│   └── __init__.py
+├── utils/                   # Utilities
+│   ├── __init__.py
+│   ├── config.py           # Configuration management
+│   ├── logger.py           # Logging utilities
+│   └── auth.py             # Authentication
+├── cli/                     # Command line interface
+│   ├── __init__.py
+│   └── main.py
+└── tests/                   # Test suite
+    └── ...
+```
+
+## 🔑 Environment Variables
+
+```bash
+# Required
+E2B_API_KEY=your_e2b_api_key_here
+
+# Optional
+GRASP_LOG_LEVEL=info
+GRASP_TIMEOUT=30000
+GRASP_TEMPLATE=python
+```
+
+## 🧪 Development
+
+```bash
+# Install development dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Format code
+black .
+isort .
+
+# Type checking
+mypy .
+
+# Linting
+flake8 .
+```
+
+## 📚 API Reference
+
+### GraspServer
+
+Main class for interacting with E2B sandboxes and browser automation.
+
+```python
+class GraspServer:
+    def __init__(self, config: ISandboxConfig = None)
+    async def start(self) -> None
+    async def close(self) -> None
+    async def execute_command(self, command: str, options: ICommandOptions = None) -> CommandResult
+    async def execute_script(self, script_path: str, options: IScriptOptions = None) -> CommandResult
+    async def create_browser_task(self, config: IBrowserConfig = None) -> BrowserTask
+    def get_sandbox_status(self) -> SandboxStatus
+    def get_sandbox_id(self) -> str
+```
+
+## 🤝 Compatibility
+
+This Python implementation provides the same API surface as the Node.js/TypeScript version, ensuring:
+
+- **Feature Parity**: All features available in both implementations
+- **API Consistency**: Same method names and behavior
+- **Type Safety**: Equivalent type definitions using TypedDict and Pydantic
+- **Error Handling**: Consistent error types and messages
+
+## 📄 License
+
+MIT License - see the [LICENSE](../LICENSE) file for details.
+
+## 🔗 Related
+
+- [Node.js/TypeScript Implementation](../src/)
+- [E2B Platform](https://e2b.dev/)
+- [Playwright Python](https://playwright.dev/python/)

grasp_sdk-0.1.0.dist-info/RECORD

@@ -0,0 +1,17 @@
+grasp_sdk/__init__.py,sha256=7P4CFKAv1YgmbEog1s5uKMTVljSC0FDkC4ePhS0j_rE,7475
+grasp_sdk/models/__init__.py,sha256=lAlbb9tG8fsKz1fo2IVr30pGVytU5V-KblDAzZnLbVQ,2738
+grasp_sdk/sandbox/chrome-stable.mjs,sha256=8e20N7tlNRlQZ6bO3qpAdwllCBWE9cdbMN-iEW19F30,11281
+grasp_sdk/sandbox/chromium.mjs,sha256=DTepEfkJ75mQE_nLLRE11ZrnODpjZXw0ahAFaaFSVX4,11477
+grasp_sdk/sandbox/jsconfig.json,sha256=XkAgp68pCDDdHNpggzFb_dYB8hk3MHfJBOsUZZJXNCs,418
+grasp_sdk/services/__init__.py,sha256=HqRD-WRedLwOb2gZPXPFzI-3892VT9IknKSbuDyiss8,327
+grasp_sdk/services/browser.py,sha256=KBLy0ySJ8Zr7-XO_xVENhvP6h5-DLGi5eYDEHd4_CA4,14863
+grasp_sdk/services/sandbox.py,sha256=VFlRuBFe5AjIbTvK80ntWK6xt2dsCfh7MwkUC-1FvpU,21783
+grasp_sdk/utils/__init__.py,sha256=IQzRV-iZJXanSlaXBcgXBCcOXTVBCY6ZujxQpDTGW9w,816
+grasp_sdk/utils/auth.py,sha256=M_SX3uKTjjfi6fzk384IqPvUtqt98bif22HHMgio1D4,7258
+grasp_sdk/utils/config.py,sha256=txnmKQ6nxw-wvOBmr9mkZiWX7ROKwyHQLBpM_Wy9XZI,4171
+grasp_sdk/utils/logger.py,sha256=k6WDmzL3cPTcQbiiTD4Q6fsDdUO_kyXQHz7nlmtv7G4,7228
+grasp_sdk-0.1.0.dist-info/METADATA,sha256=y0oJ0nxQMqEDxzUAWFW6atYg9xcTxwQeFpLF5cwEGDM,6113
+grasp_sdk-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+grasp_sdk-0.1.0.dist-info/entry_points.txt,sha256=roDjUu4JR6b1tUtRmq018mw167AbfC5zQiOtv3o6IMo,45
+grasp_sdk-0.1.0.dist-info/top_level.txt,sha256=C9GL798_aP9Hgjq7UUlaGHLDfUohO2PSGYuGDV0cMx8,10
+grasp_sdk-0.1.0.dist-info/RECORD,,

grasp_sdk-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

grasp_sdk-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+grasp-sdk = grasp_sdk:main

grasp_sdk-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+grasp_sdk