F() supports referencing JSONField attributes & Release 0.25.1 (#1960)

* F() supports referencing JSONField attributes
* Add support_json_attributes capability to Capabilities
* Release 0.25.1

Author: henadzit

CHANGELOG.rst

@@ -10,7 +10,7 @@ Changelog
 0.25
 ====
 
-0.25.1 (unreleased)
+0.25.1
 ------------------
 Changed
 ^^^^^
@@ -19,6 +19,7 @@ Changed
 Added
 ^^^^^
 - Add `no_key` parameter to `queryset.select_for_update`.
+- `F()` supports referencing JSONField attributes, e.g. `F("json_field__custom_field__nested_id")` (#1960)
 
 0.25.0
 ------

docs/expressions.rst

@@ -55,7 +55,7 @@ The NOT operation can be achieved using the negation operator (``~``):
 F Expression
 ============
 
-The ``F`` Expression represents a model field value and enables database operations on field values without loading them into Python memory. This is particularly useful for atomic operations.
+The ``F`` Expression represents a model field value and enables database operations on field values without loading them into Python memory.
 
 Example of using F expressions for balance updates (this is just an example and such updates are not recommended for use in financial applications):
 
@@ -89,6 +89,14 @@ F expressions can also be used in annotations:
 
     data = await User.annotate(idp=F("id") + 1).values_list("id", "idp")
 
+F expressions can also be used to reference JSON properties and array elements:
+
+.. code-block:: python3
+
+    await User.annotate(attr=F("json_field__property")).values_list("id", "attr")
+    await User.annotate(attr=F("json_field__arrayproperty__0")).values_list("id", "attr")
+
+
 Subquery
 ========
 

poetry.lock

@@ -1,6 +1,6 @@
 [project]
 name = "tortoise-orm"
-version = "0.25.0"
+version = "0.25.1"
 description = "Easy async ORM for python, built with relations in mind"
 authors = [{name="Andrey Bondar", email="[email protected]"}, {name="Nickolas Grigoriadis", email="[email protected]"}, {name="long2ice", email="[email protected]"}]
 license = {text="Apache-2.0"}
@@ -11,7 +11,7 @@ include = ["CHANGELOG.rst", "LICENSE", "README.rst"]
 dynamic = [ "classifiers" ]
 requires-python = ">=3.9"
 dependencies = [
-    "pypika-tortoise (>=0.6.0,<1.0.0); python_version < '4.0'",
+    "pypika-tortoise (>=0.6.1,<1.0.0); python_version < '4.0'",
     "iso8601 (>=2.1.0,<3.0.0); python_version < '4.0'",
     "aiosqlite (>=0.16.0,<1.0.0)",
     "pytz",