策略#

版本策略#

pandas 使用一种宽松的语义化版本规则(SemVer )来管理弃用、API 兼容性和版本号。

pandas 的发布号由 MAJOR.MINOR.PATCH 组成。

API 破坏性更改应仅在**主版本**发布中出现。这些更改将被记录下来,并提供关于更改内容、原因以及如何将现有代码迁移到新行为的清晰指南。

在可能的情况下,将提供弃用路径,而不是直接进行破坏性更改。

pandas 将在**次版本**发布中引入弃用。这些弃将保留现有行为,同时发出警告,提供以下方面的指导:

  • 如果存在替代方案,如何实现类似行为

  • 弃用将在哪个 pandas 版本中强制执行。

我们不会在补丁版本中引入新的弃用。

弃用将仅在**主版本**发布中强制执行。例如,如果某个行为在 pandas 1.2.0 中被弃用,它将继续在 1.x 系列的所有版本中生效,并伴随警告。该行为将在下一个主版本(2.0.0)中发生更改并移除弃用。

备注

pandas 有时会在次版本或补丁版本发布中进行*行为更改*的错误修复。更改是修复错误还是 API 破坏性更改是一个判断问题。我们将尽力而为,并邀请您参与问题跟踪器或邮件列表上的开发讨论。

这些策略不适用于文档中标为**实验性**的功能。pandas 可能会随时更改实验性功能。

Python 支持#

pandas 遵循 NumPy guidelines for Python support

安全策略#

要向 pandas 报告安全漏洞,请访问 pandas-dev/pandas 并查看那里的说明。