test(base): Add Base model Functional Test Suite

ref: #773 #767

app/centurion/tests/functional_models.py

@@ -0,0 +1,78 @@
+import pytest
+
+
+
+@pytest.mark.models
+@pytest.mark.functional
+class ModelTestCases:
+    """Model Common Test Suite
+
+    This test suite contains all of the functional common tests for **ALL**
+    Centurion Models.
+
+    For this test suite to function the following class attributes must be set
+    for all classes that inherit from this class:
+
+    - `kwargs_create_item: dict = {}`
+
+        _Dict of the models fields and the values required for
+        `model.objects.create()`_
+
+    This attribute can either be a variable or a property. This attribute along
+    with any prefixed `paremetized_` will be merged from each class in the
+    inheritence chain. In addition this object must return a dict if defined.
+
+    """
+
+
+    @pytest.fixture( scope = 'function' )
+    def created_model(self, request, django_db_blocker, model, user):
+
+        if model._meta.abstract:
+
+            yield None
+
+        else:
+
+            with django_db_blocker.unblock():
+
+                default_val = None
+
+                model.context['user'] = user
+
+                model_object = model.objects.create(
+                    **request.cls.kwargs_create_item
+                )
+
+                model.context['user'] = default_val
+
+                model_object.context['user'] = user
+
+                yield model_object
+
+                model_object.context['user'] = default_val
+
+                model_object.delete()
+
+
+
+    @property
+    def kwargs_create_item(self):
+        return {}
+
+
+
+    def test_model_created(self, model, created_model):
+        """Model Created
+
+        Ensure that the model exists within the Database
+        """
+
+        if model._meta.abstract:
+
+            pytest.xfail( reason = 'Model is an Abstract Model and can not be created.' )
+
+
+        db_model = model.objects.get( id = created_model.id )
+
+        assert db_model == created_model

app/centurion/tests/unit_models.py

@@ -33,6 +33,8 @@ class ModelTestCases(
         }
     }
 
+    ```
+
     This fields tests the following attributes, which must be specified. If the
     field is not defined with an attribute, add the default value: