Flowfile 0.4.1__py3-none-any.whl → 0.5.3__py3-none-any.whl

flowfile_frame/expr.pyi

@@ -2,33 +2,34 @@
 # DO NOT MODIFY THIS FILE MANUALLY
 from __future__ import annotations
 
-from typing import Any, List, Optional, Union,  TypeVar, TYPE_CHECKING
+from typing import TYPE_CHECKING, Any, TypeVar, Union
+
 import polars as pl
-from polars.expr.expr import Expr as PolarsExpr
-from polars.expr.string import ExprStringNameSpace
 
 if TYPE_CHECKING:
     from collections.abc import Iterable
     from io import IOBase
-    from polars import DataFrame, LazyFrame, Series
+
+    from polars import Series
     from polars._typing import *
 
     if sys.version_info >= (3, 11):
         from typing import Concatenate, ParamSpec
     else:
-        from typing_extensions import Concatenate, ParamSpec
+        from typing import Concatenate
+
+        from typing_extensions import ParamSpec
     T = TypeVar('T')
     P = ParamSpec('P')
     from flowfile_core.schemas import transform_schema
-import flowfile_frame
-from flowfile_frame.selectors import Selector
 from flowfile_frame.expr_name import ExprNameNameSpace
+from flowfile_frame.selectors import Selector
 
 # Define NoneType to handle type hints with None
 NoneType = type(None)
 
 ExprOrStr = Union['Expr', str]
-ExprOrStrList = List[ExprOrStr]
+ExprOrStrList = list[ExprOrStr]
 ExprStrOrList = Union[ExprOrStr, ExprOrStrList]
 
 class StringMethods:
@@ -40,9 +41,9 @@ class StringMethods:
 
     def __getattr__(self, name) -> Any: ...
 
-    def __init__(self, parent_expr: 'Expr', parent_repr_str: str, convertable_to_code: bool=True, _function_sources: Optional[List[str]]=None) -> Any: ...
+    def __init__(self, parent_expr: Expr, parent_repr_str: str, convertable_to_code: bool=True, _function_sources: list[str] | None=None) -> Any: ...
 
-    def _create_next_expr(self, *args, method_name: str, result_expr: Optional[pl.Expr], is_complex: bool, convertable_to_code: bool=None, **kwargs) -> 'Expr': ...
+    def _create_next_expr(self, *args, method_name: str, result_expr: pl.Expr | None, is_complex: bool, convertable_to_code: bool=None, **kwargs) -> Expr: ...
 
     def contains(self, pattern, literal=False) -> Any: ...
 
@@ -56,11 +57,11 @@ class StringMethods:
 
     def starts_with(self, prefix) -> Any: ...
 
-    def strptime(self, dtype: PolarsTemporalType, format: str | None=None, strict: bool=True, exact: bool=True, cache: bool=True, ambiguous: Literal['earliest', 'latest', 'raise', 'null'] | Expr='raise') -> 'Expr': ...
+    def strptime(self, dtype: PolarsTemporalType, format: str | None=None, strict: bool=True, exact: bool=True, cache: bool=True, ambiguous: Literal[earliest, latest, 'raise', null] | Expr='raise') -> Expr: ...
 
     def to_date(self, format: str, strict: bool=True, exact: bool=True, cache: bool=True) -> Any: ...
 
-    def to_datetime(self, format: str | None=None, time_unit: Literal['ns', 'us', 'ms'] | None=None, time_zone: str | None=None, strict: bool=True, exact: bool=True, cache: bool=True, ambiguous: Literal['earliest', 'latest', 'raise', 'null'] | Expr='raise') -> 'Expr': ...
+    def to_datetime(self, format: str | None=None, time_unit: Literal[ns, us, ms] | None=None, time_zone: str | None=None, strict: bool=True, exact: bool=True, cache: bool=True, ambiguous: Literal[earliest, latest, 'raise', null] | Expr='raise') -> Expr: ...
 
     def to_lowercase(self, ) -> Any: ...
 
@@ -78,9 +79,9 @@ class DateTimeMethods:
 
     def __getattr__(self, name) -> Any: ...
 
-    def __init__(self, parent_expr: 'Expr', parent_repr_str: str, convertable_to_code: bool=True, _function_sources: Optional[List[str]]=None) -> Any: ...
+    def __init__(self, parent_expr: Expr, parent_repr_str: str, convertable_to_code: bool=True, _function_sources: list[str] | None=None) -> Any: ...
 
-    def _create_next_expr(self, method_name: str, result_expr: Optional[pl.Expr], convertable_to_code: bool=None, *args, **kwargs) -> 'Expr': ...
+    def _create_next_expr(self, method_name: str, result_expr: pl.Expr | None, convertable_to_code: bool=None, *args, **kwargs) -> Expr: ...
 
     def day(self, ) -> Any: ...
 
@@ -109,37 +110,37 @@ class Expr:
     __doc__: Any
     __hash__: Any
 
-    def __add__(self, other) -> 'Expr': ...
+    def __add__(self, other) -> Expr: ...
 
-    def __and__(self, other) -> 'Expr': ...
+    def __and__(self, other) -> Expr: ...
 
-    def __eq__(self, other) -> 'Expr': ...
+    def __eq__(self, other) -> Expr: ...
 
-    def __floordiv__(self, other) -> 'Expr': ...
+    def __floordiv__(self, other) -> Expr: ...
 
-    def __ge__(self, other) -> 'Expr': ...
+    def __ge__(self, other) -> Expr: ...
 
-    def __gt__(self, other) -> 'Expr': ...
+    def __gt__(self, other) -> Expr: ...
 
-    def __init__(self, expr: Optional[pl.Expr], column_name: Optional[str]=None, repr_str: Optional[str]=None, initial_column_name: Optional[str]=None, selector: Optional['Selector']=None, agg_func: Optional[str]=None, ddof: Optional[int]=None, is_complex: bool=False, convertable_to_code: bool=True, _function_sources: Optional[List[str]]=None) -> Any: ...
+    def __init__(self, expr: pl.Expr | None, column_name: str | None=None, repr_str: str | None=None, initial_column_name: str | None=None, selector: Selector | None=None, agg_func: str | None=None, ddof: int | None=None, is_complex: bool=False, convertable_to_code: bool=True, _function_sources: list[str] | None=None) -> Any: ...
 
-    def __invert__(self, ) -> 'Expr': ...
+    def __invert__(self, ) -> Expr: ...
 
-    def __le__(self, other) -> 'Expr': ...
+    def __le__(self, other) -> Expr: ...
 
-    def __lt__(self, other) -> 'Expr': ...
+    def __lt__(self, other) -> Expr: ...
 
-    def __mod__(self, other) -> 'Expr': ...
+    def __mod__(self, other) -> Expr: ...
 
-    def __mul__(self, other) -> 'Expr': ...
+    def __mul__(self, other) -> Expr: ...
 
-    def __ne__(self, other) -> 'Expr': ...
+    def __ne__(self, other) -> Expr: ...
 
-    def __neg__(self, ) -> 'Expr': ...
+    def __neg__(self, ) -> Expr: ...
 
-    def __or__(self, other) -> 'Expr': ...
+    def __or__(self, other) -> Expr: ...
 
-    def __pow__(self, exponent) -> 'Expr': ...
+    def __pow__(self, exponent) -> Expr: ...
 
     def __radd__(self, other) -> Any: ...
 
@@ -157,15 +158,15 @@ class Expr:
 
     def __rtruediv__(self, other) -> Any: ...
 
-    def __sub__(self, other) -> 'Expr': ...
+    def __sub__(self, other) -> Expr: ...
 
-    def __truediv__(self, other) -> 'Expr': ...
+    def __truediv__(self, other) -> Expr: ...
 
     # Creates a new Expr for binary operations.
-    def _create_binary_op_expr(self, op_symbol: str, other: Any, result_expr: Optional[pl.Expr]) -> 'Expr': ...
+    def _create_binary_op_expr(self, op_symbol: str, other: Any, result_expr: pl.Expr | None) -> Expr: ...
 
     # Creates a new Expr instance, appending method call to repr string.
-    def _create_next_expr(self, *args, method_name: str, result_expr: Optional[pl.Expr], convertable_to_code: bool=None, is_complex: bool, _function_sources: Optional[List[str]]=None, **kwargs) -> 'Expr': ...
+    def _create_next_expr(self, *args, method_name: str, result_expr: pl.Expr | None, convertable_to_code: bool=None, is_complex: bool, _function_sources: list[str] | None=None, **kwargs) -> Expr: ...
 
     # Helper to get appropriate string representation for an expression
     def _get_expr_repr(self, expr) -> Any: ...
@@ -180,7 +181,7 @@ class Expr:
     def agg_groups(self, ) -> Expr: ...
 
     # Rename the expression result.
-    def alias(self, name) -> 'Expr': ...
+    def alias(self, name) -> Expr: ...
 
     # Return whether all values in the column are `True`.
     def all(self, ignore_nulls: bool=True) -> Expr: ...
@@ -221,12 +222,12 @@ class Expr:
     # Get the index of the minimal value.
     def arg_min(self, ) -> Expr: ...
 
-    def arg_sort(self, descending: bool=False, nulls_last: bool=False) -> 'Expr': ...
+    def arg_sort(self, descending: bool=False, nulls_last: bool=False) -> Expr: ...
 
     # Return indices where expression evaluates `True`.
     def arg_true(self, ) -> Expr: ...
 
-    def arg_unique(self, ) -> 'Expr': ...
+    def arg_unique(self, ) -> Expr: ...
 
     # Fill missing values with the next non-null value.
     def backward_fill(self, limit: int | None=None) -> Expr: ...
@@ -265,7 +266,7 @@ class Expr:
     def bottom_k_by(self, by: IntoExpr | Iterable[IntoExpr], k: int | IntoExprColumn=5, reverse: bool | Sequence[bool]=False) -> Expr: ...
 
     # Casts the Expr to a specified data type.
-    def cast(self, dtype: Union[pl.DataType, str, pl.datatypes.classes.DataTypeClass], strict=True) -> 'Expr': ...
+    def cast(self, dtype: pl.DataType | str | pl.datatypes.classes.DataTypeClass, strict=True) -> Expr: ...
 
     # Compute the cube root of the elements.
     def cbrt(self, ) -> Expr: ...
@@ -285,10 +286,10 @@ class Expr:
     # Compute the element-wise value for the cotangent.
     def cot(self, ) -> Expr: ...
 
-    def count(self, ) -> 'Expr': ...
+    def count(self, ) -> Expr: ...
 
     # Return the cumulative count of the non-null values in the column.
-    def cum_count(self, reverse: bool=False) -> 'Expr': ...
+    def cum_count(self, reverse: bool=False) -> Expr: ...
 
     # Get an array with the cumulative max computed at every element.
     def cum_max(self, reverse: bool=False) -> Expr: ...
@@ -358,14 +359,14 @@ class Expr:
     # Extremely fast method for extending the Series with 'n' copies of a value.
     def extend_constant(self, value: IntoExpr, n: int | IntoExprColumn) -> Expr: ...
 
-    def fill_nan(self, value) -> 'Expr': ...
+    def fill_nan(self, value) -> Expr: ...
 
-    def fill_null(self, value) -> 'Expr': ...
+    def fill_null(self, value) -> Expr: ...
 
     # Filter expression
-    def filter(self, *predicates, **constraints) -> 'Expr': ...
+    def filter(self, *predicates, **constraints) -> Expr: ...
 
-    def first(self, ) -> 'Expr': ...
+    def first(self, ) -> Expr: ...
 
     # Flatten a list or string column.
     def flatten(self, ) -> Expr: ...
@@ -452,9 +453,9 @@ class Expr:
     # Returns a boolean Series indicating which values are not NaN.
     def is_not_nan(self, ) -> Expr: ...
 
-    def is_not_null(self, ) -> 'Expr': ...
+    def is_not_null(self, ) -> Expr: ...
 
-    def is_null(self, ) -> 'Expr': ...
+    def is_null(self, ) -> Expr: ...
 
     # Get mask of unique values.
     def is_unique(self, ) -> Expr: ...
@@ -462,7 +463,7 @@ class Expr:
     # Compute the kurtosis (Fisher or Pearson) of a dataset.
     def kurtosis(self, fisher: bool=True, bias: bool=True) -> Expr: ...
 
-    def last(self, ) -> 'Expr': ...
+    def last(self, ) -> Expr: ...
 
     # Method equivalent of "less than or equal" operator `expr <= other`.
     def le(self, other: Any) -> Expr: ...
@@ -494,13 +495,13 @@ class Expr:
     # Map a custom/user-defined function (UDF) to each element of a column.
     def map_elements(self, function: Callable[[Any], Any], return_dtype: PolarsDataType | None=None, skip_nulls: bool=True, pass_name: bool=False, strategy: MapElementsStrategy='thread_local', returns_scalar: bool=False) -> Expr: ...
 
-    def max(self, ) -> 'Expr': ...
+    def max(self, ) -> Expr: ...
 
-    def mean(self, ) -> 'Expr': ...
+    def mean(self, ) -> Expr: ...
 
     def median(self, ) -> Any: ...
 
-    def min(self, ) -> 'Expr': ...
+    def min(self, ) -> Expr: ...
 
     # Method equivalent of modulus operator `expr % other`.
     def mod(self, other: Any) -> Expr: ...
@@ -538,7 +539,7 @@ class Expr:
     def or_(self, *others) -> Expr: ...
 
     # Compute expressions over the given groups.
-    def over(self, partition_by: ExprStrOrList, *more_exprs, order_by: Optional[ExprStrOrList]=None, descending: bool=False, nulls_last: bool=False, mapping_strategy: Literal['group_to_rows', 'join', 'explode']='group_to_rows') -> 'Expr': ...
+    def over(self, partition_by: ExprStrOrList, *more_exprs, order_by: ExprStrOrList | None=None, descending: bool=False, nulls_last: bool=False, mapping_strategy: Literal[group_to_rows, join, explode]='group_to_rows') -> Expr: ...
 
     # Computes percentage change between values.
     def pct_change(self, n: int | IntoExprColumn=1) -> Expr: ...
@@ -699,7 +700,7 @@ class Expr:
     # Get a slice of this expression.
     def slice(self, offset: int | Expr, length: int | Expr | None=None) -> Expr: ...
 
-    def sort(self, descending=False, nulls_last=False) -> 'Expr': ...
+    def sort(self, descending=False, nulls_last=False) -> Expr: ...
 
     # Sort this column by the ordering of other columns.
     def sort_by(self, by: IntoExpr | Iterable[IntoExpr], *more_by, descending: bool | Sequence[bool]=False, nulls_last: bool | Sequence[bool]=False, multithreaded: bool=True, maintain_order: bool=False) -> Expr: ...
@@ -712,7 +713,7 @@ class Expr:
     # Method equivalent of subtraction operator `expr - other`.
     def sub(self, other: Any) -> Expr: ...
 
-    def sum(self, ) -> 'Expr': ...
+    def sum(self, ) -> Expr: ...
 
     # Get the last `n` rows.
     def tail(self, n: int | Expr=10) -> Expr: ...
@@ -755,59 +756,59 @@ class Expr:
     # Method equivalent of bitwise exclusive-or operator `expr ^ other`.
     def xor(self, other: Any) -> Expr: ...
 
-    def __pos__(self, *args, **kwargs) -> 'Expr': ...
+    def __pos__(self, *args, **kwargs) -> Expr: ...
 
-    def __rxor__(self, *args, **kwargs) -> 'Expr': ...
+    def __rxor__(self, *args, **kwargs) -> Expr: ...
 
-    def __sizeof__(self, *args, **kwargs) -> 'Expr': ...
+    def __sizeof__(self, *args, **kwargs) -> Expr: ...
 
-    def __init_subclass__(self, *args, **kwargs) -> 'Expr': ...
+    def __init_subclass__(self, *args, **kwargs) -> Expr: ...
 
-    def __new__(self, *args, **kwargs) -> 'Expr': ...
+    def __new__(self, *args, **kwargs) -> Expr: ...
 
-    def __reduce__(self, *args, **kwargs) -> 'Expr': ...
+    def __reduce__(self, *args, **kwargs) -> Expr: ...
 
-    def __setattr__(self, *args, **kwargs) -> 'Expr': ...
+    def __setattr__(self, *args, **kwargs) -> Expr: ...
 
-    def __subclasshook__(self, *args, **kwargs) -> 'Expr': ...
+    def __subclasshook__(self, *args, **kwargs) -> Expr: ...
 
-    def _skip_batch_predicate(self, *args, **kwargs) -> 'Expr': ...
+    def _skip_batch_predicate(self, *args, **kwargs) -> Expr: ...
 
-    def __getattribute__(self, *args, **kwargs) -> 'Expr': ...
+    def __getattribute__(self, *args, **kwargs) -> Expr: ...
 
-    def __class__(self, *args, **kwargs) -> 'Expr': ...
+    def __class__(self, *args, **kwargs) -> Expr: ...
 
-    def _from_pyexpr(self, *args, **kwargs) -> 'Expr': ...
+    def _from_pyexpr(self, *args, **kwargs) -> Expr: ...
 
-    def __bool__(self, *args, **kwargs) -> 'Expr': ...
+    def __bool__(self, *args, **kwargs) -> Expr: ...
 
-    def __setstate__(self, *args, **kwargs) -> 'Expr': ...
+    def __setstate__(self, *args, **kwargs) -> Expr: ...
 
-    def __format__(self, *args, **kwargs) -> 'Expr': ...
+    def __format__(self, *args, **kwargs) -> Expr: ...
 
-    def __getstate__(self, *args, **kwargs) -> 'Expr': ...
+    def __getstate__(self, *args, **kwargs) -> Expr: ...
 
-    def __array_ufunc__(self, *args, **kwargs) -> 'Expr': ...
+    def __array_ufunc__(self, *args, **kwargs) -> Expr: ...
 
-    def __xor__(self, *args, **kwargs) -> 'Expr': ...
+    def __xor__(self, *args, **kwargs) -> Expr: ...
 
-    def __reduce_ex__(self, *args, **kwargs) -> 'Expr': ...
+    def __reduce_ex__(self, *args, **kwargs) -> Expr: ...
 
-    def _repr_html_(self, *args, **kwargs) -> 'Expr': ...
+    def _repr_html_(self, *args, **kwargs) -> Expr: ...
 
-    def __dir__(self, *args, **kwargs) -> 'Expr': ...
+    def __dir__(self, *args, **kwargs) -> Expr: ...
 
-    def __abs__(self, *args, **kwargs) -> 'Expr': ...
+    def __abs__(self, *args, **kwargs) -> Expr: ...
 
-    def __ror__(self, *args, **kwargs) -> 'Expr': ...
+    def __ror__(self, *args, **kwargs) -> Expr: ...
 
-    def _map_batches_wrapper(self, *args, **kwargs) -> 'Expr': ...
+    def _map_batches_wrapper(self, *args, **kwargs) -> Expr: ...
 
-    def __rand__(self, *args, **kwargs) -> 'Expr': ...
+    def __rand__(self, *args, **kwargs) -> Expr: ...
 
-    def __str__(self, *args, **kwargs) -> 'Expr': ...
+    def __str__(self, *args, **kwargs) -> Expr: ...
 
-    def __delattr__(self, *args, **kwargs) -> 'Expr': ...
+    def __delattr__(self, *args, **kwargs) -> Expr: ...
 
 
 class Column(Expr):
@@ -820,37 +821,37 @@ class Column(Expr):
     __annotations__: Any
     __doc__: Any
 
-    def __add__(self, other) -> 'Column': ...
+    def __add__(self, other) -> Column: ...
 
-    def __and__(self, other) -> 'Expr': ...
+    def __and__(self, other) -> Expr: ...
 
-    def __eq__(self, other) -> 'Column': ...
+    def __eq__(self, other) -> Column: ...
 
-    def __floordiv__(self, other) -> 'Column': ...
+    def __floordiv__(self, other) -> Column: ...
 
-    def __ge__(self, other) -> 'Expr': ...
+    def __ge__(self, other) -> Expr: ...
 
-    def __gt__(self, other) -> 'Column': ...
+    def __gt__(self, other) -> Column: ...
 
-    def __init__(self, name: str, select_input: Optional[transform_schema.SelectInput]=None) -> Any: ...
+    def __init__(self, name: str, select_input: transform_schema.SelectInput | None=None) -> Any: ...
 
-    def __invert__(self, ) -> 'Expr': ...
+    def __invert__(self, ) -> Expr: ...
 
-    def __le__(self, other) -> 'Expr': ...
+    def __le__(self, other) -> Expr: ...
 
-    def __lt__(self, other) -> 'Column': ...
+    def __lt__(self, other) -> Column: ...
 
-    def __mod__(self, other) -> 'Column': ...
+    def __mod__(self, other) -> Column: ...
 
-    def __mul__(self, other) -> 'Column': ...
+    def __mul__(self, other) -> Column: ...
 
-    def __ne__(self, other) -> 'Column': ...
+    def __ne__(self, other) -> Column: ...
 
-    def __neg__(self, ) -> 'Expr': ...
+    def __neg__(self, ) -> Expr: ...
 
-    def __or__(self, other) -> 'Expr': ...
+    def __or__(self, other) -> Expr: ...
 
-    def __pow__(self, exponent) -> 'Column': ...
+    def __pow__(self, exponent) -> Column: ...
 
     def __radd__(self, other) -> Any: ...
 
@@ -868,15 +869,15 @@ class Column(Expr):
 
     def __rtruediv__(self, other) -> Any: ...
 
-    def __sub__(self, other) -> 'Column': ...
+    def __sub__(self, other) -> Column: ...
 
-    def __truediv__(self, other) -> 'Column': ...
+    def __truediv__(self, other) -> Column: ...
 
     # Creates a new Expr for binary operations.
-    def _create_binary_op_expr(self, op_symbol: str, other: Any, result_expr: Optional[pl.Expr]) -> 'Expr': ...
+    def _create_binary_op_expr(self, op_symbol: str, other: Any, result_expr: pl.Expr | None) -> Expr: ...
 
     # Creates a new Expr instance, appending method call to repr string.
-    def _create_next_expr(self, *args, method_name: str, result_expr: Optional[pl.Expr], convertable_to_code: bool=None, is_complex: bool, _function_sources: Optional[List[str]]=None, **kwargs) -> 'Expr': ...
+    def _create_next_expr(self, *args, method_name: str, result_expr: pl.Expr | None, convertable_to_code: bool=None, is_complex: bool, _function_sources: list[str] | None=None, **kwargs) -> Expr: ...
 
     # Helper to get appropriate string representation for an expression
     def _get_expr_repr(self, expr) -> Any: ...
@@ -891,7 +892,7 @@ class Column(Expr):
     def agg_groups(self, ) -> Expr: ...
 
     # Rename a column, returning a new Column instance.
-    def alias(self, new_name: str) -> 'Column': ...
+    def alias(self, new_name: str) -> Column: ...
 
     # Return whether all values in the column are `True`.
     def all(self, ignore_nulls: bool=True) -> Expr: ...
@@ -932,12 +933,12 @@ class Column(Expr):
     # Get the index of the minimal value.
     def arg_min(self, ) -> Expr: ...
 
-    def arg_sort(self, descending: bool=False, nulls_last: bool=False) -> 'Expr': ...
+    def arg_sort(self, descending: bool=False, nulls_last: bool=False) -> Expr: ...
 
     # Return indices where expression evaluates `True`.
     def arg_true(self, ) -> Expr: ...
 
-    def arg_unique(self, ) -> 'Expr': ...
+    def arg_unique(self, ) -> Expr: ...
 
     # Fill missing values with the next non-null value.
     def backward_fill(self, limit: int | None=None) -> Expr: ...
@@ -976,7 +977,7 @@ class Column(Expr):
     def bottom_k_by(self, by: IntoExpr | Iterable[IntoExpr], k: int | IntoExprColumn=5, reverse: bool | Sequence[bool]=False) -> Expr: ...
 
     # Change the data type of a column, returning a new Column instance.
-    def cast(self, dtype: Union[pl.DataType, str, pl.datatypes.classes.DataTypeClass], strict=True) -> 'Column': ...
+    def cast(self, dtype: pl.DataType | str | pl.datatypes.classes.DataTypeClass, strict=True) -> Column: ...
 
     # Compute the cube root of the elements.
     def cbrt(self, ) -> Expr: ...
@@ -996,10 +997,10 @@ class Column(Expr):
     # Compute the element-wise value for the cotangent.
     def cot(self, ) -> Expr: ...
 
-    def count(self, ) -> 'Column': ...
+    def count(self, ) -> Column: ...
 
     # Return the cumulative count of the non-null values in the column.
-    def cum_count(self, reverse: bool=False) -> 'Expr': ...
+    def cum_count(self, reverse: bool=False) -> Expr: ...
 
     # Get an array with the cumulative max computed at every element.
     def cum_max(self, reverse: bool=False) -> Expr: ...
@@ -1069,14 +1070,14 @@ class Column(Expr):
     # Extremely fast method for extending the Series with 'n' copies of a value.
     def extend_constant(self, value: IntoExpr, n: int | IntoExprColumn) -> Expr: ...
 
-    def fill_nan(self, value) -> 'Column': ...
+    def fill_nan(self, value) -> Column: ...
 
-    def fill_null(self, value) -> 'Column': ...
+    def fill_null(self, value) -> Column: ...
 
     # Filter expression
-    def filter(self, *predicates, **constraints) -> 'Expr': ...
+    def filter(self, *predicates, **constraints) -> Expr: ...
 
-    def first(self, ) -> 'Column': ...
+    def first(self, ) -> Column: ...
 
     # Flatten a list or string column.
     def flatten(self, ) -> Expr: ...
@@ -1163,9 +1164,9 @@ class Column(Expr):
     # Returns a boolean Series indicating which values are not NaN.
     def is_not_nan(self, ) -> Expr: ...
 
-    def is_not_null(self, ) -> 'Column': ...
+    def is_not_null(self, ) -> Column: ...
 
-    def is_null(self, ) -> 'Column': ...
+    def is_null(self, ) -> Column: ...
 
     # Get mask of unique values.
     def is_unique(self, ) -> Expr: ...
@@ -1173,7 +1174,7 @@ class Column(Expr):
     # Compute the kurtosis (Fisher or Pearson) of a dataset.
     def kurtosis(self, fisher: bool=True, bias: bool=True) -> Expr: ...
 
-    def last(self, ) -> 'Column': ...
+    def last(self, ) -> Column: ...
 
     # Method equivalent of "less than or equal" operator `expr <= other`.
     def le(self, other: Any) -> Expr: ...
@@ -1205,13 +1206,13 @@ class Column(Expr):
     # Map a custom/user-defined function (UDF) to each element of a column.
     def map_elements(self, function: Callable[[Any], Any], return_dtype: PolarsDataType | None=None, skip_nulls: bool=True, pass_name: bool=False, strategy: MapElementsStrategy='thread_local', returns_scalar: bool=False) -> Expr: ...
 
-    def max(self, ) -> 'Column': ...
+    def max(self, ) -> Column: ...
 
-    def mean(self, ) -> 'Column': ...
+    def mean(self, ) -> Column: ...
 
     def median(self, ) -> Any: ...
 
-    def min(self, ) -> 'Column': ...
+    def min(self, ) -> Column: ...
 
     # Method equivalent of modulus operator `expr % other`.
     def mod(self, other: Any) -> Expr: ...
@@ -1249,7 +1250,7 @@ class Column(Expr):
     def or_(self, *others) -> Expr: ...
 
     # Compute expressions over the given groups.
-    def over(self, partition_by: ExprStrOrList, *more_exprs, order_by: Optional[ExprStrOrList]=None, descending: bool=False, nulls_last: bool=False, mapping_strategy: Literal['group_to_rows', 'join', 'explode']='group_to_rows') -> 'Expr': ...
+    def over(self, partition_by: ExprStrOrList, *more_exprs, order_by: ExprStrOrList | None=None, descending: bool=False, nulls_last: bool=False, mapping_strategy: Literal[group_to_rows, join, explode]='group_to_rows') -> Expr: ...
 
     # Computes percentage change between values.
     def pct_change(self, n: int | IntoExprColumn=1) -> Expr: ...
@@ -1410,7 +1411,7 @@ class Column(Expr):
     # Get a slice of this expression.
     def slice(self, offset: int | Expr, length: int | Expr | None=None) -> Expr: ...
 
-    def sort(self, descending=False, nulls_last=False) -> 'Column': ...
+    def sort(self, descending=False, nulls_last=False) -> Column: ...
 
     # Sort this column by the ordering of other columns.
     def sort_by(self, by: IntoExpr | Iterable[IntoExpr], *more_by, descending: bool | Sequence[bool]=False, nulls_last: bool | Sequence[bool]=False, multithreaded: bool=True, maintain_order: bool=False) -> Expr: ...
@@ -1423,7 +1424,7 @@ class Column(Expr):
     # Method equivalent of subtraction operator `expr - other`.
     def sub(self, other: Any) -> Expr: ...
 
-    def sum(self, ) -> 'Column': ...
+    def sum(self, ) -> Column: ...
 
     # Get the last `n` rows.
     def tail(self, n: int | Expr=10) -> Expr: ...
@@ -1480,38 +1481,38 @@ class When(Expr):
     __doc__: Any
     __annotations__: Any
 
-    def __add__(self, other) -> 'When': ...
+    def __add__(self, other) -> When: ...
 
-    def __and__(self, other) -> 'Expr': ...
+    def __and__(self, other) -> Expr: ...
 
-    def __eq__(self, other) -> 'When': ...
+    def __eq__(self, other) -> When: ...
 
-    def __floordiv__(self, other) -> 'When': ...
+    def __floordiv__(self, other) -> When: ...
 
-    def __ge__(self, other) -> 'Expr': ...
+    def __ge__(self, other) -> Expr: ...
 
-    def __gt__(self, other) -> 'When': ...
+    def __gt__(self, other) -> When: ...
 
     # Initialize a When expression with a condition.
     def __init__(self, condition) -> Any: ...
 
-    def __invert__(self, ) -> 'Expr': ...
+    def __invert__(self, ) -> Expr: ...
 
-    def __le__(self, other) -> 'Expr': ...
+    def __le__(self, other) -> Expr: ...
 
-    def __lt__(self, other) -> 'When': ...
+    def __lt__(self, other) -> When: ...
 
-    def __mod__(self, other) -> 'When': ...
+    def __mod__(self, other) -> When: ...
 
-    def __mul__(self, other) -> 'When': ...
+    def __mul__(self, other) -> When: ...
 
-    def __ne__(self, other) -> 'When': ...
+    def __ne__(self, other) -> When: ...
 
-    def __neg__(self, ) -> 'Expr': ...
+    def __neg__(self, ) -> Expr: ...
 
-    def __or__(self, other) -> 'Expr': ...
+    def __or__(self, other) -> Expr: ...
 
-    def __pow__(self, exponent) -> 'When': ...
+    def __pow__(self, exponent) -> When: ...
 
     def __radd__(self, other) -> Any: ...
 
@@ -1529,15 +1530,15 @@ class When(Expr):
 
     def __rtruediv__(self, other) -> Any: ...
 
-    def __sub__(self, other) -> 'When': ...
+    def __sub__(self, other) -> When: ...
 
-    def __truediv__(self, other) -> 'When': ...
+    def __truediv__(self, other) -> When: ...
 
     # Creates a new Expr for binary operations.
-    def _create_binary_op_expr(self, op_symbol: str, other: Any, result_expr: Optional[pl.Expr]) -> 'Expr': ...
+    def _create_binary_op_expr(self, op_symbol: str, other: Any, result_expr: pl.Expr | None) -> Expr: ...
 
     # Creates a new Expr instance, appending method call to repr string.
-    def _create_next_expr(self, *args, method_name: str, result_expr: Optional[pl.Expr], convertable_to_code: bool=None, is_complex: bool, _function_sources: Optional[List[str]]=None, **kwargs) -> 'Expr': ...
+    def _create_next_expr(self, *args, method_name: str, result_expr: pl.Expr | None, convertable_to_code: bool=None, is_complex: bool, _function_sources: list[str] | None=None, **kwargs) -> Expr: ...
 
     # Extract expression and representation from a value.
     def _get_expr_and_repr(self, value) -> Any: ...
@@ -1555,7 +1556,7 @@ class When(Expr):
     def agg_groups(self, ) -> Expr: ...
 
     # Rename the expression result.
-    def alias(self, name) -> 'When': ...
+    def alias(self, name) -> When: ...
 
     # Return whether all values in the column are `True`.
     def all(self, ignore_nulls: bool=True) -> Expr: ...
@@ -1596,12 +1597,12 @@ class When(Expr):
     # Get the index of the minimal value.
     def arg_min(self, ) -> Expr: ...
 
-    def arg_sort(self, descending: bool=False, nulls_last: bool=False) -> 'Expr': ...
+    def arg_sort(self, descending: bool=False, nulls_last: bool=False) -> Expr: ...
 
     # Return indices where expression evaluates `True`.
     def arg_true(self, ) -> Expr: ...
 
-    def arg_unique(self, ) -> 'Expr': ...
+    def arg_unique(self, ) -> Expr: ...
 
     # Fill missing values with the next non-null value.
     def backward_fill(self, limit: int | None=None) -> Expr: ...
@@ -1640,7 +1641,7 @@ class When(Expr):
     def bottom_k_by(self, by: IntoExpr | Iterable[IntoExpr], k: int | IntoExprColumn=5, reverse: bool | Sequence[bool]=False) -> Expr: ...
 
     # Casts the Expr to a specified data type.
-    def cast(self, dtype: Union[pl.DataType, str, pl.datatypes.classes.DataTypeClass], strict=True) -> 'When': ...
+    def cast(self, dtype: pl.DataType | str | pl.datatypes.classes.DataTypeClass, strict=True) -> When: ...
 
     # Compute the cube root of the elements.
     def cbrt(self, ) -> Expr: ...
@@ -1660,10 +1661,10 @@ class When(Expr):
     # Compute the element-wise value for the cotangent.
     def cot(self, ) -> Expr: ...
 
-    def count(self, ) -> 'When': ...
+    def count(self, ) -> When: ...
 
     # Return the cumulative count of the non-null values in the column.
-    def cum_count(self, reverse: bool=False) -> 'Expr': ...
+    def cum_count(self, reverse: bool=False) -> Expr: ...
 
     # Get an array with the cumulative max computed at every element.
     def cum_max(self, reverse: bool=False) -> Expr: ...
@@ -1733,14 +1734,14 @@ class When(Expr):
     # Extremely fast method for extending the Series with 'n' copies of a value.
     def extend_constant(self, value: IntoExpr, n: int | IntoExprColumn) -> Expr: ...
 
-    def fill_nan(self, value) -> 'When': ...
+    def fill_nan(self, value) -> When: ...
 
-    def fill_null(self, value) -> 'When': ...
+    def fill_null(self, value) -> When: ...
 
     # Filter expression
-    def filter(self, *predicates, **constraints) -> 'Expr': ...
+    def filter(self, *predicates, **constraints) -> Expr: ...
 
-    def first(self, ) -> 'When': ...
+    def first(self, ) -> When: ...
 
     # Flatten a list or string column.
     def flatten(self, ) -> Expr: ...
@@ -1827,9 +1828,9 @@ class When(Expr):
     # Returns a boolean Series indicating which values are not NaN.
     def is_not_nan(self, ) -> Expr: ...
 
-    def is_not_null(self, ) -> 'When': ...
+    def is_not_null(self, ) -> When: ...
 
-    def is_null(self, ) -> 'When': ...
+    def is_null(self, ) -> When: ...
 
     # Get mask of unique values.
     def is_unique(self, ) -> Expr: ...
@@ -1837,7 +1838,7 @@ class When(Expr):
     # Compute the kurtosis (Fisher or Pearson) of a dataset.
     def kurtosis(self, fisher: bool=True, bias: bool=True) -> Expr: ...
 
-    def last(self, ) -> 'When': ...
+    def last(self, ) -> When: ...
 
     # Method equivalent of "less than or equal" operator `expr <= other`.
     def le(self, other: Any) -> Expr: ...
@@ -1869,13 +1870,13 @@ class When(Expr):
     # Map a custom/user-defined function (UDF) to each element of a column.
     def map_elements(self, function: Callable[[Any], Any], return_dtype: PolarsDataType | None=None, skip_nulls: bool=True, pass_name: bool=False, strategy: MapElementsStrategy='thread_local', returns_scalar: bool=False) -> Expr: ...
 
-    def max(self, ) -> 'When': ...
+    def max(self, ) -> When: ...
 
-    def mean(self, ) -> 'When': ...
+    def mean(self, ) -> When: ...
 
     def median(self, ) -> Any: ...
 
-    def min(self, ) -> 'When': ...
+    def min(self, ) -> When: ...
 
     # Method equivalent of modulus operator `expr % other`.
     def mod(self, other: Any) -> Expr: ...
@@ -1916,7 +1917,7 @@ class When(Expr):
     def otherwise(self, value) -> Any: ...
 
     # Compute expressions over the given groups.
-    def over(self, partition_by: ExprStrOrList, *more_exprs, order_by: Optional[ExprStrOrList]=None, descending: bool=False, nulls_last: bool=False, mapping_strategy: Literal['group_to_rows', 'join', 'explode']='group_to_rows') -> 'Expr': ...
+    def over(self, partition_by: ExprStrOrList, *more_exprs, order_by: ExprStrOrList | None=None, descending: bool=False, nulls_last: bool=False, mapping_strategy: Literal[group_to_rows, join, explode]='group_to_rows') -> Expr: ...
 
     # Computes percentage change between values.
     def pct_change(self, n: int | IntoExprColumn=1) -> Expr: ...
@@ -2077,7 +2078,7 @@ class When(Expr):
     # Get a slice of this expression.
     def slice(self, offset: int | Expr, length: int | Expr | None=None) -> Expr: ...
 
-    def sort(self, descending=False, nulls_last=False) -> 'When': ...
+    def sort(self, descending=False, nulls_last=False) -> When: ...
 
     # Sort this column by the ordering of other columns.
     def sort_by(self, by: IntoExpr | Iterable[IntoExpr], *more_by, descending: bool | Sequence[bool]=False, nulls_last: bool | Sequence[bool]=False, multithreaded: bool=True, maintain_order: bool=False) -> Expr: ...
@@ -2090,7 +2091,7 @@ class When(Expr):
     # Method equivalent of subtraction operator `expr - other`.
     def sub(self, other: Any) -> Expr: ...
 
-    def sum(self, ) -> 'When': ...
+    def sum(self, ) -> When: ...
 
     # Get the last `n` rows.
     def tail(self, n: int | Expr=10) -> Expr: ...
@@ -2150,12 +2151,12 @@ def col(name: str) -> Column: ...
 def column(name: str) -> Column: ...
 
 # Compute the correlation between two columns.
-def corr(a: Union[str, Expr], b: Union[str, Expr], method: str='pearson', ddof: int=None, propagate_nans: bool=False) -> Expr: ...
+def corr(a: str | Expr, b: str | Expr, method: str='pearson', ddof: int=None, propagate_nans: bool=False) -> Expr: ...
 
 def count(*names) -> Expr: ...
 
 # Compute the covariance between two columns.
-def cov(a: Union[str, Expr], b: Union[str, Expr], ddof: int=1) -> Expr: ...
+def cov(a: str | Expr, b: str | Expr, ddof: int=1) -> Expr: ...
 
 # Return the cumulative count of the non-null values in the column.
 def cum_count(expr, reverse: bool=False) -> Expr: ...