12.0.0.20230529: update to debian:bookworm (#117)

* Docker image 瘦身

* fix Dockerfile

* fix workflow

* rm Symbolic Link

* add file

* Revert "Docker image 瘦身"

* 12.0.0.20230529: update to debian:bookworm (#113)

1. 更新实验环境为 `debian:bookworm`、`clang-14`、`llvm-14`
2. 重构 `lib1. 更新实验环境为 `debian:bookworm`、`clang-14`、`llvm-14`
2. 重构 `librarian` 目录
3. 调整 `cmake_minimum_required`，与 `llvm-14` 对齐
4. 调整文档
5. 修复 #74 rarian` 目录
3. 调整 `cmake_minimum_required`，与 `llvm-14` 对齐
4. 调整文档
5. 修复 #74

Author: WuK

.github/workflows/docker.yml

@@ -55,7 +55,7 @@ jobs:
           context: .
           tags: ${{ steps.meta.outputs.tags }}
           labels: ${{ steps.meta.outputs.labels }}
-          build-args: BASE_IMAGE=debian:11
+          build-args: BASE_IMAGE=debian:bookworm
 
       - name: Build Docker image for unstable-slim
         if: github.ref_name == 'unstable-slim' || github.base_ref == 'unstable-slim'
@@ -91,7 +91,7 @@ jobs:
           context: .
           tags: ${{ steps.meta.outputs.tags }}
           labels: ${{ steps.meta.outputs.labels }}
-          build-args: BASE_IMAGE=debian:11
+          build-args: BASE_IMAGE=debian:bookworm
           platforms: linux/amd64,linux/arm64/v8
 
       - name: Build and push Docker image for unstable-slim

CMakeLists.txt

@@ -1,5 +1,6 @@
-cmake_minimum_required(VERSION 3.18.4)
-project(SYsU-lang VERSION 11.1.0.20230227)
+# <https://github.com/llvm/llvm-project/blob/llvmorg-14.0.6/llvm/CMakeLists.txt>
+cmake_minimum_required(VERSION 3.13.4)
+project(SYsU-lang VERSION 12.0.0.20230529)
 include(CPack)
 include(CTest)
 add_subdirectory(compiler)

README.md

@@ -11,15 +11,19 @@ SYsU 是一个教学语言，应用于中山大学（**S**un **Y**at-**s**en **U
 
 ## 编译运行
 
-需要注意的是，[SysY](https://gitlab.eduxiji.net/nscscc/compiler2021/-/blob/master/SysY%E8%AF%AD%E8%A8%80%E5%AE%9A%E4%B9%89.pdf) 语言允许编译时能够求值的 `const int` 作为数组大小，导致部分算例不能通过 `gcc` 的编译，因此为保持兼容推荐使用 `clang` 编译。经过测试的实验环境为 `debian:11`。
+需要注意的是，[SysY](https://gitlab.eduxiji.net/nscscc/compiler2021/-/blob/master/SysY%E8%AF%AD%E8%A8%80%E5%AE%9A%E4%B9%89.pdf) 语言允许编译时能够求值的 `const int` 作为数组大小，导致部分算例不能通过 `gcc` 的编译，因此为保持兼容推荐使用 `clang` 编译。经过测试的实验环境为 `debian:bookworm`。
 
 ```bash
 # 安装依赖
 sudo apt-get install -y --no-install-recommends \
   clang llvm-dev zlib1g-dev lld flex bison \
   cmake python3 ninja-build git
 
-git clone https://github.com/arcsysu/SYsU-lang
+git clone \
+  -c feature.manyFiles=true \
+  --depth=1 \
+  https://github.com/arcsysu/SYsU-lang
+
 cd SYsU-lang
 
 # 编译安装
@@ -307,7 +311,7 @@ entry:
 大算例以 `git submodule` 的形式存放在 `tester/third_party`。加载方式：
 
 ```bash
-git submodule update --init
+git submodule update --init --recursive --depth 1
 ```
 
 ## 实验反馈
@@ -347,7 +351,7 @@ git submodule update --init
 
 目前本项目存在两个分支：
 
-- [`latest`](https://github.com/arcsysu/SYsU-lang/tree/latest) 分支下为中大课程教学中使用的代码，功能稳定，预期在 `debian:11` 环境中工作。
+- [`latest`](https://github.com/arcsysu/SYsU-lang/tree/latest) 分支下为中大课程教学中使用的代码，功能稳定，预期在 `debian:bookworm` 环境中工作。
 - [`unstable-slim`](https://github.com/arcsysu/SYsU-lang/tree/unstable-slim) 分支下为助教探索后续实验改革方案（如 mlir）的代码，预期在`debian:unstable-slim` 环境中工作。该分支中的文档可能不会及时更新，以对应 [Dockerfile](https://github.com/arcsysu/SYsU-lang/blob/unstable-slim/Dockerfile) 中的测试语句为准。
 
 对于中大以外的高校教学者与个人自学者，我们建议使用 [releases](https://github.com/arcsysu/SYsU-lang/releases) 中最新发布的实验框架源码以及对应版本号的 [docker image](https://hub.docker.com/r/wukan0621/sysu-lang)。它们可能在时间上略有落后，但经过了中大一学期的教学检验，不存在潜在的可能导致教学事故的错误。我们也十分欢迎来自你们的课堂反馈[![Discussions](https://img.shields.io/github/discussions/arcsysu/SYsU-lang)](https://github.com/arcsysu/SYsU-lang/discussions) 与改进建议[![Issues](https://img.shields.io/github/issues/arcsysu/SYsU-lang)](https://github.com/arcsysu/SYsU-lang/issues)（[![Issues-pr](https://img.shields.io/github/issues-pr/arcsysu/SYsU-lang)](https://github.com/arcsysu/SYsU-lang/pulls) 请提交至 `unstable-slim` 分支）。

generator/README.md

@@ -135,8 +135,8 @@ $ echo $? # 在 Unix & Linux 中，可以通过 echo $? 来查看最后运行的
 
 ## 你可能会感兴趣的
 
-- [Kaleidoscope: Code generation to LLVM IR](https://releases.llvm.org/11.0.1/docs/tutorial/MyFirstLanguageFrontend/LangImpl03.html)
+- [Kaleidoscope: Code generation to LLVM IR](https://releases.llvm.org/14.0.0/docs/tutorial/MyFirstLanguageFrontend/LangImpl03.html)
 - [SYsU-lang 实验三快速上手](https://www.yuque.com/shuitang/rra4fg/bnqy1c)
 - [Viz.js — Graphviz in your browser.](http://viz-js.com/)
-- [llvm::IRBuilder](https://github.com/llvm/llvm-project/blob/llvmorg-11.0.1/llvm/include/llvm/IR/IRBuilder.h)
-  - 该文件同样位于 debian:11 中 [llvm-dev](https://packages.debian.org/bullseye/devel/llvm-dev) 包的 </usr/include/llvm/IR/IRBuilder.h>。
+- [llvm::IRBuilder](https://github.com/llvm/llvm-project/blob/llvmorg-14.0.6/llvm/include/llvm/IR/IRBuilder.h)
+  - 该文件同样位于 debian:bookworm 中 [llvm-dev](https://packages.debian.org/bookworm/devel/llvm-dev) 包的 </usr/include/llvm/IR/IRBuilder.h>。

lexer/CMakeLists.txt

@@ -1,4 +1,5 @@
 find_package(FLEX REQUIRED)
-flex_target(lexer lexer.l main.cc DEFINES_FILE lexer.hh)
+flex_target(lexer lexer.l ${CMAKE_CURRENT_BINARY_DIR}/main.cc
+            DEFINES_FILE ${CMAKE_CURRENT_BINARY_DIR}/lexer.hh)
 add_executable(sysu-lexer ${FLEX_lexer_OUTPUTS})
 install(TARGETS sysu-lexer)

lexer/README.md

@@ -73,7 +73,7 @@ eof ''          Loc=<tester/functional/000_main.sysu.c:3:2>
 ## 你可能会感兴趣的
 
 - [Lexical Analysis With Flex](http://westes.github.io/flex/manual/)
-- [FindFLEX — CMake 3.18.6 Documentation](https://cmake.org/cmake/help/v3.18/module/FindFLEX.html)
-- [Preprocessor Output](https://gcc.gnu.org/onlinedocs/gcc-10.2.0/cpp/Preprocessor-Output.html)
+- [FindFLEX — CMake 3.13.5 Documentation](https://cmake.org/cmake/help/v3.13/module/FindFLEX.html)
+- [Preprocessor Output](https://gcc.gnu.org/onlinedocs/gcc-12.2.0/cpp/Preprocessor-Output.html)
 - [这篇博客](https://wu-kan.cn/2020/05/14/%E4%BD%BF%E7%94%A8%E8%AF%8D%E6%B3%95%E5%88%86%E6%9E%90%E5%99%A8-Flex-%E6%8F%90%E5%8F%96%E7%A8%8B%E5%BA%8F%E4%B8%AD%E7%9A%84%E6%95%B4%E6%95%B0%E5%92%8C%E6%B5%AE%E7%82%B9%E6%95%B0/)提到了一种处理注释的方案，如果你不想使用 [flex 自带的注释处理方法](http://westes.github.io/flex/manual/Comments-in-the-Input.html)（当然，实际上注释在预处理阶段已经去除了…）。
 - [这篇博客](https://wu-kan.cn/2020/07/03/%E6%AD%A3%E5%88%99%E8%A1%A8%E8%BE%BE%E5%BC%8F%E5%85%B3%E7%B3%BB%E5%88%A4%E5%AE%9A/)通过构造有限自动机，判断两个正则表达式的关系。

librarian/CMakeLists.txt

@@ -1,10 +1 @@
-set(libs sysy;sysu)
-foreach(lib IN LISTS libs)
-  file(GLOB mains ${lib}/*.cc)
-  add_library(${lib} SHARED ${mains})
-  install(TARGETS ${lib})
-  file(GLOB mains ${lib}/*.h)
-  foreach(mainfile ${mains})
-    install(FILES ${mainfile} DESTINATION include/${lib})
-  endforeach()
-endforeach()
+add_subdirectory(lib)