truant

版本 1.2.0

truant 是一个命令行程序，可以读取包含从 Canvas 导出的考勤数据的 CSV 文件，并以易于阅读和理解的方式显示。

再说一遍？

Canvas（流行的课程管理系统）允许您进行考勤。它还允许您以多种方式查看考勤数据，并可以导出类似这样的 CSV 文件

246848,ENGL-230A-001.1234,ENGL-230A-001.1234,SHAKESPEARE
ENGL230A            SEC 001 Spring 2023,SHAKESPEARE
ENGL230A            SEC 001 Spring 2023,168353,ENGL-230A-001.1231,
82413,Stephen Ramsay,152891,Percy Henry,2023-01-24,present,
2023-01-24 18:34:35 UTC,""

但它不允许您点击按钮并得到类似这样的结果

Aguecheek, Andrew: 8
Andronicus, Titus: 0
Percy, Henry: 1
Denny, Anthony: 4
Pembroke, William: 0
Urswick, Christopher: 2

即使获取那个 CSV 文件也有点麻烦；您请求它，它会通过电子邮件发送给您一个（长、复杂的）链接，然后您从那里下载。

人们已经想出了聪明的解决方案。例如，有些人已经在 Microsoft Excel 中编写了交叉表，而其他人则找到了用 Google Sheets（来自 Google Drive）进行相同操作的方法。

我想要一个直接从原始 CSV 文件到上述输出的程序，而不需要“企业中介”，这就是 truant 做的事情。如果您下载 CSV 文件并将其重命名为“attendance.csv”，您可以这样做

$ truant attendance.csv

然后它将给出类似上面的输出。

（您不必重命名文件；truant 不在乎文件名是什么，但 Canvas 发送给您的文件名通常有点……不便。而且对那些其他方法的开发者没有任何冒犯之意。正如我所说的，它们相当聪明。它们可能对某些用户来说也非常方便。）

我如何安装此程序？

此程序是用 Rust 编写的，因此您需要在您的机器上安装 Rust 编译器。

假设您已经解决了这个问题，它可能类似于以下内容

$ cargo install truant

确切地 在哪里 安装二进制文件取决于您的本地配置，但 cargo 非常聪明，可以将其放在您喜欢的任何位置。

就是这样吗？

是的，就是这样。这就是它所做的一切。我可能会创建一个版本，可以可选地将显示的输出导出为JSON，因为这看起来像是良好的公民行为。但我没有立即计划添加这个功能。

它不起作用！

请与我联系。truant几乎不可能破坏数据或造成其他类型的损害，但名称非常复杂，我几乎可以肯定没有在名称字段中考虑到所有可能性。但我对任何形式的错误行为都感兴趣，所以请通过以下地址给我发邮件。

此外，请记住，CSV文件通常包含各种敏感信息。truant不会将其写入或保存到任何地方，但它不会试图让您免受自己行为的伤害。它只是一个普通的UNIX过滤器。

许可证

说到破坏和损害……

truant由Stephen Ramsay（sramsay{at}protonmail{dot}com）编写和维护。

此程序是自由软件：您可以在自由软件基金会的GNU通用公共许可证（GPL）的条款下重新分发和/或修改它，许可证版本为3或（根据您的选择）任何后续版本。

分发此程序是希望它将是有用的，但没有任何保证；甚至没有对适销性或特定用途适用性的暗示保证。有关详细信息，请参阅GNU通用公共许可证。

truant既未获得Instructure（Canvas的开发者和出版商）的认可，也与之无任何关联。

最后修改时间：2024-05-19T15:57:01:-0500