zhBddlmZddlmZddlmZddlmZddlmZerddlmZedd Z Gd d ee Z y ) ) annotations) TYPE_CHECKING)Callable)Generic)TypeVar)ExprExprTr)boundcDeZdZd dZd dZd dZd dZd dZd dZd dZ y)ExprNameNamespacec||_yN)_expr)selfexprs P/var/www/skyplay_api_hub/venv/lib/python3.12/site-packages/narwhals/expr_name.py__init__zExprNameNamespace.__init__s  cjjjfdjjS)aKeep the original root name of the expression. Returns: A new expression. Notes: This will undo any previous renaming operations on the expression. Due to implementation constraints, this method can only be called as the last expression in a chain. Only one name operation per expression will work. Examples: >>> import pandas as pd >>> import narwhals as nw >>> df_native = pd.DataFrame({"foo": [1, 2], "BAR": [4, 5]}) >>> df = nw.from_native(df_native) >>> df.select(nw.col("foo").alias("alias_for_foo").name.keep()).columns ['foo'] cjjj|jjSr)r_to_compliant_exprnamekeepplxrs rz(ExprNameNamespace.keep..&s% 55c:??DDFrr __class__ _metadatars`rrzExprNameNamespace.keeps,&zz## F JJ   rcnjjfdjjS)atRename the output of an expression by mapping a function over the root name. Arguments: function: Function that maps a root name to a new name. Returns: A new expression. Notes: This will undo any previous renaming operations on the expression. Due to implementation constraints, this method can only be called as the last expression in a chain. Only one name operation per expression will work. Examples: >>> import pandas as pd >>> import narwhals as nw >>> df_native = pd.DataFrame({"foo": [1, 2], "BAR": [4, 5]}) >>> df = nw.from_native(df_native) >>> renaming_func = lambda s: s[::-1] # reverse column name >>> df.select(nw.col("foo", "BAR").name.map(renaming_func)).columns ['oof', 'RAB'] cljj|jjSr)rrrmap)rfunctionrs rrz'ExprNameNamespace.map..Bs' 55c:??CCHMrr)rr$s``rr#zExprNameNamespace.map*s,.zz## M JJ   rcnjjfdjjS)a&Add a prefix to the root column name of the expression. Arguments: prefix: Prefix to add to the root column name. Returns: A new expression. Notes: This will undo any previous renaming operations on the expression. Due to implementation constraints, this method can only be called as the last expression in a chain. Only one name operation per expression will work. Examples: >>> import polars as pl >>> import narwhals as nw >>> df_native = pl.DataFrame({"foo": [1, 2], "BAR": [4, 5]}) >>> df = nw.from_native(df_native) >>> df.select(nw.col("foo", "BAR").name.prefix("with_prefix")).columns ['with_prefixfoo', 'with_prefixBAR'] cljj|jjSr)rrrprefix)rr'rs rrz*ExprNameNamespace.prefix..]' 55c:??FFvNrr)rr's``rr'zExprNameNamespace.prefixF,,zz## N JJ   rcnjjfdjjS)a)Add a suffix to the root column name of the expression. Arguments: suffix: Suffix to add to the root column name. Returns: A new expression. Notes: This will undo any previous renaming operations on the expression. Due to implementation constraints, this method can only be called as the last expression in a chain. Only one name operation per expression will work. Examples: >>> import polars as pl >>> import narwhals as nw >>> df_native = pl.DataFrame({"foo": [1, 2], "BAR": [4, 5]}) >>> df = nw.from_native(df_native) >>> df.select(nw.col("foo", "BAR").name.suffix("_with_suffix")).columns ['foo_with_suffix', 'BAR_with_suffix'] cljj|jjSr)rrrsuffix)rrr,s rrz*ExprNameNamespace.suffix..xr(rr)rr,s``rr,zExprNameNamespace.suffixar)rcjjjfdjjS)aMake the root column name lowercase. Returns: A new expression. Notes: This will undo any previous renaming operations on the expression. Due to implementation constraints, this method can only be called as the last expression in a chain. Only one name operation per expression will work. Examples: >>> import pyarrow as pa >>> import narwhals as nw >>> df_native = pa.table({"foo": [1, 2], "BAR": [4, 5]}) >>> df = nw.from_native(df_native) >>> df.select(nw.col("foo", "BAR").name.to_lowercase()).columns ['foo', 'bar'] cjjj|jjSr)rrr to_lowercasers rrz0ExprNameNamespace.to_lowercase..% 55c:??LLNrrr s`rr/zExprNameNamespace.to_lowercase|,&zz## N JJ   rcjjjfdjjS)aMake the root column name uppercase. Returns: A new expression. Notes: This will undo any previous renaming operations on the expression. Due to implementation constraints, this method can only be called as the last expression in a chain. Only one name operation per expression will work. Examples: >>> import pyarrow as pa >>> import narwhals as nw >>> df_native = pa.table({"foo": [1, 2], "BAR": [4, 5]}) >>> df = nw.from_native(df_native) >>> df.select(nw.col("foo", "BAR").name.to_uppercase()).columns ['FOO', 'BAR'] cjjj|jjSr)rrr to_uppercasers rrz0ExprNameNamespace.to_uppercase..r0rrr s`rr4zExprNameNamespace.to_uppercaser1rN)rr returnNone)r5r )r$zCallable[[str], str]r5r )r'strr5r )r,r7r5r ) __name__ __module__ __qualname__rrr#r'r,r/r4rrr r s% 0 8 6 6 0 rr N) __future__rtypingrrrr narwhals.exprrr r r;rrr?s8" "v&\ \ r