弃用受支持的Python版本时,我应该碰到SemVer的哪一部分?

时间:2019-05-14 17:35:49

标签: python semantic-versioning python-packaging

如果一个库同时支持Python 2和3,并且我想弃用对Python 2的支持,那么我应该对SemVer的哪一部分进行改动,主要还是次要?

1 个答案:

答案 0 :(得分:3)

弃用不会破坏(或真正改变)任何东西;这是一个官方的,明确的预先警告,表示将来某些版本中 会发生更改。

SemVar规范专门指出to bump the minor version

  
      
  1. 如果向公共API引入了新的,向后兼容的功能,则必须增加次要版本Y(x.Y.z | x> 0)。 如果任何公共API功能被标记为已弃用,则必须递增。如果在私有代码中引入了实质性的新功能或改进,则可以递增。它可能包括补丁级别的改变。当次要版本增加时,修补程序版本必须重置为0。
  2.   

实际上 删除支持后,这是向后不兼容的更改:不再适用于Python 2用户。现在是时候to bump the major version number了。

  
      
  1. 如果向公共API引入了任何向后不兼容的更改,则必须增加主版本X(X.y.z | X> 0)。它可能包括次要级别和补丁级别更改。当主要版本增加时,补丁和次要版本必须重置为0。
  2.