o hB@spddlmZddlmZddlmZddlmZddlmZer&ddlmZeddd Z Gd d d ee Z d S) ) annotations) TYPE_CHECKING)Callable)Generic)TypeVar)ExprExprTr)boundc@sReZdZdddZdddZdd d ZdddZdddZdddZdddZ dS)ExprNameNamespaceexprrreturnNonecCs ||_dSN)_expr)selfr rF/var/www/vscode/kcb/lib/python3.10/site-packages/narwhals/expr_name.py__init__s zExprNameNamespace.__init__cjfddjjS)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'] cj|jSr)r_to_compliant_exprnamekeepplxrrr&z(ExprNameNamespace.keep..r __class__ _metadatarrrrr zExprNameNamespace.keepfunctionCallable[[str], str]cjfddjjS)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'] cj|jSr)rrrmaprr"rrrrBz'ExprNameNamespace.map..r)rr"rr'rr&*s zExprNameNamespace.mapprefixstrcr$)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'] cr%r)rrrr)rr)rrrr]r(z*ExprNameNamespace.prefix..r)rr)rr+rr)F zExprNameNamespace.prefixsuffixcsjfddjjS)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'] csj|jSr)rrrr-rrr-rrrxr(z*ExprNameNamespace.suffix..rr.rr.rr-ar,zExprNameNamespace.suffixcr)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'] crr)rrr to_lowercaserrrrrrz0ExprNameNamespace.to_lowercase..rrrrrr/|r!zExprNameNamespace.to_lowercasecr)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'] crr)rrr to_uppercaserrrrrrz0ExprNameNamespace.to_uppercase..rrrrrr0r!zExprNameNamespace.to_uppercaseN)r rr r )r r)r"r#r r)r)r*r r)r-r*r r) __name__ __module__ __qualname__rrr&r)r-r/r0rrrrr s      r N) __future__rtypingrrrr narwhals.exprrrr rrrrs