nextver

一个用于解析和递增任意格式版本的库。

该库不遵循特定的版本号方案，允许您定义自己的版本格式，根据它解析版本字符串，并按照语义和/或日历规则递增版本。

还附带了一个 命令行界面。

这是一个文档的简略版本。有关完整文档，请参阅 docs.rs。

示例

以下括号中的文本 < 和 > 是指定符。请参阅它们的含义 这里。

快速获取下一个版本

use nextver::prelude::*;

let next = Sem::next_version_string(
  "<MAJOR>.<MINOR>.<PATCH>",  // format string
  "1.2.3",                    // current version string
  SemLevel::Minor             // the specifier to increment
)?;
assert_eq!(next, "1.3.0");

API 概述

nextver 围绕三个主要概念构建：方案、格式和版本。

• 方案 规定了版本中允许的值类型及其递增规则。（见下表。）它们由 Scheme 特性建模并由以下结构体实现

  • [Sem]: 语义版本号方案。它与 SemVer 类似。
  • CalSem: 日历语义版本号方案。它与 CalVer 类似，但要求显式地包含语义部分。
  • [Cal]: 一种日历版本控制方案。它类似于 CalSem，但没有语义指定符。（由于无法在最低指定符的相同周期内增加版本两次，因此此方案在实践中的用途较小。）

• 格式定义了版本字符串的结构。它们通过Format结构体建模。它们包含一系列指定符和文本字面量令牌。例如，<MAJOR>.<MINOR>.<PATCH>是一个可以转换为Format对象的格式字符串。

• 版本类似于格式，但用实际值而不是指定符表示。它们代表项目开发中的一个点。这些通过Version结构体建模。它们可以被增加到新版本，并相互比较。

格式字符串语法

在格式字符串中使用任何序列的指定符（如下所示）和文本字面量。指定符用<和>括起来。

表

下表“示例”列中，我们引用了主版本为1，次版本为2，补丁为3，日期为2001-02-03（这是第四周）。

cargo install nextver

nextver --help