/cpp_auto_judge

A very primitive backend implementation to compile, test, score and comment C++ homework when I was a TA.

Primary LanguagePythonMIT LicenseMIT

CPP作业批改脚本

AutoJudge类

在src/autojudge.py中提供了方便移植的AutoJudge类。

class AutoJudge(object):
    """
    批改一份代码, 包括编译、测试、打分与评论错误等操作

    Parameters
    ----------
        code_dir   : 代码所在文件夹
        ouput_dir  : 编译、测试、打分过程产生的文件的保存路径
        finput     : 输入测例的文件路径
        fanswer    : 测例答案的文件路径
        separators : 输入测例的分隔符，默认以换行符分隔

    Methods
    ---------
        self.compile()           : 编译代码
        self.running_test_case() : 测试测例
        self.check_answers()     : 检查测例输出是否为正确答案
        self.errors(prob_name)   : 评论错误情况
        self.process(fullscore=100, per_case=.05, per_build=.25):
            完成所有代码的编译、测试、打分操作。默认分数配比为 编译 25% 代码 25% 测例 50%
            fullscore 是该问题的满分, per_case=.05 是指一个测例分数默认占 5%
            per_build=.25 是指编译错误扣分 25%
        self.load(pkl_path):
        self.save(pkl_path):
                pkl_path 是 pathlib.Path 类型，以文件形式加载或保存AutoJudge对象

    Properties
    ---------
        self.build_failed : 是否编译成功
        self.TLE          : 运行超时的测例列表
        self.WA           : 答案错误的测例列表
        self.time         : 运行测例的时间列表
        self.memory       : 运行测例的内存列表
		self.score        : 代码分数

    TODO
    ---------
        提供更多的编译接口
    """

环境要求

python包: pandas(仅用于将评价结果输出为excel时使用)

环境中有mingw-w64版本g++编译器(用于编译cpp代码，且提供了编译时的gbk编码支持)

使用方法:

  1. 需要在根目录提供学生姓名和学号，目前要求保存为sid_names.txt(每行学号<TAB>姓名)
  2. 在src/config.json中配置相关参数，包括实验号、问题号、每个问题的分数、包含所有学生的作业压缩包的路径。目前提供了批改实验9的配置。
  3. 在test_case文件夹中添加不同问题的测例和答案
  4. 逐行执行python src/main.py
本项目提供的其他操作，包括
  • src/move.py中move_redundant_files()：删除冗余作业，只保留同一个同学最新提交的作业
  • src/copy.py中copy_files(): 从解压处拷贝作业到work_dir/codes/ 和work_dir/reports下，统一处理
  • src/release.py中auto_judge()：自动评价work_dir/codes/中所有的代码，包括编译、测试、打分，接受的测例跟据实验号和题号在test_case文件夹中寻找
  • src/release.py中release_excel()：将评价结果和测例输出发布为excel
  • src/release.py中recommend_cpp()：从work_dir/优秀代码.txt中抽取出学号，将这些同学的作业拷贝到 work_dir/优秀代码/下。这里优秀代码.txt中的学号需要自行提供。