chore: adds lesson 07 content

.github/workflows/check_lesson_07_pr.yml

@@ -0,0 +1,33 @@
+name: Check Lesson 07 Pull Request
+
+on:
+ pull_request:
+ branches: [ "main" ]
+ paths:
+ - "lesson_07/exceptions/**"
+
+jobs:
+ build:
+
+ runs-on: ubuntu-latest
+ permissions:
+ contents: read
+
+ steps:
+ - uses: actions/checkout@v4
+ - name: Set up JDK 17
+ uses: actions/setup-java@v4
+ with:
+ java-version: '17'
+ distribution: 'temurin'
+
+ # Configure Gradle for optimal use in GiHub Actions, including caching of downloaded dependencies.
+ # See: https://github.com/gradle/actions/blob/main/setup-gradle/README.md
+ - name: Setup Gradle
+ uses: gradle/actions/setup-gradle@417ae3ccd767c252f5661f1ace9f835f9654f2b5 # v3.1.0
+
+ - name: Build Lesson 07 with Gradle Wrapper
+ working-directory: ./lesson_07/exceptions
+ run: ./gradlew check
+
+

.github/workflows/check_push.yml

@@ -51,6 +51,10 @@ jobs:
  working-directory: ./lesson_06/conditionals
  run: ./gradlew assemble && ./gradlew spotlessCheck
 
+ - name: Build Lesson 07 with Gradle Wrapper
+ working-directory: ./lesson_07/exceptions
+ run: ./gradlew assemble && ./gradlew spotlessCheck
+
  - name: Build Shared Lib with Gradle Wrapper
  working-directory: ./lib/java/codedifferently-instructional
  run: ./gradlew check

lesson_06/README.md

@@ -10,4 +10,4 @@
 This exercise will provide you ample opportunities to practice your understanding of conditional expressions and loops. To complete this assignment, implement the functions in [Lesson6.java][lesson6-file], ensure the tests pass, and submit a PR. Remember to use the [Conventional Commits][conventional-commits] spec for your commit messages and pull requests.
 
 [lesson6-file]: ./conditionals/conditionals_app/src/main/java/com/codedifferently/lesson6/Lesson6.java
-[conventional-commits]: https://www.conventionalcommits.org/en/v1.0.0/
+[conventional-commits]: https://www.conventionalcommits.org/en/v1.0.0/

lesson_06/conditionals/conditionals_app/src/test/java/com/codedifferently/lesson6/Lesson6Test.java

@@ -121,4 +121,4 @@ void testBinarySearch() {
  // Test for value not present in the array
  assertThat(Lesson6.binarySearch(values, 0, values.length - 1, 4)).isEqualTo(-1);
  }
-}
+}

lesson_07/README.md

@@ -0,0 +1,3 @@
+# Lesson 07
+
+TODO(anthonydmays): Finish this

lesson_07/exceptions/.gitattributes

@@ -0,0 +1,9 @@
+#
+# https://help.github.com/articles/dealing-with-line-endings/
+#
+# Linux start script should use lf
+/gradlew text eol=lf
+
+# These are Windows script files and should use crlf
+*.bat text eol=crlf
+

lesson_07/exceptions/.gitignore

@@ -0,0 +1,5 @@
+# Ignore Gradle project-specific cache directory
+.gradle
+
+# Ignore Gradle build output directory
+build

lesson_07/exceptions/exceptions_app/build.gradle.kts

@@ -0,0 +1,64 @@
+plugins {
+ // Apply the application plugin to add support for building a CLI application in Java.
+ application
+ eclipse
+ id("com.diffplug.spotless") version "6.25.0"
+ id("org.springframework.boot") version "3.2.2"
+ id("com.adarshr.test-logger") version "4.0.0"
+}
+
+apply(plugin = "io.spring.dependency-management")
+
+repositories {
+ // Use Maven Central for resolving dependencies.
+ mavenCentral()
+}
+
+dependencies {
+ // Use JUnit Jupiter for testing.
+ testImplementation("com.codedifferently.instructional:instructional-lib")
+ testImplementation("org.junit.jupiter:junit-jupiter:5.9.1")
+ testImplementation("org.springframework.boot:spring-boot-starter-test")
+ testImplementation("org.assertj:assertj-core:3.25.1")
+ testImplementation("at.favre.lib:bcrypt:0.10.2")
+
+ // This dependency is used by the application.
+ implementation("com.codedifferently.instructional:instructional-lib")
+ implementation("com.google.guava:guava:31.1-jre")
+ implementation("com.google.code.gson:gson:2.10.1")
+ implementation("org.projectlombok:lombok:1.18.30")
+ implementation("org.springframework.boot:spring-boot-starter")
+}
+
+application {
+ // Define the main class for the application.
+ mainClass.set("com.codedifferently.lesson6.Lesson6")
+}
+
+tasks.named<Test>("test") {
+ // Use JUnit Platform for unit tests.
+ useJUnitPlatform()
+}
+
+
+configure<com.diffplug.gradle.spotless.SpotlessExtension> {
+
+ format("misc", {
+ // define the files to apply `misc` to
+ target("*.gradle", ".gitattributes", ".gitignore")
+
+ // define the steps to apply to those files
+ trimTrailingWhitespace()
+ indentWithTabs() // or spaces. Takes an integer argument if you don't like 4
+ endWithNewline()
+ })
+
+ java {
+ // don't need to set target, it is inferred from java
+
+ // apply a specific flavor of google-java-format
+ googleJavaFormat()
+ // fix formatting of type annotations
+ formatAnnotations()
+ }
+}

lesson_07/exceptions/exceptions_app/src/main/java/com/codedifferently/lesson7/Lesson7.java

@@ -0,0 +1,116 @@
+package com.codedifferently.lesson7;
+
+import com.codedifferently.lesson7.gpa.GpaToLetterGradeConverter;
+import com.codedifferently.lesson7.util.Helpers;
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.context.annotation.Configuration;
+
+@Configuration
+@SpringBootApplication(scanBasePackages = "com.codedifferently")
+public class Lesson7 {
+
+ public static void main(String[] args) {
+ var application = new SpringApplication(Lesson7.class);
+ application.run(args);
+ }
+
+ /**
+ * Returns true if the provided age meets the minimum US voting age and false otherwise.
+ *
+ * @param age The age to check.
+ * @return True if the age corresponds to a voting age and false otherwise.
+ */
+ public static boolean canVote(int age) {
+ throw new UnsupportedOperationException();
+ }
+
+ /**
+ * Compares two strings lexographically.
+ *
+ * @param value1 The first `String` to compare.
+ * @param value2 The second `String` to compare.
+ * @rerturn -1 if a is less than b, 1 if a is greater than b, and 0 otherwise.
+ */
+ public static int compareStrings(String a, String b) {
+ // The distance will be a number less than 0 if string `a` is lexographically less than `b`, 1
+ // if it is greater, and 0 if the strings are equal.
+ int distance = Helpers.computeLexographicDistance(a, b);
+
+ // TODO(you): Finish this method.
+
+ return 0;
+ }
+
+ /** An instance of a GPA converter. */
+ private static final GpaToLetterGradeConverter gpaConverter = new GpaToLetterGradeConverter();
+
+ /**
+ * Converts a GPA on the 4.0 scale to the corresponding letter grade using the college board
+ * scale. See
+ * https://bigfuture.collegeboard.org/plan-for-college/college-basics/how-to-convert-gpa-4.0-scale
+ * for details.
+ *
+ * @param gpa The GPA value.
+ * @return The letter grade ("A+", "A", "A-", "B+", etc.).
+ */
+ public static String convertGpaToLetterGrade(double gpa) {
+ return gpaConverter.convertToLetterGrade(gpa);
+ }
+
+ /**
+ * Computes the factorial of the given value of `n`.
+ *
+ * @param n The value for which to compute the factorial.
+ * @return The factorial of n.
+ */
+ public static int computeFactorial(int n) {
+ return 0;
+ }
+
+ /**
+ * Adds all of the provided values and returns the sum.
+ *
+ * @param values The values to sum.
+ * @return The sum of all the values.
+ */
+ public static double addNumbers(double[] values) {
+ return 0;
+ }
+
+ /**
+ * Returns an array of the first `n` fibonacci numbers starting from 1.
+ *
+ * @param n The first `n` of fibonacci values to compute.
+ * @return An array containing the first `n` fibonacci values.
+ */
+ public static int[] getFirstNFibonacciNumbers(int n) {
+ return null;
+ }
+
+ /**
+ * Finds a value in an array of values.
+ *
+ * @param values The values to search.
+ * @param The left most index to search.
+ * @param The right most index to search.
+ * @param value The value to look for.
+ * @return The index of the value if found in the array and -1 otherwise.
+ */
+ public static int binarySearch(int[] values, int start, int end, int value) {
+
+ while (start <= end) {
+ int pivotIndex = (start + end) / 2;
+
+ if (values[pivotIndex] == value) {
+ return pivotIndex;
+ } else if (values[pivotIndex] > value) {
+ end = pivotIndex - 1;
+ } else {
+ start = pivotIndex + 1;
+ }
+ }
+
+ return -1;
+ }
+}

lesson_07/exceptions/exceptions_app/src/main/java/com/codedifferently/lesson7/gpa/GpaToLetterGradeConverter.java

@@ -0,0 +1,59 @@
+package com.codedifferently.lesson7.gpa;
+
+import com.codedifferently.lesson7.util.LinkedListNode;
+
+/** An object that converts GPAs to their letter grade equivalent. */
+public class GpaToLetterGradeConverter {
+
+ private LinkedListNode<GpaLetterGradeMapping> head;
+
+ public GpaToLetterGradeConverter() {
+ this.head = new LinkedListNode<GpaLetterGradeMapping>(new GpaLetterGradeMapping(0, 1, "F"));
+
+ var current = this.head;
+ current.next =
+ new LinkedListNode<GpaLetterGradeMapping>(new GpaLetterGradeMapping(1, 1.3, "D"));
+
+ current = current.next;
+ current.next =
+ new LinkedListNode<GpaLetterGradeMapping>(new GpaLetterGradeMapping(1.3, 1.7, "D+"));
+
+ // TODO(you): Finish configuring the linked list.
+ }
+
+ /**
+ * Converts a GPA on the 4.0 scale to the corresponding letter grade using the college board
+ * scale. See
+ * https://bigfuture.collegeboard.org/plan-for-college/college-basics/how-to-convert-gpa-4.0-scale
+ * for details.
+ *
+ * @param gpa The GPA value.
+ * @return The letter grade ("A+", "A", "A-", "B+", etc.).
+ */
+ public String convertToLetterGrade(double gpa) throws IllegalArgumentException {
+ // Iterate through the list list starting at the head node and return the letter grade for the
+ // matching GPA range.
+ throw new UnsupportedOperationException();
+ }
+}
+
+/** An object that represents the mapping between a GPA range and a grade letter. */
+class GpaLetterGradeMapping {
+ public double minGpaInclusive;
+ public double maxGpaExclusive;
+ public String gradeLetter;
+
+ public GpaLetterGradeMapping(double minGpaInclusive, double maxGpaExclusive, String gradeLetter) {
+ this.minGpaInclusive = minGpaInclusive;
+ this.maxGpaExclusive = maxGpaExclusive;
+ this.gradeLetter = gradeLetter;
+ }
+
+ public boolean includesGpa(double gpa) {
+ throw new UnsupportedOperationException();
+ }
+
+ public String getLetterGrade() {
+ throw new UnsupportedOperationException();
+ }
+}

lesson_07/exceptions/exceptions_app/src/main/java/com/codedifferently/lesson7/util/Helpers.java

@@ -0,0 +1,28 @@
+package com.codedifferently.lesson7.util;
+
+public class Helpers {
+ /**
+ * Computes a score describing the lexographic distance between two strings. For two strings of
+ * equal length, the score will be the difference between the first differing character. In the
+ * case where either is a sub-string of the other, then the difference in length determines the
+ * score.
+ *
+ * @param a The first string to compare.
+ * @param b The second string to compare.
+ * @return A score representing the lexographic distance between two strings.
+ */
+ public static int computeLexographicDistance(String a, String b) {
+ for (var i = 0; i < a.length(); ++i) {
+ if (a.charAt(i) == b.charAt(i)) {
+ continue;
+ }
+ return (int) a.charAt(i) - (int) b.charAt(i);
+ }
+
+ if (a.length() != b.length()) {
+ return a.length() - b.length();
+ }
+
+ return 0;
+ }
+}

lesson_07/exceptions/exceptions_app/src/main/java/com/codedifferently/lesson7/util/LinkedListNode.java

@@ -0,0 +1,14 @@
+package com.codedifferently.lesson7.util;
+
+/** A LinkedList node. */
+public class LinkedListNode<T> {
+ /** The next node in a linked list. */
+ public LinkedListNode<T> next;
+
+ /** The data stored in this node. */
+ public T data;
+
+ public LinkedListNode(T data) {
+ this.data = data;
+ }
+}