Skip to content

refactor!: 迁移到 c-project-standard v0.2.1 工程结构 - #10

Merged
wubing7755 merged 4 commits into
mainfrom
refactor/template-migration
Oct 23, 2026
Merged

wubing7755 merged 4 commits into
mainfrom
refactor/template-migration

Conversation

@wubing7755

Copy link
Copy Markdown
Member

摘要

  • 按 c-project-standard v0.2.1 迁移 CalcExpr 工程结构
  • 拆分为 calcexpr_core 库与 calcexpr CLI,公共 API 收敛到 include/calcexpr
  • 调试系统改为 CALCEXPR_ENABLE_DEBUG,新增 --version/--help,版本统一为 1.0.0
  • 测试迁移到 vendored Unity,补声明/版本/文档/CPack 门禁与包/子项目冒烟
  • 文档改为中文单语,删除英文与西语镜像

破坏性变更

  • 可执行文件名 calculator → calcexpr
  • 头文件从 include/*.h 移到 include/calcexpr/calculator.h 与 src/calcexpr/
  • CMake 选项 CALCEXPR_BUILD_EXAMPLE → CALCEXPR_BUILD_CLI,ENABLE_DEBUG → CALCEXPR_ENABLE_DEBUG

验证

本地 Windows(GCC 16.2 / Clang 22 / CMake 4.3.3 / Ninja 1.13.2):

  • ninja-debug、ninja-release、ninja-shared 构建 + 7 项 CTest 全绿
  • ninja-coverage 构建 + CTest 全绿
  • scripts/check.ps1 -EnableTidy、clang-format、clang-tidy、cppcheck 全绿
  • 静态/动态安装 + find_package 包消费冒烟、add_subdirectory 子项目冒烟全绿
  • CPack 产出 CalcExpr-1.0.0-win64.zip 与 .tar.gz
  • CLI 手动验证 --version/--help/表达式/错误//show process//quit

未本地验证:ASAN/UBSAN(Windows MinGW/Clang 缺少 ASAN 运行时)、MSVC、macOS、DEB/RPM;由 CI 覆盖。

影响

  • 公共 API 头文件路径变更,函数签名保持不变
  • 构建预设名称保持模板约定;Debug 预设默认开启调试系统
  • 文档删除英文/西语版本,README 改为中文索引

AI 辅助

本次迁移由 Qoder 代理执行;已阅读 C_PROJECT_STANDARD.md、CONTRIBUTING.md、docs/guides/testing.md、docs/guides/cmake.md 等必读文档,并在本地执行上述验证。人工复核请重点看构建/目标改名与文档删除范围。

- 采用模板的 CMake、CTest/Unity、CI、安装与 CPack 骨架
- 拆分为 calcexpr_core 库与 calcexpr CLI,公共 API 收敛到 include/calcexpr
- 调试系统改为 CALCEXPR_ENABLE_DEBUG,Debug 预设默认开启
- 新增 --version/--help,版本统一为 1.0.0
- 补声明/定义、版本、文档、CPack 与门禁自检
- 删除英文/西语镜像与旧构建配置,补充中文模板文档
- README 增加项目说明、使用方式、测试与安装索引
- 新增调试系统指南与递归下降解析器指南
- debug.c 在 POSIX 下定义 _POSIX_C_SOURCE 以暴露 fileno
- 补齐 calculator.c/parser.c 文件末尾换行
- 用 clang-format off/on 固定跨版本对齐不一致的解析器追踪宏
- Linux 睡眠改用 nanosleep,避免严格 C11 下 usleep 未声明
- 对 clang-analyzer 18 的 va_list 误报添加精确 NOLINT
@wubing7755
wubing7755 merged commit c8b9e14 into main Oct 23, 2026
34 checks passed
@wubing7755
wubing7755 deleted the refactor/template-migration branch October 23, 2026 01:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant