Appendix E — Install and use the checker

The checker runs on your computer and gives feedback on public test cases. It is for developing your work; checking a file does not submit it for grading.

E.1 Fresh Install

An internet connection is required for this step, but Git is not. Choose the instructions for your computer:

Open Anaconda Prompt from the Start menu, then run:

python -m pip install "https://github.com/jgostick/UW-NE111-checker/archive/refs/heads/main.zip"

Open Terminal, then run:

python3 -m pip install "https://github.com/jgostick/UW-NE111-checker/archive/refs/heads/main.zip"

E.2 Updated Install

You will probably need to update the checker from time to time, which can be done by adding --upgrade to the previous command.

Open Anaconda Prompt from the Start menu, then run:

python -m pip install --upgrade "https://github.com/jgostick/UW-NE111-checker/archive/refs/heads/main.zip"

Open Terminal, then run:

python3 -m pip install --upgrade "https://github.com/jgostick/UW-NE111-checker/archive/refs/heads/main.zip"

E.3 Check your assignment

Save your work as A1.ipynb in a folder you can find again. You can launch the checker from any folder and select your saved file in its browser interface.

Open Anaconda Prompt and start the checker:
```
python -m ne111_checker A1
```
To stop it, return to Anaconda Prompt and press Ctrl+C. If that does not work, press Ctrl+Break (or Ctrl+Fn+Pause on some laptops).

Open Terminal and start the checker:
```
python3 -m ne111_checker A1
```
To stop it, return to Terminal and press Ctrl+C.

Your browser should open automatically. Click Browse… to open your computer’s standard file dialog, select A1.ipynb, and click Open. The selected file’s full path appears above the question tabs. If A1.ipynb is already in the folder where you launched the checker, it is selected automatically.

Open each question tab and choose Run A1Q… cell. Read the feedback, revise the tagged cell in Jupyter, save the notebook, and run the check again. The checker remembers the selected file for the session and rereads its saved contents each time you run a question. You do not need to select it again after each edit.

For assignments submitted as Python files, use the assignment number and filename specified in the handout in place of A1 and A1.ipynb. Save all required function definitions in that .py file. The checker imports the file and calls the named functions with its own inputs, so each function must return its result. Use the Run button for the appropriate function, save any changes in your editor, and run the check again. Notebook cell tags and the variable answer are only required for notebook submissions.