msaber1004 / patpat

Auto Judger for BUAA-SE-OOP Course (2021 Spring)

patpat

Auto Judger for BUAA-SE-OOP Course (2021 Spring)

1. 评测机使用方法

1.1. 一些准备工作

1.1.1. 下载评测机

见 GitHub 中的 Releases，下载对应版本即可。目前提供 Windows, Linux, MacOS(Intel 架构)的可执行文件。如有 ARM 架构版本的需要或程序无法正常运行，请联系我解决。

1.1.2. 统一编码

统一使用 UTF-8 编码。

请确认你的程序能通过如下命令成功编译！

javac -encoding UTF-8 1-18373722-朱英豪/src/*.java # 请修改为自己的相关信息

1.1.3. 自检编译和执行命令

评测机使用的编译命令与执行命令：

javac -encoding UTF-8 folderName/src/*.java # 编译
java -classpath folderName/src Test # 执行
# folderName为1-123456-hanhan含有学号姓名等信息的文件夹名，在后续会具体说明各字段含义。

注：评测机环境使用 Windows 下的 Oracle JDK 15。

1.2. 自评

请严格按照如下的目录层级与命名准备好待测文件：

• patpat.exe (Mac 与 Linux 用户的程序无后缀)
• test
  • judge.yaml (用于告知评测机需要测哪些测试用例，编写方法见下)
  • testcase1.yaml
  • testcase2.yaml
  • ...
• 1(第几次作业)-18373722(学号)-朱英豪(姓名)
  • src
    • Test.java (程序运行的主入口)
    • 其余*.java
    • (有无*.class没有关系，评测机会重新编译)

运行方式: 在 terminal(如 PowerShell)中运行如下命令：

注：对于 Mac 与 Linux 用户，需要首先chmod +x patpat，使评测机程序具有可执行权限。

./patpat stu -judge 1-18373722-朱英豪 # 请修改为自己的相关信息

评测结果: 见生成的$testcase$_result.md。(其与该patpat程序在同级目录)

1.3. 查询助教评测结果

• 首先需要注册账号 (sid 为您的学号)

./patpat reg -sid your_sid -pwd your_password
# 如./patpat reg -sid 18373722 -pwd buaa-se-oop

注：账号创建后，密码不支持修改。如需修改，请联系我。

• 查询命令：

./patpat query -sid your_sid -pwd your_password

学号及对应的密码正确后即可显示截至到目前的所有评测结果。

1.4. judge.yaml的编写

tests: [testcase1.yaml, testcase2.yaml] # 可有更多，这是个列表
# 请将本judge.yaml置于test目录下

注：在自测时testcase的名称，需要与test目录下的testcase文件名相一致。

2. 作业提交方式

• 1(第几次作业)-18373722(学号)-朱英豪(姓名)
  • src
    • Test.java (程序运行的主入口)
    • 其余*.java

将上述文件夹压缩为zip格式后，上传至云平台。

注：请务必反复确认文件的命名，如有误将无法评测。

3. 开发者指南

3.1. 编译项目

数据库的配置在mysql.yaml中，参考如下：

host: xx.xx.xx.xx
port: xxx
username: xxx
password: xxx
database: xxx

交叉编译：

见Makefile。一键交叉编译可使用make。

3.2. 测试文件编写

样例：

name: testcase
data:
  - # 单行输入，无输出
    - SUDO
  - # 单行输入，单行输出
    - nc hh12345678 oop6324 [10086,10001] 1 [1-16]2,3
    - Course add illegal.
  - # 单行输入，多行输出
    - myc 1 1000
    - |
      Page:1
      1.CID:bh00000002,Name:oop6326,Teachers:[A,B,10086],Capacity:1/100,Time:[1-10]1,5
      2.CID:bh00000004,Name:oop6328,Teachers:[A,B],Capacity:1/100,Time:[11-18]1,5
      3.CID:bh00000005,Name:oop6329,Teachers:[A,B],Capacity:1/100,Time:[1-18]1,6
      n-next page, l-last page, q-quit
  - # 多行输入，无输出
    - |
      quit
      quit again
      quit quit
  - # 多行输入，一行输出
    - |
      quit
      quit again
      QUIT
    - ----- Good Bye! -----
  # 多行输入，多行输出，类比以上写法，不建议使用。

# 这里 data 部分的数据类型为 [n][2]string。
# 第一级的 - 相当于一条小测试点
# 第二级的 - 第一条对应输入，可能有的第二条对应输出。
# (即第二级的输入是必须的，可以无输出。至少为 1 个二级 - 至多为 2 个二级 - 。)

4. 如何贡献项目

• 发现 Bug——提 Issue
• 贡献测试数据——提 Pull Request
• 为了时刻了解是否有新的测试样例，请 Watch 和 Star 该项目
• Plus，欢迎 Follow 我，谢谢！