o $&]i@shddlmZddlmZmZmZmZddlmZm Z er"ddl m Z edddZ Gdd d ee Z d S) ) annotations) TYPE_CHECKINGCallableGenericTypeVar)ExprKindExprNode)ExprExprTr )boundc@sReZdZdddZdddZdd d ZdddZdddZdddZdddZ dS)ExprNameNamespaceexprr returnNonecCs ||_dS)N)_expr)selfr rP/var/www/html/IGF-ODF-V3/venv/lib/python3.10/site-packages/narwhals/expr_name.py__init__s zExprNameNamespace.__init__cC|jttjdS)aKeep the original root name of the expression. Notes: For Polars versions prior to 1.32, this will undo any previous renaming operations on the expression. 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'] z name.keepr _append_noderr ELEMENTWISErrrrkeepszExprNameNamespace.keepfunctionCallable[[str], str]cC|jttjd|dS)aRename 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. Notes: For Polars versions prior to 1.32, this will undo any previous renaming operations on the expression. 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'] zname.map)rr)rrrrrmap!szExprNameNamespace.mapprefixstrcCr)ajAdd a prefix to the root column name of the expression. Arguments: prefix: Prefix to add to the root column name. Notes: For Polars versions prior to 1.32, this will undo any previous renaming operations on the expression. 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'] z name.prefix)rr)rrrrrr7zExprNameNamespace.prefixsuffixcCr)amAdd a suffix to the root column name of the expression. Arguments: suffix: Suffix to add to the root column name. Notes: For Polars versions prior to 1.32, this will undo any previous renaming operations on the expression. 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'] z name.suffix)r"r)rr"rrrr"Lr!zExprNameNamespace.suffixcCr)aMake the root column name lowercase. Notes: For Polars versions prior to 1.32, this will undo any previous renaming operations on the expression. 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'] zname.to_lowercaserrrrr to_lowercasea zExprNameNamespace.to_lowercasecCr)aMake the root column name uppercase. Notes: For Polars versions prior to 1.32, this will undo any previous renaming operations on the expression. 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'] zname.to_uppercaserrrrr to_uppercasesr$zExprNameNamespace.to_uppercaseN)r r rr)rr )rrrr )rr rr )r"r rr ) __name__ __module__ __qualname__rrrrr"r#r%rrrrr s      r N) __future__rtypingrrrrnarwhals._expression_parsingrr narwhals.exprr r r rrrrs