home · contact · privacy
Improve Days tests.
[plomtask] / tests / days.py
index 17c0ba9d09340b8b4d6b0fcecdb44431448d05f7..3da78ee0bc71b0dda15e87d7af609a50d55e5c74 100644 (file)
@@ -9,8 +9,8 @@ from plomtask.exceptions import BadFormatException, NotFoundException
 class TestsSansDB(TestCase):
     """Days module tests not requiring DB setup."""
 
-    def test_Day_dates(self) -> None:
-        """Test Day's date format."""
+    def test_Day_valid_date(self) -> None:
+        """Test Day's date format validation and parsing."""
         with self.assertRaises(BadFormatException):
             Day('foo')
         with self.assertRaises(BadFormatException):
@@ -20,7 +20,7 @@ class TestsSansDB(TestCase):
         self.assertEqual(datetime(2024, 1, 1), Day('2024-01-01').datetime)
 
     def test_Day_sorting(self) -> None:
-        """Test Day.__lt__."""
+        """Test sorting by .__lt__ and Day.__eq__."""
         day1 = Day('2024-01-01')
         day2 = Day('2024-01-02')
         day3 = Day('2024-01-03')
@@ -31,21 +31,49 @@ class TestsSansDB(TestCase):
         """Test Day.weekday."""
         self.assertEqual(Day('2024-03-17').weekday, 'Sunday')
 
+    def test_Day_neighbor_dates(self) -> None:
+        """Test Day.prev_date and Day.next_date."""
+        self.assertEqual(Day('2024-01-01').prev_date, '2023-12-31')
+        self.assertEqual(Day('2023-02-28').next_date, '2023-03-01')
+
 
 class TestsWithDB(TestCaseWithDB):
     """Tests requiring DB, but not server setup."""
 
+    def test_Day_saving_and_caching(self) -> None:
+        """Test .save/.save_core."""
+        date = '2024-01-01'
+        comment = 'comment'
+        day = Day(date, comment)
+        # check object init itself doesn't store anything yet
+        self.assertEqual({}, Day.get_cache())
+        self.assertEqual([], Day.all(self.db_conn))
+        # check saving stores in cache and DB
+        day.save(self.db_conn)
+        assert isinstance(day.id_, str)
+        for row in self.db_conn.row_where(Day.table_name, 'id', day.id_):
+            self.assertEqual(day, Day.from_table_row(self.db_conn, row))
+        self.assertEqual({day.id_: day}, Day.get_cache())
+        # check attributes set properly (and not unset by saving)
+        self.assertEqual(day.id_, date)
+        self.assertEqual(day.comment, comment)
+
     def test_Day_by_id(self) -> None:
-        """Test Day.by_id()."""
-        with self.assertRaises(NotFoundException):
-            Day.by_id(self.db_conn, '2024-01-01')
-        Day('2024-01-01').save(self.db_conn)
-        self.assertEqual(Day('2024-01-01'),
-                         Day.by_id(self.db_conn, '2024-01-01'))
+        """Test .by_id()."""
+        date1 = '2024-01-01'
+        date2 = '2024-01-02'
+        # check failure if not yet saved
+        day1 = Day(date1)
         with self.assertRaises(NotFoundException):
-            Day.by_id(self.db_conn, '2024-01-02')
-        self.assertEqual(Day('2024-01-02'),
-                         Day.by_id(self.db_conn, '2024-01-02', create=True))
+            Day.by_id(self.db_conn, date1)
+        # check identity of saved and retrieved
+        day1.save(self.db_conn)
+        self.assertEqual(day1, Day.by_id(self.db_conn, date1))
+        # check create=True acts like normal instantiation (sans saving)
+        by_id_created = Day.by_id(self.db_conn, date2, create=True)
+        self.assertEqual(Day(date2), by_id_created)
+        self.assertEqual({day1.id_: day1}, Day.get_cache())
+        self.assertEqual([day1], Day.all(self.db_conn))
 
     def test_Day_all(self) -> None:
         """Test Day.all(), especially in regards to date range filtering."""
@@ -56,24 +84,32 @@ class TestsWithDB(TestCaseWithDB):
         day2 = Day(date2)
         day3 = Day(date3)
         day1.save(self.db_conn)
-        day2.save(self.db_conn)
         day3.save(self.db_conn)
+        # check that all() shows all saved, but no unsaved items
+        self.assertEqual(Day.all(self.db_conn),
+                         [day1, day3])
+        day2.save(self.db_conn)
         self.assertEqual(Day.all(self.db_conn),
                          [day1, day2, day3])
+        # check empty date range values show everything
         self.assertEqual(Day.all(self.db_conn, ('', '')),
                          [day1, day2, day3])
+        # check date range is open interval
         self.assertEqual(Day.all(self.db_conn, (date1, date3)),
                          [day1, day2, day3])
+        # check first date range value excludes what's earlier
         self.assertEqual(Day.all(self.db_conn, (date2, date3)),
                          [day2, day3])
         self.assertEqual(Day.all(self.db_conn, (date3, '')),
                          [day3])
-        self.assertEqual(Day.all(self.db_conn, (date1, '')),
-                         [day1, day2, day3])
+        # check second date range value excludes what's later
         self.assertEqual(Day.all(self.db_conn, ('', date2)),
                          [day1, day2])
+        # check swapped (impossible) date range returns emptiness
         self.assertEqual(Day.all(self.db_conn, (date3, date1)),
                          [])
+        # check fill_gaps= instantiates unsaved dates within date range
+        # (but does not store them)
         day4 = Day('2024-01-04')
         day5 = Day('2024-01-05')
         day6 = Day('2024-01-06')
@@ -81,14 +117,29 @@ class TestsWithDB(TestCaseWithDB):
         self.assertEqual(Day.all(self.db_conn, (date2, '2024-01-07'),
                                  fill_gaps=True),
                          [day2, day3, day4, day5, day6])
+        self.assertEqual(Day.get_cache().keys(),
+                         {date1, date2, date3, day6.date})
+        assert isinstance(day4.id_, str)
+        assert isinstance(day5.id_, str)
+        self.assertEqual(self.db_conn.row_where(Day.table_name,
+                                                'id', day4.id_), [])
+        self.assertEqual(self.db_conn.row_where(Day.table_name,
+                                                'id', day5.id_), [])
+        # check 'today' is interpreted as today's date
         today = Day(todays_date())
         today.save(self.db_conn)
         self.assertEqual(Day.all(self.db_conn, ('today', 'today')), [today])
 
-    def test_Day_neighbor_dates(self) -> None:
-        """Test Day.prev_date and Day.next_date."""
-        self.assertEqual(Day('2024-01-01').prev_date, '2023-12-31')
-        self.assertEqual(Day('2023-02-28').next_date, '2023-03-01')
+    def test_Day_remove(self) -> None:
+        """Test .remove() effects on DB and cache."""
+        date = '2024-01-01'
+        day = Day(date)
+        day.save(self.db_conn)
+        day.remove(self.db_conn)
+        assert isinstance(day.id_, str)
+        self.assertEqual(self.db_conn.row_where(Day.table_name,
+                                                'id', day.id_), [])
+        self.assertEqual(Day.get_cache(), {})
 
     def test_Day_singularity(self) -> None:
         """Test pointers made for single object keep pointing to it."""