1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168
|
from collections.abc import Callable, Iterable, Iterator, Sequence
from datetime import date, datetime
from decimal import Decimal
from typing import Any, Literal, TypeAlias, overload
from uuid import UUID
from django.db.backends.base.base import BaseDatabaseWrapper
from django.db.backends.utils import CursorWrapper
from django.db.models import Field
from django.db.models.base import Model
from django.db.models.expressions import BaseExpression, Expression, Ref
from django.db.models.sql.query import Query
from django.db.models.sql.subqueries import AggregateQuery, DeleteQuery, InsertQuery, UpdateQuery
from django.utils.datastructures import _ListOrTuple
from django.utils.functional import cached_property
_ParamT: TypeAlias = str | int
_ParamsT: TypeAlias = _ListOrTuple[_ParamT]
_AsSqlType: TypeAlias = tuple[str, _ParamsT]
class PositionRef(Ref):
def __init__(self, ordinal: str, refs: str, source: Expression) -> None: ...
class SQLCompiler:
query: Query
connection: BaseDatabaseWrapper
using: str | None
quote_cache: Any
select: Any
annotation_col_map: Any
klass_info: Any
ordering_parts: Any
def __init__(self, query: Query, connection: BaseDatabaseWrapper, using: str | None) -> None: ...
col_count: int | None
def setup_query(self, with_col_aliases: bool = False) -> None: ...
has_extra_select: Any
def pre_sql_setup(
self,
with_col_aliases: bool = False,
) -> tuple[
list[tuple[Expression, _AsSqlType, None]],
list[tuple[Expression, tuple[str, _ParamsT, bool]]],
list[_AsSqlType],
]: ...
def get_group_by(
self,
select: list[tuple[BaseExpression, _AsSqlType, str | None]],
order_by: list[tuple[Expression, tuple[str, _ParamsT, bool]]],
) -> list[_AsSqlType]: ...
def collapse_group_by(
self, expressions: list[Expression], having: list[Expression] | tuple
) -> list[Expression]: ...
def get_select(
self,
with_col_aliases: bool = False,
) -> tuple[list[tuple[Expression, _AsSqlType, str | None]], dict[str, Any] | None, dict[str, int]]: ...
def _order_by_pairs(self) -> None: ...
def get_order_by(self) -> list[tuple[Expression, tuple[str, _ParamsT, bool]]]: ...
def get_extra_select(
self,
order_by: list[tuple[Expression, tuple[str, _ParamsT, bool]]],
select: list[tuple[Expression, _AsSqlType, str | None]],
) -> list[tuple[Expression, _AsSqlType, None]]: ...
def quote_name_unless_alias(self, name: str) -> str: ...
def compile(self, node: BaseExpression) -> _AsSqlType: ...
def get_combinator_sql(self, combinator: str, all: bool) -> tuple[list[str], list[int] | list[str]]: ...
def as_sql(self, with_limits: bool = True, with_col_aliases: bool = False) -> _AsSqlType: ...
def get_default_columns(
self, start_alias: str | None = None, opts: Any | None = None, from_parent: type[Model] | None = None
) -> list[Expression]: ...
def get_distinct(self) -> tuple[list[Any], list[Any]]: ...
def find_ordering_name(
self,
name: str,
opts: Any,
alias: str | None = None,
default_order: str = "ASC",
already_seen: set[tuple[tuple[tuple[str, str]] | None, tuple[tuple[str, str]]]] | None = None,
) -> list[tuple[Expression, bool]]: ...
def get_from_clause(self) -> tuple[list[str], _ParamsT]: ...
def get_related_selections(
self,
select: list[tuple[Expression, str | None]],
opts: Any | None = None,
root_alias: str | None = None,
cur_depth: int = 1,
requested: dict[str, dict[str, dict[str, dict[Any, Any]]]] | None = None,
restricted: bool | None = None,
) -> list[dict[str, Any]]: ...
def get_select_for_update_of_arguments(self) -> list[Any]: ...
def get_converters(self, expressions: list[Expression]) -> dict[int, tuple[list[Callable], Expression]]: ...
def apply_converters(
self, rows: Iterable[Iterable[Any]], converters: dict[int, tuple[list[Callable], Expression]]
) -> Iterator[list[None | date | datetime | float | Decimal | UUID | bytes | str]]: ...
def results_iter(
self,
results: Iterable[list[Sequence[Any]]] | None = None,
tuple_expected: bool = False,
chunked_fetch: bool = False,
chunk_size: int = 100,
) -> Iterator[Sequence[Any]]: ...
def has_results(self) -> bool: ...
@overload
def execute_sql(
self, result_type: Literal["cursor"] = "cursor", chunked_fetch: bool = False, chunk_size: int = 100
) -> CursorWrapper: ...
@overload
def execute_sql(
self,
result_type: Literal["no results"] | None = "no results",
chunked_fetch: bool = False,
chunk_size: int = 100,
) -> None: ...
@overload
def execute_sql(
self, result_type: Literal["single"] = "single", chunked_fetch: bool = False, chunk_size: int = 100
) -> Iterable[Sequence[Any]] | None: ...
@overload
def execute_sql(
self, result_type: Literal["multi"] = "multi", chunked_fetch: bool = False, chunk_size: int = 100
) -> Iterable[list[Sequence[Any]]] | None: ...
def explain_query(self) -> Iterator[str]: ...
def composite_fields_to_tuples(
self, rows: Iterable[Any], expressions: Iterable[Expression]
) -> Iterator[list[tuple[Any, ...]]]: ...
def has_composite_fields(self, expressions: Iterable[Expression]) -> bool: ...
class SQLInsertCompiler(SQLCompiler):
query: InsertQuery
returning_fields: Sequence[Any] | None
returning_params: Sequence[Any]
def field_as_sql(
self,
field: Field[Any, Any] | None,
get_placeholder: Callable[[Any, SQLInsertCompiler, BaseDatabaseWrapper], str],
val: Any,
) -> _AsSqlType: ...
def prepare_value(self, field: Any, value: Any) -> Any: ...
def pre_save_val(self, field: Any, obj: Any) -> Any: ...
def assemble_as_sql(self, fields: Any, value_rows: Any) -> tuple[list[list[str]], list[list[Any]]]: ...
def as_sql(self) -> list[_AsSqlType]: ... # type: ignore[override]
def execute_sql( # type: ignore[override]
self, returning_fields: Sequence[str] | None = None
) -> list[tuple[Any]]: ... # 1-tuple
class SQLDeleteCompiler(SQLCompiler):
query: DeleteQuery
@cached_property
def single_alias(self) -> bool: ...
@cached_property
def contains_self_reference_subquery(self) -> bool: ...
def as_sql(self) -> _AsSqlType: ... # type: ignore[override]
class SQLUpdateCompiler(SQLCompiler):
query: UpdateQuery
def as_sql(self) -> _AsSqlType: ... # type: ignore[override]
def execute_sql(self, result_type: Literal["cursor", "no results"]) -> int: ... # type: ignore[override]
def pre_sql_setup(self) -> None: ... # type: ignore[override]
class SQLAggregateCompiler(SQLCompiler):
query: AggregateQuery
col_count: int
def as_sql(self) -> _AsSqlType: ... # type: ignore[override]
def cursor_iter(
cursor: CursorWrapper, sentinel: Any, col_count: int | None, itersize: int
) -> Iterator[list[Sequence[Any]]]: ...
|