#semver #tags #git #management #version

bin+lib rustytag

A semantic version management tool built on Git tags

7 stable releases

new 1.0.18 Feb 10, 2025
1.0.15 Feb 6, 2025
1.0.10 Feb 5, 2025

#974 in Development tools

Download history 503/week @ 2025-02-05

503 downloads per month

MIT license

54KB
1K SLoC

RustyTag

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

English | 简体中文

Crates.io Downloads License

特性

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

安装

使用 Cargo 安装

cargo install rustytag

从源码安装

  1. 克隆仓库:
git clone https://github.com/yourusername/rustytag.git
  1. 构建项目:
cd rustytag
cargo build --release

使用方法

基础命令

# 初始化语义化版本
rustytag init

# 版本升级命令
rustytag patch  # 升级补丁版本 (例如: 1.0.0 -> 1.0.1)
rustytag minor  # 升级次要版本 (例如: 1.0.0 -> 1.1.0)
rustytag major  # 升级主要版本 (例如: 1.0.0 -> 2.0.0)

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

# 信息查看命令
rustytag show   # 显示当前版本信息
rustytag show v1.0.0  # 显示特定标签详情

# 发布管理
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: 按照语义化版本规范升级版本号
  • sync: 将本地标签与远程仓库同步
  • reset: 将本地标签重置为与远程仓库一致
  • show: 显示版本信息
  • release: 管理发布
  • config: 配置 RustyTag 设置,不带参数时显示当前配置信息

贡献

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

许可证

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

致谢

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

Dependencies

~18–35MB
~543K SLoC