首页
/ Gspread 6.2.0版本发布:新增表格扩展与批量合并功能

Gspread 6.2.0版本发布:新增表格扩展与批量合并功能

2025-05-30 11:21:53作者:丁柯新Fawn

gspread作为Python操作Google Sheets的核心库,近期发布了6.2.0版本更新。本次更新带来了多项实用功能增强和错误修复,为开发者提供了更强大的表格操作能力。

核心功能升级

表格扩展功能

新版本引入了expand_table方法,允许开发者动态扩展表格范围。这一功能特别适用于数据量不断增长的业务场景,开发者不再需要手动调整表格范围,可以自动将表格扩展到指定行数或列数。

批量单元格合并

新增的batch_merge方法解决了批量合并单元格的需求。相比之前逐个合并单元格的操作,现在可以一次性提交多个合并请求,显著提升了处理效率。该方法支持多种合并模式,包括行合并、列合并以及区域合并。

错误处理优化

针对API错误处理机制进行了重要改进:

  1. 增强了APIError异常处理逻辑,现在能够更准确地解析Google Sheets API返回的错误信息
  2. 新增了对非JSON格式错误响应的处理能力,当API返回异常响应时会转换为GSpreadException
  3. 移除了将异常作为参数传递给super的冗余代码,使错误处理更加清晰

类型注解增强

本次更新继续强化了类型提示系统:

  1. 完善了测试工具集的类型注解
  2. 修复了default_blank参数的类型标注问题
  3. 更新了多个依赖的类型定义文件

文档改进

  1. 新增了社区ORM扩展包的文档说明
  2. 修正了BackOffHTTPClient的文档描述
  3. 更新了get_all_records方法的文档说明
  4. 添加了batch_merge方法的使用示例

依赖项更新

项目维护了依赖库的最新版本:

  • 升级了mypy至1.11.2版本
  • 更新black代码格式化工具至24.8.0
  • 升级flake8至7.1.1版本
  • 更新了typing-extensions等类型相关依赖

向后兼容性

6.2.0版本保持了良好的向后兼容性,没有引入破坏性变更。开发者可以安全地从6.1.x版本升级,无需修改现有代码。

对于遇到502错误的用户,建议升级到最新版本以获得更稳定的错误处理能力。新版本能够更好地处理Google API端偶尔返回的非标准错误响应。

登录后查看全文
热门项目推荐
相关项目推荐