Add 10_quiz_limited example for testing quiz functions

Author: ChrisMayfield

examples/10_quiz_limited/quiz3.py

@@ -0,0 +1,51 @@
+"""Quiz 3.
+
+Name: Some Student
+"""
+
+
+def sum_positive(numbers):
+    """Return the sum of all positive numbers in a list.
+
+    Args:
+        numbers (list): Zero or more integers.
+
+    Returns:
+        int: Sum of the positive numbers.
+
+    Example:
+    >>> sum_positive([1, -2, 3, -4, 5])
+    9
+    >>> sum_positive([-1, -2, -3])
+    0
+    """
+    total = 0
+    for n in numbers:
+        if n > 0:
+            total += n
+    return total
+
+
+def first_upper(text):
+    """Return the first uppercase letter in a string.
+
+    Args:
+        text (str): The string to search.
+
+    Returns:
+        str or None: First uppercase letter, or None.
+
+    Example:
+    >>> first_upper("hello World")
+    'W'
+    >>> first_upper("python")
+    """
+    for c in text:
+        if c.isupper():
+            return c
+    return None
+
+
+if __name__ == "__main__":
+    import doctest
+    doctest.testmod()

examples/10_quiz_limited/test_quiz3.py

@@ -0,0 +1,60 @@
+# Limited feedback is shown to students during the quiz. Before grading, the
+# instructor clicks "Regrade All Submissions" to show the complete results.
+
+import quiz3
+from jmu_pytest_utils.meta import submission_closed
+from jmu_pytest_utils.quiz import check_docstring, check_return_types
+
+
+def sum_positive(numbers):
+    # Wrapper to avoid "from import" errors.
+    return quiz3.sum_positive(numbers)
+
+
+def first_upper(text):
+    # Wrapper to avoid "from import" errors.
+    return quiz3.first_upper(text)
+
+
+def test_docs():
+    check_docstring(quiz3)
+
+
+def test_types(tmp_path):
+    check_return_types(
+        (int, sum_positive, ([1, -2, 3, -4, 5],)),
+        (str, first_upper, ("hello World",)),
+    )
+
+
+if submission_closed():
+
+    def test_sum_positive():
+        """sum_positive: typical cases"""
+        assert sum_positive([1, -2, 3, -4, 5]) == 9
+        assert sum_positive([-1, -2, -3]) == 0
+        assert sum_positive([0, 0, 0]) == 0
+        assert sum_positive([10, 20, 30]) == 60
+
+    def test_sum_positive_edge():
+        """sum_positive: edge cases"""
+        assert sum_positive([]) == 0
+        assert sum_positive([-5, 5]) == 5
+        assert sum_positive([-1, 2, -3, 4]) == 6
+
+    def test_first_upper():
+        """first_upper: typical cases"""
+        assert first_upper("helloWorld") == "W"
+        assert first_upper("Python") == "P"
+        assert first_upper("aBcDe") == "B"
+
+    def test_first_upper_lower():
+        """first_upper: all lowercase"""
+        assert first_upper("python") is None
+        assert first_upper("") is None
+
+    def test_first_upper_edge():
+        """first_upper: edge cases"""
+        # Edge cases
+        assert first_upper("123ABC") == "A"
+        assert first_upper("!@#") is None

examples/README.md

@@ -11,6 +11,7 @@ The following "assignments" are used for testing `jmu_pytest_utils` and provided
 * [7_class_package](7_class_package) -- classes and packages
 * [8_test_coverage](8_test_coverage) -- grading student's tests
 * [9_leaderboard](9_leaderboard) -- Gradescope leaderboard
+* [10_quiz_limited](10_quiz_limited) -- feedback during a quiz
 
 ## API Docs