Assignment Requirements

This page lists the example project requirements for Example 2 in CC 410. Read the requirements carefully and discuss any questions with the instructors or TAs.

Purpose

This example will cover creating new packages, classes, and enumerations within an existing project. Similar to the restaurant project, the examples will cover a smaller subset of those requirements as part of a fictional ice cream shop.

General Requirements

This milestone must follow these professional coding standards:

• All code must be object-oriented.
  • All executable code must be within a class
    • Python package files such as __init__.py and __main__.py are exempt.
  • Classes must be organized into packages based on common usage.
• This project must include automation for compilation and execution.
  • Java: Use Gradle with the application plugin. The project should compile without errors. You may include a main class in a separate package for testing purposes only.
  • Python: Use tox configured to use Python 3.10 and a requirements file to install libraries. You may include a main class in a separate package for testing purposes only.
• All code must properly compile or be interpreted.
  • Java: It must compile using Gradle.
  • Python: It must be interpreted using Python 3.109. Where specified, type hints should be included in the code, and all code should pass a strict Mypy type check.
• Submissions to Canvas should be tagged GitHub releases that are numbered according to Semantic Versioning.

Assignment Requirements

This milestone should include the following features:

• Sundae classes - 1
  • Declared in the starfleettreats.data.sundaes package
• Enumeration classes - 2
  • Declared in the starfleettreats.data.enums package

See the Starfleet Treats Menu section below for descriptions of what each class should contain.

Time Requirements

Completing this project is estimated to require 1 hour.

Grading Rubric

This assignment will be graded based on the rubric below:

• Sundae classes - 70%
• Enumeration classes - 30%

The following deductions apply:

• Any portion of the project which will not compile (Java), pass a strict type check (Python), or execute properly will be given a grade of 0.

This is not an exhaustive list of possible deductions. The instructors will strive to provide reasonable and fair grading, but we can’t predict all possible defects. It is up to the student to ensure that the project is complete and correct before submission.

Submission

Submit this assignment by creating a release on GitHub and uploading the release URL to the assignment on Canvas. You should not submit this Codio project or mark it as complete in Codio, in case you need to come back to it and make changes later.

Sundaes

Each sundae should be stored in an appropriately named class in the starfleettreats.data.sundaes package. Each sundae should include an attribute for the following data:

• Container - a Container value (see below). It should have a getter and setter method.
• Toppings - a Java HashSet or a Python set of Topping values (see below).
  • This attribute should have a getter method that returns a shallow copy of the set to prevent external modification. See HashSet’s Copy Constructor (Java) or set.copy (Python).
  • This attribute should also have methods for Add Topping and Remove Topping to modify the list of toppings.

In addition, each sundae should have the ability to return the following data through an appropriate getter method. The data may be stored as attributes or hard coded directly into the method.

• Price - a Java double or Python float value.
• Calories - an int value.
• Special Instructions - a Java LinkedList of String values or a Python list of str values.
  • If stored as an attribute, it should return a shallow copy of the list to prevent external modification. See LinkedList’s Copy Constructor (Java) or list.copy (Python).

Each sundae class should also override the default string representation method (toString() in Java or __str__() in Python) and return a string that properly describes the sundae. The string should be formatted as “{sundae name} in a {container}”, such as “The Classic in a Waffle Cone”.

It should also override the default equality method (equals() in Java or __eq__() in Python). Two items should be considered equal only if the values of all attributes are equal.

Each sundae description will include a list of ingredients included on the sundae. Those ingredients should be represented using Boolean attributes that are set to true by default, with appropriate getter and setter methods. Changing any of these to false will cause a “Hold {ingredient}” message, such as “Hold Vanilla”, to be added to the Special Instructions list. Likewise, changing it back to true will remove the appropriate message. If all ingredients are at their default values, the Special Instructions list should be empty.

Likewise, each sundae description will include a Price, number of Calories, a default value for Container and a default set of Toppings. Those attributes should be populated appropriately in the constructor for the sundae. Changes to the Container and Toppings attributes will not affect the Special Instructions attribute. Likewise, the Price and number of Calories will remain constant, regardless of other attributes.

The Classic (Banana Split)

it doesn’t get more traditional that this

starfleettreats.data.sundaes.TheClassic - The price is $5.50 and it is 1050 calories. Served in a Waffle Cone with Vanilla and Banana. Comes with Chocolate, Whipped Cream, and Cherry.

Enumerations

Each enumeration should be stored in an appropriately named class in the starfleetsubs.data.enums package. Each enumeration should be stored in an appropriately named class in the starfleetsubs.data.enums package. Each enumeration class should also override the default string representation method (toString() in Java or __str__() in Python) and return a string that properly describes the item. Python developers may also wish to override the __repr__() method to return this value as well.

Containers

a vessel to contain the deliciousness

starfleettreats.data.enums.Container - Dish, Cake Cone, Waffle Cone

Toppings

build your own top-notch treat

starfleettreats.data.enums.Topping - Chocolate, Whipped Cream, Cherry, Caramel, Peanuts

Java

Outline

Here is a basic outline of the steps to follow to complete this example.

1. Clone Starter Code from GitHub

git clone <url> java

2. Install SDKMAN

Instructions

curl -s "https://get.sdkman.io" | bash

3. Close and Reopen Terminal to load SDK Man
4. Install Gradle

sdk install gradle 7.6

5. Compile, Run & Test Existing Project

cd java
gradle run
gradle test
gradle check
gradle javadoc

6. Confirm that project runs, all unit tests pass with 100% coverage, no style errors, and Javadoc generates properly.

7. Create New Packages, Classes, and Enums. Continuously commit to Git as changes are made!

8. Update HelloWorld.java to use new classes (optional). This is just for testing purposes.

9. When complete, use Git to commit and push updated code.

git add .
git commit -m "Example Complete"
git push

10. On GitHub, create a release tag and submit URL to Canvas for grading.

Python

Outline

Here is a basic outline of the steps to follow to complete this example.

1. Clone Starter Code from GitHub

git clone <url> python

2. Run Project

cd python
python3 -m src

3. Install Tox

pip3 install tox

4. Check & Test Existing Project

python3 -m tox

5. Confirm that project runs, all unit tests pass with 100% coverage, no style errors, no type errors, and documentation generates properly.

6. Create New Packages, Classes, and Enums. Continuously commit to Git as changes are made!

7. Update HelloWorld.py to use new classes (optional). This is just for testing purposes.

8. When complete, use Git to commit and push updated code.

git add .
git commit -m "Example Complete"
git push

9. On GitHub, create a release tag and submit URL to Canvas for grading.