pycalver 201903.30

如果一切正常，您可以执行pycalver bump

$ pip install pycalver
...
Installing collected packages: click pathlib2 typing toml six pycalver
Successfully installed pycalver-201903.30

$ pycalver --version
pycalver, version v201903.0030

$ cd myproject
~/myproject$ pycalver init --dry
WARNING - File not found: pycalver.toml
Exiting because of '--dry'. Would have written to pycalver.toml:

    [pycalver]current_version="v201902.0001-alpha"version_pattern="{pycalver}"commit=truetag=truepush=true[pycalver.file_patterns]"README.md"=["{version}",
        "{pep440_version}",
    ]"pycalver.toml"=['current_version = "{version}"',
    ]

pycalver格式

版本字符串的pycalver格式有三部分：

$ pip install pycalver
...
Installing collected packages: click pathlib2 typing toml six pycalver
Successfully installed pycalver-201903.30

$ pycalver --version
pycalver, version v201903.0030

$ cd myproject
~/myproject$ pycalver init --dry
WARNING - File not found: pycalver.toml
Exiting because of '--dry'. Would have written to pycalver.toml:

    [pycalver]current_version="v201902.0001-alpha"version_pattern="{pycalver}"commit=truetag=truepush=true[pycalver.file_patterns]"README.md"=["{version}",
        "{pep440_version}",
    ]"pycalver.toml"=['current_version = "{version}"',
    ]

一些示例：

$ pip install pycalver
...
Installing collected packages: click pathlib2 typing toml six pycalver
Successfully installed pycalver-201903.30

$ pycalver --version
pycalver, version v201903.0030

$ cd myproject
~/myproject$ pycalver init --dry
WARNING - File not found: pycalver.toml
Exiting because of '--dry'. Would have written to pycalver.toml:

    [pycalver]current_version="v201902.0001-alpha"version_pattern="{pycalver}"commit=truetag=truepush=true[pycalver.file_patterns]"README.md"=["{version}",
        "{pep440_version}",
    ]"pycalver.toml"=['current_version = "{version}"',
    ]

这种略显冗长的格式在某种程度上是为了区别于 其他的，这样您的包的用户一眼就能看到您的项目 将努力维护一个真正重要的语义：更新== 更好

为了让你相信不破坏东西的好处，这里有一些 Pycalver的灵感来源：

• "投机"Rich的谈话 希基
• 设计马哈茂德的版本 哈希米
• calver.org
• "版本控制的货物崇拜"作者：kartik 阿加兰
• bumpversion项目 Pycalver部分基于此。
• russ cox的"我们的软件依赖性问题"一文

解析

可以使用以下正则表达式分析这些版本字符串：

$ pip install pycalver
...
Installing collected packages: click pathlib2 typing toml six pycalver
Successfully installed pycalver-201903.30

$ pycalver --version
pycalver, version v201903.0030

$ cd myproject
~/myproject$ pycalver init --dry
WARNING - File not found: pycalver.toml
Exiting because of '--dry'. Would have written to pycalver.toml:

    [pycalver]current_version="v201902.0001-alpha"version_pattern="{pycalver}"commit=truetag=truepush=true[pycalver.file_patterns]"README.md"=["{version}",
        "{pep440_version}",
    ]"pycalver.toml"=['current_version = "{version}"',
    ]

~/myproject$ ls
README.md  setup.cfg  setup.py

~/myproject$ pycalver init
WARNING - Couldn't parse setup.cfg: Missing [pycalver] section.
Updated setup.cfg

~/myproject$ ls
README.md  setup.cfg  setup.py

~/myproject$ pycalver init
WARNING - Couldn't parse setup.cfg: Missing [pycalver] section.
Updated setup.cfg

~/myproject$ ls
README.md  setup.cfg  setup.py

~/myproject$ pycalver init
WARNING - Couldn't parse setup.cfg: Missing [pycalver] section.
Updated setup.cfg

~/myproject$ ls
README.md  setup.cfg  setup.py

~/myproject$ pycalver init
WARNING - Couldn't parse setup.cfg: Missing [pycalver] section.
Updated setup.cfg

~/myproject$ ls
README.md  setup.cfg  setup.py

~/myproject$ pycalver init
WARNING - Couldn't parse setup.cfg: Missing [pycalver] section.
Updated setup.cfg

~/myproject$ ls
README.md  setup.cfg  setup.py

~/myproject$ pycalver init
WARNING - Couldn't parse setup.cfg: Missing [pycalver] section.
Updated setup.cfg

~/myproject$ ls
README.md  setup.cfg  setup.py

~/myproject$ pycalver init
WARNING - Couldn't parse setup.cfg: Missing [pycalver] section.
Updated setup.cfg

~/myproject$ ls
README.md  setup.cfg  setup.py

~/myproject$ pycalver init
WARNING - Couldn't parse setup.cfg: Missing [pycalver] section.
Updated setup.cfg

~/myproject$ ls
README.md  setup.cfg  setup.py

~/myproject$ pycalver init
WARNING - Couldn't parse setup.cfg: Missing [pycalver] section.
Updated setup.cfg

如果这看起来有点过分，因为这对你 维护人员，首先考虑在您的工具上投入一些时间，所以 尽可能减少创建新包所需的后续工作。我已经为 我的个人项目，但您可能会发现其他 使其更适合您的使用。

如果因为你不相信 对用户来说很小的负担是一件大事，想想你自己 项目可能间接依赖于数十个库，而您从未 甚至听说过。如果每个维护人员只引入一次中断更改 每年，只依赖于十几个图书馆的用户都要面对 包装问题每个月！换句话说：破坏东西是一件大事 处理< > >。对一些维护人员来说，额外的努力似乎是公平的 为了降低对许多用户的影响，他们非常乐意 继续使用旧代码，直到他们决定何时升级。

无意中断的更改

另一种破坏性的变化是非故意的，否则 被称为"错误"或"回归"。首先要意识到 任何版本控制系统都无法对已发生的情况进行编码： 因为维护人员并不是故意引入一个bug，所以他们自然不能 更新他们的版本号以反映他们不知道的内容。相反 我们必须在事后处理这些问题。

包维护人员可以做的第一件事是将 对用户使用有缺陷的软件。在任何不平凡的（潜在的破坏）之后 更改时，最好先创建-alpha/-beta/-rc版本。 这些所谓的--pre版本只供少数人下载 勇敢者：那些愿意参加测试的人。任何问题之后 通过--pre版本进行修正，可以为 更广泛的公众。

注意，pip install<；package>；的默认行为（不带任何版本 specifier）是下载最新的final版本。它将下载--pre 只有在

1. 没有最终版本版本可用
2. 显式使用--pre标志，或
3. 如果需求说明符显式地包含 预发布，例如pip install mypkg==v201812.0007-alpha

如果一个版本包含了一个bug（天堂禁止，尽管有所有的预防措施）。 然后，维护者应该发布一个新的版本来修复这个bug 或恢复更改。如果用户以前下载了 包中包含了这个bug，他们只需执行pip install--upgrade<；package>；即可解决问题。

也许时间线会更清楚地说明：

# setup.cfg[pycalver]current_version="v201902.0001-alpha"version_pattern="{pycalver}"commit=Truetag=Truepush=True[pycalver:file_patterns]setup.cfg=    current_version = {version}setup.py=    "{version}",    "{pep440_version}",README.md=    {version}    {pep440_version}

# setup.cfg[pycalver]current_version="v201902.0001-alpha"version_pattern="{pycalver}"commit=Truetag=Truepush=True[pycalver:file_patterns]setup.cfg=    current_version = {version}setup.py=    "{version}",    "{pep440_version}",README.md=    {version}    {pep440_version}