chore: 规范标点
This commit is contained in:
pluv committed
1 parent
e54390a9f8
commit
15e79887fa
84 files changed
+5439
-5398
No files matched your search
+41
-41
@@ -1,47 +1,47 @@
|
||||
#!/bin/sh
|
||||
# get-version.sh - 算出版本号，供 Makefile 用 -D 注入
|
||||
# get-version.sh - 算出版本号, 供 Makefile 用 -D 注入
|
||||
#
|
||||
# 输出六行（顺序固定，Makefile 按行取）：
|
||||
# 输出六行 (顺序固定, Makefile 按行取)：
|
||||
# 1. CalVer 主版本号 YYYY.MM.DD
|
||||
# 2. git 短哈希 abc1234 / 1a2b3c4.dirty / unknown
|
||||
# 3. 分支名 master / unknown（detached HEAD 或非 git）
|
||||
# 4. 构建日期 YYYY-MM-DD（UTC）
|
||||
# 5. 构建时间 HH:MM:SS（UTC）
|
||||
# 6. 本脚本算出的版本串（仅供人看/调试）
|
||||
# 3. 分支名 master / unknown (detached HEAD 或非 git)
|
||||
# 4. 构建日期 YYYY-MM-DD (UTC)
|
||||
# 5. 构建时间 HH:MM:SS (UTC)
|
||||
# 6. 本脚本算出的版本串 (仅供人看/调试)
|
||||
#
|
||||
# 版本方案：**CalVer（发布日的 YYYY.MM.DD）+ git 短哈希**。
|
||||
# 版本方案：**CalVer (发布日的 YYYY.MM.DD)+ git 短哈希**.
|
||||
#
|
||||
# 2026.02.14 打在 tag 上的发布版
|
||||
# 2026.02.14-1a2b3c4 tag 之后又提交了
|
||||
# 2026.02.14-1a2b3c4.dirty 工作区还有没提交的改动
|
||||
#
|
||||
# 为什么 CalVer 而不是 SemVer：ligent 是个终端工具，不是被别人链接的库，
|
||||
# "第几个大版本"这种信息对它没什么用；"这是哪天的东西"才有用 —— 用户看到
|
||||
# 2026.02.14 立刻知道新旧。真需要表达破坏性变更时，git 历史和 README 比版本
|
||||
# 号数字说得清楚。
|
||||
# 为什么 CalVer 而不是 SemVer：ligent 是个终端工具, 不是被别人链接的库,
|
||||
# "第几个大版本"这种信息对它没什么用; "这是哪天的东西"才有用 —— 用户看到
|
||||
# 2026.02.14 立刻知道新旧. 真需要表达破坏性变更时, git 历史和 README 比版本
|
||||
# 号数字说得清楚.
|
||||
#
|
||||
# 为什么还要带哈希：CalVer 的粒度是"天"，同一天可能发好几次；而且用户手上
|
||||
# 的二进制未必来自 tag（可能自己改了源码）。带上哈希，报 bug 时能精确定位。
|
||||
# 为什么还要带哈希：CalVer 的粒度是"天", 同一天可能发好几次; 而且用户手上
|
||||
# 的二进制未必来自 tag (可能自己改了源码). 带上哈希, 报 bug 时能精确定位.
|
||||
#
|
||||
# 分隔符用 "-" 而不是 git describe 传统的 "+g"：我们只用 git，不存在"区分是
|
||||
# 哪种 SCM"的需求（那正是 g 前缀存在的理由），而 2026.09.22-1a2b3c4 少两个
|
||||
# 符号、念起来也顺。
|
||||
# 分隔符用 "-" 而不是 git describe 传统的 "+g"：我们只用 git, 不存在"区分是
|
||||
# 哪种 SCM"的需求 (那正是 g 前缀存在的理由), 而 2026.09.22-1a2b3c4 少两个
|
||||
# 符号、念起来也顺.
|
||||
#
|
||||
# 取版本号的优先级（从高到低）：
|
||||
# 1. 环境变量 LIGENT_VERSION_OVERRIDE —— 给 CI 用，tag 打得不对时能手动指定
|
||||
# 2. git tag 里最新的 CalVer 形态的 tag（v2026.02.14 或 2026.02.14）
|
||||
# 3. 源码目录的 mtime（从 tarball 解出来时没有 .git，用文件的日期当版本）
|
||||
# 取版本号的优先级 (从高到低)：
|
||||
# 1. 环境变量 LIGENT_VERSION_OVERRIDE —— 给 CI 用, tag 打得不对时能手动指定
|
||||
# 2. git tag 里最新的 CalVer 形态的 tag (v2026.02.14 或 2026.02.14)
|
||||
# 3. 源码目录的 mtime (从 tarball 解出来时没有 .git, 用文件的日期当版本)
|
||||
#
|
||||
# 任何一步失败都不算致命：退回一个明确的默认值，绝不让构建挂掉 ——
|
||||
# 版本号不对只是难看，构建挂掉是真的不能用。
|
||||
# 任何一步失败都不算致命：退回一个明确的默认值, 绝不让构建挂掉 ——
|
||||
# 版本号不对只是难看, 构建挂掉是真的不能用.
|
||||
set -eu
|
||||
|
||||
ROOT=$(cd "$(dirname "$0")/.." && pwd)
|
||||
|
||||
# ------------------------------------------------------- 构建日期与时间
|
||||
# SOURCE_DATE_EPOCH 是"可复现构建"的标准约定：设了它就用它当构建时间，
|
||||
# 这样同一个源码在不同时间编出来的二进制是**逐字节相同**的。
|
||||
# 不认这个约定的话，CI 上每次构建的产物哈希都不一样，没法校验。
|
||||
# SOURCE_DATE_EPOCH 是"可复现构建"的标准约定：设了它就用它当构建时间,
|
||||
# 这样同一个源码在不同时间编出来的二进制是**逐字节相同**的.
|
||||
# 不认这个约定的话, CI 上每次构建的产物哈希都不一样, 没法校验.
|
||||
if [ -n "${SOURCE_DATE_EPOCH:-}" ]; then
|
||||
BUILD_DATE=$(date -u -d "@$SOURCE_DATE_EPOCH" +%Y-%m-%d 2>/dev/null \
|
||||
|| date -u -r "$SOURCE_DATE_EPOCH" +%Y-%m-%d 2>/dev/null \
|
||||
@@ -61,17 +61,17 @@ else
|
||||
CALVER=
|
||||
# 只在真的在 git 工作区里、且 git 可用时才问 git
|
||||
if command -v git >/dev/null 2>&1 && [ -d "$ROOT/.git" ]; then
|
||||
# 找最近的、长得像 CalVer 的 tag。用 grep 过滤而不是 --match：不同
|
||||
# git 版本对 --match 的 glob 支持略有差异，而这里只要"第一个符合
|
||||
# YYYY.MM.DD 形态的"就够了，过滤更直观也更可移植。
|
||||
# 找最近的、长得像 CalVer 的 tag. 用 grep 过滤而不是 --match：不同
|
||||
# git 版本对 --match 的 glob 支持略有差异, 而这里只要"第一个符合
|
||||
# YYYY.MM.DD 形态的"就够了, 过滤更直观也更可移植.
|
||||
CALVER=$(git -C "$ROOT" tag --list 2>/dev/null \
|
||||
| grep -E '^v?[0-9]{4}\.[0-9]{2}\.[0-9]{2}$' \
|
||||
| sed 's/^v//' \
|
||||
| sort \
|
||||
| tail -1 || true)
|
||||
fi
|
||||
# 没有 tag：用源码目录的日期当版本。tarball 场景下这是"这份源码什么时候
|
||||
# 打的包"，虽然不如 tag 精确，但比写死一个 0.0.0 有用。
|
||||
# 没有 tag：用源码目录的日期当版本. tarball 场景下这是"这份源码什么时候
|
||||
# 打的包", 虽然不如 tag 精确, 但比写死一个 0.0.0 有用.
|
||||
if [ -z "$CALVER" ]; then
|
||||
CALVER=$(date -u -r "$ROOT/src/main.c" +%Y.%m.%d 2>/dev/null || true)
|
||||
fi
|
||||
@@ -79,14 +79,14 @@ else
|
||||
fi
|
||||
|
||||
# ---------------------------------------------------------------- git 哈希
|
||||
# LIGENT_HASH_OVERRIDE：给容器/CI 用。容器里没有 .git（.dockerignore 排除了），
|
||||
# 那里问不出哈希来，只能由外面算好传进来。
|
||||
# LIGENT_HASH_OVERRIDE：给容器/CI 用. 容器里没有 .git (.dockerignore 排除了),
|
||||
# 那里问不出哈希来, 只能由外面算好传进来.
|
||||
HASH=${LIGENT_HASH_OVERRIDE:-}
|
||||
if [ -z "$HASH" ] && command -v git >/dev/null 2>&1 && [ -d "$ROOT/.git" ]; then
|
||||
if h=$(git -C "$ROOT" rev-parse --short=7 HEAD 2>/dev/null); then
|
||||
HASH=$h
|
||||
# 工作区脏了就标出来。**这一条很重要**：不带这个标记的话，一个改过
|
||||
# 源码的构建和一个干净的构建会报出同样的版本号，排查时会被误导。
|
||||
# 工作区脏了就标出来. **这一条很重要**：不带这个标记的话, 一个改过
|
||||
# 源码的构建和一个干净的构建会报出同样的版本号, 排查时会被误导.
|
||||
if ! git -C "$ROOT" diff --quiet HEAD -- 2>/dev/null; then
|
||||
HASH="$HASH.dirty"
|
||||
elif [ -n "$(git -C "$ROOT" ls-files --others --exclude-standard 2>/dev/null)" ]; then
|
||||
@@ -98,13 +98,13 @@ fi
|
||||
[ -n "$HASH" ] || HASH=unknown
|
||||
|
||||
# ---------------------------------------------------------------- 分支名
|
||||
# LIGENT_BRANCH_OVERRIDE 同理给容器/CI 用。
|
||||
# LIGENT_BRANCH_OVERRIDE 同理给容器/CI 用.
|
||||
BRANCH=${LIGENT_BRANCH_OVERRIDE:-}
|
||||
if [ -z "$BRANCH" ] && command -v git >/dev/null 2>&1 && [ -d "$ROOT/.git" ]; then
|
||||
b=$(git -C "$ROOT" rev-parse --abbrev-ref HEAD 2>/dev/null || true)
|
||||
# detached HEAD（CI 上 checkout 某个 tag/commit 时就是这种状态）会返回
|
||||
# 字面量 "HEAD" —— 那不是分支名，照实说成 unknown，别让读的人以为
|
||||
# 有个叫 HEAD 的分支。
|
||||
# detached HEAD (CI 上 checkout 某个 tag/commit 时就是这种状态)会返回
|
||||
# 字面量 "HEAD" —— 那不是分支名, 照实说成 unknown, 别让读的人以为
|
||||
# 有个叫 HEAD 的分支.
|
||||
if [ -n "$b" ] && [ "$b" != "HEAD" ]; then
|
||||
BRANCH=$b
|
||||
fi
|
||||
@@ -116,9 +116,9 @@ printf '%s\n' "$HASH"
|
||||
printf '%s\n' "$BRANCH"
|
||||
printf '%s\n' "$BUILD_DATE"
|
||||
printf '%s\n' "$BUILD_TIME"
|
||||
# 第 6 行只是给人看的完整串。哈希未知时**不要**拼出 "…-unknown" ——
|
||||
# 那既丑又会被误读成一个真实的哈希。src/version.c 的拼接遵循同一规则，
|
||||
# 两处必须一致，否则这个"调试输出"会误导人。
|
||||
# 第 6 行只是给人看的完整串. 哈希未知时**不要**拼出 "…-unknown" ——
|
||||
# 那既丑又会被误读成一个真实的哈希. src/version.c 的拼接遵循同一规则,
|
||||
# 两处必须一致, 否则这个"调试输出"会误导人.
|
||||
if [ "$HASH" = unknown ]; then
|
||||
printf '%s\n' "$CALVER"
|
||||
else
|
||||
|
||||
Reference in new issue
Block a user