Add Python 3.15 sqlite3 updates

Author: JelleZijlstra

stdlib/@tests/stubtest_allowlists/py315.txt

@@ -36,7 +36,6 @@ _pyrepl.types
 _pyrepl.utils
 _pyrepl.windows_console
 _pyrepl.windows_eventqueue
-_sqlite3.SQLITE_KEYWORDS
 _ssl.HAS_PSK_TLS13
 _ssl._SSLContext.get_groups
 _ssl._SSLContext.set_ciphersuites
@@ -273,13 +272,6 @@ site.addsitedir
 site.addsitepackages
 site.addusersitepackages
 site.process_startup_files
-sqlite3.Connection.create_aggregate
-sqlite3.Connection.create_function
-sqlite3.Connection.set_authorizer
-sqlite3.Connection.set_progress_handler
-sqlite3.Connection.set_trace_callback
-sqlite3.SQLITE_KEYWORDS
-sqlite3.dbapi2.SQLITE_KEYWORDS
 sre_compile
 sre_constants
 sre_parse

stdlib/_sqlite3.pyi

@@ -69,6 +69,8 @@ SQLITE_SAVEPOINT: Final = 32
 SQLITE_SELECT: Final = 21
 SQLITE_TRANSACTION: Final = 22
 SQLITE_UPDATE: Final = 23
+if sys.version_info >= (3, 15):
+    SQLITE_KEYWORDS: tuple[str, ...]
 adapters: dict[tuple[type[Any], type[Any]], _Adapter[Any]]
 converters: dict[str, _Converter]
 sqlite_version: str

stdlib/sqlite3/__init__.pyi

@@ -68,6 +68,9 @@ from typing_extensions import Self, disjoint_base
 if sys.version_info < (3, 14):
     from sqlite3.dbapi2 import version_info as version_info
 
+if sys.version_info >= (3, 15):
+    from sqlite3.dbapi2 import SQLITE_KEYWORDS as SQLITE_KEYWORDS
+
 if sys.version_info >= (3, 12):
     from sqlite3.dbapi2 import (
         LEGACY_TRANSACTION_CONTROL as LEGACY_TRANSACTION_CONTROL,
@@ -331,7 +334,10 @@ class Connection:
         def blobopen(self, table: str, column: str, row: int, /, *, readonly: bool = False, name: str = "main") -> Blob: ...
 
     def commit(self) -> None: ...
-    def create_aggregate(self, name: str, n_arg: int, aggregate_class: Callable[[], _AggregateProtocol]) -> None: ...
+    if sys.version_info >= (3, 15):
+        def create_aggregate(self, name: str, n_arg: int, aggregate_class: Callable[[], _AggregateProtocol], /) -> None: ...
+    else:
+        def create_aggregate(self, /, name: str, n_arg: int, aggregate_class: Callable[[], _AggregateProtocol]) -> None: ...
     if sys.version_info >= (3, 11):
         # num_params determines how many params will be passed to the aggregate class. We provide an overload
         # for the case where num_params = 1, which is expected to be the common case.
@@ -350,9 +356,15 @@ class Connection:
         ) -> None: ...
 
     def create_collation(self, name: str, callback: Callable[[str, str], SupportsIndex] | None, /) -> None: ...
-    def create_function(
-        self, name: str, narg: int, func: Callable[..., _SqliteData] | None, *, deterministic: bool = False
-    ) -> None: ...
+    if sys.version_info >= (3, 15):
+        def create_function(
+            self, name: str, narg: int, func: Callable[..., _SqliteData] | None, /, *, deterministic: bool = False
+        ) -> None: ...
+    else:
+        def create_function(
+            self, /, name: str, narg: int, func: Callable[..., _SqliteData] | None, *, deterministic: bool = False
+        ) -> None: ...
+
     @overload
     def cursor(self, factory: None = None) -> Cursor: ...
     @overload
@@ -367,11 +379,18 @@ class Connection:
         def iterdump(self) -> Generator[str]: ...
 
     def rollback(self) -> None: ...
-    def set_authorizer(
-        self, authorizer_callback: Callable[[int, str | None, str | None, str | None, str | None], int] | None
-    ) -> None: ...
-    def set_progress_handler(self, progress_handler: Callable[[], int | None] | None, n: int) -> None: ...
-    def set_trace_callback(self, trace_callback: Callable[[str], object] | None) -> None: ...
+    if sys.version_info >= (3, 15):
+        def set_authorizer(
+            self, authorizer_callback: Callable[[int, str | None, str | None, str | None, str | None], int] | None, /
+        ) -> None: ...
+        def set_progress_handler(self, progress_handler: Callable[[], int | None] | None, /, n: int) -> None: ...
+        def set_trace_callback(self, trace_callback: Callable[[str], object] | None, /) -> None: ...
+    else:
+        def set_authorizer(
+            self, /, authorizer_callback: Callable[[int, str | None, str | None, str | None, str | None], int] | None
+        ) -> None: ...
+        def set_progress_handler(self, /, progress_handler: Callable[[], int | None] | None, n: int) -> None: ...
+        def set_trace_callback(self, /, trace_callback: Callable[[str], object] | None) -> None: ...
     # enable_load_extension and load_extension is not available on python distributions compiled
     # without sqlite3 loadable extension support. see footnotes https://docs.python.org/3/library/sqlite3.html#f1
     def enable_load_extension(self, enable: bool, /) -> None: ...

stdlib/sqlite3/dbapi2.pyi

@@ -90,6 +90,9 @@ if sys.version_info >= (3, 12):
         SQLITE_DBCONFIG_WRITABLE_SCHEMA as SQLITE_DBCONFIG_WRITABLE_SCHEMA,
     )
 
+if sys.version_info >= (3, 15):
+    from _sqlite3 import SQLITE_KEYWORDS as SQLITE_KEYWORDS
+
 if sys.version_info >= (3, 11):
     from _sqlite3 import (
         SQLITE_ABORT as SQLITE_ABORT,