eduxator 0.0.1.dev1

想法

在这里，我将尝试解释eduxator将做什么。我将使用现在时，这样在未来修改文本会更容易。

Eduxator是一个具有交互式控制台的命令行工具。它的目的是为学生评分并将这些评分保存到Edux。为了告诉eduxator您打算给出什么类型的评分，您应该提供一些信息，例如

• 课程名称（例如BI-3DT，BI-SAP…）

• 我们正在处理的学生类型（例如全日制，非全日制）

• 正在发生的课程类型（例如辅导课，实验室，讲座，考试）

• 当前课程有什么标识符（例如1，101…）

• 您这次要填写分类图表中的哪一列（例如cv01，tut8…）

您可以将这些信息作为命令行参数提供，eduxator将尝试解析所有参数并确定如何处理它们。如果您省略了某些信息，eduxator将交互式地询问您或选择唯一可用的选项（例如，如果您课程中只有全日制学生，您无需指定它）。以下命令将是完美的

eduxator BI-3DT 3 cv1

请注意，BI-3DT 只有全职教程，因此这些信息被省略，不会造成任何损害。参数的顺序不重要，eduxator 首先会寻找任何有效的课程标识符，然后是全职/兼职等。如果有多个参数可以匹配某个东西，你将交互式地进行询问。你也可以直接省略所有内容，让 eduxator 询问你需要什么。

$ eduxator
Cannot see Edux cookie in ~./.edux.cookie
Please provide the name and value of your cookie from Edux. The one where name
looks like it's random generated is the one. Enter the cookie's name:
> oihgYftudy654hvkgjgdbytuTGB
Cookie's value:
> jkf67HJFKHtg%hh@hjGK67FghjHggqwerty
Good, I feel your anger. Should I save this to ~./.edux.cookie to save you
some pain later? (Y/n):
> y
What course do you want (use tab to help yourself):
> B[tab]
> BI-
> BI-3[tab]
> BI-3DT
What is the identifier for this tutorial (1, 2, 3):
> 3
What column you want to edit (use tab to help yourself):
> [tab]
> cv
> cv[tab]
cv1 cv2 cv3 cv4 cv5 cv8 cv9 cv10 cv11
> cv1
All set up. Hint: Use the following command to start eduxator using the same setup:
    eduxator BI-3DT 3 cv1
You are ready to give points. Type student's username (tab works again)
to know what number of points she has. Follow the username by N or +N
or -N to set points. Type help to see other commands.
> hr[tab]
> hroncmir
hroncmir: (unset)
> hroncmir +1
hroncmir: 1
> hroncmir +1.5
hroncmir: 2.5
> hroncmir 1
hroncmir 1
> undo
hroncmir 2.5
> hroncmir +1
hroncmir 3.5
> hroncmir 0
hroncmir 0
> unset hroncmir
hroncmir: (unset)
> help
You can use the following commands: undo, unset, stats, info, points, bye, exit.
Use help <command> to get more info.
> [Ctrl+D]

每次在添加、减去或更改分数之前，都会从 Edux 获取真实值，因此多个教师应该能够并行使用 eduxator。然而，撤销功能将值设置为命令运行之前最后已知值，因此在并行环境中可能会有风险。特别是如果你做了几个这样的操作，或者你没有在执行上一个命令后立即运行它。