prairielearn/grader-c

PrairieLearn C语言外部自动评分器镜像

镜像概述

PrairieLearn C语言外部自动评分器镜像是PrairieLearn在线学习系统的专用组件，用于对C语言编程作业和测试进行自动化评分。该镜像集成了C语言编译环境、测试用例执行引擎和评分规则模块，可与PrairieLearn系统对接，实现C代码提交后的自动编译、运行验证及分数计算，提升C语言作业批改效率。

核心功能与特性

• C代码编译验证：支持标准C语言代码（C99/C11标准）的编译，自动检测语法错误、链接错误及编译警告
• 程序运行管控：执行编译后的可执行文件，支持自定义输入参数、标准输入处理及运行超时控制（默认30秒）
• 测试用例匹配：对比程序实际输出与预设预期结果，支持文本比对、数值精度控制及错误类型分类
• 多维度评分：支持按测试用例通过率、代码规范性（如注释率、命名规范）、性能指标（如运行时间、内存占用）等多维度计算分数
• PrairieLearn集成：遵循PrairieLearn外部评分器接口规范，支持评分结果JSON格式输出，直接与PrairieLearn学习系统数据交互

使用场景与适用范围

• 高校计算机课程：适用于《C语言程序设计》《数据结构（C语言版）》等课程的编程作业自动批改
• 在线编程教育平台：为C语言练习题提供即时反馈，支持学生提交后快速获取评分结果
• 编程竞赛训练：用于C语言题目提交的自动评测，验证算法正确性及代码效率

使用方法与配置说明

前提条件

• 已安装Docker Engine（20.10+版本）
• 已部署PrairieLearn系统（2.0+版本）并启用外部评分器功能
• 本地或服务器端具备读写权限的测试用例目录和学生代码存放目录

获取镜像

通过Docker Hub拉取最新版本镜像：

bash
docker pull prairielearn/prairielearn-c-autograder:latest

基础运行示例

以下命令展示如何通过Docker运行镜像，对指定C代码进行评分（需配合测试用例和配置）：

bash
docker run --rm \
  -v /local/test-cases:/app/test-cases \  # 挂载测试用例目录（含输入/预期输出文件）
  -v /local/submitted-code:/app/submitted \  # 挂载学生提交的C代码目录（如main.c）
  -e SCORE_CRITERIA="test_case_pass_rate" \  # 指定评分标准为测试用例通过率
  -e COMPILE_FLAGS="-Wall -Werror -std=c99" \  # 设置编译参数（开启警告并视为错误，使用C99标准）
  -e TIMEOUT=20 \  # 设置运行超时时间为20秒
  prairielearn/prairielearn-c-autograder:latest

关键配置参数

环境变量

挂载卷

评分结果说明

评分完成后，镜像将生成JSON格式的评分结果（默认输出至/app/output/score.json），包含以下关键字段：

• score：最终得分（0-100分）
• passed_tests：通过的测试用例数量
• total_tests：总测试用例数量
• compile_status：编译状态（success/failed）
• error_details：错误详情（如编译错误信息、运行时异常）

更多信息

完整技术文档及接口规范请参考PrairieLearn官方文档：[***]