chore: 规范标点
This commit is contained in:
pluv committed
1 parent
15e79887fa
commit
3dd2231c70
81 files changed
+1751
-1751
No files matched your search
+35
-35
@@ -1,7 +1,7 @@
|
||||
#!/bin/sh
|
||||
# build-static-deps.sh - 造一份"musl 工具链编出来的静态 libcurl", 给 make static 用.
|
||||
#
|
||||
# 为什么需要它：发行版的 libcurl.a 是针对 glibc 编的, 跟 musl 混link会得到一堆
|
||||
# 为什么需要它: 发行版的 libcurl.a 是针对 glibc 编的, 跟 musl 混link会得到一堆
|
||||
# "undefined reference to __libc_start_main". 所以必须自己用 musl 工具链把
|
||||
# libcurl 和它的依赖 (zlib、OpenSSL)编一遍.
|
||||
#
|
||||
@@ -46,7 +46,7 @@ need() {
|
||||
need make
|
||||
need "$CC"
|
||||
need perl # OpenSSL 的 Configure
|
||||
# 下载靠它. 以前这里写的是 `need curl || true` —— 那是**假的容错**：need 失败时
|
||||
# 下载靠它. 以前这里写的是 `need curl || true` —— 那是**假的容错**: need 失败时
|
||||
# 直接 exit, `|| true` 根本执行不到 (那句注释"下面会再确认"也不成立). 于是缺
|
||||
# curl 时脚本会一路跑到 fetch, 最后报"所有候选地址都不可用 / 要么是没网, 要么
|
||||
# 是版本号写错了", 把人引去查网络和版本号 —— 而真正的原因是工具没装.
|
||||
@@ -57,7 +57,7 @@ need tar
|
||||
# OpenSSL 的 Configure 要一个明确的 target 名, 它**不做**自动探测. 以前这里
|
||||
# 写死 linux-x86_64, 于是在 aarch64/riscv64 上会去编 x86 的汇编, 直接失败 ——
|
||||
# 而这个脚本的产物恰恰是"拷到别的机器也能跑"的静态件.
|
||||
# 认不出来时**不猜**：猜错的后果是编出一堆看着像成功、其实不对的东西.
|
||||
# 认不出来时**不猜**: 猜错的后果是编出一堆看着像成功、其实不对的东西.
|
||||
OPENSSL_TARGET=${OPENSSL_TARGET:-}
|
||||
if [ -z "$OPENSSL_TARGET" ]; then
|
||||
case "$(uname -m)" in
|
||||
@@ -71,7 +71,7 @@ if [ -z "$OPENSSL_TARGET" ]; then
|
||||
loongarch64) OPENSSL_TARGET=linux64-loongarch64 ;; # 3.1+ 才有
|
||||
*)
|
||||
echo "认不出这台机器的架构 ($(uname -m)), 而 OpenSSL 的 Configure" >&2
|
||||
echo "需要一个明确的 target 名. 请显式指定, 例如：" >&2
|
||||
echo "需要一个明确的 target 名. 请显式指定, 例如: " >&2
|
||||
echo " OPENSSL_TARGET=linux-aarch64 $0" >&2
|
||||
echo " (可用的 target 见 OpenSSL 源码里的 Configurations/10-main.conf)" >&2
|
||||
exit 1 ;;
|
||||
@@ -80,27 +80,27 @@ fi
|
||||
|
||||
# 刻意**不带** -fno-pie. 依赖库编成默认的 PIE 兼容代码就行 —— PIC 代码放进
|
||||
# 非 PIE 可执行文件是合法的, 最后那一步由 ligent 自己用 -no-pie 决定.
|
||||
# 反过来 (依赖 -fno-pie、链接却不带 -no-pie)会立刻炸：这些项目在 make 里
|
||||
# 反过来 (依赖 -fno-pie、链接却不带 -no-pie)会立刻炸: 这些项目在 make 里
|
||||
# 还会顺手链几个测试程序, 而那些链接用的是默认的 PIE, 于是
|
||||
# relocation R_X86_64_32 against ... can not be used when making a PIE object
|
||||
# 而且 zlib 的 configure 探测 vsnprintf 也会因此失败, 悄悄退化成不安全的
|
||||
# vsprintf 版本 (实测踩过).
|
||||
# 体积优先. 静态产物是"拷过去就能跑"的发布件, 不是拿来调试的, 所以这里的
|
||||
# 取舍和普通构建相反 —— 目标是越小越好. 三组开关要一起上才有意义：
|
||||
# 取舍和普通构建相反 —— 目标是越小越好. 三组开关要一起上才有意义:
|
||||
# -Os 别做以体积换速度的展开/内联
|
||||
# -ffunction-sections 依赖库也按函数分段, 这样最后链接时
|
||||
# -fdata-sections --gc-sections 才**丢得掉**没被引用的部分
|
||||
# -fno-*-unwind-tables C 代码不需要 C++ 异常和栈回溯, .eh_frame 全省
|
||||
# 实测 (连同 Makefile 那侧的 strip 等一起)：6.24 MB → 3.29 MB.
|
||||
# 其中这一半的功劳很大：libcurl+OpenSSL 的 .text 从 3.45 MB 掉到 2.41 MB ——
|
||||
# 实测 (连同 Makefile 那侧的 strip 等一起): 6.24 MB → 3.29 MB.
|
||||
# 其中这一半的功劳很大: libcurl+OpenSSL 的 .text 从 3.45 MB 掉到 2.41 MB ——
|
||||
# 静态归档里本来就有一大堆我们永远走不到的算法和协议实现.
|
||||
# 想回到调试友好 (-O2、保留 unwind 表)：CFLAGS_COMMON="-O2 $0"
|
||||
# 想回到调试友好 (-O2、保留 unwind 表): CFLAGS_COMMON="-O2 $0"
|
||||
CFLAGS_COMMON=${CFLAGS_COMMON:-"-Os -ffunction-sections -fdata-sections -fno-asynchronous-unwind-tables -fno-unwind-tables"}
|
||||
|
||||
# musl-gcc 只搜 /usr/lib/musl/include, **不搜 /usr/include**, 于是内核的 UAPI
|
||||
# 头 (linux/mman.h、asm/*.h 这些)找不到 —— OpenSSL 就死在这一步：
|
||||
# 头 (linux/mman.h、asm/*.h 这些)找不到 —— OpenSSL 就死在这一步:
|
||||
# fatal error: linux/mman.h: No such file or directory
|
||||
# 用 -idirafter：musl 自己的头优先, /usr/include 只在 musl 没有时兜底.
|
||||
# 用 -idirafter: musl 自己的头优先, /usr/include 只在 musl 没有时兜底.
|
||||
# 直接写 -I 会让 glibc 的头盖过 musl 的, 那是另一个坑.
|
||||
UAPI_INC="-idirafter /usr/include"
|
||||
|
||||
@@ -110,14 +110,14 @@ UAPI_INC="-idirafter /usr/include"
|
||||
# 记得把 BUILD_DEFS 加一**才能被发现; 忘了就继续用旧参数编出来的库, 症状是
|
||||
# "我明明加了个 --disable-x, 怎么产物一点没变".
|
||||
|
||||
# zlib 只要 --static：我们要的是 libz.a
|
||||
# zlib 只要 --static: 我们要的是 libz.a
|
||||
ZLIB_CONFIGURE_ARGS="--static"
|
||||
|
||||
# OpenSSL：no-shared 只出 .a; no-tests 少编一堆测试程序 (省几分钟);
|
||||
# OpenSSL: no-shared 只出 .a; no-tests 少编一堆测试程序 (省几分钟);
|
||||
# no-legacy 去掉已淘汰的算法 (体积).
|
||||
OPENSSL_CONFIGURE_ARGS="no-shared no-tests no-legacy"
|
||||
|
||||
# curl：ligent 只用 chat/completions 一个端点, 所以只要能发 HTTPS 的那部分.
|
||||
# curl: ligent 只用 chat/completions 一个端点, 所以只要能发 HTTPS 的那部分.
|
||||
# --disable-* FTP/邮件/字典/… 这些协议编进来纯属占地
|
||||
# --without-* 静态链接下每个"可选增强"都会再拖一串依赖进来 (libpsl、idn2、
|
||||
# brotli、zstd、nghttp2/3…), 而 ligent 一个都不用
|
||||
@@ -138,21 +138,21 @@ mkdir -p "$SRC" "$PREFIX"
|
||||
# 编译选项变了就得把依赖整个重建. 否则下面每个守卫都会看到 libz.a 已存在而
|
||||
# 直接跳过, 于是你一直用着旧选项编出来的库, 而且**看不出来** —— 症状是
|
||||
# "我明明加了 -Os, 怎么产物一点没小".
|
||||
# 这和 Makefile 里"对象目录按编译器/插桩分标签"是同一个坑的两处：make 和这个
|
||||
# 这和 Makefile 里"对象目录按编译器/插桩分标签"是同一个坑的两处: make 和这个
|
||||
# 脚本都只看文件在不在, 看不见命令行变了.
|
||||
STAMP="$PREFIX/.build-flags"
|
||||
# BUILD_DEFS：配方版本号, 留给"改了脚本逻辑、但 WANT 里的文本一个字都没变"的
|
||||
# BUILD_DEFS: 配方版本号, 留给"改了脚本逻辑、但 WANT 里的文本一个字都没变"的
|
||||
# 改动 (比如换了一种绕坑的处理方式). 凡是会改变产物内容的改动都要加一.
|
||||
#
|
||||
# 注意它现在**不再是唯一的触发源**：编译选项、三个版本号、OpenSSL target、
|
||||
# 注意它现在**不再是唯一的触发源**: 编译选项、三个版本号、OpenSSL target、
|
||||
# 每个库的 configure 参数都直接进了下面的 WANT, 改它们会自动触发重建, 不需要
|
||||
# 谁记得来这里加一 —— 以前 configure 参数不在 WANT 里, 全靠这个手写数字兜着,
|
||||
# 而人是会忘的 (忘了就是"一直用旧参数编出来的库, 看不出来").
|
||||
# 已有的历史值：1 = 加了体积优先的 CFLAGS; 2 = configure 期间藏起 .pc 文件;
|
||||
# 已有的历史值: 1 = 加了体积优先的 CFLAGS; 2 = configure 期间藏起 .pc 文件;
|
||||
# 3 = 架构与 configure 参数进指纹 (本版).
|
||||
BUILD_DEFS=3
|
||||
|
||||
# 多行参数折叠成一行：好塞进戳文件, 也好肉眼比对
|
||||
# 多行参数折叠成一行: 好塞进戳文件, 也好肉眼比对
|
||||
flatten() {
|
||||
printf '%s' "$1" | tr -s '[:space:]' ' ' | sed 's/^ *//; s/ *$//'
|
||||
}
|
||||
@@ -164,7 +164,7 @@ WANT="defs=$BUILD_DEFS | CC=$CC | zlib=$ZLIB_VER openssl=$OPENSSL_VER curl=$CURL
|
||||
| curl:[$(flatten "$CURL_CONFIGURE_ARGS")]"
|
||||
if [ ! -f "$STAMP" ] && [ -f "$PREFIX/lib/libz.a" ]; then
|
||||
# 有库却没有选项记录 —— 那是**旧版脚本**编的, 不知道用的什么选项.
|
||||
# 这一条不能省：没有它, 下面的判断会认为"stamp 不存在 = 不用重建",
|
||||
# 这一条不能省: 没有它, 下面的判断会认为"stamp 不存在 = 不用重建",
|
||||
# 然后我们就给旧库写上一个声称是新选项的 stamp, 把它洗白成"新的".
|
||||
echo "== 这个前缀没有编译选项记录 (旧版脚本编的), 重建以确认选项一致"
|
||||
rm -rf "$PREFIX"
|
||||
@@ -208,8 +208,8 @@ fetch() {
|
||||
echo " 这个地址不行, 换下一个"
|
||||
rm -f "$out.part"
|
||||
done
|
||||
echo " 下载 $(basename "$out") 失败：所有候选地址都不可用. " >&2
|
||||
echo " 要么是没网, 要么是版本号写错了. 可以指定版本重来, 例如：" >&2
|
||||
echo " 下载 $(basename "$out") 失败: 所有候选地址都不可用. " >&2
|
||||
echo " 要么是没网, 要么是版本号写错了. 可以指定版本重来, 例如: " >&2
|
||||
echo " ZLIB=1.3.1 OPENSSL=3.5.0 CURL=8.11.1 $0" >&2
|
||||
exit 1
|
||||
}
|
||||
@@ -269,30 +269,30 @@ if [ ! -x "$PREFIX/bin/curl-config" ]; then
|
||||
|
||||
# ---- configure 期间把 .pc 文件藏起来, 别让它走 pkg-config ----
|
||||
#
|
||||
# curl 的 configure 是这么挑 OpenSSL 的 (--with-openssl 给的是自定义前缀)：
|
||||
# curl 的 configure 是这么挑 OpenSSL 的 (--with-openssl 给的是自定义前缀):
|
||||
# OPENSSL_PCDIR="$OPT_OPENSSL/lib/pkgconfig"
|
||||
# if test -f "$OPENSSL_PCDIR/openssl.pc"; then PKGTEST="yes" # 用 pkg-config
|
||||
# ...
|
||||
# if test "$PKGTEST" != "yes"; then
|
||||
# SSL_LDFLAGS="-L$PREFIX_OPENSSL/lib" # 直接给目录, 路径原样
|
||||
#
|
||||
# 走 pkg-config 那条路会出事：configure 开头就 `LC_ALL=C; export LC_ALL`
|
||||
# 走 pkg-config 那条路会出事: configure 开头就 `LC_ALL=C; export LC_ALL`
|
||||
# (autoconf 的标准开头, 脚本外面设 LC_ALL 压不住它), 而 pkg-config 在
|
||||
# C locale 下用 isprint() 判断字节要不要转义 —— 每个 >= 0x80 的字节都被判成
|
||||
# "不可打印", 于是它给路径里每个非 ASCII 字节前面加个反斜杠：
|
||||
# "不可打印", 于是它给路径里每个非 ASCII 字节前面加个反斜杠:
|
||||
# -L/…/开发/… -> -L/…/\开\发/…
|
||||
# \ 后面跟 E5 不是合法续字节, 所以那串是**非法 UTF-8**. curl 拿到就写进
|
||||
# curl-config、libcurl.pc 和一堆 Makefile (实测 26 个文件).
|
||||
#
|
||||
# 后果不只是难看：之后 `make static` 里 `curl-config --static-libs` 一打印,
|
||||
# 后果不只是难看: 之后 `make static` 里 `curl-config --static-libs` 一打印,
|
||||
# 坏字节就顺着工具输出进了对话历史, 服务端会以
|
||||
# invalid unicode code point
|
||||
# 拒掉**整个**请求, 而且坏数据已在历史里, 之后每次请求都失败.
|
||||
#
|
||||
# 本仓库路径带中文, 所以必中; 纯 ASCII 路径的人永远碰不到.
|
||||
# 让 .pc 暂时消失, curl 就退回上面那条"直接给目录"的路, 路径干干净净.
|
||||
# 藏而不是删：这些 .pc 是 OpenSSL/zlib 正常安装的一部分, 别人可能要用.
|
||||
# PCDIR/PCHIDE 和恢复用的 trap 在脚本开头 (restore_pc)：这几步要几分钟,
|
||||
# 藏而不是删: 这些 .pc 是 OpenSSL/zlib 正常安装的一部分, 别人可能要用.
|
||||
# PCDIR/PCHIDE 和恢复用的 trap 在脚本开头 (restore_pc): 这几步要几分钟,
|
||||
# 中途 Ctrl-C 很常见, 不能让 .pc 在没人知道的情况下"消失"一段.
|
||||
restore_pc # 上一次被打断留下的隐藏目录, 先放回去
|
||||
if [ -d "$PCDIR" ]; then mv "$PCDIR" "$PCHIDE"; fi
|
||||
@@ -318,7 +318,7 @@ fi
|
||||
# 光看文件在不在不够 —— 要真的**链一个用 curl 的静态程序**, 才能证明这份
|
||||
# 前缀是可用的 (静态链接最常栽在依赖顺序和缺库上, 而那只在链接时暴露).
|
||||
echo
|
||||
echo "== 自检：编一个最小程序并静态链接"
|
||||
echo "== 自检: 编一个最小程序并静态链接"
|
||||
CHECK="$SRC/check.c"
|
||||
cat > "$CHECK" <<'EOF'
|
||||
#include <curl/curl.h>
|
||||
@@ -336,7 +336,7 @@ LIBS=$("$PREFIX/bin/curl-config" --static-libs)
|
||||
if ldd "$SRC/check" 2>&1 | grep -q "not a dynamic executable\|statically linked\|不是动态可执行文件"; then
|
||||
echo " 静态链接成功, 且确实不依赖动态库"
|
||||
else
|
||||
echo " 注意：ldd 没说它是静态的, 检查一下下面这行输出：" >&2
|
||||
echo " 注意: ldd 没说它是静态的, 检查一下下面这行输出: " >&2
|
||||
ldd "$SRC/check" 2>&1 | head -3 >&2
|
||||
fi
|
||||
|
||||
@@ -345,19 +345,19 @@ fi
|
||||
# 于是会进工具输出、进对话历史、最后进请求体. 一旦含非法字节, 服务端会以
|
||||
# "invalid unicode code point" 拒掉整个请求 —— 而且坏数据已经留在历史里,
|
||||
# 之后每次请求都会失败. 上面 curl 那段的长注释解释了坏字节是怎么来的.
|
||||
# 用 iconv 做往返校验：截断的/被转义的序列都会被它拒掉. 没有 iconv 就跳过.
|
||||
# 用 iconv 做往返校验: 截断的/被转义的序列都会被它拒掉. 没有 iconv 就跳过.
|
||||
if command -v iconv >/dev/null 2>&1; then
|
||||
if "$PREFIX/bin/curl-config" --static-libs 2>/dev/null \
|
||||
| iconv -f UTF-8 -t UTF-8 > /dev/null 2>&1; then
|
||||
echo " curl-config --static-libs 输出是合法 UTF-8"
|
||||
else
|
||||
echo " 错误：curl-config --static-libs 的输出含非法 UTF-8. " >&2
|
||||
echo " 错误: curl-config --static-libs 的输出含非法 UTF-8. " >&2
|
||||
echo " 这通常意味着 configure 走了 pkg-config 那条路 (见上面 curl 那段). " >&2
|
||||
echo " 删掉这个前缀重跑本脚本：rm -rf \"$PREFIX\"" >&2
|
||||
echo " 删掉这个前缀重跑本脚本: rm -rf \"$PREFIX\"" >&2
|
||||
exit 1
|
||||
fi
|
||||
fi
|
||||
|
||||
echo
|
||||
echo "依赖就绪：$PREFIX"
|
||||
echo "接下来： make static"
|
||||
echo "依赖就绪: $PREFIX"
|
||||
echo "接下来: make static"
|
||||
@@ -1,17 +1,17 @@
|
||||
#!/bin/sh
|
||||
# check-colors.sh - 审计所有 ANSI 颜色码, 确保都在 16 色内
|
||||
#
|
||||
# 为什么要单独一个脚本：颜色越界这件事**看代码看不出来** —— \033[94m 在人眼里
|
||||
# 为什么要单独一个脚本: 颜色越界这件事**看代码看不出来** —— \033[94m 在人眼里
|
||||
# 也是"一个蓝色", 只有拿尺子量才知道它属于 aixterm 的亮色段, 不在最窄的
|
||||
# 16 色 ANSI 里. 而这个项目是硬编码 SGR、不查 terminfo 的, 既然不探测终端
|
||||
# 能力, 就该待在所有终端都认的那一档.
|
||||
#
|
||||
# 允许的 SGR 参数：
|
||||
# 允许的 SGR 参数:
|
||||
# 0 重置
|
||||
# 1/2/3/4 加粗/暗淡/斜体/下划线 (属性, 不是颜色)
|
||||
# 30-37 标准前景 8 色
|
||||
# 39 默认前景色
|
||||
# 不允许：90-97 (亮色)、38;5/48;5 (256 色)、38;2/48;2 (真彩)
|
||||
# 不允许: 90-97 (亮色)、38;5/48;5 (256 色)、38;2/48;2 (真彩)
|
||||
set -eu
|
||||
|
||||
ROOT=$(cd "$(dirname "$0")/.." && pwd)
|
||||
@@ -29,10 +29,10 @@ if [ -n "$bad" ]; then
|
||||
echo "发现 16 色范围外的 SGR 参数:" >&2
|
||||
printf ' %s\n' $bad >&2
|
||||
echo "" >&2
|
||||
echo "允许的：0 1 2 3 4 30-37 39" >&2
|
||||
echo "越界的：90-97 (aixterm 亮色)、38;5/48;5 (256 色)、38;2/48;2 (真彩)" >&2
|
||||
echo "允许的: 0 1 2 3 4 30-37 39" >&2
|
||||
echo "越界的: 90-97 (aixterm 亮色)、38;5/48;5 (256 色)、38;2/48;2 (真彩)" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
n=$(grep -rhoE '\\033\[[0-9;]+m' src/*.c src/*.h 2>/dev/null | sort -u | wc -l)
|
||||
echo "颜色审计通过：$n 个不同的 SGR 序列, 全部在 16 色内. "
|
||||
echo "颜色审计通过: $n 个不同的 SGR 序列, 全部在 16 色内. "
|
||||
+12
-12
@@ -1,7 +1,7 @@
|
||||
#!/bin/sh
|
||||
# get-version.sh - 算出版本号, 供 Makefile 用 -D 注入
|
||||
#
|
||||
# 输出六行 (顺序固定, Makefile 按行取)：
|
||||
# 输出六行 (顺序固定, Makefile 按行取):
|
||||
# 1. CalVer 主版本号 YYYY.MM.DD
|
||||
# 2. git 短哈希 abc1234 / 1a2b3c4.dirty / unknown
|
||||
# 3. 分支名 master / unknown (detached HEAD 或非 git)
|
||||
@@ -9,37 +9,37 @@
|
||||
# 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 是个终端工具, 不是被别人链接的库,
|
||||
# 为什么 CalVer 而不是 SemVer: ligent 是个终端工具, 不是被别人链接的库,
|
||||
# "第几个大版本"这种信息对它没什么用; "这是哪天的东西"才有用 —— 用户看到
|
||||
# 2026.02.14 立刻知道新旧. 真需要表达破坏性变更时, git 历史和 README 比版本
|
||||
# 号数字说得清楚.
|
||||
#
|
||||
# 为什么还要带哈希：CalVer 的粒度是"天", 同一天可能发好几次; 而且用户手上
|
||||
# 为什么还要带哈希: CalVer 的粒度是"天", 同一天可能发好几次; 而且用户手上
|
||||
# 的二进制未必来自 tag (可能自己改了源码). 带上哈希, 报 bug 时能精确定位.
|
||||
#
|
||||
# 分隔符用 "-" 而不是 git describe 传统的 "+g"：我们只用 git, 不存在"区分是
|
||||
# 分隔符用 "-" 而不是 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, 用文件的日期当版本)
|
||||
#
|
||||
# 任何一步失败都不算致命：退回一个明确的默认值, 绝不让构建挂掉 ——
|
||||
# 任何一步失败都不算致命: 退回一个明确的默认值, 绝不让构建挂掉 ——
|
||||
# 版本号不对只是难看, 构建挂掉是真的不能用.
|
||||
set -eu
|
||||
|
||||
ROOT=$(cd "$(dirname "$0")/.." && pwd)
|
||||
|
||||
# ------------------------------------------------------- 构建日期与时间
|
||||
# SOURCE_DATE_EPOCH 是"可复现构建"的标准约定：设了它就用它当构建时间,
|
||||
# SOURCE_DATE_EPOCH 是"可复现构建"的标准约定: 设了它就用它当构建时间,
|
||||
# 这样同一个源码在不同时间编出来的二进制是**逐字节相同**的.
|
||||
# 不认这个约定的话, CI 上每次构建的产物哈希都不一样, 没法校验.
|
||||
if [ -n "${SOURCE_DATE_EPOCH:-}" ]; then
|
||||
@@ -61,7 +61,7 @@ else
|
||||
CALVER=
|
||||
# 只在真的在 git 工作区里、且 git 可用时才问 git
|
||||
if command -v git >/dev/null 2>&1 && [ -d "$ROOT/.git" ]; then
|
||||
# 找最近的、长得像 CalVer 的 tag. 用 grep 过滤而不是 --match：不同
|
||||
# 找最近的、长得像 CalVer 的 tag. 用 grep 过滤而不是 --match: 不同
|
||||
# git 版本对 --match 的 glob 支持略有差异, 而这里只要"第一个符合
|
||||
# YYYY.MM.DD 形态的"就够了, 过滤更直观也更可移植.
|
||||
CALVER=$(git -C "$ROOT" tag --list 2>/dev/null \
|
||||
@@ -70,7 +70,7 @@ else
|
||||
| sort \
|
||||
| tail -1 || true)
|
||||
fi
|
||||
# 没有 tag：用源码目录的日期当版本. tarball 场景下这是"这份源码什么时候
|
||||
# 没有 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)
|
||||
@@ -79,13 +79,13 @@ 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"
|
||||
|
||||
+19
-19
@@ -1,10 +1,10 @@
|
||||
/* md_demo.c - Markdown 渲染效果演示
|
||||
*
|
||||
* 一个独立的小程序：把内置示例 (或你指定的文件 / stdin)喂进 ligent 的
|
||||
* 一个独立的小程序: 把内置示例 (或你指定的文件 / stdin)喂进 ligent 的
|
||||
* 流式 Markdown 渲染器, 直观看到每种语法的渲染结果.
|
||||
*
|
||||
* 编译： make md_demo
|
||||
* 运行： ./build/md_demo
|
||||
* 编译: make md_demo
|
||||
* 运行: ./build/md_demo
|
||||
*/
|
||||
#include "markdown.h"
|
||||
#include "util.h"
|
||||
@@ -16,7 +16,7 @@
|
||||
#include <unistd.h>
|
||||
|
||||
/* ------------------------------------------------------------------ */
|
||||
/* 内置示例：把支持的语法和边界情况都覆盖一遍 */
|
||||
/* 内置示例: 把支持的语法和边界情况都覆盖一遍 */
|
||||
/* ------------------------------------------------------------------ */
|
||||
|
||||
static const char *SAMPLE =
|
||||
@@ -25,9 +25,9 @@ static const char *SAMPLE =
|
||||
"## 行内样式\n"
|
||||
"\n"
|
||||
"这是 **粗体**、*斜体*、_下划线斜体_ 和 `行内代码` 的混排效果. \n"
|
||||
"标识符不会被误伤：foo_bar_baz、__init__、arr[i]、a_b_c 都保持原样. \n"
|
||||
"链接只高亮方括号：[官方文档](https://example.com/doc) 后面还有普通文字. \n"
|
||||
"图片保留原文：\n"
|
||||
"标识符不会被误伤: foo_bar_baz、__init__、arr[i]、a_b_c 都保持原样. \n"
|
||||
"链接只高亮方括号: [官方文档](https://example.com/doc) 后面还有普通文字. \n"
|
||||
"图片保留原文: \n"
|
||||
"\n"
|
||||
"## 列表与引用\n"
|
||||
"\n"
|
||||
@@ -52,7 +52,7 @@ static const char *SAMPLE =
|
||||
"}\n"
|
||||
"```\n"
|
||||
"\n"
|
||||
"行内代码同理：`a ** b` 里的星号不会被当成粗体标记. \n"
|
||||
"行内代码同理: `a ** b` 里的星号不会被当成粗体标记. \n"
|
||||
"\n"
|
||||
"## 表格\n"
|
||||
"\n"
|
||||
@@ -68,8 +68,8 @@ static const char *SAMPLE =
|
||||
"\n"
|
||||
"## 边界情况\n"
|
||||
"\n"
|
||||
"乘法星号原样保留：2 * 3 * 4 = 24\n"
|
||||
"管道命令不会被误判成表格：ls -la | grep foo\n"
|
||||
"乘法星号原样保留: 2 * 3 * 4 = 24\n"
|
||||
"管道命令不会被误判成表格: ls -la | grep foo\n"
|
||||
"未闭合的 **粗体标记 会在行尾被复位\n"
|
||||
"#井号后没有空格就不是标题\n"
|
||||
"####### 七个井号也不是标题\n"
|
||||
@@ -144,20 +144,20 @@ static void usage(FILE *out)
|
||||
fputs(
|
||||
"md_demo - 演示 ligent 的流式 Markdown 渲染效果\n"
|
||||
"\n"
|
||||
"用法： md_demo [选项] [文件...]\n"
|
||||
"用法: md_demo [选项] [文件...]\n"
|
||||
"\n"
|
||||
"不指定文件时使用内置示例; 文件名为 - 或 stdin 不是终端时从标准输入读取. \n"
|
||||
"\n"
|
||||
"选项：\n"
|
||||
"选项: \n"
|
||||
" -p, --plain 关闭渲染, 输出原始 Markdown (对照用)\n"
|
||||
" --color 强制开启渲染 (默认仅在输出到终端时开启)\n"
|
||||
" -c, --chunk N 按每 N 字节一片喂入 (默认 0 = 一次性喂完)\n"
|
||||
" -d, --delay MS 每片之间延时毫秒 (默认 0)\n"
|
||||
" -s, --stream 流式预设：等价于 -c 5 -d 12\n"
|
||||
" --compare 自检：把同一段文本按多种分片方式渲染, 比对结果是否一致\n"
|
||||
" -s, --stream 流式预设: 等价于 -c 5 -d 12\n"
|
||||
" --compare 自检: 把同一段文本按多种分片方式渲染, 比对结果是否一致\n"
|
||||
" -h, --help 显示本帮助\n"
|
||||
"\n"
|
||||
"例子：\n"
|
||||
"例子: \n"
|
||||
" md_demo 看渲染效果\n"
|
||||
" md_demo --plain 看原始 Markdown, 对照差异\n"
|
||||
" md_demo -c 5 -d 12 模拟 SSE 流式 (标记会被随机切断)\n"
|
||||
@@ -240,9 +240,9 @@ int main(int argc, char **argv)
|
||||
int enabled = plain ? 0 : (force_color ? 1 : (isatty(fileno(stdout)) ? 1 : 0));
|
||||
|
||||
if (compare) {
|
||||
/* 分片不变性自检：不同分片大小必须得到完全相同的结果 */
|
||||
/* 分片不变性自检: 不同分片大小必须得到完全相同的结果 */
|
||||
puts("分片不变性自检 (同一段文本, 不同分片方式, 输出必须逐字节一致)");
|
||||
printf("输入：%s (%zu 字节)\n\n", source_name, strlen(src));
|
||||
printf("输入: %s (%zu 字节)\n\n", source_name, strlen(src));
|
||||
|
||||
char *whole = render_to_mem(src, 1, 0);
|
||||
size_t sizes[] = { 1, 2, 3, 5, 7, 13, 64 };
|
||||
@@ -279,14 +279,14 @@ int main(int argc, char **argv)
|
||||
free(buf);
|
||||
free(whole);
|
||||
|
||||
printf("\n结论：%s\n", all_ok ? "全部一致, 标记跨分片处理正确. "
|
||||
printf("\n结论: %s\n", all_ok ? "全部一致, 标记跨分片处理正确. "
|
||||
: "存在不一致, 渲染器有 bug. ");
|
||||
free(src);
|
||||
return all_ok ? 0 : 1;
|
||||
}
|
||||
|
||||
if (isatty(fileno(stdout))) {
|
||||
fprintf(stderr, "── 输入：%s 渲染：%s%s ──\n\n",
|
||||
fprintf(stderr, "── 输入: %s 渲染: %s%s ──\n\n",
|
||||
source_name, enabled ? "开" : "关",
|
||||
chunk ? " (分片模式)" : "");
|
||||
}
|
||||
|
||||
Reference in new issue
Block a user