时间戳

首页 > 解决方案 > 补丁是否可以在 SemVer 中包含添加内容？

python - 补丁是否可以在 SemVer 中包含添加内容？

问题描述

我正在尝试为我正在开发的 python 包采用版本控制系统（我对这些系统非常陌生），并且我一直在阅读语义版本控制。我非常喜欢这个系统，但在某些情况下我会重新考虑，特别是对于这样的事情：

假设（愚蠢的例子）我们的 v0.1.0 包有一个Bob有几个方法的类：

class Bob:
    def __init__(self, age, coolness):
        self.age = age
        self.coolness = coolness

    def says_hi(self):
        return "Hi!"

    def says_bye(self):
        return "Bye!"

假设我们添加以下极其简单的方法：

    def says_good_day(self):
        return "Good day!"

...现在是一个极其复杂的方法：

    def explains_the_meaning_of_life(self):
        ... # bob explains it here

根据语义版本控制规则，任何向后兼容的添加都应该将次要版本增加 1。因此，如果我们分别实现这两种方法，我们现在已经增加到 v0.3.0。但是我发现我们会为这两个向后兼容的添加分配相同的“权重”是不寻常的，尽管事实上一个非常简单，一个非常复杂。您能否证明将第一个添加分配为补丁更新而将第二个添加为次要更新？我是否通过甚至考虑“复杂”与“简单”添加来误解语义版本控制的意义，即添加只是添加？

标签： pythonversion-controlsemantic-versioning

解决方案

我是否通过甚至考虑“复杂”与“简单”添加来误解语义版本控制的意义，即添加只是添加？

是的，我会这么说。语义版本控制并不关心更改的复杂性，而是更改对升级到新版本的现有客户的影响。在这种情况下，影响是相同的：以向后兼容的方式添加了一个新功能。

推荐阅读