ง q-Phึ/ใ๓L—ddlmZddlmZmZerddlmZGd„dฆซZdS)้)ฺ annotations)ฺ TYPE_CHECKINGฺCallable)ฺExprc๓f—eZdZdZdZdd„Zdd„Zdd „Zdd„Zdd„Z dd„Z dd„Z dd„Z dd„Z dd„ZdS)ฺExprNameNameSpacez;Namespace for expressions that operate on expression names.ฺnameฺexprrฺreturnฺNonec๓6—|j|_|j|_dS)N)ฺ _from_pyexprฺ_pyexpr)ฺselfr s ๚P/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/polars/expr/name.pyฺ__init__zExprNameNameSpace.__init__s€ุ ิ-ˆิุ”|ˆŒ ˆ ˆ ๓c๓Z—| |j ฆซฆซS)u Keep the original root name of the 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. Consider using `.name.map` for advanced renaming. See Also -------- Expr.alias map Examples -------- Prevent errors due to potential duplicate column names. >>> df = pl.DataFrame( ... { ... "a": [1, 2], ... "b": [3, 4], ... } ... ) >>> df.select((pl.lit(10) / pl.all()).name.keep()) shape: (2, 2) โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ a โ”† b โ”‚ โ”‚ --- โ”† --- โ”‚ โ”‚ f64 โ”† f64 โ”‚ โ•žโ•โ•โ•โ•โ•โ•โ•ชโ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•ก โ”‚ 10.0 โ”† 3.333333 โ”‚ โ”‚ 5.0 โ”† 2.5 โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ Undo an alias operation. >>> df.with_columns((pl.col("a") * 9).alias("c").name.keep()) shape: (2, 2) โ”Œโ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ” โ”‚ a โ”† b โ”‚ โ”‚ --- โ”† --- โ”‚ โ”‚ i64 โ”† i64 โ”‚ โ•žโ•โ•โ•โ•โ•โ•ชโ•โ•โ•โ•โ•โ•ก โ”‚ 9 โ”† 3 โ”‚ โ”‚ 18 โ”† 4 โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”˜ )rrฺ name_keepฉrs rฺkeepzExprNameNameSpace.keeps'€๐fื า  คื!7า!7ั!9ิ!9ั:ิ:ะ:rฺfunction๚Callable[[str], str]c๓\—| |j |ฆซฆซS)uฑ Rename the output of an expression by mapping a function over the root name. 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. Parameters ---------- function Function that maps a root name to a new name. See Also -------- keep prefix suffix Examples -------- Remove a common suffix and convert to lower case. >>> df = pl.DataFrame( ... { ... "A_reverse": [3, 2, 1], ... "B_reverse": ["z", "y", "x"], ... } ... ) >>> df.with_columns( ... pl.all() ... .reverse() ... .name.map(lambda c: c.removesuffix("_reverse").lower()) ... ) shape: (3, 4) โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ” โ”‚ A_reverse โ”† B_reverse โ”† a โ”† b โ”‚ โ”‚ --- โ”† --- โ”† --- โ”† --- โ”‚ โ”‚ i64 โ”† str โ”† i64 โ”† str โ”‚ โ•žโ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•ชโ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•ชโ•โ•โ•โ•โ•โ•ชโ•โ•โ•โ•โ•โ•ก โ”‚ 3 โ”† z โ”† 1 โ”† x โ”‚ โ”‚ 2 โ”† y โ”† 2 โ”† y โ”‚ โ”‚ 1 โ”† x โ”† 3 โ”† z โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”˜ )rrฺname_mapฉrrs rฺmapzExprNameNameSpace.mapGs)€๐bื า  คื!6า!6ฐxั!@ิ!@ัAิAะArฺprefixฺstrc๓\—| |j |ฆซฆซS)u Add a prefix to the root column name of the expression. Parameters ---------- prefix Prefix to add to the root column name. 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. Consider using `.name.map` for advanced renaming. See Also -------- suffix Examples -------- >>> df = pl.DataFrame( ... { ... "a": [1, 2, 3], ... "b": ["x", "y", "z"], ... } ... ) >>> df.with_columns(pl.all().reverse().name.prefix("reverse_")) shape: (3, 4) โ”Œโ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ a โ”† b โ”† reverse_a โ”† reverse_b โ”‚ โ”‚ --- โ”† --- โ”† --- โ”† --- โ”‚ โ”‚ i64 โ”† str โ”† i64 โ”† str โ”‚ โ•žโ•โ•โ•โ•โ•โ•ชโ•โ•โ•โ•โ•โ•ชโ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•ชโ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•ก โ”‚ 1 โ”† x โ”† 3 โ”† z โ”‚ โ”‚ 2 โ”† y โ”† 2 โ”† y โ”‚ โ”‚ 3 โ”† z โ”† 1 โ”† x โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ )rrฺ name_prefixฉrrs rrzExprNameNameSpace.prefixzs)€๐Tื า  คื!9า!9ธ&ั!Aิ!AัBิBะBrฺsuffixc๓\—| |j |ฆซฆซS)u Add a suffix to the root column name of the expression. Parameters ---------- suffix Suffix to add to the root column name. 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. Consider using `.name.map` for advanced renaming. See Also -------- prefix Examples -------- >>> df = pl.DataFrame( ... { ... "a": [1, 2, 3], ... "b": ["x", "y", "z"], ... } ... ) >>> df.with_columns(pl.all().reverse().name.suffix("_reverse")) shape: (3, 4) โ”Œโ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ a โ”† b โ”† a_reverse โ”† b_reverse โ”‚ โ”‚ --- โ”† --- โ”† --- โ”† --- โ”‚ โ”‚ i64 โ”† str โ”† i64 โ”† str โ”‚ โ•žโ•โ•โ•โ•โ•โ•ชโ•โ•โ•โ•โ•โ•ชโ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•ชโ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•ก โ”‚ 1 โ”† x โ”† 3 โ”† z โ”‚ โ”‚ 2 โ”† y โ”† 2 โ”† y โ”‚ โ”‚ 3 โ”† z โ”† 1 โ”† x โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ )rrฺ name_suffixฉrr#s rr#zExprNameNameSpace.suffixฆs)€๐Rื า  คื!9า!9ธ&ั!Aิ!AัBิBะBrc๓Z—| |j ฆซฆซS)u. Make the root column name lowercase. 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. Consider using `.name.map` for advanced renaming. See Also -------- prefix suffix to_uppercase Examples -------- >>> df = pl.DataFrame( ... { ... "ColX": [1, 2, 3], ... "ColY": ["x", "y", "z"], ... } ... ) >>> df.with_columns(pl.all().name.to_lowercase()) shape: (3, 4) โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ ColX โ”† ColY โ”† colx โ”† coly โ”‚ โ”‚ --- โ”† --- โ”† --- โ”† --- โ”‚ โ”‚ i64 โ”† str โ”† i64 โ”† str โ”‚ โ•žโ•โ•โ•โ•โ•โ•โ•ชโ•โ•โ•โ•โ•โ•โ•ชโ•โ•โ•โ•โ•โ•โ•ชโ•โ•โ•โ•โ•โ•โ•ก โ”‚ 1 โ”† x โ”† 1 โ”† x โ”‚ โ”‚ 2 โ”† y โ”† 2 โ”† y โ”‚ โ”‚ 3 โ”† z โ”† 3 โ”† z โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”˜ )rrฺname_to_lowercasers rฺ to_lowercasezExprNameNameSpace.to_lowercaseั๓'€๐Lื า  คื!?า!?ั!Aิ!AัBิBะBrc๓Z—| |j ฆซฆซS)u. Make the root column name uppercase. 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. Consider using `.name.map` for advanced renaming. See Also -------- prefix suffix to_lowercase Examples -------- >>> df = pl.DataFrame( ... { ... "ColX": [1, 2, 3], ... "ColY": ["x", "y", "z"], ... } ... ) >>> df.with_columns(pl.all().name.to_uppercase()) shape: (3, 4) โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ ColX โ”† ColY โ”† COLX โ”† COLY โ”‚ โ”‚ --- โ”† --- โ”† --- โ”† --- โ”‚ โ”‚ i64 โ”† str โ”† i64 โ”† str โ”‚ โ•žโ•โ•โ•โ•โ•โ•โ•ชโ•โ•โ•โ•โ•โ•โ•ชโ•โ•โ•โ•โ•โ•โ•ชโ•โ•โ•โ•โ•โ•โ•ก โ”‚ 1 โ”† x โ”† 1 โ”† x โ”‚ โ”‚ 2 โ”† y โ”† 2 โ”† y โ”‚ โ”‚ 3 โ”† z โ”† 3 โ”† z โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”˜ )rrฺname_to_uppercasers rฺ to_uppercasezExprNameNameSpace.to_uppercase๙r*rc๓\—| |j |ฆซฆซS)aL Rename fields of a struct by mapping a function over the field name(s). Notes ----- This only takes effect for struct columns. Parameters ---------- function Function that maps a field name to a new name. See Also -------- prefix_fields suffix_fields Examples -------- >>> df = pl.DataFrame({"x": {"a": 1, "b": 2}}) >>> df.select(pl.col("x").name.map_fields(lambda x: x.upper())).schema Schema({'x': Struct({'A': Int64, 'B': Int64})}) )rrฺname_map_fieldsrs rฺ map_fieldszExprNameNameSpace.map_fields!s(€๐0ื า  คื!=า!=ธhั!Gิ!GัHิHะHrc๓\—| |j |ฆซฆซS)a% Add a prefix to all field names of a struct. Notes ----- This only takes effect for struct columns. Parameters ---------- prefix Prefix to add to the field name. See Also -------- map_fields suffix_fields Examples -------- >>> df = pl.DataFrame({"x": {"a": 1, "b": 2}}) >>> df.select(pl.col("x").name.prefix_fields("prefix_")).schema Schema({'x': Struct({'prefix_a': Int64, 'prefix_b': Int64})}) )rrฺname_prefix_fieldsr"s rฺ prefix_fieldszExprNameNameSpace.prefix_fields;๓(€๐0ื า  คื!@า!@ภั!Hิ!HัIิIะIrc๓\—| |j |ฆซฆซS)a% Add a suffix to all field names of a struct. Notes ----- This only takes effect for struct columns. Parameters ---------- suffix Suffix to add to the field name. See Also -------- map_fields prefix_fields Examples -------- >>> df = pl.DataFrame({"x": {"a": 1, "b": 2}}) >>> df.select(pl.col("x").name.suffix_fields("_suffix")).schema Schema({'x': Struct({'a_suffix': Int64, 'b_suffix': Int64})}) )rrฺname_suffix_fieldsr&s rฺ suffix_fieldszExprNameNameSpace.suffix_fieldsUr4rN)r rr r )r r)rrr r)rrr r)r#rr r)ฺ__name__ฺ __module__ฺ __qualname__ฺ__doc__ฺ _accessorrrrrr#r)r-r0r3r7ฉrrrr s€€€€€ุEะEเ€I๐$๐$๐$๐$๐3;๐3;๐3;๐3;๐j1B๐1B๐1B๐1B๐f*C๐*C๐*C๐*C๐X)C๐)C๐)C๐)C๐V&C๐&C๐&C๐&C๐P&C๐&C๐&C๐&C๐PI๐I๐I๐I๐4J๐J๐J๐J๐4J๐J๐J๐J๐J๐JrrN)ฺ __future__rฺtypingrrฺpolarsrrr=rr๚rAs๐ุ"ะ"ะ"ะ"ะ"ะ"เ*ะ*ะ*ะ*ะ*ะ*ะ*ะ*เ๐ุะะะะะ๐dJ๐dJ๐dJ๐dJ๐dJ๑dJ๔dJ๐dJ๐dJ๐dJr