Merge remote-tracking branch 'upstream/develop' into replace-pytz

Author: waketzheng

.github/workflows/ci.yml

@@ -45,7 +45,7 @@ jobs:
       TORTOISE_MSSQL_DRIVER: ODBC Driver 18 for SQL Server
     strategy:
       matrix:
-        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
     steps:
       - uses: actions/cache@v4
         with:
@@ -65,7 +65,7 @@ jobs:
           sudo apt-get update
           sudo ACCEPT_EULA=Y apt-get install -y msodbcsql18
       - name: Run ci
-        run: uv run make ci
+        run: make ci
       - name: Test FastAPI/Blacksheep Example
         run: |
           PYTHONPATH=$DEST_FASTAPI uv run pytest $PYTEST_ARGS $DEST_FASTAPI/_tests.py

.github/workflows/gh-pages-release.yml

@@ -13,7 +13,7 @@ jobs:
           python-version: "3.9"
       - uses: astral-sh/setup-uv@v6
       - name: Build docs
-        run: uv run make docs
+        run: make docs
       - name: Deploy release docs
         uses: peaceiris/actions-gh-pages@v3
         with:

.github/workflows/gh-pages.yml

@@ -14,7 +14,7 @@ jobs:
           python-version: "3.9"
       - uses: astral-sh/setup-uv@v6
       - name: Build docs
-        run: uv run make docs
+        run: make docs
       - name: Deploy latest docs
         uses: peaceiris/actions-gh-pages@v3
         with:

CHANGELOG.rst

@@ -11,17 +11,36 @@ Changelog
 ====
 
 0.26.0 (unreleased)
-------------------- 
-Added
+-------------------
+
+0.25
+====
+
+0.25.3
+------
+Fixed
 ^^^^^
-- Add `create()` method to reverse ForeignKey relations, enabling `parent.children.create()` syntax
+- Fix exception when creating aiosqlite connections on aiosqlite==0.22.0 (#2035)
+- Fix implicit anyio dependency introduced, but not declared (#2045)
 
+0.25.2
+------
 Fixed
 ^^^^^
-- Fix sqlite decimal filter error with `__gt` (#2020)
+- Fix grouping by in subqueries (#2021)
+- Fix sqlite decimal filter error with `__gt` (#2019)
+
+Changed
+^^^^^
+- Official support python3.14 (#2026)
+- Migrate from poetry to uv (#1987)
+- Reorder imports by ruff (#1966)
+- Migrate lint tool from isort+black to ruff (#1963)
+
+Added
+^^^^^
+- Add `create()` method to reverse ForeignKey relations, enabling `parent.children.create()` syntax (#1991)
 
-0.25
-====
 
 0.25.1
 ------------------

Makefile

@@ -21,25 +21,25 @@ help:
 	@echo  "    lint    Auto-formats the code and check type hints"
 
 up:
-	@uv lock --upgrade
+	uv lock --upgrade
 
 deps:
-	@uv sync --all-groups --extra asyncpg --extra accel --extra psycopg --extra asyncodbc --extra aiomysql $(options)
+	uv sync --frozen --all-groups --extra asyncpg --extra accel --extra psycopg --extra asyncodbc --extra aiomysql $(options)
 
 deps_with_asyncmy:
-	@uv sync --all-groups --extra asyncpg --extra accel --extra psycopg --extra asyncodbc --extra asyncmy $(options)
+	uv sync --frozen --all-groups --extra asyncpg --extra accel --extra psycopg --extra asyncodbc --extra asyncmy $(options)
 
 check: build _check
 _check:
-	ruff format --check $(checkfiles) || (echo "Please run 'make style' to auto-fix style issues" && false)
-	ruff check $(checkfiles)
+	uv run --frozen ruff format --check $(checkfiles) || (echo "Please run 'make style' to auto-fix style issues" && false)
+	uv run --frozen ruff check $(checkfiles)
 	#pylint -d C,W,R $(checkfiles)
 	$(MAKE) _codeqc
 
 style: deps _style
 _style:
-	ruff format $(checkfiles)
-	ruff check --fix $(checkfiles)
+	uv run --frozen ruff format $(checkfiles)
+	uv run --frozen ruff check --fix $(checkfiles)
 
 lint: build _lint
 _lint:
@@ -48,30 +48,30 @@ _lint:
 
 codeqc: build _codeqc
 _codeqc:
-	mypy $(checkfiles)
-	bandit -c pyproject.toml -r $(checkfiles)
-	twine check dist/*
+	uv run --frozen mypy $(checkfiles)
+	uv run --frozen bandit -c pyproject.toml -r $(checkfiles)
+	uv run --frozen twine check dist/*
 
 test: deps
-	$(py_warn) TORTOISE_TEST_DB=sqlite://:memory: pytest $(pytest_opts)
+	$(py_warn) TORTOISE_TEST_DB=sqlite://:memory: uv run --frozen pytest $(pytest_opts)
 
 test_sqlite:
-	$(py_warn) TORTOISE_TEST_DB=sqlite://:memory: pytest --cov-report= $(pytest_opts)
+	$(py_warn) TORTOISE_TEST_DB=sqlite://:memory: uv run --frozen pytest --cov-report= $(pytest_opts)
 
 test_sqlite_regexp:
-	$(py_warn) TORTOISE_TEST_DB=sqlite://:memory:?install_regexp_functions=True pytest --cov-report= $(pytest_opts)
+	$(py_warn) TORTOISE_TEST_DB=sqlite://:memory:?install_regexp_functions=True uv run --frozen pytest --cov-report= $(pytest_opts)
 
 test_postgres_asyncpg:
-	python -V | grep PyPy || $(py_warn) TORTOISE_TEST_DB="asyncpg://postgres:$(TORTOISE_POSTGRES_PASS)@127.0.0.1:5432/test_\{\}" pytest $(pytest_opts) --cov-report=
+	uv run --frozen python -V | grep PyPy || $(py_warn) TORTOISE_TEST_DB="asyncpg://postgres:$(TORTOISE_POSTGRES_PASS)@127.0.0.1:5432/test_\{\}" uv run --frozen pytest $(pytest_opts) --cov-report=
 
 test_postgres_psycopg:
-	python -V | grep PyPy || $(py_warn) TORTOISE_TEST_DB="psycopg://postgres:$(TORTOISE_POSTGRES_PASS)@127.0.0.1:5432/test_\{\}" pytest $(pytest_opts) --cov-report=
+	uv run --frozen python -V | grep PyPy || $(py_warn) TORTOISE_TEST_DB="psycopg://postgres:$(TORTOISE_POSTGRES_PASS)@127.0.0.1:5432/test_\{\}" uv run --frozen pytest $(pytest_opts) --cov-report=
 
 test_mysql_myisam:
-	$(py_warn) TORTOISE_TEST_DB="mysql://root:$(TORTOISE_MYSQL_PASS)@127.0.0.1:3306/test_\{\}?storage_engine=MYISAM" pytest $(pytest_opts) --cov-report=
+	$(py_warn) TORTOISE_TEST_DB="mysql://root:$(TORTOISE_MYSQL_PASS)@127.0.0.1:3306/test_\{\}?storage_engine=MYISAM" uv run --frozen pytest $(pytest_opts) --cov-report=
 
 test_mysql:
-	$(py_warn) TORTOISE_TEST_DB="mysql://root:$(TORTOISE_MYSQL_PASS)@127.0.0.1:3306/test_\{\}" pytest $(pytest_opts) --cov-report=
+	$(py_warn) TORTOISE_TEST_DB="mysql://root:$(TORTOISE_MYSQL_PASS)@127.0.0.1:3306/test_\{\}" uv run --frozen pytest $(pytest_opts) --cov-report=
 
 test_mysql_asyncmy:
 	$(MAKE) deps_with_asyncmy
@@ -80,26 +80,26 @@ test_mysql_asyncmy:
 	$(MAKE) deps
 
 test_mssql:
-	$(py_warn) TORTOISE_TEST_DB="mssql://sa:$(TORTOISE_MSSQL_PASS)@127.0.0.1:1433/test_\{\}?driver=$(TORTOISE_MSSQL_DRIVER)&TrustServerCertificate=YES" pytest $(pytest_opts) --cov-report=
+	$(py_warn) TORTOISE_TEST_DB="mssql://sa:$(TORTOISE_MSSQL_PASS)@127.0.0.1:1433/test_\{\}?driver=$(TORTOISE_MSSQL_DRIVER)&TrustServerCertificate=YES" uv run --frozen pytest $(pytest_opts) --cov-report=
 
 test_oracle:
-	$(py_warn) TORTOISE_TEST_DB="oracle://SYSTEM:$(TORTOISE_ORACLE_PASS)@127.0.0.1:1521/test_\{\}?driver=$(TORTOISE_ORACLE_DRIVER)" pytest $(pytest_opts) --cov-report=
+	$(py_warn) TORTOISE_TEST_DB="oracle://SYSTEM:$(TORTOISE_ORACLE_PASS)@127.0.0.1:1521/test_\{\}?driver=$(TORTOISE_ORACLE_DRIVER)" uv run --frozen pytest $(pytest_opts) --cov-report=
 
 _testall: test_sqlite test_postgres_asyncpg test_postgres_psycopg test_mysql_myisam test_mysql test_mysql_asyncmy test_mssql
 
-	coverage report
+	uv run --frozen coverage report
 
 testall: deps _testall
 
 ci: check _testall
 
 docs: deps
 	rm -fR ./build
-	sphinx-build -M html docs build
+	uv run --frozen sphinx-build -M html docs build
 
 build: deps
 	rm -fR dist/
 	uv build
 
 publish: deps _build
-	twine upload dist/*
+	uv run --frozen twine upload dist/*

pyproject.toml

@@ -8,9 +8,11 @@ keywords = ["sql", "mysql", "postgres", "psql", "sqlite", "aiosqlite", "asyncpg"
 dynamic = [ "version" ]
 requires-python = ">=3.9"
 dependencies = [
-    "pypika-tortoise (>=0.6.1,<1.0.0)",
+    "pypika-tortoise (>=0.6.3,<1.0.0)",
     "iso8601 (>=2.1.0,<3.0.0); python_version < '4.0'",
     "aiosqlite (>=0.16.0,<1.0.0)",
+    "anyio",
+    "typing-extensions (>= 4.1.0); python_version < '3.11'",
 ]
 classifiers = [
     "License :: OSI Approved :: Apache Software License",
@@ -22,6 +24,7 @@ classifiers = [
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Programming Language :: Python :: Implementation :: CPython",
     "Programming Language :: Python :: Implementation :: PyPy",
     "Programming Language :: PL/SQL",

tests/contrib/test_decorator.py

@@ -8,8 +8,9 @@
 class TestDecorator(test.TestCase):
     @test.requireCapability(dialect="sqlite")
     async def test_script_with_init_memory_sqlite(self) -> None:
-        r = subprocess.run(["python", "examples/basic.py"], capture_output=True)  # nosec
-        output = r.stdout.decode()
+        r = subprocess.run(["python", "examples/basic.py"], capture_output=True, text=True)  # nosec
+        assert not r.stderr
+        output = r.stdout
         s = "[{'id': 1, 'name': 'Updated name'}, {'id': 2, 'name': 'Test 2'}]"
         self.assertIn(s, output)
 

tests/test_group_by.py

@@ -1,5 +1,6 @@
 from tests.testmodels import Author, Book, Event, Team, Tournament
 from tortoise.contrib import test
+from tortoise.expressions import Subquery
 from tortoise.functions import Avg, Count, Sum, Upper
 
 
@@ -317,3 +318,14 @@ async def test_group_by_nested_column(self):
     async def test_group_by_id_with_nested_filter(self):
         ret = await Book.filter(author__name="author1").group_by("id").values_list("id")
         self.assertEqual(set(ret), {(book.id,) for book in self.books1})
+
+    async def test_select_subquery_with_group_by(self):
+        subquery = Subquery(
+            Book.all().group_by("rating").order_by("-rating").limit(1).values("rating")
+        )
+        ret = (
+            await Author.annotate(top_rating=subquery)
+            .order_by("id")
+            .values_list("name", "top_rating")
+        )
+        self.assertEqual(ret, [(self.a1.name, 9.0), (self.a2.name, 9.0)])

tests/test_table_name.py

@@ -36,3 +36,7 @@ async def test_glabal_name_generator(self):
 
     async def test_custom_table_name_precedence(self):
         self.assertEqual(CustomTable._meta.db_table, "my_custom_table")
+
+    async def _tearDownDB(self) -> None:
+        # Explicitly close aiosqlite connection to fix ResourceWarning
+        await Tortoise.get_connection("default").close()

tests/utils/test_describe_model.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import json
+import sys
 import uuid
 from typing import Union
 
@@ -29,6 +30,18 @@
     OneToOneFieldInstance,
 )
 
+if sys.version_info >= (3, 14):
+
+    def union_annotation(x: str, y: str) -> str:
+        return f"{x} | {y}"
+else:
+
+    def union_annotation(x: str, y: str) -> str:
+        return f"Union[{x}, {y}]"
+
+
+UNION_DICT_LIST = union_annotation("dict", "list")
+
 
 class TestDescribeModels(test.TestCase):
     def test_describe_models_all_serializable(self):
@@ -1366,7 +1379,7 @@ def test_describe_model_json(self):
                             "oracle": "NCLOB",
                             "postgres": "JSONB",
                         },
-                        "python_type": "Union[dict, list]",
+                        "python_type": UNION_DICT_LIST,
                         "generated": False,
                         "nullable": False,
                         "unique": False,
@@ -1386,7 +1399,7 @@ def test_describe_model_json(self):
                             "oracle": "NCLOB",
                             "postgres": "JSONB",
                         },
-                        "python_type": "Union[dict, list]",
+                        "python_type": UNION_DICT_LIST,
                         "generated": False,
                         "nullable": True,
                         "unique": False,
@@ -1406,7 +1419,7 @@ def test_describe_model_json(self):
                             "oracle": "NCLOB",
                             "postgres": "JSONB",
                         },
-                        "python_type": "Union[dict, list]",
+                        "python_type": UNION_DICT_LIST,
                         "generated": False,
                         "nullable": False,
                         "unique": False,
@@ -1426,7 +1439,7 @@ def test_describe_model_json(self):
                             "oracle": "NCLOB",
                             "postgres": "JSONB",
                         },
-                        "python_type": "Union[dict, list]",
+                        "python_type": UNION_DICT_LIST,
                         "generated": False,
                         "nullable": True,
                         "unique": False,