评分工具

我在评分Canvas作业时使用的工具。

包括命令行工具和一些用于处理Canvas输出的实用工具。

主要用途是在手动评分包含多个组件的作业时，并希望跟踪每个组件的分数以及评分笔记。

为此，我会创建一个Markdown评分日志文件，在顶部有规范，然后为每个学生创建一个二级标题，如下所示

# 2018 Marking log for assessment Foo

Ordinary maxima:

* quality: 20
* does_task: 15
* skill_range: 10
* elegance: 10
* functions_variables: 10
* display: 10
* usable: 15
* comments_safety: 10

Total: 100

## mbr110

* quality: 14.0
* does_task: 11.0
* skill_range: 7.0
* elegance: 6.0
* functions_variables: 7.0
* display: 8.0
* usable: 10.0
* comments_safety: 8.0

Total: 71

Martin Brett

You did a good job generally.  Etc.  More comments on specifics.

## vrr101

* quality: 5.0
* does_task: 6.0
* skill_range: 3.0
* elegance: 2.0
* functions_variables: 3.0
* display: 4.0
* usable: 5.0
* comments_safety: 3.0

Total: 55.0

Valia Rodriguez Rodriguez

You did not do a very good job, generally.  Etc.

命令行工具

命令需要当前目录中的文件 gdconfig.toml。

示例

log = "markingb_log.md"
year = "2018"
assignment = "Data Analysis Due (000000)"

[fudges]
2018 = 10

• gdo-check : 分析Markdown格式的评分日志，每个学生一个标题，以及每个组件的子总计。检查子总计是否与文件顶部的规范匹配，并检查并打印每个学生的总计。
• gdo-year : 打印配置文件（上述）中的“year”字段值。
• gdo-mkstable : 创建一个模板CSV文件以上传到Canvas，使用从Canvas导出的CSV文件作为输入。
• gdo-stinit : 为指定登录的学生创建评分日志中的部分。如果配置文件中存在字段 nb_template，则为学生创建匹配的笔记本。
• gdo-mkfb : 将评分日志分割成每个学生一个文件，为每个学生构建PDF。
• gdo-report : 从报告中写入分数CSV。

实用工具

• canvastools - 诠释Canvas输出文件名、读取Canvas输出CSV文件的各种实用工具。

安装、开发

通常从pip安装

pip install gradools

要从仓库本地安装，您需要flit。

flit install --user

开发时，我使用

flit install --user -s

测试使用

pip install -r test-requirements.txt
pytest gradools