home · contact · privacy
Improve Todo tests.
[plomtask] / tests / utils.py
index 61dbb36b949ee3fdfd5a38dcada155a5ab18a924..fb7e22746a96482e04153adff90a4bfa086bd58c 100644 (file)
@@ -15,10 +15,28 @@ from plomtask.todos import Todo
 from plomtask.exceptions import NotFoundException, HandledException
 
 
+class TestCaseSansDB(TestCase):
+    """Tests requiring no DB setup."""
+    checked_class: Any
+
+    def check_id_setting(self, *args: Any) -> None:
+        """Test .id_ being set and its legal range being enforced."""
+        with self.assertRaises(HandledException):
+            self.checked_class(0, *args)
+        obj = self.checked_class(5, *args)
+        self.assertEqual(obj.id_, 5)
+
+    def check_versioned_defaults(self, attrs: dict[str, Any]) -> None:
+        """Test defaults of VersionedAttributes."""
+        obj = self.checked_class(None)
+        for k, v in attrs.items():
+            self.assertEqual(getattr(obj, k).newest, v)
+
+
 class TestCaseWithDB(TestCase):
     """Module tests not requiring DB setup."""
     checked_class: Any
-    default_ids: tuple[int | str, int | str, int | str]
+    default_ids: tuple[int | str, int | str, int | str] = (1, 2, 3)
 
     def setUp(self) -> None:
         Condition.empty_cache()
@@ -43,14 +61,14 @@ class TestCaseWithDB(TestCase):
         self.assertEqual(self.checked_class.get_cache(), expected_cache)
         db_found: list[Any] = []
         for item in content:
-            assert isinstance(item.id_, (str, int))
+            assert isinstance(item.id_, type(self.default_ids[0]))
             for row in self.db_conn.row_where(self.checked_class.table_name,
                                               'id', item.id_):
                 db_found += [self.checked_class.from_table_row(self.db_conn,
                                                                row)]
         self.assertEqual(sorted(content), sorted(db_found))
 
-    def check_saving_and_caching(self, **kwargs: Any) -> Any:
+    def check_saving_and_caching(self, **kwargs: Any) -> None:
         """Test instance.save in its core without relations."""
         obj = self.checked_class(**kwargs)  # pylint: disable=not-callable
         # check object init itself doesn't store anything yet
@@ -62,6 +80,19 @@ class TestCaseWithDB(TestCase):
         for key, value in kwargs.items():
             self.assertEqual(getattr(obj, key), value)
 
+    def check_saving_of_versioned(self, attr_name: str, type_: type) -> None:
+        """Test owner's versioned attributes."""
+        owner = self.checked_class(None)
+        vals: list[Any] = ['t1', 't2'] if type_ == str else [0.9, 1.1]
+        attr = getattr(owner, attr_name)
+        attr.set(vals[0])
+        attr.set(vals[1])
+        owner.save(self.db_conn)
+        owner.uncache()
+        retrieved = owner.__class__.by_id(self.db_conn, owner.id_)
+        attr = getattr(retrieved, attr_name)
+        self.assertEqual(sorted(attr.history.values()), vals)
+
     def check_by_id(self) -> None:
         """Test .by_id(), including creation."""
         # check failure if not yet saved
@@ -79,18 +110,32 @@ class TestCaseWithDB(TestCase):
         self.assertEqual(self.checked_class(id2), by_id_created)
         self.check_storage([obj])
 
-    def check_from_table_row(self) -> None:
+    def check_from_table_row(self, *args: Any) -> None:
         """Test .from_table_row() properly reads in class from DB"""
         id_ = self.default_ids[0]
-        obj = self.checked_class(id_)  # pylint: disable=not-callable
+        obj = self.checked_class(id_, *args)  # pylint: disable=not-callable
         obj.save(self.db_conn)
-        assert isinstance(obj.id_, (str, int))
+        assert isinstance(obj.id_, type(self.default_ids[0]))
         for row in self.db_conn.row_where(self.checked_class.table_name,
                                           'id', obj.id_):
             retrieved = self.checked_class.from_table_row(self.db_conn, row)
             self.assertEqual(obj, retrieved)
             self.assertEqual({obj.id_: obj}, self.checked_class.get_cache())
 
+    def check_versioned_from_table_row(self, attr_name: str,
+                                       type_: type) -> None:
+        """Test .from_table_row() reads versioned attributes from DB."""
+        owner = self.checked_class(None)
+        vals: list[Any] = ['t1', 't2'] if type_ == str else [0.9, 1.1]
+        attr = getattr(owner, attr_name)
+        attr.set(vals[0])
+        attr.set(vals[1])
+        owner.save(self.db_conn)
+        for row in self.db_conn.row_where(owner.table_name, 'id', owner.id_):
+            retrieved = owner.__class__.from_table_row(self.db_conn, row)
+            attr = getattr(retrieved, attr_name)
+            self.assertEqual(sorted(attr.history.values()), vals)
+
     def check_all(self) -> tuple[Any, Any, Any]:
         """Test .all()."""
         # pylint: disable=not-callable
@@ -110,20 +155,29 @@ class TestCaseWithDB(TestCase):
         return item1, item2, item3
 
     def check_singularity(self, defaulting_field: str,
-                          non_default_value: Any) -> None:
+                          non_default_value: Any, *args: Any) -> None:
         """Test pointers made for single object keep pointing to it."""
         id1 = self.default_ids[0]
-        obj = self.checked_class(id1)  # pylint: disable=not-callable
+        obj = self.checked_class(id1, *args)  # pylint: disable=not-callable
         obj.save(self.db_conn)
         setattr(obj, defaulting_field, non_default_value)
         retrieved = self.checked_class.by_id(self.db_conn, id1)
         self.assertEqual(non_default_value,
                          getattr(retrieved, defaulting_field))
 
-    def check_remove(self) -> None:
+    def check_versioned_singularity(self) -> None:
+        """Test singularity of VersionedAttributes on saving (with .title)."""
+        obj = self.checked_class(None)  # pylint: disable=not-callable
+        obj.save(self.db_conn)
+        assert isinstance(obj.id_, int)
+        obj.title.set('named')
+        retrieved = self.checked_class.by_id(self.db_conn, obj.id_)
+        self.assertEqual(obj.title.history, retrieved.title.history)
+
+    def check_remove(self, *args: Any) -> None:
         """Test .remove() effects on DB and cache."""
         id_ = self.default_ids[0]
-        obj = self.checked_class(id_)  # pylint: disable=not-callable
+        obj = self.checked_class(id_, *args)  # pylint: disable=not-callable
         with self.assertRaises(HandledException):
             obj.remove(self.db_conn)
         obj.save(self.db_conn)