grade-school: add test template (exercism#1892)

Author: cmccandless

exercises/grade-school/.meta/template.j2

@@ -0,0 +1,27 @@
+{%- import "generator_macros.j2" as macros -%}
+{%- macro test_case( case) -%}
+    {%- set input = case["input"] -%}
+    def test_{{ case["description"] | to_snake }}(self):
+        school = School()
+        {% for student, grade in input["students"] -%}
+        school.add_student(name="{{ student }}", grade={{ grade }})
+        {% endfor -%}
+        expected = {{ case["expected"] }}
+        {% if "desiredGrade" in input -%}
+        self.assertEqual(school.{{ case["property"] | to_snake }}({{ input["desiredGrade"] }}), expected)
+        {%- else -%}
+        self.assertEqual(school.{{ case["property"] | to_snake }}(), expected)
+        {%- endif %}
+{% endmacro -%}
+import unittest
+
+from {{ exercise | to_snake }} import School
+
+{{ macros.canonical_ref(version) }}
+
+class {{ exercise | camel_case }}Test(unittest.TestCase):
+    {% for case in cases %}
+    {{ test_case(case) }}
+    {% endfor %}
+
+{{ macros.footer(has_error_case) }}

exercises/grade-school/grade_school_test.py

@@ -2,60 +2,63 @@
 
 from grade_school import School
 
-
 # Tests adapted from `problem-specifications//canonical-data.json` @ v1.0.0
 
+
 class GradeSchoolTest(unittest.TestCase):
-    def test_adding_student_adds_them_to_sorted_roster(self):
+    def test_adding_a_student_adds_them_to_the_sorted_roster(self):
         school = School()
-        school.add_student(name='Aimee', grade=2)
-        expected = ['Aimee']
+        school.add_student(name="Aimee", grade=2)
+        expected = ["Aimee"]
         self.assertEqual(school.roster(), expected)
 
-    def test_adding_more_students_adds_them_to_sorted_roster(self):
+    def test_adding_more_student_adds_them_to_the_sorted_roster(self):
         school = School()
-        school.add_student(name='Blair', grade=2)
-        school.add_student(name='James', grade=2)
-        school.add_student(name='Paul', grade=2)
-        expected = ['Blair', 'James', 'Paul']
+        school.add_student(name="Blair", grade=2)
+        school.add_student(name="James", grade=2)
+        school.add_student(name="Paul", grade=2)
+        expected = ["Blair", "James", "Paul"]
         self.assertEqual(school.roster(), expected)
 
-    def test_students_in_different_grades_in_same_roster(self):
+    def test_adding_students_to_different_grades_adds_them_to_the_same_sorted_roster(
+        self
+    ):
         school = School()
-        school.add_student(name='Chelsea', grade=3)
-        school.add_student(name='Logan', grade=7)
-        expected = ['Chelsea', 'Logan']
+        school.add_student(name="Chelsea", grade=3)
+        school.add_student(name="Logan", grade=7)
+        expected = ["Chelsea", "Logan"]
         self.assertEqual(school.roster(), expected)
 
-    def test_roster_returns_empty_list_if_no_students_are_enrolled(self):
-        self.assertEqual(School().roster(), [])
+    def test_roster_returns_an_empty_list_if_there_are_no_students_enrolled(self):
+        school = School()
+        expected = []
+        self.assertEqual(school.roster(), expected)
 
-    def test_roster_is_sorted_by_grade_then_name(self):
+    def test_student_names_with_grades_are_displayed_in_the_same_sorted_roster(self):
         school = School()
-        for name, grade in [
-            ('Peter', 2),
-            ('Anna', 1),
-            ('Barb', 1),
-            ('Zoe', 2),
-            ('Alex', 2),
-            ('Jim', 3),
-            ('Charlie', 1),
-        ]:
-            school.add_student(name, grade)
-        expected = ['Anna', 'Barb', 'Charlie', 'Alex', 'Peter', 'Zoe', 'Jim']
+        school.add_student(name="Peter", grade=2)
+        school.add_student(name="Anna", grade=1)
+        school.add_student(name="Barb", grade=1)
+        school.add_student(name="Zoe", grade=2)
+        school.add_student(name="Alex", grade=2)
+        school.add_student(name="Jim", grade=3)
+        school.add_student(name="Charlie", grade=1)
+        expected = ["Anna", "Barb", "Charlie", "Alex", "Peter", "Zoe", "Jim"]
         self.assertEqual(school.roster(), expected)
 
-    def test_grade_returns_students_in_that_grade_in_alphabetical_order(self):
+    def test_grade_returns_the_students_in_that_grade_in_alphabetical_order(self):
         school = School()
-        school.add_student(name='Franklin', grade=5)
-        school.add_student(name='Bradley', grade=5)
-        school.add_student(name='Jeff', grade=1)
-        expected = ['Bradley', 'Franklin']
+        school.add_student(name="Franklin", grade=5)
+        school.add_student(name="Bradley", grade=5)
+        school.add_student(name="Jeff", grade=1)
+        expected = ["Bradley", "Franklin"]
         self.assertEqual(school.grade(5), expected)
 
-    def test_grade_returns_empty_list_if_no_students_are_in_that_grade(self):
-        self.assertEqual(School().grade(1), [])
+    def test_grade_returns_an_empty_list_if_there_are_no_students_in_that_grade(self):
+        school = School()
+        expected = []
+        self.assertEqual(school.grade(1), expected)
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main()