RustyTag

一个基于 Git 标签的语义化版本管理工具

English | 简体中文

特性

• 基于 Git 标签的语义化版本管理
• 完整的语义化版本支持
• 自动版本升级（patch/minor/major）
• 本地标签与远程仓库同步
• 版本对比功能
• 轻量快速
• 跨平台支持

安装

使用 Cargo 安装

cargo install rustytag

从源码安装

1. 克隆仓库：

git clone https://github.com/yourusername/rustytag.git

2. 构建项目：

cd rustytag
cargo build --release

使用方法

基础命令

# 初始化语义化版本
rustytag init

# 版本升级命令
rustytag patch                    # 升级补丁版本 (例如: 1.0.0 -> 1.0.1)
rustytag patch -V 1.2.3          # 直接设置为指定版本 1.2.3
rustytag minor                    # 升级次要版本 (例如: 1.0.0 -> 1.1.0)
rustytag minor --version 2.0.0   # 直接设置为指定版本 2.0.0
rustytag major                    # 升级主要版本 (例如: 1.0.0 -> 2.0.0)
rustytag major -V 3.0.0          # 直接设置为指定版本 3.0.0

# 标签同步命令
rustytag sync   # 同步本地标签与远程仓库
rustytag reset  # 重置本地标签以匹配远程仓库

# 信息查看命令
rustytag show          # 显示当前项目和版本信息
rustytag show --quiet  # 仅输出当前版本
rustytag show --json   # 以 JSON 输出项目信息

# 发布管理
rustytag release                  # 创建发布
rustytag release -l               # 列出所有发布
rustytag release --list           # 列出所有发布
rustytag release -t v1.0.0        # 为指定版本创建发布
rustytag release --tag v1.0.0     # 为指定版本创建发布

# 配置管理
rustytag config                   # 显示当前配置信息
rustytag config --set KEY=VALUE  # 设置配置项

命令详解

版本管理命令

• init: 初始化新的 Git 仓库并设置语义化版本
• patch/minor/major: 按照语义化版本规范升级版本号
  • 不带参数：自动递增版本号
  • 带 -V 或 --version 参数：直接设置为指定版本

标签同步命令

• sync: 将本地标签与远程仓库同步
• reset: 将本地标签重置为与远程仓库一致

信息查看命令

• show: 显示当前项目和工具的详细信息
  • -q 或 --quiet：仅输出当前版本，适合脚本使用
  • --json：以机器可读的 JSON 输出项目信息
  • --quiet 与 --json 不能同时使用

发布管理命令

• release: 管理 GitHub 发布
  • 不带参数：为当前版本创建发布
  • -l 或 --list：列出所有发布
  • -t 或 --tag：为指定版本创建发布

配置管理命令

• config: 配置 RustyTag 设置
  • 不带参数：显示当前配置信息
  • --set KEY=VALUE：设置配置项
  • --global：写入用户配置 ~/.rustytag.json
  • --local：写入仓库配置 .rustytag.json
  • 加载顺序：用户配置 → 仓库配置 → CLI 参数，后者覆盖前者
  • 检测到 tag 前缀时，会自动写入仓库配置

使用示例

基本工作流程

# 1. 初始化项目
rustytag init

# 2. 开发完成后，升级版本
rustytag patch              # 修复 bug，升级补丁版本
rustytag minor              # 新增功能，升级次要版本  
rustytag major              # 破坏性更改，升级主要版本

# 3. 推送到远程仓库
git push --follow-tags origin main

# 4. 创建 GitHub 发布
rustytag release

高级用法

# 直接设置特定版本
rustytag patch -V 1.2.3
rustytag minor --version 2.0.0

# 查看项目信息
rustytag show
rustytag show --quiet
rustytag show --json

# 同步远程标签
rustytag sync

# 配置 GitHub Token（用于发布管理）
rustytag config --set GITHUB_TOKEN=your_token_here

# 为当前仓库设置 Go 风格的 tag 前缀
rustytag config --set VERSION_PREFIX=v

贡献

欢迎贡献！详情请参阅 CONTRIBUTING.md。

许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件。

致谢

• 灵感来源于 Git 的原生标签功能
• 使用 Rust 构建以确保性能和安全性