Rodent - Go语言版本管理与依赖追踪工具

Rodent 是一个用于 Go 语言项目的轻量级版本管理和依赖追踪工具插件库。它可以帮助开发者更好地管理项目依赖和版本控制。

安装 Rodent

go get github.com/rodent/rodent

主要功能

1. 版本管理

Rodent 提供了简单的版本管理功能，可以帮助你跟踪项目版本号。

package main

import (
	"fmt"
	"github.com/rodent/rodent/version"
)

func main() {
	// 初始化版本管理
	ver := version.New("1.0.0")
	
	// 获取当前版本
	fmt.Println("Current version:", ver.Current())
	
	// 升级版本
	ver.IncrementPatch() // 1.0.1
	ver.IncrementMinor() // 1.1.0
	ver.IncrementMajor() // 2.0.0
	
	// 设置特定版本
	ver.Set("3.2.1")
	
	// 检查版本兼容性
	compatible := ver.IsCompatibleWith("3.0.0")
	fmt.Println("Is compatible with 3.0.0:", compatible)
}

2. 依赖追踪

Rodent 可以扫描你的项目并生成依赖关系图。

package main

import (
	"fmt"
	"github.com/rodent/rodent/dependency"
)

func main() {
	// 初始化依赖追踪器
	tracker := dependency.NewTracker("./go.mod")
	
	// 分析项目依赖
	deps, err := tracker.Analyze()
	if err != nil {
		panic(err)
	}
	
	// 打印依赖信息
	for _, dep := range deps {
		fmt.Printf("Package: %s\n", dep.Path)
		fmt.Printf("Version: %s\n", dep.Version)
		fmt.Printf("Direct: %v\n", dep.Direct)
		fmt.Println("---")
	}
	
	// 检查是否有过期的依赖
	outdated := tracker.CheckOutdated()
	for pkg, info := range outdated {
		fmt.Printf("%s: current %s, latest %s\n", pkg, info.Current, info.Latest)
	}
}

3. 依赖锁定

Rodent 提供了依赖锁定功能，可以确保构建的一致性。

package main

import (
	"github.com/rodent/rodent/lock"
)

func main() {
	// 创建新的锁定文件
	locker := lock.NewLocker("rodent.lock")
	
	// 生成锁定文件
	err := locker.Generate()
	if err != nil {
		panic(err)
	}
	
	// 验证当前依赖是否与锁定文件匹配
	valid, err := locker.Validate()
	if err != nil {
		panic(err)
	}
	
	if !valid {
		println("Warning: dependencies have changed since lock file was generated")
	}
}

4. 依赖可视化

Rodent 可以生成依赖关系图的可视化表示。

package main

import (
	"github.com/rodent/rodent/viz"
)

func main() {
	// 创建可视化生成器
	visualizer := viz.NewVisualizer()
	
	// 生成依赖图
	graph, err := visualizer.GenerateGraph(".")
	if err != nil {
		panic(err)
	}
	
	// 保存为DOT格式
	err = visualizer.SaveAsDOT(graph, "dependencies.dot")
	if err != nil {
		panic(err)
	}
	
	// 也可以保存为PNG (需要Graphviz)
	err = visualizer.SaveAsPNG(graph, "dependencies.png")
	if err != nil {
		println("Could not generate PNG (is Graphviz installed?):", err.Error())
	}
}

高级用法

自定义版本策略

package main

import (
	"fmt"
	"github.com/rodent/rodent/version"
)

// 自定义版本策略
type MyVersionPolicy struct{}

func (p MyVersionPolicy) Validate(v string) bool {
	// 实现自定义验证逻辑
	return true
}

func (p MyVersionPolicy) Compare(v1, v2 string) int {
	// 实现自定义比较逻辑
	return 0
}

func main() {
	ver := version.NewWithPolicy("1.0.0", MyVersionPolicy{})
	
	// 使用自定义策略
	fmt.Println("Version valid:", ver.Validate())
}

依赖过滤

package main

import (
	"fmt"
	"github.com/rodent/rodent/dependency"
)

func main() {
	tracker := dependency.NewTracker("./go.mod")
	
	// 添加过滤器
	tracker.AddFilter(func(dep dependency.Dependency) bool {
		// 只关注直接依赖
		return dep.Direct
	})
	
	deps, err := tracker.Analyze()
	if err != nil {
		panic(err)
	}
	
	fmt.Println("Direct dependencies only:")
	for _, dep := range deps {
		fmt.Println(dep.Path)
	}
}

集成到构建流程

你可以将 Rodent 集成到你的构建脚本中：

package main

import (
	"github.com/rodent/rodent/build"
)

func main() {
	builder := build.NewBuilder().
		WithVersionCheck().
		WithDependencyCheck().
		WithLockValidation()
	
	err := builder.Run()
	if err != nil {
		panic(err)
	}
	
	println("Build completed successfully with all checks passed")
}

Rodent 是一个轻量级但功能强大的工具，可以帮助 Go 开发者更好地管理项目依赖和版本控制。它的模块化设计允许你只使用你需要的功能，而不会给项目带来不必要的负担。