Rust版本管理工具next_version的使用：自动化语义化版本控制和发布流程

概述

next_version是一个Rust库，用于基于conventional commits计算下一个语义化版本。它不会分析git历史，用户需要自己提供commit列表。

安装

在项目目录中运行以下Cargo命令：

cargo add next_version

或者在Cargo.toml中添加以下行：

next_version = "0.2.24"

示例使用

以下是使用next_version的完整示例：

use next_version::NextVersion;
use semver::Version;

fn main() {
    // 当前版本
    let current_version = Version::new(1, 0, 0);
    
    // 模拟一些遵循conventional commits规范的提交消息
    let commits = vec![
        "feat: add new API endpoint",  // 特性提交 - 触发minor版本升级
        "fix: resolve memory leak",    // 修复提交 - 触发patch版本升级
        "chore: update dependencies",  // 维护提交 - 不影响版本
        "feat!: breaking change"       // 破坏性变更 - 触发major版本升级
    ];
    
    // 计算下一个版本
    let next_version = current_version.next(commits);
    
    println!("当前版本: {}", current_version);
    println!("下一个版本: {}", next_version);
}

这个示例会输出:

当前版本: 1.0.0
下一个版本: 2.0.0

工作原理

next_version分析提供的提交消息，根据以下规则确定版本升级类型：

• feat: - 触发minor版本升级
• fix: - 触发patch版本升级
• feat!:或其他包含破坏性变更的提交 - 触发major版本升级
• chore:, docs:等 - 不影响版本号

高级用法

你还可以自定义配置：

use next_version::{NextVersion, VersionIncrement};

fn main() {
    let current_version = Version::new(0, 5, 2);
    let commits = vec![
        "perf: improve rendering speed",
        "docs: update README"
    ];
    
    // 自定义规则：将perf提交视为特性
    let next_version = current_version.next_with_options(
        commits, 
        |commit| {
            if commit.starts_with("perf:") {
                Some(VersionIncrement::Minor)
            } else {
                None
            }
        }
    );
    
    println!("下一个版本: {}", next_version); // 0.6.0
}

完整示例demo

下面是一个更完整的示例，展示如何在实际项目中使用next_version：

use next_version::{NextVersion, VersionIncrement};
use semver::Version;

fn main() {
    // 当前版本
    let current_version = Version::new(0, 1, 0);
    
    // 从git日志中获取的实际提交消息
    let commits = vec![
        "feat: implement user authentication",
        "fix: correct login validation",
        "docs: update API documentation",
        "refactor: improve code structure",
        "feat!: change authentication method",
        "perf: optimize database queries"
    ];
    
    // 标准计算方式
    let next_standard = current_version.next(commits.clone());
    
    // 自定义计算方式 - 将perf视为minor更新
    let next_custom = current_version.next_with_options(
        commits,
        |commit| {
            if commit.starts_with("perf:") {
                Some(VersionIncrement::Minor)
            } else if commit.starts_with("refactor:") {
                Some(VersionIncrement::Patch)
            } else {
                None
            }
        }
    );
    
    println!("当前版本: {}", current_version);
    println!("标准计算的下一个版本: {}", next_standard);
    println!("自定义计算的下一个版本: {}", next_custom);
}

示例输出:

当前版本: 0.1.0
标准计算的下一个版本: 1.0.0
自定义计算的下一个版本: 1.0.0

许可证

next_version采用MIT或Apache-2.0双重许可。