策略#
版本策略#
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 并查看那里的说明。