AI prompts
base on 中山大学编译原理课程实验(完全重构版本) <p align="center">
<img width="512" src="docs/logo/SYsU-lang-LOGO.png">
</p>
# SYsU-lang **(2.0)**
中山大学(**S**un **Y**at-**s**en **U**niversity)[编译原理](https://arcsysu.github.io/teach/dcs290/s2024.html)课程实验 **2.0** 版。
根据此前的教学反馈,我们对原先实验框架进行了彻底的重构,重构后的版本:
- 与 CMake 构建系统和 VSCode 编辑器深度结合,提供了涵盖构建、调试、评测、打包的完整解决方案,为同学们带来了现代化的开发体验;
- 预置了完整、规范、采用最佳实践的基础示例代码和项目组织结构,大大降低了同学们的上手难度,减少了与课程内容无关的工程量;
- 设计了自定义配置机制,允许同学们根据自身情况和偏好选择完成实验的方式,提高了实验的灵活性;
- 精简了评测样例,改进了评分脚本,可以提供更加清晰的评测结果,帮助同学们更好地理解实验要求和自己代码的问题;
- 提供了环境配置脚本以及开箱即用的标准化开发容器,简化了环境配置,大大降低了环境差异引发问题的可能性;
- 根据示例代码重新撰写的“手把手”实验文档言之有物,从而提供了更加具体和清晰的实验指导。
> 由于时间有限,重构仍然在进行中,实验框架仍在积极更新…………
# 内容
本实验共由 5 个任务组成:
- [任务 0:环境准备](task/0)
- [任务 1:词法分析](task/1)
- [任务 2:语法分析](task/2)
- [任务 3:中间代码生成](task/3)
- [任务 4:中间代码优化](task/4)
> 到任务各自的目录中查看具体的任务要求。
> (同时面向同学们和实验项目的维护人员)**为了建立对实验框架的整体认知,请阅读[《实验设计手册》](/docs/gyh-manual)。**
# 准备
## 安装
我们提供了开箱即用的标准化开发容器,[这篇文章](https://arcsysu.github.io/SYsU-lang2/#/introduction/environment)介绍了如何在你的电脑上拉取并使用它。如果同学们可以使用 GitHub Codespaces,一种简单且快速的体验方式是直接点击仓库右上角的 `Code` 来一键式地创建 Codespace,只需经过一段时间的等待就可以直接使用。
如果你不想使用容器而是想直接在自己的 Linux 环境中使用本框架,请使用以下 bash 命令:
```bash
# 安装依赖(以 Ubuntu 22.04 为例)
sudo apt-get update
sudo apt-get install -y build-essential git cmake ninja-build default-jdk \
python3 bison flex
# 克隆仓库
git clone https://github.com/arcsysu/SYsU-lang.git -b main --single-branch --depth 1
# 进入仓库
cd SYsU-lang
# 安装 antlr 与 llvm
cd antlr && bash install.sh
cd ../llvm && bash install.sh
```
然后,使用 VSCode 的 Remote - SSH 插件连接到你的 Linux 环境,打开仓库文件夹,即可开始实验。
实验所需的 VSCode 插件已经全部列在 [`.vscode/extensions.json`](.vscode/extensions.json) 中,在打开文件夹时,VSCode 会自动提示你安装这些插件,你只需点击提示进行安装即可。
## 配置
注意仓库根目录下的 `config.cmake` 文件,这是一个自定义配置文件,你可以根据自己的情况和偏好修改它。至少,你需要在其中填入你的姓名和学号。
通过这个文件,你可以选择实验一和实验二的完成方式:是使用 bison+flex 还是 antlr,相应地,你的程序也会在我们评测时使用相应的方式运行。
除此之外,你还可以通过它配置第一个之后的每个实验是否“复活”。所谓“复活”,是指将程序的输入由源代码的内容改为前一个实验的标准答案。由于本实验是线性、渐进的,如果你在前一个实验中“挂了”或是做得不够好,那么就可以选择“复活”来同步进度,从而继续后面的实验。
> 复活机制默认关闭,启用复活需要让预置的示例代码适配变化后的输入,我们会尽快在将来的更新中给出适配代码。
# 开始
现在,你已经准备好了,请按照每个任务的具体要求,开始你的编译器实验之旅吧!
你可以在这里找到更多的参考文档:[arcsysu.github.io/SYsU-lang2/](https://arcsysu.github.io/SYsU-lang2/)。
", Assign "at most 3 tags" to the expected json: {"id":"8198","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"