Update some database backend attributes for Django 5.1 (#2567)

From django/django@b863c5f:

* `django.db.backends.base.operations.BaseDatabaseOperations.force_group_by` added

From django/django@db349fc:

* `django.db.backends.ddl_references.Reference.references_index` added
* `django.db.backends.ddl_references.Statement.references_index` added
* `django.db.backends.ddl_references.Table.references_index` added

From django/django@6375cee:

* `django.db.backends.base.operations.BaseDatabaseOperations.window_frame_end` removed
* `django.db.backends.base.operations.BaseDatabaseOperations.window_frame_start` removed
* `django.db.backends.base.operations.BaseDatabaseOperations.window_frame_value` added

From django/django@912f72a:

* `django.db.backends.base.operations.BaseDatabaseOperations.bulk_insert_sql` added
* other `bulk_insert_sql` methods removed

Author: adamchainz

django-stubs/contrib/gis/db/backends/mysql/operations.pyi

@@ -20,6 +20,8 @@ class MySQLOperations(BaseSpatialOperations, DatabaseOperations):
     @cached_property
     def from_text(self) -> str: ...  # type: ignore[override]
     @cached_property
+    def collect(self) -> str: ...
+    @cached_property
     def gis_operators(self) -> dict[str, SpatialOperator]: ...
     disallowed_aggregates: Any
     @cached_property

django-stubs/db/backends/base/operations.pyi

@@ -47,11 +47,13 @@ class BaseDatabaseOperations:
     def fetch_returned_insert_columns(self, cursor: Any, returning_params: Any) -> Any: ...
     @deprecated("field_cast_sql() is deprecated and will be removed in Django 6.0. Use lookup_cast() instead.")
     def field_cast_sql(self, db_type: str | None, internal_type: str) -> str: ...
+    def force_group_by(self) -> list[str]: ...
     def force_no_ordering(self) -> list[Any]: ...
     def for_update_sql(
         self, nowait: bool = False, skip_locked: bool = False, of: Any = (), no_key: bool = False
     ) -> str: ...
     def limit_offset_sql(self, low_mark: int, high_mark: int | None) -> str: ...
+    def bulk_insert_sql(self, fields: Iterable[Field], placeholder_rows: Iterable[str]) -> str: ...
     def last_executed_query(self, cursor: Any, sql: Any, params: Any) -> str: ...
     def last_insert_id(self, cursor: CursorWrapper, table_name: str, pk_name: str) -> int: ...
     def lookup_cast(self, lookup_type: str, internal_type: str | None = None) -> str: ...
@@ -105,8 +107,7 @@ class BaseDatabaseOperations:
     def modify_insert_params(self, placeholder: str, params: Any) -> Any: ...
     def integer_field_range(self, internal_type: Any) -> tuple[int, int]: ...
     def subtract_temporals(self, internal_type: Any, lhs: Any, rhs: Any) -> tuple[str, tuple[Any, ...]]: ...
-    def window_frame_start(self, start: Any) -> str: ...
-    def window_frame_end(self, end: Any) -> str: ...
+    def window_frame_value(self, value: int | None) -> str: ...
     def window_frame_rows_start_end(self, start: int | None = None, end: int | None = None) -> tuple[str, str]: ...
     def window_frame_range_start_end(self, start: int | None = None, end: int | None = None) -> tuple[str, str]: ...
     def explain_query_prefix(self, format: str | None = None, **options: Any) -> str: ...

django-stubs/db/backends/ddl_references.pyi

@@ -10,13 +10,15 @@ class _QuoteCallable(Protocol):
 class Reference:
     def references_table(self, table: Any) -> bool: ...
     def references_column(self, table: Any, column: Any) -> bool: ...
+    def references_index(self, table: Any, index: Any) -> bool: ...
     def rename_table_references(self, old_table: Any, new_table: Any) -> None: ...
     def rename_column_references(self, table: Any, old_column: Any, new_column: Any) -> None: ...
 
 class Table(Reference):
     table: str
     quote_name: _QuoteCallable
     def __init__(self, table: str, quote_name: _QuoteCallable) -> None: ...
+    def references_index(self, table: Any, index: Any) -> bool: ...
     def references_table(self, table: str) -> bool: ...
     def rename_table_references(self, old_table: str, new_table: str) -> None: ...
 
@@ -81,5 +83,6 @@ class Statement(Reference):
     def __init__(self, template: str, **parts: Any) -> None: ...
     def references_table(self, table: str) -> bool: ...
     def references_column(self, table: str, column: str) -> bool: ...
+    def references_index(self, table: Any, index: Any) -> bool: ...
     def rename_table_references(self, old_table: str, new_table: str) -> None: ...
     def rename_column_references(self, table: str, old_column: str, new_column: str) -> None: ...

django-stubs/db/backends/mysql/operations.pyi

@@ -30,7 +30,6 @@ class DatabaseOperations(BaseDatabaseOperations):
     def adapt_datetimefield_value(self, value: Any) -> Any: ...
     def adapt_timefield_value(self, value: Any) -> Any: ...
     def max_name_length(self) -> Any: ...
-    def bulk_insert_sql(self, fields: Any, placeholder_rows: Any) -> Any: ...
     def combine_expression(self, connector: Any, sub_expressions: Any) -> Any: ...
     def get_db_converters(self, expression: Any) -> Any: ...
     def convert_booleanfield_value(self, value: Any, expression: Any, connection: Any) -> Any: ...

django-stubs/db/backends/oracle/operations.pyi

@@ -53,7 +53,6 @@ class DatabaseOperations(BaseDatabaseOperations):
     def adapt_datetimefield_value(self, value: Any) -> Any: ...
     def adapt_timefield_value(self, value: Any) -> Any: ...
     def combine_expression(self, connector: Any, sub_expressions: Any) -> Any: ...
-    def bulk_insert_sql(self, fields: Any, placeholder_rows: Any) -> str: ...
     def subtract_temporals(self, internal_type: Any, lhs: Any, rhs: Any) -> Any: ...
     def bulk_batch_size(self, fields: Any, objs: Any) -> int: ...
     def conditional_expression_supported_in_where_clause(self, expression: Any) -> bool: ...

django-stubs/db/backends/postgresql/operations.pyi

@@ -1,4 +1,3 @@
-from collections.abc import Iterable
 from typing import Any
 
 from django.db.backends.base.operations import BaseDatabaseOperations
@@ -8,6 +7,5 @@ class DatabaseOperations(BaseDatabaseOperations):
     connection: DatabaseWrapper
     explain_options: frozenset[str]
 
-    def bulk_insert_sql(self, fields: Any, placeholder_rows: Iterable[str]) -> str: ...
     def compose_sql(self, sql: Any, params: Any) -> Any: ...
     def fetch_returned_insert_rows(self, cursor: Any) -> Any: ...

django-stubs/db/backends/sqlite3/operations.pyi

@@ -1,12 +1,11 @@
-from collections.abc import Callable, Iterable
+from collections.abc import Callable
 from typing import Any
 from uuid import UUID
 
 from django.db.backends.base.operations import BaseDatabaseOperations
 
 class DatabaseOperations(BaseDatabaseOperations):
     jsonfield_datatype_values: frozenset[str]
-    def bulk_insert_sql(self, fields: Any, placeholder_rows: Iterable[str]) -> str: ...
     def convert_booleanfield_value(self, value: Any, expression: Any, connection: Any) -> Any: ...
     def convert_datefield_value(self, value: Any, expression: Any, connection: Any) -> Any: ...
     def convert_datetimefield_value(self, value: Any, expression: Any, connection: Any) -> Any | None: ...

scripts/stubtest/allowlist.txt

@@ -163,6 +163,7 @@ django.contrib.contenttypes.fields.ReverseGenericManyToOneDescriptor.related_man
 django.contrib.gis.db.backends.base.operations.BaseSpatialOperations.select_extent
 django.contrib.gis.db.backends.mysql.features.DatabaseFeatures.django_test_skips
 django.contrib.gis.db.backends.mysql.features.DatabaseFeatures.supports_geometry_field_unique_index
+django.contrib.gis.db.backends.mysql.operations.MySQLOperations.collect
 django.contrib.gis.geoip2.GeoIP2.is_country
 django.contrib.gis.geoip2.GeoIP2.is_city
 django.contrib.gis.db.backends.mysql.operations.MySQLOperations.from_text

scripts/stubtest/allowlist_todo_django51.txt

@@ -5,7 +5,6 @@
 
 django.contrib.contenttypes.fields.GenericForeignKey.get_attname_column
 django.contrib.contenttypes.models.ContentType.get_object_for_this_type
-django.contrib.gis.db.backends.mysql.operations.MySQLOperations.collect
 django.contrib.gis.db.models.ForeignObjectRel.accessor_name
 django.contrib.gis.forms.ModelChoiceField.validate_no_null_characters
 django.contrib.gis.forms.RadioSelect.__slotnames__
@@ -40,14 +39,6 @@ django.contrib.postgres.fields.CIText
 django.contrib.postgres.fields.citext.CIText
 django.contrib.postgres.indexes.BTreeIndex.__init__
 django.core.signing.Signer.__init__
-django.db.backends.base.operations.BaseDatabaseOperations.bulk_insert_sql
-django.db.backends.base.operations.BaseDatabaseOperations.force_group_by
-django.db.backends.base.operations.BaseDatabaseOperations.window_frame_end
-django.db.backends.base.operations.BaseDatabaseOperations.window_frame_start
-django.db.backends.base.operations.BaseDatabaseOperations.window_frame_value
-django.db.backends.ddl_references.Reference.references_index
-django.db.backends.ddl_references.Statement.references_index
-django.db.backends.ddl_references.Table.references_index
 django.db.backends.oracle.features.DatabaseFeatures.bare_select_suffix
 django.db.backends.oracle.features.DatabaseFeatures.supports_aggregation_over_interval_types
 django.db.backends.oracle.features.DatabaseFeatures.supports_comparing_boolean_expr
@@ -56,7 +47,6 @@ django.db.backends.postgresql.base.DatabaseWrapper.pool
 django.db.backends.postgresql.features.DatabaseFeatures.django_test_skips
 django.db.backends.postgresql.features.DatabaseFeatures.is_postgresql_16
 django.db.backends.sqlite3.base.DatabaseWrapper.transaction_modes
-django.db.backends.sqlite3.operations.DatabaseOperations.force_group_by
 django.db.migrations.autodetector.MigrationAutodetector.generate_altered_index_together
 django.db.migrations.autodetector.OperationDependency
 django.db.models.ForeignObjectRel.accessor_name