版本保证¶
本库遵循一个 语义版本控制原则 ,这意味着每次有不兼容的 API 更改时都会更新主要版本。 但是,由于 QQ 方面在破坏性更改方面缺乏保证以及 Python 的相当动态的性质,因此很难辨别哪些可以被视为破坏性更改,哪些不是。 首先要记住的是,重大更改仅适用于 公开记录的函数和类。 如果它没有在此处的文档中列出,那么它就不是公共 API 的一部分,因此必然会发生变化。 这包括以下划线开头的属性或未记录的不带下划线的函数。
注解
以下示例并非详尽无遗。
重大变化的例子¶
将默认参数值更改为其他值。
将没有别名的函数重命名为旧函数。
向事件添加或删除参数。
非重大变化的示例¶
添加或删除私有下划线属性。
将元素添加到一个数据类的
__slots__
。更改函数的行为以修复错误。
文档中的更改。
修改内部 HTTP 处理。
将依赖项升级到新版本,主要版本或其他版本。