Release 1.1.9

[waketzheng]

What's Changed

Added

• Q.__bool__() so Q objects with no filters/children (including nested empty Q children) are falsy. (feat: q to bool #2227)
• PostgreSQL password credential now accepts a sync or async callable, resolved once per new connection, to support short-lived credentials such as AWS RDS/Aurora IAM tokens and Azure Entra ID tokens. (feat(postgres): allow password to be a sync/async callable #2261)

Changed

• tortoise.contrib.starlette now only supports Starlette 1.0+ (This does not affect FastAPI users; you can continue using FastAPI with any version of Starlette). (Support Starlette 1.0+ #2282)

Fixed

• Aggregates now apply _filter when the aggregated argument is an F() or a combined expression (e.g. Sum(F("price") * F("qty"), _filter=Q(status="paid"))). Previously the filter was silently dropped and every row was aggregated. (fix(expressions): apply aggregate _filter to F() and combined expressions #2290)
• Negating an already negated Q now cancels out: ~~Q(...) and .exclude(~Q(...)) used to keep a single NOT, so they returned the rows the caller meant to drop. (fix(expressions): make ~~Q cancel out instead of staying negated #2291)
• PostgreSQL and Oracle RemoveIndex / partial RemoveConstraint now schema-qualify DROP INDEX, so indexes on models with Meta.schema can be dropped when they are not on the connection search_path. (DROP INDEX in migrations is not schema-qualified (PostgreSQL/Oracle) — breaks RemoveIndex/RemoveConstraint for models outside the default schema #2288)
• ForeignKeyField/OneToOneField no longer lose a declared source_field when deconstructed. makemigrations wrote the generated <field>_id backing field name as the column name, so a migrated schema disagreed with generate_schemas() and neither path reported an error. (Keep the declared source_field when deconstructing a FK #2284)
• QuerySet.distinct().count() no longer counts rows duplicated by a join (e.g. filtering on a m2m relation); it now counts distinct primary keys and matches the number of rows the query returns. (fix(queryset): make distinct().count() ignore join-duplicated rows #2255)
• DecimalField no longer strips the scale it just applied: to_python_value() called .normalize() immediately after .quantize(), so a DecimalField(max_digits=12, decimal_places=2) holding 100.00 came back as Decimal('1E+2') and rendered as 1E+2 in strings, f-strings and JSON. (fix: DecimalField no longer strips the scale it just quantized to #2271)
• BlackSheep: register_tortoise now enables the global connection fallback, so database access works when BlackSheep runs handlers in tasks other than the one that initialized the ORM. (Fix BlackSheep cross-task database access #2248)
• fix(queryset): support DELETE/UPDATE with filters on related fields. (fix(queryset): support DELETE/UPDATE with filters on related fields #2269)
• Fix naive DatetimeField timezone drift. (Fix naive DatetimeField timezone drift #2277)
• A model with its own Meta now inherits Meta.ordering from its abstract base model when it does not define its own. (Inherit Meta.ordering from abstract base models (#2046) #2236)
• The return type hint for IntEnumField/CharEnumField is now tortoise.fields.Field[EnumType] instead of EnumType. (Update the return type hint for IntEnumField/CharEnumField from EnumType to tortoise.fields.Field[EnumType] (fixes #2155) #2243)
• Make EmailValidator allowed_domains actually restrict domains. (Make EmailValidator allowed_domains actually restrict domains #2252)
• AlterModelOptions now clears options that were removed from the model, instead of only merging in the ones that remain; removing a model docstring no longer makes makemigrations regenerate the same migration on every run. (makemigrations keeps regenerating the same migration after a model docstring is removed #2279)
• Model.update_or_create() now applies the caller's defaults after losing a concurrent insert, re-reading the current row through the existing transactional update path. Creation is attempted at most twice, with a final locked read after the last conflict; repeated concurrent deletions that exhaust recovery raise OperationalError rather than retrying indefinitely. (fix(models): apply defaults after concurrent inserts #2276)
• psycopg: the connection pool now validates a connection on checkout, so one silently dropped by the network while idle (a firewall or load balancer closing it, a DB restart, ...) gets transparently replaced instead of being handed to the caller and failing with psycopg.OperationalError: the connection is closed. The check is a cheap no-op query on an already-open socket, so the added latency per checkout is negligible next to a real query. (fix(psycopg): check connection health on pool checkout #2285)
• Fixed prefetch_related() on m2m fields ignoring select_related(), annotate(), and order_by() applied to the prefetched queryset. (feat: rewrote the method for getting m2m objects #2205)
• pydantic_model_creator no longer raises TypeError for models with annotations whose origin is not a class, such as Literal[...]. (fix(pydantic): handle non-class annotation origins in is_field_annotation #2311)

New Contributors

• @VladislavYar made their first contribution in feat: q to bool #2227
• @mmdverse made their first contribution in fix(queryset): support DELETE/UPDATE with filters on related fields #2269
• @Sanjays2402 made their first contribution in fix(queryset): make distinct().count() ignore join-duplicated rows #2255
• @TheRodzz made their first contribution in Fix naive DatetimeField timezone drift #2277
• @get-bowen made their first contribution in feat(postgres): allow password to be a sync/async callable #2261
• @uttam12331 made their first contribution in Inherit Meta.ordering from abstract base models (#2046) #2236
• @apoorvdarshan made their first contribution in Update the return type hint for IntEnumField/CharEnumField from EnumType to tortoise.fields.Field[EnumType] (fixes #2155) #2243
• @dylanpulver made their first contribution in fix: DecimalField no longer strips the scale it just quantized to #2271
• @TrueFurina made their first contribution in fix: replace bare except with except Exception in sphinx autodoc typehints script #2263
• @sam-dawnops made their first contribution in Improve QuerySet integer-indexing error guidance #2093
• @edu2004eu made their first contribution in Clear removed model options in AlterModelOptions #2280
• @fzlzjerry made their first contribution in fix(models): apply defaults after concurrent inserts #2276
• @TianHengZhuang made their first contribution in docs: improve grammar in CONTRIBUTING.rst #2281
• @weberhyj made their first contribution in Support Starlette 1.0+ #2282
• @aksgupta98 made their first contribution in Keep the declared source_field when deconstructing a FK #2284
• @AdhamKhalifa made their first contribution in fix: schema-qualify DROP INDEX for non-default schemas #2289
• @RitiGrover made their first contribution in fix(psycopg): check connection health on pool checkout #2285
• @breken-ai made their first contribution in fix(expressions): make ~~Q cancel out instead of staying negated #2291
• @moneebullah25 made their first contribution in fix(pydantic): handle non-class annotation origins in is_field_annotation #2311

Full Changelog: 1.1.8...1.1.9

[codspeed]

Merging this PR will not alter performance

⚠️ 21 benchmarks spent significant time in system calls

System calls cannot be consistently instrumented, so they are not included in the measure, which understates the real cost. Please switch to the Walltime instrument to accurately measure system calls.

Measurement and system calls

• test_expressions_count
• test_hydrate_100_rows_many_fields
• test_update_many_fields_with_update
• test_update_many_fields_with_save
• test_expressions_f
• test_update_few_fields_with_save
• test_chained_filters_10
• test_create_few_fields
• test_get_few_fields
• test_hydrate_100_rows_few_fields
• …and 11 more

✅ 24 untouched benchmarks

---

_{Comparing waketzheng:release-1.1.9 (5fa34f5) with develop (a47e3f6)}