python-sandbox-sdk 1.0.1__tar.gz → 1.0.2__tar.gz

{python_sandbox_sdk-1.0.1 → python_sandbox_sdk-1.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-sandbox-sdk
-Version: 1.0.1
+Version: 1.0.2
 Summary: Python SDK for Python Sandbox API - Run Python code, shell commands, and manage packages in Docker containers
 Home-page: https://github.com/zjwan461/python-sandbox
 Author-email: Jerry <826935261@qq.com>
@@ -45,7 +45,8 @@ Python Sandbox 官方 Python SDK — 在隔离的 Docker 容器中执行 Python
 - 🔌 **上下文管理器**：自动管理 HTTP 连接与会话生命周期
 - 🛡️ **异常体系**：独立的 `ApiRequestError` / `SandboxError` 类型
 - 🧵 **线程安全**：`requests.Session` 复用，支持 `ThreadPoolExecutor` 并发
-- 🐍 **Python ≥ 3.8**：仅依赖 `requests>=2.31.0`
+- ⚡ **异步支持**：提供 `AsyncSandboxClient`，基于 `aiohttp` 实现完整异步 API
+- 🐍 **Python ≥ 3.8**：同步客户端仅依赖 `requests>=2.31.0`
 
 ## 📦 安装
 
@@ -57,6 +58,9 @@ pip install python-sandbox-sdk
 git clone https://github.com/zjwan461/python-sandbox.git
 cd python-sandbox/sdk/python-sandbox-sdk
 pip install -e .
+
+# 安装异步支持（可选）
+pip install python-sandbox-sdk[async]
 ```
 
 ## 🚀 快速开始
@@ -112,7 +116,6 @@ content = client.read_file(session_id, "/tmp/config.json")
 client.upload_file(session_id, "/tmp/image.png", b"\\x89PNG...")
 data = client.download_file(session_id, "/tmp/image.png")
 ```
-
 ## 📚 使用样例（覆盖全部 API 与典型场景）
 
 完整可运行样例见 [`usage/`](usage/) 目录：
@@ -130,6 +133,8 @@ data = client.download_file(session_id, "/tmp/image.png")
 | [`09_long_running.py`](usage/09_long_running.py) | 长任务：进度回报 + 异常安全 | `exec_python`, `exec_shell` |
 | [`10_concurrent_sessions.py`](usage/10_concurrent_sessions.py) | 并发：`ThreadPoolExecutor` + 上限约束 | 多会话并行 |
 | [`11_error_handling.py`](usage/11_error_handling.py) | 错误全景：鉴权 / 会话 / 黑名单 / 网络 | 全 API 错误路径 |
+| [`12_async_client.py`](usage/12_async_client.py) | 异步客户端：完整异步操作示例 | 全 API 异步版本 |
+| [`11_error_handling.py`](usage/11_error_handling.py) | 错误全景：鉴权 / 会话 / 黑名单 / 网络 | 全 API 错误路径 |
 
 运行样例：
 
@@ -160,6 +165,8 @@ for f in 0[1-9]_*.py 1[0-1]_*.py; do python "$f"; done
 
 `CommandResult` 字段：`exit_code`, `stdout`, `stderr`, `success`（property）, `combined_output`（property）。
 
+> 💡 **异步版本**：`AsyncSandboxClient` 提供完全相同的 API，所有方法均为 `async`，支持 `await` 调用和 `async with` 上下文管理器。
+
 ## ⚙️ 环境变量
 
 为避免硬编码，样例通过环境变量注入连接信息：
@@ -189,6 +196,8 @@ except OSError as e:
 
 ## 🧵 并发使用
 
+### 同步并发（ThreadPoolExecutor）
+
 ```python
 from concurrent.futures import ThreadPoolExecutor
 # 每个任务使用独立的 client + session（线程安全）
@@ -198,6 +207,33 @@ with ThreadPoolExecutor(max_workers=5) as pool:
         print(f.result())
 ```
 
+### 异步并发（AsyncSandboxClient）
+
+```python
+import asyncio
+from python_sandbox_sdk import AsyncSandboxClient
+
+async def run_task(task_id):
+    async with AsyncSandboxClient("http://localhost:8080", "sandbox-secret-key") as client:
+        session_id = await client.create_session()
+        try:
+            result = await client.exec_python(
+                session_id, f"print('Task {task_id} done')"
+            )
+            return result.stdout
+        finally:
+            await client.delete_session(session_id)
+
+async def main():
+    # 并发执行 5 个任务
+    tasks = [run_task(i) for i in range(5)]
+    results = await asyncio.gather(*tasks)
+    for r in results:
+        print(r)
+
+asyncio.run(main())
+```
+
 > ⚠️ 并发数受后端 `sandbox.max-containers`（默认 10）约束。
 
 ## 📦 打包发布

{python_sandbox_sdk-1.0.1 → python_sandbox_sdk-1.0.2}/README.md

@@ -14,7 +14,8 @@ Python Sandbox 官方 Python SDK — 在隔离的 Docker 容器中执行 Python
 - 🔌 **上下文管理器**：自动管理 HTTP 连接与会话生命周期
 - 🛡️ **异常体系**：独立的 `ApiRequestError` / `SandboxError` 类型
 - 🧵 **线程安全**：`requests.Session` 复用，支持 `ThreadPoolExecutor` 并发
-- 🐍 **Python ≥ 3.8**：仅依赖 `requests>=2.31.0`
+- ⚡ **异步支持**：提供 `AsyncSandboxClient`，基于 `aiohttp` 实现完整异步 API
+- 🐍 **Python ≥ 3.8**：同步客户端仅依赖 `requests>=2.31.0`
 
 ## 📦 安装
 
@@ -26,6 +27,9 @@ pip install python-sandbox-sdk
 git clone https://github.com/zjwan461/python-sandbox.git
 cd python-sandbox/sdk/python-sandbox-sdk
 pip install -e .
+
+# 安装异步支持（可选）
+pip install python-sandbox-sdk[async]
 ```
 
 ## 🚀 快速开始
@@ -81,7 +85,6 @@ content = client.read_file(session_id, "/tmp/config.json")
 client.upload_file(session_id, "/tmp/image.png", b"\\x89PNG...")
 data = client.download_file(session_id, "/tmp/image.png")
 ```
-
 ## 📚 使用样例（覆盖全部 API 与典型场景）
 
 完整可运行样例见 [`usage/`](usage/) 目录：
@@ -99,6 +102,8 @@ data = client.download_file(session_id, "/tmp/image.png")
 | [`09_long_running.py`](usage/09_long_running.py) | 长任务：进度回报 + 异常安全 | `exec_python`, `exec_shell` |
 | [`10_concurrent_sessions.py`](usage/10_concurrent_sessions.py) | 并发：`ThreadPoolExecutor` + 上限约束 | 多会话并行 |
 | [`11_error_handling.py`](usage/11_error_handling.py) | 错误全景：鉴权 / 会话 / 黑名单 / 网络 | 全 API 错误路径 |
+| [`12_async_client.py`](usage/12_async_client.py) | 异步客户端：完整异步操作示例 | 全 API 异步版本 |
+| [`11_error_handling.py`](usage/11_error_handling.py) | 错误全景：鉴权 / 会话 / 黑名单 / 网络 | 全 API 错误路径 |
 
 运行样例：
 
@@ -129,6 +134,8 @@ for f in 0[1-9]_*.py 1[0-1]_*.py; do python "$f"; done
 
 `CommandResult` 字段：`exit_code`, `stdout`, `stderr`, `success`（property）, `combined_output`（property）。
 
+> 💡 **异步版本**：`AsyncSandboxClient` 提供完全相同的 API，所有方法均为 `async`，支持 `await` 调用和 `async with` 上下文管理器。
+
 ## ⚙️ 环境变量
 
 为避免硬编码，样例通过环境变量注入连接信息：
@@ -158,6 +165,8 @@ except OSError as e:
 
 ## 🧵 并发使用
 
+### 同步并发（ThreadPoolExecutor）
+
 ```python
 from concurrent.futures import ThreadPoolExecutor
 # 每个任务使用独立的 client + session（线程安全）
@@ -167,6 +176,33 @@ with ThreadPoolExecutor(max_workers=5) as pool:
         print(f.result())
 ```
 
+### 异步并发（AsyncSandboxClient）
+
+```python
+import asyncio
+from python_sandbox_sdk import AsyncSandboxClient
+
+async def run_task(task_id):
+    async with AsyncSandboxClient("http://localhost:8080", "sandbox-secret-key") as client:
+        session_id = await client.create_session()
+        try:
+            result = await client.exec_python(
+                session_id, f"print('Task {task_id} done')"
+            )
+            return result.stdout
+        finally:
+            await client.delete_session(session_id)
+
+async def main():
+    # 并发执行 5 个任务
+    tasks = [run_task(i) for i in range(5)]
+    results = await asyncio.gather(*tasks)
+    for r in results:
+        print(r)
+
+asyncio.run(main())
+```
+
 > ⚠️ 并发数受后端 `sandbox.max-containers`（默认 10）约束。
 
 ## 📦 打包发布

{python_sandbox_sdk-1.0.1 → python_sandbox_sdk-1.0.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-sandbox-sdk"
-version = "1.0.1"
+version = "1.0.2"
 description = "Python SDK for Python Sandbox API - Run Python code, shell commands, and manage packages in Docker containers"
 readme = "README.md"
 requires-python = ">=3.8"

{python_sandbox_sdk-1.0.1 → python_sandbox_sdk-1.0.2}/python_sandbox_sdk/__init__.py

@@ -15,4 +15,4 @@ __all__ = [
     'ApiKeyMissingError',
     'ApiRequestError',
 ]
-__version__ = '1.0.1'
+__version__ = '1.0.2'

{python_sandbox_sdk-1.0.1 → python_sandbox_sdk-1.0.2}/python_sandbox_sdk/async_client.py

@@ -15,8 +15,7 @@
     Hello!
 """
 
-import os
-import tempfile
+import io
 from typing import Optional
 
 import aiohttp
@@ -266,31 +265,27 @@ class AsyncSandboxClient:
             container_path: 容器内目标路径
             data: 文件字节数据
         """
-        # 写入临时文件
-        fd, tmp_path = tempfile.mkstemp(prefix="sandbox_upload_")
-        try:
-            with os.fdopen(fd, "wb") as f:
-                f.write(data)
-
-            url = f"{self.base_url}/api/sandbox/file/upload"
-            form = aiohttp.FormData()
-            form.add_field(
-                "file",
-                open(tmp_path, "rb"),
-                filename=os.path.basename(container_path),
-            )
-            form.add_field("sessionId", session_id)
-            form.add_field("path", container_path)
-
-            # 上传使用独立的 session，避免继承主 session 的 Content-Type
-            upload_timeout = aiohttp.ClientTimeout(total=120)
-            async with aiohttp.ClientSession(timeout=upload_timeout) as upload_session:
-                upload_session.headers.update({"X-Api-Key": self.api_key})
-                async with upload_session.post(url, data=form) as resp:
-                    await self._raise_if_error(resp)
-        finally:
-            if os.path.exists(tmp_path):
-                os.unlink(tmp_path)
+        import os
+
+        url = f"{self.base_url}/api/sandbox/file/upload"
+        
+        # 使用 BytesIO 避免临时文件和阻塞 I/O
+        file_obj = io.BytesIO(data)
+        form = aiohttp.FormData()
+        form.add_field(
+            "file",
+            file_obj,
+            filename=os.path.basename(container_path),
+        )
+        form.add_field("sessionId", session_id)
+        form.add_field("path", container_path)
+
+        # 上传使用独立的 session，避免继承主 session 的 Content-Type
+        upload_timeout = aiohttp.ClientTimeout(total=120)
+        async with aiohttp.ClientSession(timeout=upload_timeout) as upload_session:
+            upload_session.headers.update({"X-Api-Key": self.api_key})
+            async with upload_session.post(url, data=form) as resp:
+                await self._raise_if_error(resp)
 
     async def download_file(self, session_id: str, container_path: str) -> bytes:
         """

{python_sandbox_sdk-1.0.1 → python_sandbox_sdk-1.0.2}/python_sandbox_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-sandbox-sdk
-Version: 1.0.1
+Version: 1.0.2
 Summary: Python SDK for Python Sandbox API - Run Python code, shell commands, and manage packages in Docker containers
 Home-page: https://github.com/zjwan461/python-sandbox
 Author-email: Jerry <826935261@qq.com>
@@ -45,7 +45,8 @@ Python Sandbox 官方 Python SDK — 在隔离的 Docker 容器中执行 Python
 - 🔌 **上下文管理器**：自动管理 HTTP 连接与会话生命周期
 - 🛡️ **异常体系**：独立的 `ApiRequestError` / `SandboxError` 类型
 - 🧵 **线程安全**：`requests.Session` 复用，支持 `ThreadPoolExecutor` 并发
-- 🐍 **Python ≥ 3.8**：仅依赖 `requests>=2.31.0`
+- ⚡ **异步支持**：提供 `AsyncSandboxClient`，基于 `aiohttp` 实现完整异步 API
+- 🐍 **Python ≥ 3.8**：同步客户端仅依赖 `requests>=2.31.0`
 
 ## 📦 安装
 
@@ -57,6 +58,9 @@ pip install python-sandbox-sdk
 git clone https://github.com/zjwan461/python-sandbox.git
 cd python-sandbox/sdk/python-sandbox-sdk
 pip install -e .
+
+# 安装异步支持（可选）
+pip install python-sandbox-sdk[async]
 ```
 
 ## 🚀 快速开始
@@ -112,7 +116,6 @@ content = client.read_file(session_id, "/tmp/config.json")
 client.upload_file(session_id, "/tmp/image.png", b"\\x89PNG...")
 data = client.download_file(session_id, "/tmp/image.png")
 ```
-
 ## 📚 使用样例（覆盖全部 API 与典型场景）
 
 完整可运行样例见 [`usage/`](usage/) 目录：
@@ -130,6 +133,8 @@ data = client.download_file(session_id, "/tmp/image.png")
 | [`09_long_running.py`](usage/09_long_running.py) | 长任务：进度回报 + 异常安全 | `exec_python`, `exec_shell` |
 | [`10_concurrent_sessions.py`](usage/10_concurrent_sessions.py) | 并发：`ThreadPoolExecutor` + 上限约束 | 多会话并行 |
 | [`11_error_handling.py`](usage/11_error_handling.py) | 错误全景：鉴权 / 会话 / 黑名单 / 网络 | 全 API 错误路径 |
+| [`12_async_client.py`](usage/12_async_client.py) | 异步客户端：完整异步操作示例 | 全 API 异步版本 |
+| [`11_error_handling.py`](usage/11_error_handling.py) | 错误全景：鉴权 / 会话 / 黑名单 / 网络 | 全 API 错误路径 |
 
 运行样例：
 
@@ -160,6 +165,8 @@ for f in 0[1-9]_*.py 1[0-1]_*.py; do python "$f"; done
 
 `CommandResult` 字段：`exit_code`, `stdout`, `stderr`, `success`（property）, `combined_output`（property）。
 
+> 💡 **异步版本**：`AsyncSandboxClient` 提供完全相同的 API，所有方法均为 `async`，支持 `await` 调用和 `async with` 上下文管理器。
+
 ## ⚙️ 环境变量
 
 为避免硬编码，样例通过环境变量注入连接信息：
@@ -189,6 +196,8 @@ except OSError as e:
 
 ## 🧵 并发使用
 
+### 同步并发（ThreadPoolExecutor）
+
 ```python
 from concurrent.futures import ThreadPoolExecutor
 # 每个任务使用独立的 client + session（线程安全）
@@ -198,6 +207,33 @@ with ThreadPoolExecutor(max_workers=5) as pool:
         print(f.result())
 ```
 
+### 异步并发（AsyncSandboxClient）
+
+```python
+import asyncio
+from python_sandbox_sdk import AsyncSandboxClient
+
+async def run_task(task_id):
+    async with AsyncSandboxClient("http://localhost:8080", "sandbox-secret-key") as client:
+        session_id = await client.create_session()
+        try:
+            result = await client.exec_python(
+                session_id, f"print('Task {task_id} done')"
+            )
+            return result.stdout
+        finally:
+            await client.delete_session(session_id)
+
+async def main():
+    # 并发执行 5 个任务
+    tasks = [run_task(i) for i in range(5)]
+    results = await asyncio.gather(*tasks)
+    for r in results:
+        print(r)
+
+asyncio.run(main())
+```
+
 > ⚠️ 并发数受后端 `sandbox.max-containers`（默认 10）约束。
 
 ## 📦 打包发布