Add db_default for fields (#2101)

Author: abondar

CHANGELOG.rst

@@ -10,12 +10,22 @@ Changelog
 1.0
 ===
 
-1.0.1 (unreleased)
-------------------
+1.1.0
+-----
+
+Added
+^^^^^
+- **``db_default`` parameter for fields** — set database-level ``DEFAULT`` clauses that propagate to schema generation and migrations. Unlike ``default`` (Python-only), ``db_default`` is persisted in the DB schema and applied even for rows inserted outside the ORM. (#2101)
+- ``Model.construct()`` classmethod for building model instances without field validation — useful in test factories and fixtures. (#2099)
+- ``truncate_all_models()`` now respects foreign key constraints using topological ordering (SQLite/MySQL) or ``TRUNCATE ... CASCADE`` (PostgreSQL). (#2100)
+- Auto-recreate database connection when event loop changes. Enables easier testing without session level fixtures (#2098)
+
 Fixed
 ^^^^^
-- Type checking of None assignment to nullable fields (#2089)
-- Fix set global fallback default in Sanic register_tortoise (#2090)
+- Type checking of ``None`` assignment to nullable fields. (#2089)
+- Fix ``set global fallback default`` in Sanic ``register_tortoise``. (#2090)
+- Escape ``[`` ``]`` for db url parsing. (#2081) (#2092)
+- Fix ``UnicodeEncodeError`` by using UTF-8 encoding for migration files. (#2096, #2097)
 
 
 1.0.0

examples/comprehensive_migrations_project/migrations/0018_add_db_defaults.py

@@ -0,0 +1,21 @@
+from tortoise import fields, migrations
+from tortoise.migrations import operations as ops
+
+
+class Migration(migrations.Migration):
+    dependencies = [("erp", "0017_create_bad_sorted_fk")]
+
+    initial = False
+
+    operations = [
+        ops.AlterField(
+            model_name="Product",
+            name="is_active",
+            field=fields.BooleanField(default=True, db_default=True),
+        ),
+        ops.AddField(
+            model_name="Product",
+            name="stock_quantity",
+            field=fields.IntField(db_default=0),
+        ),
+    ]

examples/comprehensive_migrations_project/migrations/0019_change_db_default.py

@@ -0,0 +1,16 @@
+from tortoise import fields, migrations
+from tortoise.migrations import operations as ops
+
+
+class Migration(migrations.Migration):
+    dependencies = [("erp", "0018_add_db_defaults")]
+
+    initial = False
+
+    operations = [
+        ops.AlterField(
+            model_name="Product",
+            name="stock_quantity",
+            field=fields.IntField(db_default=10),
+        ),
+    ]

examples/comprehensive_migrations_project/migrations/0020_drop_db_default.py

@@ -0,0 +1,16 @@
+from tortoise import fields, migrations
+from tortoise.migrations import operations as ops
+
+
+class Migration(migrations.Migration):
+    dependencies = [("erp", "0019_change_db_default")]
+
+    initial = False
+
+    operations = [
+        ops.AlterField(
+            model_name="Product",
+            name="is_active",
+            field=fields.BooleanField(default=True),
+        ),
+    ]

examples/comprehensive_migrations_project/models.py

@@ -116,6 +116,7 @@ class Product(models.Model):
     rating = fields.FloatField(null=True, description="Average customer rating 0.0-5.0")
     processing_time = fields.TimeDeltaField(null=True, description="Average time to fulfill")
     is_active = fields.BooleanField(default=True)
+    stock_quantity = fields.IntField(db_default=10)
     created_at = fields.DatetimeField(auto_now_add=True)
 
     def __str__(self) -> str: