o @g@s|ddlmZddlmZddlmZddlmZddlmZer,ddlmZddl m Z edd d Z Gd d d ee Z d S)) annotations) TYPE_CHECKING)Callable)Generic)TypeVar)Self)ExprExprTr)boundc@sReZdZdddZdd d Zdd dZdddZdddZdddZdddZ dS) ExprNameNamespaceselfrexprr returnNonecCs ||_dSN)_expr)r r rY/var/www/html/development/chatbot/venv/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_exprnamekeepplxr rr(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#r rrrDz'ExprNameNamespace.map..r)r r#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*r rrr_r)z*ExprNameNamespace.prefix..r)r r*rr,rr*H 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.rr r.rrrzr)z*ExprNameNamespace.suffix..rr/rr/rr.cr-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..rrrrrr0~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..rrrrrr1r"zExprNameNamespace.to_uppercaseN)r rr r rr)r rrr )r rr#r$rr )r rr*r+rr )r rr.r+rr ) __name__ __module__ __qualname__rrr'r*r.r0r1rrrrr s      r N) __future__rtypingrrrrtyping_extensionsr narwhals.exprrr r rrrrs