Release 1.1.8

[waketzheng]

What's Changed

Added

• QuerySet.union() — SQL UNION query support for combining results from multiple QuerySets, including support for union across different models, union(all=True) for duplicates, order_by(), limit(), and count(). (feat: add union query support #2146)
• feat: add postgresql:// scheme as alias for asyncpg (feat: add postgresql:// scheme as alias for asyncpg #2154)
• feat: add pre commit config and fix codespell issues (feat: add pre commit config and fix codespell issues #2159)
• feat: django compatibility field name (feat: django compatibility field name #2160)
• feat: expose classmethod to build tortoise config (feat: expose classmethod to build tortoise config #2162)
• QuerySet.contains() method to check if an object exists in a queryset. (feat: add contains() operation to QuerySet #2163)
• Added comprehensive EXPLAIN support for MySQL and PostgreSQL. (feat: Improve EXPLAIN support for MySQL and PostgreSQL #2165)
• Built-in DomainNameValidator, URLValidator, and EmailValidator classes for common validation patterns. (feat: add domain, URL and email validators #2167)

Fixed

• MigrationRecorder now uses parameterized queries; fixes MariaDB/MySQL rejecting ISO-8601 applied_at values. (tortoise migrate fails to insert migration info row into tortoise_migrations table when using MariaDB #2132)
• fix(migrations): use parameterized queries in MigrationRecorder (fix(migrations): use parameterized queries in MigrationRecorder #2153)
• Applies model generics on relational fields functions (Applies model generics on relational fields functions #2156)
• fix: MSSQL connection left in busy state after insert (fix: MSSQL connection left in busy state after insert #2171)
• db_default on ForeignKeyField/OneToOneField now propagates to the underlying <fk>_id column, so CREATE TABLE emits the DEFAULT clause for FK columns. (FK/O2O db_default is dropped during _init_relations (CREATE TABLE omits DEFAULT on FK columns) #2199)
• Fix db_default on FK/O2O dropped during _init_relations (Fix db_default on FK/O2O dropped during _init_relations #2200)
• MigrationRecorder no longer emits tortoise's own pk field DeprecationWarning when applying migrations; it now builds its bookkeeping model with primary_key=True. (fix(migrations): use primary_key instead of deprecated pk in MigrationRecorder #2203)
• QuerySet.count() now matches the limited query result for the LIMIT/OFFSET edge cases: it returns 0 (instead of a negative number) when offset() exceeds the total row count, and 0 (instead of the total) for limit(0). (fix: clamp count() at 0 when offset exceeds total #2208)
• tests: cover Q inequality and unhashable behavior (chore: improve tortoise-orm maintenance path #2214)
• Field declarations on models now resolve to their concrete type (e.g. CharField[str]) in Pyright/Pylance instead of Field[Unknown]; the Field.__new__ type-check stub now returns Self. (fix: improve type resolution for model field declarations #2216)
• Type hint for TransactionContext now returns a TransactionalDBClient instead of a raw database connection. This change gives the correct inferred type for the transaction context. (Fix transaction typing #2232)
• Fix TSVectorField returned value conversion. (Fix TSVectorField returned value conversion #2237)

New Contributors

• @ropmyung made their first contribution in Applies model generics on relational fields functions #2156
• @9t8 made their first contribution in Fix Piccolo name #2182
• @EmmanuelNiyonshuti made their first contribution in Switch setup-uv action to immutable releases #2189
• @roomm made their first contribution in docs: add config.py example to FastAPI documentation #2192
• @koriyoshi2041 made their first contribution in fix: clamp count() at 0 when offset exceeds total #2208
• @lphuc2250gma made their first contribution in chore: improve tortoise-orm maintenance path #2214
• @r266-tech made their first contribution in feat: add postgresql:// scheme as alias for asyncpg #2154
• @vlakius made their first contribution in fix: improve type resolution for model field declarations #2216
• @mixartemev made their first contribution in Fix db_default on FK/O2O dropped during _init_relations #2200

Full Changelog: 1.1.7...1.1.8

[codspeed-hq]

Merging this PR will not alter performance

✅ 24 untouched benchmarks

---

_{Comparing waketzheng:release-1.1.8 (7dbc65f) with develop (8c12adc)}