divide docs in sections, provide Meta attributes inheritance, add tests for fastapi use wih mixins and concrete

tests/test_inheritance_concrete.py

@@ -9,6 +9,7 @@ from sqlalchemy import create_engine
 
 import ormar
 from ormar import ModelDefinitionError
+from ormar.exceptions import ModelError
 from tests.settings import DATABASE_URL
 
 metadata = sa.MetaData()
@@ -38,6 +39,8 @@ class DateFieldsModelNoSubclass(ormar.Model):
 class DateFieldsModel(ormar.Model):
     class Meta:
         abstract = True
+        metadata = metadata
+        database = db
 
     created_date: datetime.datetime = ormar.DateTime(default=datetime.datetime.now)
     updated_date: datetime.datetime = ormar.DateTime(default=datetime.datetime.now)
@@ -46,8 +49,6 @@ class DateFieldsModel(ormar.Model):
 class Category(DateFieldsModel, AuditModel):
     class Meta(ormar.ModelMeta):
         tablename = "categories"
-        metadata = metadata
-        database = db
 
     id: int = ormar.Integer(primary_key=True)
     name: str = ormar.String(max_length=50, unique=True, index=True)
@@ -56,9 +57,7 @@ class Category(DateFieldsModel, AuditModel):
 
 class Subject(DateFieldsModel):
     class Meta(ormar.ModelMeta):
-        tablename = "subjects"
-        metadata = metadata
-        database = db
+        pass
 
     id: int = ormar.Integer(primary_key=True)
     name: str = ormar.String(max_length=50, unique=True, index=True)
@@ -72,6 +71,11 @@ def create_test_database():
     metadata.drop_all(engine)
 
 
+def test_init_of_abstract_model():
+    with pytest.raises(ModelError):
+        DateFieldsModel()
+
+
 def test_field_redefining_raises_error():
     with pytest.raises(ModelDefinitionError):
         class WrongField(DateFieldsModel):  # pragma: no cover

tests/test_uuid_fks.py

@@ -0,0 +1,63 @@
+import uuid
+
+import databases
+import pytest
+import sqlalchemy
+from sqlalchemy import create_engine
+
+import ormar
+from tests.settings import DATABASE_URL
+
+metadata = sqlalchemy.MetaData()
+db = databases.Database(DATABASE_URL)
+
+
+class User(ormar.Model):
+    class Meta:
+        tablename = "user"
+        metadata = metadata
+        database = db
+
+    id: uuid.UUID = ormar.UUID(
+        primary_key=True, default=uuid.uuid4, uuid_format="string"
+    )
+    username = ormar.String(index=True, unique=True, null=False, max_length=255)
+    email = ormar.String(index=True, unique=True, nullable=False, max_length=255)
+    hashed_password = ormar.String(null=False, max_length=255)
+    is_active = ormar.Boolean(default=True, nullable=False)
+    is_superuser = ormar.Boolean(default=False, nullable=False)
+
+
+class Token(ormar.Model):
+    class Meta:
+        tablename = "token"
+        metadata = metadata
+        database = db
+
+    id = ormar.Integer(primary_key=True)
+    text = ormar.String(max_length=4, unique=True)
+    user = ormar.ForeignKey(User, related_name="tokens")
+    created_at = ormar.DateTime(server_default=sqlalchemy.func.now())
+
+
+@pytest.fixture(autouse=True, scope="module")
+def create_test_database():
+    engine = create_engine(DATABASE_URL)
+    metadata.create_all(engine)
+    yield
+    metadata.drop_all(engine)
+
+
+@pytest.mark.asyncio
+async def test_uuid_fk():
+    async with db:
+        async with db.transaction(force_rollback=True):
+            user = await User.objects.create(
+                username="User1",
+                email="email@example.com",
+                hashed_password="^$EDACVS(&A&Y@2131aa",
+                is_active=True,
+                is_superuser=False,
+            )
+            await Token.objects.create(text="AAAA", user=user)
+            await Token.objects.order_by("-created_at").all()