Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Make it clearer how to set due dates #546

Merged
merged 1 commit into from
Sep 9, 2016
Merged

Make it clearer how to set due dates #546

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion nbgrader/docs/source/configuration/jupyterhub/nbgrader_config.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@

c.NbGrader.course_id = "example_course"
c.TransferApp.exchange_directory = "/tmp/exchange"
c.NbGrader.db_assignments = [dict(name="ps1")]
c.NbGrader.db_assignments = [dict(name="ps1", duedate="2015-02-02 17:00:00 UTC")]
c.NbGrader.db_students = [
dict(id="bitdiddle", first_name="Ben", last_name="Bitdiddle"),
dict(id="hacker", first_name="Alyssa", last_name="Hacker"),
Expand Down
19 changes: 13 additions & 6 deletions nbgrader/docs/source/user_guide/creating_and_grading_assignments.ipynb
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -392,7 +392,7 @@
"%%file nbgrader_config.py\n",
"\n",
"c = get_config()\n",
"c.NbGrader.db_assignments = [dict(name=\"ps1\")]\n",
"c.NbGrader.db_assignments = [dict(name=\"ps1\", duedate=\"2015-02-02 17:00:00 UTC\")]\n",
"c.NbGrader.db_students = [\n",
" dict(id=\"bitdiddle\", first_name=\"Ben\", last_name=\"Bitdiddle\"),\n",
" dict(id=\"hacker\", first_name=\"Alyssa\", last_name=\"Hacker\"),\n",
Expand Down Expand Up @@ -427,7 +427,7 @@
"output_type": "stream",
"text": [
"[AssignApp | INFO] Copying /Users/jhamrick/project/tools/nbgrader/nbgrader/docs/source/user_guide/source/./ps1/jupyter.png -> /Users/jhamrick/project/tools/nbgrader/nbgrader/docs/source/user_guide/release/./ps1/jupyter.png\n",
"[AssignApp | INFO] Updating/creating assignment 'ps1': {}\n",
"[AssignApp | INFO] Updating/creating assignment 'ps1': {'duedate': '2015-02-02 17:00:00 UTC'}\n",
"[AssignApp | INFO] Converting notebook /Users/jhamrick/project/tools/nbgrader/nbgrader/docs/source/user_guide/source/./ps1/problem1.ipynb to notebook\n",
"[AssignApp | INFO] Writing 8174 bytes to /Users/jhamrick/project/tools/nbgrader/nbgrader/docs/source/user_guide/release/./ps1/problem1.ipynb\n",
"[AssignApp | INFO] Converting notebook /Users/jhamrick/project/tools/nbgrader/nbgrader/docs/source/user_guide/source/./ps1/problem2.ipynb to notebook\n",
Expand Down Expand Up @@ -583,7 +583,7 @@
"text": [
"\r\n",
"c = get_config()\r\n",
"c.NbGrader.db_assignments = [dict(name=\"ps1\")]\r\n",
"c.NbGrader.db_assignments = [dict(name=\"ps1\", duedate=\"2015-02-02 17:00:00 UTC\")]\r\n",
"c.NbGrader.db_students = [\r\n",
" dict(id=\"bitdiddle\", first_name=\"Ben\", last_name=\"Bitdiddle\"),\r\n",
" dict(id=\"hacker\", first_name=\"Alyssa\", last_name=\"Hacker\"),\r\n",
Expand Down Expand Up @@ -618,6 +618,7 @@
"[AutogradeApp | INFO] Copying /Users/jhamrick/project/tools/nbgrader/nbgrader/docs/source/user_guide/submitted/bitdiddle/ps1/timestamp.txt -> /Users/jhamrick/project/tools/nbgrader/nbgrader/docs/source/user_guide/autograded/bitdiddle/ps1/timestamp.txt\n",
"[AutogradeApp | INFO] Creating/updating student with ID 'bitdiddle': {'first_name': 'Ben', 'last_name': 'Bitdiddle'}\n",
"[AutogradeApp | INFO] SubmittedAssignment<ps1 for bitdiddle> submitted at 2015-02-02 22:58:23.948203\n",
"[AutogradeApp | WARNING] SubmittedAssignment<ps1 for bitdiddle> is 21503.948203 seconds late\n",
"[AutogradeApp | INFO] Overwriting files with master versions from the source directory\n",
"[AutogradeApp | INFO] Copying /Users/jhamrick/project/tools/nbgrader/nbgrader/docs/source/user_guide/source/./ps1/jupyter.png -> /Users/jhamrick/project/tools/nbgrader/nbgrader/docs/source/user_guide/autograded/bitdiddle/ps1/jupyter.png\n",
"[AutogradeApp | INFO] Sanitizing /Users/jhamrick/project/tools/nbgrader/nbgrader/docs/source/user_guide/submitted/bitdiddle/ps1/problem1.ipynb\n",
Expand All @@ -628,13 +629,19 @@
"[AutogradeApp | INFO] Autograding /Users/jhamrick/project/tools/nbgrader/nbgrader/docs/source/user_guide/autograded/bitdiddle/ps1/problem1.ipynb\n",
"[AutogradeApp | INFO] Converting notebook /Users/jhamrick/project/tools/nbgrader/nbgrader/docs/source/user_guide/autograded/bitdiddle/ps1/problem1.ipynb to notebook\n",
"[AutogradeApp | INFO] Executing notebook with kernel: python\n",
"[AutogradeApp | WARNING] SubmittedAssignment<ps1 for bitdiddle> is 21503.948203 seconds late\n",
"[AutogradeApp | INFO] Using late submission penalty method: none\n",
"[AutogradeApp | WARNING] Late submission penalty: None\n",
"[AutogradeApp | INFO] Writing 13736 bytes to /Users/jhamrick/project/tools/nbgrader/nbgrader/docs/source/user_guide/autograded/bitdiddle/ps1/problem1.ipynb\n",
"[AutogradeApp | INFO] Sanitizing /Users/jhamrick/project/tools/nbgrader/nbgrader/docs/source/user_guide/submitted/bitdiddle/ps1/problem2.ipynb\n",
"[AutogradeApp | INFO] Converting notebook /Users/jhamrick/project/tools/nbgrader/nbgrader/docs/source/user_guide/submitted/bitdiddle/ps1/problem2.ipynb to notebook\n",
"[AutogradeApp | INFO] Writing 2557 bytes to /Users/jhamrick/project/tools/nbgrader/nbgrader/docs/source/user_guide/autograded/bitdiddle/ps1/problem2.ipynb\n",
"[AutogradeApp | INFO] Autograding /Users/jhamrick/project/tools/nbgrader/nbgrader/docs/source/user_guide/autograded/bitdiddle/ps1/problem2.ipynb\n",
"[AutogradeApp | INFO] Converting notebook /Users/jhamrick/project/tools/nbgrader/nbgrader/docs/source/user_guide/autograded/bitdiddle/ps1/problem2.ipynb to notebook\n",
"[AutogradeApp | INFO] Executing notebook with kernel: python\n",
"[AutogradeApp | WARNING] SubmittedAssignment<ps1 for bitdiddle> is 21503.948203 seconds late\n",
"[AutogradeApp | INFO] Using late submission penalty method: none\n",
"[AutogradeApp | WARNING] Late submission penalty: None\n",
"[AutogradeApp | INFO] Writing 2554 bytes to /Users/jhamrick/project/tools/nbgrader/nbgrader/docs/source/user_guide/autograded/bitdiddle/ps1/problem2.ipynb\n",
"[AutogradeApp | INFO] Setting destination file permissions to 444\n",
"[AutogradeApp | INFO] Copying /Users/jhamrick/project/tools/nbgrader/nbgrader/docs/source/user_guide/submitted/hacker/ps1/jupyter.png -> /Users/jhamrick/project/tools/nbgrader/nbgrader/docs/source/user_guide/autograded/hacker/ps1/jupyter.png\n",
Expand Down Expand Up @@ -673,7 +680,7 @@
"source": [
"When grading the submission for `Bitdiddle`, you'll see some warnings that look like \"Checksum for grade cell correct_squares has changed!\". What's happening here is that nbgrader has recorded what the *original* contents of the grade cell `correct_squares` (when `nbgrader assign` was run), and is checking the submitted version against this original version. It has found that the submitted version changed (perhaps this student tried to cheat by commenting out the failing tests), and has therefore overwritten the submitted version of the tests with the original version of the tests.\n",
"\n",
"You may also notice that there is a note saying \"ps1 for Bitdiddle is 86303.948203 seconds late\". What is happening here is that nbgrader is detecting a file in Bitdiddle's submission called `timestamp.txt`, reading in that timestamp, and saving it into the database. From there, it can compare the timestamp to the duedate of the problem set, and compute whether the submission is at all late.\n",
"You may also notice that there is a note saying \"ps1 for Bitdiddle is 21503.948203 seconds late\". What is happening here is that nbgrader is detecting a file in Bitdiddle's submission called `timestamp.txt`, reading in that timestamp, and saving it into the database. From there, it can compare the timestamp to the duedate of the problem set, and compute whether the submission is at all late.\n",
"\n",
"Once the autograding is complete, there will be new directories for the autograded versions of the submissions:\n",
"\n",
Expand Down Expand Up @@ -958,8 +965,8 @@
"output_type": "stream",
"text": [
"assignment,duedate,timestamp,student_id,last_name,first_name,email,raw_score,late_submission_penalty,score,max_score\n",
"ps1,,2015-02-02 22:58:23.948203,bitdiddle,Bitdiddle,Ben,,1.5,0.0,1.5,9.0\n",
"ps1,,2015-02-01 17:28:58.749302,hacker,Hacker,Alyssa,,3.0,0.0,3.0,9.0\n"
"ps1,2015-02-02 17:00:00,2015-02-02 22:58:23.948203,bitdiddle,Bitdiddle,Ben,,1.5,0.0,1.5,9.0\n",
"ps1,2015-02-02 17:00:00,2015-02-01 17:28:58.749302,hacker,Hacker,Alyssa,,3.0,0.0,3.0,9.0\n"
]
}
],
Expand Down
4 changes: 2 additions & 2 deletions nbgrader/docs/source/user_guide/grades.csv
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
assignment,duedate,timestamp,student_id,last_name,first_name,email,raw_score,late_submission_penalty,score,max_score
ps1,,2015-02-02 22:58:23.948203,bitdiddle,Bitdiddle,Ben,,1.5,0.0,1.5,9.0
ps1,,2015-02-01 17:28:58.749302,hacker,Hacker,Alyssa,,3.0,0.0,3.0,9.0
ps1,2015-02-02 17:00:00,2015-02-02 22:58:23.948203,bitdiddle,Bitdiddle,Ben,,1.5,0.0,1.5,9.0
ps1,2015-02-02 17:00:00,2015-02-01 17:28:58.749302,hacker,Hacker,Alyssa,,3.0,0.0,3.0,9.0
32 changes: 16 additions & 16 deletions nbgrader/docs/source/user_guide/managing_assignment_files.ipynb
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -346,9 +346,9 @@
"output_type": "stream",
"text": [
"total 40\n",
"-rw-r--r-- 1 jhamrick wheel 5733 Sep 8 15:19 jupyter.png\n",
"-rw-r--r-- 1 jhamrick wheel 8174 Sep 8 15:19 problem1.ipynb\n",
"-rw-r--r-- 1 jhamrick wheel 2518 Sep 8 15:19 problem2.ipynb\n"
"-rw-r--r-- 1 jhamrick wheel 5733 Sep 8 15:35 jupyter.png\n",
"-rw-r--r-- 1 jhamrick wheel 8174 Sep 8 15:35 problem1.ipynb\n",
"-rw-r--r-- 1 jhamrick wheel 2518 Sep 8 15:35 problem2.ipynb\n"
]
}
],
Expand Down Expand Up @@ -488,8 +488,8 @@
"output_type": "stream",
"text": [
"[SubmitApp | INFO] Source: /private/tmp/student_home/ps1\n",
"[SubmitApp | INFO] Destination: /tmp/exchange/example_course/inbound/jhamrick+ps1+2016-09-08 22:19:48 UTC\n",
"[SubmitApp | INFO] Submitted as: example_course ps1 2016-09-08 22:19:48 UTC\n"
"[SubmitApp | INFO] Destination: /tmp/exchange/example_course/inbound/jhamrick+ps1+2016-09-08 22:36:01 UTC\n",
"[SubmitApp | INFO] Submitted as: example_course ps1 2016-09-08 22:36:01 UTC\n"
]
}
],
Expand Down Expand Up @@ -519,9 +519,9 @@
"output_type": "stream",
"text": [
"total 8\n",
"drwxr-xr-x 3 jhamrick wheel 102 Sep 8 15:19 Library\n",
"-rw-r--r-- 1 jhamrick wheel 108 Sep 8 15:19 nbgrader_config.py\n",
"drwxr-xr-x 5 jhamrick wheel 170 Sep 8 15:19 ps1\n"
"drwxr-xr-x 3 jhamrick wheel 102 Sep 8 15:36 Library\n",
"-rw-r--r-- 1 jhamrick wheel 108 Sep 8 15:35 nbgrader_config.py\n",
"drwxr-xr-x 5 jhamrick wheel 170 Sep 8 15:35 ps1\n"
]
}
],
Expand Down Expand Up @@ -551,7 +551,7 @@
"output_type": "stream",
"text": [
"[ListApp | INFO] Submitted assignments:\n",
"[ListApp | INFO] example_course jhamrick ps1 2016-09-08 22:19:48 UTC\n"
"[ListApp | INFO] example_course jhamrick ps1 2016-09-08 22:36:01 UTC\n"
]
}
],
Expand Down Expand Up @@ -581,8 +581,8 @@
"output_type": "stream",
"text": [
"[SubmitApp | INFO] Source: /private/tmp/student_home/ps1\n",
"[SubmitApp | INFO] Destination: /tmp/exchange/example_course/inbound/jhamrick+ps1+2016-09-08 22:19:51 UTC\n",
"[SubmitApp | INFO] Submitted as: example_course ps1 2016-09-08 22:19:51 UTC\n"
"[SubmitApp | INFO] Destination: /tmp/exchange/example_course/inbound/jhamrick+ps1+2016-09-08 22:36:05 UTC\n",
"[SubmitApp | INFO] Submitted as: example_course ps1 2016-09-08 22:36:05 UTC\n"
]
}
],
Expand Down Expand Up @@ -612,8 +612,8 @@
"output_type": "stream",
"text": [
"[ListApp | INFO] Submitted assignments:\n",
"[ListApp | INFO] example_course jhamrick ps1 2016-09-08 22:19:48 UTC\n",
"[ListApp | INFO] example_course jhamrick ps1 2016-09-08 22:19:51 UTC\n"
"[ListApp | INFO] example_course jhamrick ps1 2016-09-08 22:36:01 UTC\n",
"[ListApp | INFO] example_course jhamrick ps1 2016-09-08 22:36:05 UTC\n"
]
}
],
Expand Down Expand Up @@ -758,8 +758,8 @@
"output_type": "stream",
"text": [
"[ListApp | INFO] Submitted assignments:\n",
"[ListApp | INFO] example_course jhamrick ps1 2016-09-08 22:19:48 UTC\n",
"[ListApp | INFO] example_course jhamrick ps1 2016-09-08 22:19:51 UTC\n"
"[ListApp | INFO] example_course jhamrick ps1 2016-09-08 22:36:01 UTC\n",
"[ListApp | INFO] example_course jhamrick ps1 2016-09-08 22:36:05 UTC\n"
]
}
],
Expand Down Expand Up @@ -818,7 +818,7 @@
"total 0\n",
"drwxr-xr-x 3 jhamrick staff 102 Apr 4 13:05 bitdiddle\n",
"drwxr-xr-x 3 jhamrick staff 102 Apr 4 13:05 hacker\n",
"drwxr-xr-x 3 jhamrick staff 102 Sep 8 15:19 jhamrick\n"
"drwxr-xr-x 3 jhamrick staff 102 Sep 8 15:36 jhamrick\n"
]
}
],
Expand Down
2 changes: 1 addition & 1 deletion nbgrader/docs/source/user_guide/philosophy.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -88,7 +88,7 @@ You will almost always need a configuration file as you are using nbgrader. At a
::

c = get_config()
c.NbGrader.db_assignments = [dict(name="ps1")]
c.NbGrader.db_assignments = [dict(name="ps1", duedate="2015-02-02 17:00:00 UTC")]
c.NbGrader.db_students = [
dict(id="bitdiddle", first_name="Ben", last_name="Bitdiddle"),
dict(id="hacker", first_name="Alyssa", last_name="Hacker"),
Expand Down