fistbump

一个用于管理项目版本号的小巧命令行工具。

安装

从发布页面获取二进制文件并将其放置在您的PATH路径上。请确保在Linux和MacOS上对二进制文件执行chmod +x。

使用Cargo: 运行cargo install fistbump

macOS

支持macOS 10.7及以上版本。通过Homebrew打包。

使用Brew

brew tap nearengine/tap
brew install nearengine/tap/fistbump

用法

配置

fistbump 使用位于项目目录中的配置文件。要指定配置，请在项目根目录中创建一个名为 .fistbumprc.json 的文件。

示例

{
    "current_version": "0.1.0",
    "files": [
        {
            "path": "Cargo.toml",
            "search": "version = \"{current_version}\"",
            "replace": "version = \"{new_version}\""
        }
    ],
    "search": "{current_version}",
    "replace": "{new_version}"
}

默认值

配置文件中的 search 和 replace 选项是可选的。它们的默认值分别为 {current_version} 和 {new_version}。您可以将这些选项更改为匹配更具体的字符串，但不要忘记在您的字符串中包含 {current_version} 或 {new_version}。它们只能为纯字符串，目前不支持正则表达式。

所需字段仅为 current_version 和 files（每个都必须包含一个 path）。

参数

当您在项目中创建新版本时，请运行 fistbump <version>，其中 <version> 是新版本字符串。例如： fistbump 1.0.0。

环境变量

将 FISTBUMP_LOG_LEVEL 设置为查看详细的日志，在 fistbump 运行时。默认值是 error。有效值有 debug、info、error。查看所有输出的示例：FISTBUMP_LOG_LEVEL=debug fistbump 1.0.0。

开发

运行 FISTBUMP_LOG_LEVEL=debug cargo run -- 1.0.0 来查看所有调试输出。

发布

• fistbump<版本>
• cargo更新
• git提交 -am "<版本>"
• git标签 -a <版本> -m"<发布说明>"
• git推送 --所有
• cargo发布 --dry-run
• cargo发布

贡献

如果 fistbump 让你的生活变得更轻松，考虑通过捐赠到 bitcoin:18Xg5pLi4ueMCpoNHt5of44AirPhzjXXQ2 来进一步支持其开发。

如果你愿意为项目贡献代码，请随时提交现有问题的拉取请求或提交一个增强或错误请求的问题。拉取请求将由维护者自行决定是否合并。