o h@sddlmZGdddeZGdddeZGdddeeZGdd d eZGd d d eZGd d d eZ GdddeZ GdddeZ Gddde eZ GdddeZGdddeZGdddeZGdddeZGdddeZdS)) annotationsc@eZdZdZdS) NarwhalsErrorz'Base class for all Narwhals exceptions.N__name__ __module__ __qualname____doc__r r G/var/www/vscode/kcb/lib/python3.10/site-packages/narwhals/exceptions.pyrrc@s$eZdZdZd ddZd dd Zd S) FormattedKeyErrora7KeyError with formatted error message. Python's `KeyError` has special casing around formatting (see https://bugs.python.org/issue2651). Use this class when the error message has newlines and other special format characters. Needed by https://github.com/tensorflow/tensorflow/issues/36857. messagestrreturnNonecCs ||_dSNrselfrr r r __init__s zFormattedKeyError.__init__cCs|jSrr)rr r r __str__szFormattedKeyError.__str__Nrrrr)rr)rrrr rrr r r r r s r cs0eZdZdZdfdd Zedd dZZS)ColumnNotFoundErrorz0Exception raised when column name isn't present.rrrrc||_t|jdSrrsuperrr __class__r r rzColumnNotFoundError.__init__clstypemissing_columns list[str]available_columnscCsd|d|d}t|S)Nz&The following columns were not found: z+ Hint: Did you mean one of these columns: ?)r)r r"r$rr r r 'from_missing_and_available_column_namess z;ColumnNotFoundError.from_missing_and_available_column_namesr)r r!r"r#r$r#rr)rrrr r classmethodr& __classcell__r r rr r rc@r) ComputeErrorzHException raised when the underlying computation could not be evaluated.Nrr r r r r**r r*c@r) ShapeErrorz_Exception raised when trying to perform operations on data structures with incompatible shapes.Nrr r r r r+.r r+c@r)MultiOutputExpressionErrorzKException raised when using multi-output expression in unsupported context.Nrr r r r r,2r r,c@r)DuplicateErrorz6Exception when duplicate column names are encountered.Nrr r r r r-6r r-c@r)InvalidOperationErrorz+Exception raised during invalid operations.Nrr r r r r.:r r.c0eZdZdZd fdd Zedd d ZZS)InvalidIntoExprErrorz>Exception raised when object can't be converted to expression.rrrrcrrrrrr r rArzInvalidIntoExprError.__init__r r! invalid_typecCd|d}t|S)NzBExpected an object which can be converted into an expression, got a Hint: - if you were trying to select a column which does not have a string column name, then you should explicitly use `nw.col`. For example, `df.select(nw.col(0))` if you have a column named `0`. - if you were trying to create a new literal column, then you should explicitly use `nw.lit`. For example, `df.select(nw.lit(0))` if you want to create a new column with literal value `0`.)r0)r r1rr r r from_invalid_typeEs  z&InvalidIntoExprError.from_invalid_typer)r r!r1r!rr0)rrrr rr'r3r(r r rr r0>r)r0cr/)AnonymousExprErrorzLException raised when trying to perform operations on anonymous expressions.rrrrcrrrrrr r rXrzAnonymousExprError.__init__r r! expr_namecCr2)Nz,Anonymous expressions are not supported in `zR`. Instead of `nw.all()`, try using a named expression, such as `nw.col('a', 'b')`)r4)r r5rr r r from_expr_name\s z!AnonymousExprError.from_expr_namer)r r!r5rrr4)rrrr rr'r6r(r r rr r4Ur)r4c"eZdZdZdfdd ZZS) OrderDependentExprErrorzSException raised when trying to use an order-dependent expressions with LazyFrames.rrrrcrrrrrr r rirz OrderDependentExprError.__init__rrrrr rr(r r rr r8fr8cr7) LengthChangingExprErrorzWException raised when trying to use an expression which changes length with LazyFrames.rrrrcrrrrrr r rqrz LengthChangingExprError.__init__rr9r r rr r;nr:r;c@r)UnsupportedDTypeErrorz_Exception raised when trying to convert to a DType which is not supported by the given backend.Nrr r r r r<vr r<c@r)NarwhalsUnstableWarningzRWarning issued when a method or function is considered unstable in the stable api.Nrr r r r r=zr r=N) __future__r ValueErrorrKeyErrorr rr*r+r,r-r. TypeErrorr0r4r8r;r< UserWarningr=r r r r s