Vercel Sandbox Python SDK 1.0 正式发布

Vercel Sandbox Python SDK 1.0 正式发布

💡 原文英文,约200词,阅读约需1分钟。
📝

内容提要

Vercel Sandbox Python SDK 发布 1.0 版,公共 API 稳定,功能与 TypeScript SDK 对齐。该 SDK 可在隔离沙箱中运行 AI 生成代码、测试变更和分析数据集,提供上下文管理器自动清理沙箱,并基于 AnyIO 支持 asyncio 和 Trio 异步,同步代码可使用 vercel.sandbox.sync。安装命令为 uv add 'vercel-sandbox>=1.0'。示例展示从 Git 分支运行 pytest 后自动清理沙箱。从 0.x 升级需注意命令输入输出改为 bytes 等破坏性变更。

🔎

延伸解读

1.0 版本的核心变化

Vercel Sandbox Python SDK 1.0 的主要变化是公共 API 稳定,并与 TypeScript SDK 功能对齐。这意味着 Python 开发者可以依赖稳定的接口,且跨语言使用时行为一致。从 0.x 升级需注意破坏性变更,例如命令输入输出改为 bytes,升级前应查阅发布说明并调整代码。

异步与同步的灵活支持

SDK 基于 AnyIO 提供异步支持,兼容 asyncio 和 Trio 两种异步框架,为不同技术栈的 Python 项目提供选择。同步代码可使用 vercel.sandbox.sync 模块,无需强制改为异步。这种设计降低了集成门槛,适合在现有同步脚本或异步服务中按需选用。

自动清理与典型用例

SDK 提供上下文管理器,在代码块结束时自动清理沙箱,避免资源泄漏。示例展示了从 Git 分支创建沙箱、运行 pytest 测试,退出上下文后自动清理。该模式适合在隔离环境中运行 AI 生成代码、测试变更或分析数据集,减少手动管理沙箱的生命周期。

❓

Q&A

Vercel Sandbox Python SDK 1.0 有什么主要更新?

Vercel Sandbox Python SDK 1.0 正式发布,公共 API 已稳定,功能与 TypeScript SDK 对齐。

Vercel Sandbox Python SDK 可以用来做什么?

可以在隔离沙箱中运行 AI 生成的代码、测试变更和分析数据集。

如何安装 Vercel Sandbox Python SDK?

使用命令 uv add 'vercel-sandbox>=1.0' 安装。

Vercel Sandbox Python SDK 支持异步编程吗?

支持,基于 AnyIO 提供异步支持,兼容 asyncio 和 Trio。同步代码可使用 vercel.sandbox.sync。

从 0.x 升级到 1.0 需要注意哪些破坏性变更?

需要注意命令输入输出改为 bytes 等破坏性变更,建议查看 1.0 发布说明。

如何确保沙箱在使用后自动清理?

SDK 提供上下文管理器,使用 async with 创建沙箱,退出时自动清理。

🏷️

标签

➡️

继续阅读