使用modver比较Go模块版本变更级别

modver是一个根据语义化版本(SemVer)规则比较Go模块版本变更级别的工具库，可以帮助开发者判断两个版本之间是MAJOR、MINOR还是PATCH级别的变更。

安装modver

go get github.com/bobg/modver/v2

基本使用方法

modver提供了简单的API来比较两个版本字符串：

package main

import (
	"fmt"
	"github.com/bobg/modver/v2"
)

func main() {
	// 比较两个版本
	result, err := modver.Compare("v1.2.3", "v1.2.4")
	if err != nil {
		fmt.Printf("比较出错: %v\n", err)
		return
	}

	switch result {
	case modver.Major:
		fmt.Println("MAJOR版本变更")
	case modver.Minor:
		fmt.Println("MINOR版本变更")
	case modver.Patch:
		fmt.Println("PATCH版本变更")
	case modver.None:
		fmt.Println("版本相同")
	}
}

实际应用示例

以下是一个更完整的示例，展示如何比较Go模块的两个版本：

package main

import (
	"fmt"
	"os"

	"github.com/bobg/modver/v2"
)

func main() {
	if len(os.Args) < 3 {
		fmt.Println("用法: go run main.go <旧版本> <新版本>")
		fmt.Println("示例: go run main.go v1.2.3 v1.3.0")
		return
	}

	oldVer := os.Args[1]
	newVer := os.Args[2]

	result, err := modver.Compare(oldVer, newVer)
	if err != nil {
		fmt.Printf("版本比较错误: %v\n", err)
		return
	}

	fmt.Printf("版本变更分析: %s -> %s\n", oldVer, newVer)
	
	switch result {
	case modver.Major:
		fmt.Println("这是一个MAJOR版本变更 (不兼容的API变更)")
	case modver.Minor:
		fmt.Println("这是一个MINOR版本变更 (向后兼容的功能新增)")
	case modver.Patch:
		fmt.Println("这是一个PATCH版本变更 (向后兼容的问题修正)")
	case modver.None:
		fmt.Println("版本相同")
	}
}

高级用法 - 比较Go模块目录

modver还可以直接比较两个Go模块目录，分析它们之间的变更级别：

package main

import (
	"fmt"
	"os"

	"github.com/bobg/modver/v2"
)

func main() {
	if len(os.Args) < 3 {
		fmt.Println("用法: go run main.go <旧模块目录> <新模块目录>")
		return
	}

	oldDir := os.Args[1]
	newDir := os.Args[2]

	result, err := modver.CompareDirs(oldDir, newDir)
	if err != nil {
		fmt.Printf("目录比较错误: %v\n", err)
		return
	}

	fmt.Printf("模块变更级别分析:\n")
	fmt.Printf("旧目录: %s\n新目录: %s\n", oldDir, newDir)
	
	switch result {
	case modver.Major:
		fmt.Println("检测到MAJOR版本变更")
	case modver.Minor:
		fmt.Println("检测到MINOR版本变更")
	case modver.Patch:
		fmt.Println("检测到PATCH版本变更")
	case modver.None:
		fmt.Println("没有检测到版本变更")
	}
}

处理特殊情况

modver还能处理一些版本比较的特殊情况：

package main

import (
	"fmt"
	"github.com/bobg/modver/v2"
)

func main() {
	// 比较带有预发布版本的标签
	result, _ := modver.Compare("v1.2.3-alpha", "v1.2.3")
	fmt.Println(result) // 输出: Patch (从预发布到正式版视为补丁变更)

	// 比较带有构建元数据的版本
	result, _ = modver.Compare("v1.2.3+build1", "v1.2.3+build2")
	fmt.Println(result) // 输出: None (构建元数据不影响版本比较)
}

集成到CI/CD流程

modver可以方便地集成到CI/CD流程中，自动检查版本变更是否符合预期：

package main

import (
	"fmt"
	"os"

	"github.com/bobg/modver/v2"
)

func main() {
	// 假设我们从环境变量获取版本
	oldVer := os.Getenv("OLD_VERSION")
	newVer := os.Getenv("NEW_VERSION")

	result, err := modver.Compare(oldVer, newVer)
	if err != nil {
		fmt.Printf("版本比较错误: %v\n", err)
		os.Exit(1)
	}

	// 在CI中，我们可能希望禁止MAJOR变更
	if result == modver.Major {
		fmt.Println("错误: 检测到MAJOR版本变更，需要手动确认")
		os.Exit(1)
	}

	fmt.Println("版本变更检查通过")
}

modver是一个强大的工具，可以帮助Go开发者更好地遵循语义化版本规范，确保版本号的变更准确反映了代码变更的实际影响。