DriverTrac/venv/lib/python3.12/site-packages/narwhals/_sql/dataframe.py

54 lines
1.8 KiB
Python

from __future__ import annotations
from typing import TYPE_CHECKING, Any, Protocol
from narwhals._compliant.dataframe import CompliantLazyFrame
from narwhals._compliant.typing import (
CompliantExprT_contra,
NativeExprT,
NativeLazyFrameT,
)
from narwhals._translate import ToNarwhalsT_co
from narwhals._utils import check_columns_exist
from narwhals.exceptions import MultiOutputExpressionError
if TYPE_CHECKING:
from collections.abc import Sequence
from typing_extensions import Self, TypeAlias
from narwhals._compliant.window import WindowInputs
from narwhals._sql.expr import SQLExpr
from narwhals.exceptions import ColumnNotFoundError
Incomplete: TypeAlias = Any
class SQLLazyFrame(
CompliantLazyFrame[CompliantExprT_contra, NativeLazyFrameT, ToNarwhalsT_co],
Protocol[CompliantExprT_contra, NativeLazyFrameT, ToNarwhalsT_co],
):
def _evaluate_window_expr(
self,
expr: SQLExpr[Self, NativeExprT],
/,
window_inputs: WindowInputs[NativeExprT],
) -> NativeExprT:
result = expr.window_function(self, window_inputs)
if len(result) != 1: # pragma: no cover
msg = "multi-output expressions not allowed in this context"
raise MultiOutputExpressionError(msg)
return result[0]
def _evaluate_single_output_expr(
self, expr: SQLExpr[Self, NativeExprT], /
) -> NativeExprT:
result = expr(self)
if len(result) != 1: # pragma: no cover
msg = "multi-output expressions not allowed in this context"
raise MultiOutputExpressionError(msg)
return result[0]
def _check_columns_exist(self, subset: Sequence[str]) -> ColumnNotFoundError | None:
return check_columns_exist(subset, available=self.columns)