[Sync Iteration] python/making-the-grade/1

solutions/python/making-the-grade/1/loops.py

@@ -0,0 +1,84 @@
+"""Functions for organizing and calculating student exam scores."""
+
+
+def round_scores(student_scores: list) -> list:
+    """
+    Round all provided student scores.
+
+    :param student_scores: list - float or int of student exam scores.
+    :return: list - student scores *rounded* to nearest integer value.
+    """
+    return [round(score) for score in student_scores]
+
+
+def count_failed_students(student_scores: list) -> int:
+    """
+    Count the number of failing students out of the group provided.
+
+    :param student_scores: list - containing int student scores.
+    :return: int - count of student scores at or below 40.
+    """
+    return len([score for score in student_scores if score <= 40.0])
+
+
+def above_threshold(student_scores: list,
+                    threshold: int) -> list:
+    """
+    Filter out above threshold scores.
+
+    Determine how many of the provided student scores were 'the best'
+    based on the provided threshold.
+
+    :param student_scores: list - of integer scores.
+    :param threshold: int - threshold to cross to be the "best" score.
+    :return: list - of integer scores that are at or above the "best" threshold.
+    """
+    return [score for score in student_scores if score >= threshold]
+
+
+def letter_grades(highest: int) -> list:
+    """
+    Create a list of grade thresholds based on the provided highest grade.
+
+    :param highest: int - value of highest exam score.
+    :return: list - of lower threshold scores for each D-A letter grade interval.
+            For example, where the highest score is 100, and failing is <= 40,
+            The result would be [41, 56, 71, 86]:
+
+            41 <= "D" <= 55
+            56 <= "C" <= 70
+            71 <= "B" <= 85
+            86 <= "A" <= 100
+    """
+    interval = (highest - 40) // 4
+    return [41 + i * interval for i in range(4)]
+
+
+def student_ranking(student_scores: list,
+                    student_names: list) -> list[str]:
+    """
+    Organize the student's rank, name, and grade information in descending order.
+
+    :param student_scores: list - of scores in descending order.
+    :param student_names: list - of string names by exam score in descending order.
+    :return: list - of strings in format ["<rank>. <student name>: <score>"].
+    """
+    return [f"{i}. {name}: {score}" for i, score, name in zip(
+        range(1, len(student_scores) + 1), student_scores, student_names)]
+
+
+def perfect_score(student_info: list) -> list:
+    """
+    Create a list that contains the name and grade of the first
+    student to make a perfect score on the exam.
+
+    :param student_info: list - of [<student name>, <score>] lists.
+    :return: list - first `[<student name>, 100]` or `[]` if no
+             student score of 100 is found.
+    """
+    result_lst: list = []
+    for student, score in student_info:
+        if score == 100:
+            return [student, score]
+
+    return result_lst