CS107 How to submit

Written by Julie Zelenski

When finished with an assignment, you submit it for grading. It's important to recognize the difference between commit and submit. You use hg commit to record a snapshot in your revision history. You will make many commits during development, but these commits are stored only in the history of your local repo. When finished, you must explicitly submit; this final act copies your work to your class repo (the one that lives in /afs/ir/class/cs107) so that it is available to the staff to be graded.

Log into a myth machine.
Use the cd command to change into the directory containing your project repo.
Verify that all of your files are up-to-date and committed. The output of hg diff should be empty.
Issue the command
```
/afs/ir/class/cs107/tools/submit
```
The submit tool first verifies your project's readiness for submission. The project must have no uncommitted changes and must compile successfully. It will offer you the option to run sanity check (responding 'no' will skip it). If any part of verification fails, it will reject the project and you must fix the issues and try submit again.
If verification passes and submissions are being accepted, the project is submitted and a confirmation message indicates the submission was successfully made. If the deadline has passed and grace period expired, the submission is rejected.
You can submit as many times as you want. To submit an updated version, just repeat the same steps. Only your last submission will be graded.
If you run into a submit failure that you cannot resolve, please seek help from the course staff or the discussion forum. We recommend that you make a test submit well in advance of the deadline to confirm things will roll smoothly when the time comes.

Submission deadlines are firm. Cutting it too close runs the risk of landing on the wrong side -- don't let this happen to you! Computers can sense fear and that's just when you are going to hit a snag or network bottleneck... submit early to give yourself a safety cushion and avoid the last-minute stress!

Frequently asked questions about submit

Can I submit a program that doesn't pass sanity check?

We strongly recommend that you resolve any sanity check failures before submitting, but the submit tool will not force you to do so. To submit a project doesn't pass sanity check, respond no when asked if you want to run sanity check, and the project will be submitted without that check.

How can I verify my submission?

This is not a necessary step, but if helps you sleep easier, you can review the contents of your submission in your class repo. Your class repo lives in /afs/ir/class/cs107/repos/assignN/$USER. (N is a placeholder, replace with the assignment number in question). You can cd into this directory but you won't be able to directly read the files or view the contents via ls. Instead, use Mercurial commands to review the repo contents. Here are two ways to double-check your class repo:

Review the history of your class repo and verify the tip revision is the intended submission. Change to your class repo using cd /afs/ir/class/cs107/repos/assignN/$USER and do an hg log. The most recent revision (the "tip") is the one we will grade. Verify that the log listing shows the correct revision as the tip. Use the command hg manifest -r tip to list all files being tracked in the tip revision and ensure all the files you intended to be there for grading are listed.
View the entire contents of that tip revision by re-cloning your class repo. This allows you to verify that the tip contains the desired versions of all files. For example, cd to your home directory and use hg clone /afs/ir/class/cs107/repos/assignN/$USER mysubmission to create a mysubmission directory that contains the tip revision. If you're satisfied that everything you want us to see is there, then you're done. If not, use the clone to to figure out what's not right (forgot to hg add a file? didn't commit your most recent change?), fix it, and make another submission.