EX04 – JUnit Tests!

0. Complete the Prerequisites

Before continuing on, make sure you’re caught up on the lectures through 5/22 and completed EX03.

1. Unit tests for the Complex Number ADT.

In your ex03 package, right click and create a new java class called ComplexNumberTests. This is the file where you will write your test suite. Please write 2 Unit Tests for each one of methods from EX03, excluding the constructor. So, this should be 12 methods in total.

You will make use of the assertEquals and method we saw in class to check if the results of your methods match what is expected. Additionally, when checking for boolean conditions (i.e. with the ComplexNumberImpl equals method), you should use the assertTrue or assertFalse methods provided by the JUnit Library. For example,

Example e = new Example();
boolean b = e.is_alive();
assertTrue(b);

2. Make a Backup Checkpoint “Commit”

“Push” your work up to GitHub for backup. By creating “commits”, which you can think of as versioned checkpoints in your workspace, you are not at risk of losing your work. It’s easy to revert back to an old version or to restore your entire workspace on a different computer.

1. Select the Git menu along the top of your screen and then choose “Commit”.
2. Notice the files listed under Changes. These are files you’ve made modifications to since your last backup.
3. Ensure all the files that you’d like to backup are selected. Your cursor should be inside of a message box where you will write a nice description of the modifications you’ve made to your code, like “Finished EX04!”, and then hit the “Commit” button.
   • If you do not want to backup all changed files, you can select them individually. For this course you’re encouraged to back everything up.
   • IntelliJ might tell you there are some warnings or errors here, and you should just commit anyway!
4. If you open the Git at the bottom of your screen, you should see this commit added to your chain of git commits. However, it has just been added to your local main branch, and needs to be pushed to your remote backup.
5. Select the Git menu along the top of your screen again and then choose “Push”.
6. A pop-up should appear that displays: “main -> backup : main”, which means your latest local commit on the local main branch is going to be pushed to the main branch on the remote backup. If you see “main -> origin : main”, just click where it says origin and select backup. Hit the “Push” button.
7. If you want to see your backed up work on Github, navigate to the following URL but replace USERNAME with your GitHub username:
   • https://github.com/comp210-ss1-24/summer210-workspace-USERNAME
   • You can also verify it was pushed successfully by opening the Git view along the bottom of your screen and verifying the latest commit appears on the local and remote branches. (The text next to the tag icons should say backup & main, next to the latest commit message)

4. Submit to Gradescope for Grading

All that’s left now is to hand-in your work on Gradescope for grading! IMPORTANT This assignment will be manually graded.

Before doing so, you need to know that before an assignment’s deadline you can resubmit work as many times as you need to without penalty. Portions of assignments are autograded and will provide near-immediate feedback. We want you to resubmit as many times as it takes you in order to earn full autograding credit!

Login to Gradescope and select the assignment named “EX04 - Unit Tests” You’ll see an area to upload a zip file. To produce a zip file for autograding, return back to IntelliJ.

Mac Users

Along the bottom of your window, you should see an option to open a terminal integrated into IntelliJ.

Type the following command (all on a single line):

./submit.sh ex03

In the file explorer pane, look to find the zip file named “ex03_submission.zip”. The script will call it an ex03 submission since that is the package we zipped. If you right click on this file “Open in -> Finder” on Mac, the zip file’s location on your computer will open. Upload this file to Gradescope to submit your work for this exercise.

Windows Users

We are working on rewriting the script to work for Windows! Until then, please navigate to your course workspace in a File Explorer window. Then right click on the src folder in your exercises directory and compress the directory into a zip folder. You can name it “ex04_submission.zip”

When you upload it to Gradescope, please delete any files that showed up in the src/ folder that were not actually part of ex03. You should include the ComplexNumber Interface, ComplexNumberImpl Class, and ComplexNumberTests in your zip.