Λ θΛ€hΦ/γσD—ddlmZddlmZmZerddlmZGd„d«Zy)ι)Ϊ annotations)Ϊ TYPE_CHECKINGΪCallable)ΪExprcσd—eZdZdZdZdd„Zdd„Zdd„Zdd„Zdd„Z dd„Z dd „Z dd „Z dd „Z dd „Zy )ΪExprNameNameSpacez;Namespace for expressions that operate on expression names.ΪnamecσH—|j|_|j|_y)N)Ϊ _from_pyexprΪ_pyexpr)ΪselfΪexprs ϊl/var/www/html/wine-match-dev/backend/winematch-backend/venv/lib/python3.12/site-packages/polars/expr/name.pyΪ__init__zExprNameNameSpace.__init__s€Ψ Χ-Ρ-ˆΤΨ—|‘|ˆ σcσT—|j|jj««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 β”‚ β””β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”˜ )r r Ϊ name_keep©r s rΪkeepzExprNameNameSpace.keeps#€πfΧ Ρ  §‘Χ!7Ρ!7Σ!9Σ:Π:rcσV—|j|jj|««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 β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”˜ )r r Ϊname_map©r Ϊfunctions rΪmapzExprNameNameSpace.mapGs%€πbΧ Ρ  §‘Χ!6Ρ!6°xΣ!@ΣAΠArcσV—|j|jj|««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 β”‚ β””β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ )r r Ϊ name_prefix©r Ϊprefixs rrzExprNameNameSpace.prefixzs%€πTΧ Ρ  §‘Χ!9Ρ!9Έ&Σ!AΣBΠBrcσV—|j|jj|««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 β”‚ β””β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ )r r Ϊ name_suffix©r Ϊsuffixs rr"zExprNameNameSpace.suffix¦s%€πRΧ Ρ  §‘Χ!9Ρ!9Έ&Σ!AΣBΠBrcσT—|j|jj««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 β”‚ β””β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”˜ )r r Ϊname_to_lowercasers rΪ to_lowercasezExprNameNameSpace.to_lowercaseΡσ#€πLΧ Ρ  §‘Χ!?Ρ!?Σ!AΣBΠBrcσT—|j|jj««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 β”‚ β””β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”˜ )r r Ϊname_to_uppercasers rΪ to_uppercasezExprNameNameSpace.to_uppercaseωr&rcσV—|j|jj|««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})}) )r r Ϊname_map_fieldsrs rΪ map_fieldszExprNameNameSpace.map_fields!s$€π0Χ Ρ  §‘Χ!=Ρ!=ΈhΣ!GΣHΠHrcσV—|j|jj|««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})}) )r r Ϊname_prefix_fieldsrs rΪ prefix_fieldszExprNameNameSpace.prefix_fields;σ$€π0Χ Ρ  §‘Χ!@Ρ!@ΐΣ!HΣIΠIrcσV—|j|jj|««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})}) )r r Ϊname_suffix_fieldsr!s rΪ suffix_fieldszExprNameNameSpace.suffix_fieldsUr0rN)rrΪreturnΪNone)r4r)rzCallable[[str], str]r4r)rΪstrr4r)r"r6r4r)Ϊ__name__Ϊ __module__Ϊ __qualname__Ϊ__doc__Ϊ _accessorrrrrr"r%r)r,r/r3©rrrr sJ„ΩEΰ€Iσ$σ3;σj1Bσf*CσX)CσV&CσP&CσPIσ4Jτ4JrrN)Ϊ __future__rΪtypingrrΪpolarsrrr<rrϊr@sπέ"η*αέχdJςdJr