15.3.0

用法 - 额外参数

可以通过传递额外的命令行标志来更改下一个语义版本的计算内容和方式。

用法 - Git环境变量

在查找仓库时，会尊重Git环境变量。当设置${GIT_DIR}时，它具有优先级，并且常规提交下一个版本开始在该目录中查找仓库。如果没有设置${GIT_DIR}，常规提交下一个版本从当前目录开始查找仓库。

用法 - 日志记录

使用crate pretty_env_logger 和 log 提供日志记录。可以使用环境变量 RUST_LOG 来设置日志级别。有关更详细的文档，请参阅 https://crates.io/crates/pretty_env_logger。

CICD 示例

GitLab CI Rust 项目示例

通过 Cargo

有关通过Cargo安装的更多详细信息，请参阅 通过Cargo编译。

注意 - 此示例下载了最新的 6.* 版本。

conventional-commits-next-version-checking:
    stage: conventional-commits-next-version-checking
    image: rust
    before_script:
        - cargo install conventional_commits_next_version --version ^6
    script:
        # Get current version.
        - current_version=$(grep "^version = \"[0-9][0-9]*.[0-9][0-9]*.[0-9][0-9]*\"$" "Cargo.toml" | cut -d '"' -f 2)
        # Get latest tag.
        - latest_tag=$(git tag --sort=committerdate | tail -1)
        # Check current vs expected.
        - /usr/local/cargo/bin/conventional_commits_next_version --calculation-mode "Batch" --from-reference "${latest_tag}" --from-version "${latest_tag}" --current-version "${current_version}"
    rules:
        - if: $CI_MERGE_REQUEST_ID

通过二进制下载

有关二进制下载的更多详细信息，请参阅 下载二进制文件。

注意 - 此示例下载了版本 6.0.0。

conventional-commits-next-version-checking:
    stage: conventional-commits-next-version-checking
    image: rust
    before_script:
        - wget -q -O tmp.zip "https://gitlab.com/DeveloperC/conventional_commits_next_version/-/jobs/artifacts/bin-6.0.0/download?job=release-binary-compiling-x86_64-linux-musl" && unzip tmp.zip && rm tmp.zip
    script:
        # Get current version.
        - current_version=$(grep "^version = \"[0-9][0-9]*.[0-9][0-9]*.[0-9][0-9]*\"$" "Cargo.toml" | cut -d '"' -f 2)
        # Get latest tag.
        - latest_tag=$(git tag --sort=committerdate | tail -1)
        # Check current vs expected.
        - ./conventional_commits_next_version --calculation-mode "Batch" --from-reference "${latest_tag}" --from-version "${latest_tag}" --current-version "${current_version}"
    rules:
        - if: $CI_MERGE_REQUEST_ID

Git Hooks Rust 项目示例

一个示例 commit-msg Git钩子，用于检查由于提交消息而是否需要增加Rust项目的语义版本。

#!/usr/bin/env bash

set -o errexit
set -o pipefail

commit_message=$(cat "${1}")

# Get current version in the commit to be made.
current_version=$(grep "^version = \"[0-9][0-9]*.[0-9][0-9]*.[0-9][0-9]*\"$" "Cargo.toml" | cut -d '"' -f 2)
# Get latest version on the remote HEAD.
head_version=$(git show remotes/origin/HEAD:Cargo.toml | grep "^version = \"[0-9][0-9]*.[0-9][0-9]*.[0-9][0-9]*\"$" "Cargo.toml" | cut -d '"' -f 2)

# Check current commits version vs expected because of the new commit's message.
echo "${commit_message}" | "${HOME}/.cargo/bin/conventional_commits_next_version" --from-stdin --from-version "${head_version}" --current-version "${current_version}"

下载二进制文件

提供可下载的静态链接编译的二进制文件。访问https://gitlab.com/DeveloperC/conventional_commits_next_version/-/releases上的发行页面，以查看所有发行版，发行说明中包含各种架构的二进制文件下载链接。

如果您不相信提供的二进制文件，另一种选择是自行编译并在远程下载它，这样您的CICD等就可以下载它。

通过本地仓库编译

在本地检出代码仓库，切换到仓库目录，然后通过Cargo构建。使用--release标志可以生成优化的二进制文件，但编译时间更长。

git clone [email protected]:DeveloperC/conventional_commits_next_version.git
cd conventional_commits_next_version/
cargo build --release

编译的二进制文件位于target/release/conventional_commits_next_version。

通过 Cargo 编译

Cargo是Rust包管理器，install子命令从crates.io获取，然后在本地编译二进制文件，将编译的二进制文件放置在${HOME}/.cargo/bin/conventional_commits_next_version。

cargo install conventional_commits_next_version

默认情况下，在执行时安装最新版本。您可以使用--version参数指定要安装的特定版本。对于CICD等某些环境，您可能想锁定版本。

例如：

cargo install conventional_commits_next_version --version 6.0.0

与其锁定到特定版本，您还可以指定主版本或次要版本。

例如：

cargo install conventional_commits_next_version --version ^6

将下载最新的6.*版本，无论它是6.0.2还是6.2.0

cargo test

cargo build
cd conventional_commits_next_version/end-to-end-tests/
virtualenv -p python3 .venv
source .venv/bin/activate
pip3 install -r requirements.txt
behave