'h7SSKJr SSKJrJrJr SSKJr SSK J r SSK J r SSK Jr SSKJr SSKJr \(a;SSKrSS KJr SS KJr SS KJr SS KJrJr \R:S :aSSKJ r OSSKJ r "SS5r g)) annotations) TYPE_CHECKINGLiteraloverloadN) deprecated)serialize_polars_object)display_dot_graph) wrap_expr) ComputeError)IOBase)Path)Expr) SchemaDictSerializationFormat) cz\rSrSrSrSrS.SjrS/SjrS/SjrS/Sjr S/Sjr S0S jr S0S jr S0S jr S S .S1SjjrS S .S1Sjjr\SS.S2Sjj5r\S3Sj5rSS.S4SjjrSS.S5SjjrS6SjrS7SjrS8Sjr\S9SS.S:Sjjj5r\S9S;Sjj5r\SS.SS!jjjr\S9S?S"jj5r\S@S#j5r\"S$5S=SAS%jj5r\SSS&.SBS'jj5r\SS.SCS(jj5rS SS&.SDS)jjrSSS S*SS+.SES,jjrS-rg)FExprMetaNameSpacez*Namespace for expressions on a meta level.metac&URUlgN_pyexpr)selfexprs cC:\Users\julio\OneDrive\Documentos\Trabajo\Ideas Frescas\venv\Lib\site-packages\polars/expr/meta.py__init__ExprMetaNameSpace.__init__s || cLURRUR5$rrmeta_eqrothers r__eq__ExprMetaNameSpace.__eq__"s||##EMM22r c X:X+$rr$s r__ne__ExprMetaNameSpace.__ne__%s   r cLURRUR5$)a Indicate if this expression is the same as another expression. Examples -------- >>> foo_bar = pl.col("foo").alias("bar") >>> foo = pl.col("foo") >>> foo_bar.meta.eq(foo) False >>> foo_bar2 = pl.col("foo").alias("bar") >>> foo_bar.meta.eq(foo_bar2) True r"r$s reqExprMetaNameSpace.eq(s||##EMM22r c.URU5(+$)a Indicate if this expression is NOT the same as another expression. Examples -------- >>> foo_bar = pl.col("foo").alias("bar") >>> foo = pl.col("foo") >>> foo_bar.meta.ne(foo) True >>> foo_bar2 = pl.col("foo").alias("bar") >>> foo_bar.meta.ne(foo_bar2) False )r-r$s rneExprMetaNameSpace.ne8s775>!!r c6URR5$)z Indicate if this expression expands into multiple expressions. Examples -------- >>> e = pl.col(["a", "b"]).name.suffix("_foo") >>> e.meta.has_multiple_outputs() True )rmeta_has_multiple_outputsrs rhas_multiple_outputs&ExprMetaNameSpace.has_multiple_outputsHs||5577r c6URR5$)a  Indicate if this expression is a basic (non-regex) unaliased column. Examples -------- >>> e = pl.col("foo") >>> e.meta.is_column() True >>> e = pl.col("foo") * pl.col("bar") >>> e.meta.is_column() False >>> e = pl.col(r"^col.*\d+$") >>> e.meta.is_column() False )rmeta_is_columnr4s r is_columnExprMetaNameSpace.is_columnTs ||**,,r c6URR5$)z Indicate if this expression expands to columns that match a regex pattern. Examples -------- >>> e = pl.col("^.*$").name.prefix("foo_") >>> e.meta.is_regex_projection() True )rmeta_is_regex_projectionr4s ris_regex_projection%ExprMetaNameSpace.is_regex_projectionfs||4466r F)allow_aliasingc8URRU5$)a Indicate if this expression only selects columns (optionally with aliasing). This can include bare columns, columns matched by regex or dtype, selectors and exclude ops, and (optionally) column/expression aliasing. .. versionadded:: 0.20.30 Parameters ---------- allow_aliasing If False (default), any aliasing is not considered to be column selection. Set True to allow for column selection that also includes aliasing. Examples -------- >>> import polars.selectors as cs >>> e = pl.col("foo") >>> e.meta.is_column_selection() True >>> e = pl.col("foo").alias("bar") >>> e.meta.is_column_selection() False >>> e.meta.is_column_selection(allow_aliasing=True) True >>> e = pl.col("foo") * pl.col("bar") >>> e.meta.is_column_selection() False >>> e = cs.starts_with("foo") >>> e.meta.is_column_selection() True >>> e = cs.starts_with("foo").exclude("foo!") >>> e.meta.is_column_selection() True )rmeta_is_column_selectionrr?s ris_column_selection%ExprMetaNameSpace.is_column_selectionrsH||44^DDr c8URRU5$)a Indicate if this expression is a literal value (optionally aliased). .. versionadded:: 1.14 Parameters ---------- allow_aliasing If False (default), only a bare literal will match. Set True to also allow for aliased literals. Examples -------- >>> from datetime import datetime >>> e = pl.lit(123) >>> e.meta.is_literal() True >>> e = pl.lit(987.654321).alias("foo") >>> e.meta.is_literal() False >>> e = pl.lit(datetime.now()).alias("bar") >>> e.meta.is_literal(allow_aliasing=True) True )rmeta_is_literalrBs r is_literalExprMetaNameSpace.is_literals2||++N;;r T)raise_if_undeterminedcgrr)rrIs r output_nameExprMetaNameSpace.output_namesRUr cgrr)rKs rrLrMsSVr chURR5$![a U(dgef=f)a Get the column name that this expression would produce. It may not always be possible to determine the output name as that can depend on the schema of the context; in that case this will raise `ComputeError` if `raise_if_undetermined` is True (the default), or `None` otherwise. Examples -------- >>> e = pl.col("foo") * pl.col("bar") >>> e.meta.output_name() 'foo' >>> e_filter = pl.col("foo").filter(pl.col("bar") == 13) >>> e_filter.meta.output_name() 'foo' >>> e_sum_over = pl.sum("foo").over("groups") >>> e_sum_over.meta.output_name() 'foo' >>> e_sum_slice = pl.sum("foo").slice(pl.len() - 10, pl.col("bar")) >>> e_sum_slice.meta.output_name() 'foo' >>> pl.len().meta.output_name() 'len' N)rmeta_output_namer rKs rrLrMs22 <<002 2 (  s 11N)schemacvURRU5Vs/sHn[U5PM sn$s snf)a Pop the latest expression and return the input(s) of the popped expression. Returns ------- list of Expr A list of expressions which in most cases will have a unit length. This is not the case when an expression has multiple inputs. For instance in a `fold` expression. Examples -------- >>> e = pl.col("foo") + pl.col("bar") >>> first = e.meta.pop()[0] >>> first.meta == pl.col("bar") True >>> first.meta == pl.col("foo") False )rmeta_popr )rrQes rpopExprMetaNameSpace.pops1('+ll&;&;F&CD&C ! &CDDDs6c6URR5$)a Get a list with the root column name. Examples -------- >>> e = pl.col("foo") * pl.col("bar") >>> e.meta.root_names() ['foo', 'bar'] >>> e_filter = pl.col("foo").filter(pl.col("bar") == 13) >>> e_filter.meta.root_names() ['foo', 'bar'] >>> e_sum_over = pl.sum("foo").over("groups") >>> e_sum_over.meta.root_names() ['foo', 'groups'] >>> e_sum_slice = pl.sum("foo").slice(pl.len() - 10, pl.col("bar")) >>> e_sum_slice.meta.root_names() ['foo', 'bar'] )rmeta_root_namesr4s r root_namesExprMetaNameSpace.root_namess&||++--r cH[URR55$)a Undo any renaming operation like `alias` or `name.keep`. Examples -------- >>> e = pl.col("foo").alias("bar") >>> e.meta.undo_aliases().meta == pl.col("foo") True >>> e = pl.col("foo").sum().over("bar") >>> e.name.keep().meta.undo_aliases().meta == e True )r rmeta_undo_aliasesr4s r undo_aliasesExprMetaNameSpace.undo_aliasess779::r cp[RRURR 55$)a Try to turn this expression in a selector. Raises if the underlying expressions is not a column or selector. .. warning:: This functionality is considered **unstable**. It may be changed at any point without it being considered a breaking change. )plSelector_from_pyselectorr into_selectorr4s r as_selectorExprMetaNameSpace.as_selectors&{{++DLL,F,F,HIIr .formatcgrr)rfilergs r serializeExprMetaNameSpace.serializesr cgrr)ris rrkrl$sNQr cgrr)ris rrkrl'sr binarycUS:XaURRnO.US:XaURRnOSU<3n[U5e[ X1U5$)u Serialize this expression to a file or string in JSON format. Parameters ---------- file File path to which the result should be written. If set to `None` (default), the output is returned as a string instead. format The format in which to serialize. Options: - `"binary"`: Serialize to binary format (bytes). This is the default. - `"json"`: Serialize to JSON format (string). See Also -------- Expr.deserialize Notes ----- Serialization is not stable across Polars versions: a LazyFrame serialized in one Polars version may not be deserializable in another Polars version. Examples -------- Serialize the expression into a binary representation. >>> expr = pl.col("foo").sum().over("bar") >>> bytes = expr.meta.serialize() >>> type(bytes) The bytes can later be deserialized back into an `Expr` object. >>> import io >>> pl.Expr.deserialize(io.BytesIO(bytes)) rojsonz0`format` must be one of {'binary', 'json'}, got )rserialize_binaryserialize_json ValueErrorr)rrjrg serializermsgs rrkrl,sVX X 66J v 44JFvjQCS/ !&z@@r cgrr)rrjs r write_jsonExprMetaNameSpace.write_jsonbs36r cgrr)rxs rryrzes=@r z;`meta.write_json` was renamed; use `meta.serialize` insteadc"URUSS9$)zk Write expression to json. .. deprecated:: 0.20.11 This method has been renamed to :meth:`serialize`. rqrf)rkrxs rryrzhs~~d6~22r )return_as_stringrQcgrr)rr}rQs r tree_formatExprMetaNameSpace.tree_formatrs r cgrr)rs rrrzsr cbURRU5nU(aU$[U5 g)a" Format the expression as a tree. Parameters ---------- return_as_string: If True, return as string rather than printing to stdout. Examples -------- >>> e = (pl.col("foo") * pl.col("bar")).sum().over(pl.col("ham")) / 2 >>> e.meta.tree_format(return_as_string=True) # doctest: +SKIP N)rmeta_tree_formatprint)rr}rQss rrrs* LL ) )& 1 H !Hr )g0@g(@)show output_path raw_outputfigsizerQcRURRU5n[UUUUUS9$)a4 Format the expression as a Graphviz graph. Note that Graphviz must be installed to render the visualization (if not already present, you can download it here: ``_). Parameters ---------- show Show the figure. output_path Write the figure to disk. raw_output Return dot syntax. This cannot be combined with `show` and/or `output_path`. figsize Passed to matplotlib if `show == True`. Examples -------- >>> e = (pl.col("foo") * pl.col("bar")).sum().over(pl.col("ham")) / 2 >>> e.meta.show_graph() # doctest: +SKIP )dotrrrr)rmeta_show_graphr )rrrrrrQrs r show_graphExprMetaNameSpace.show_graphs4>ll**62 #!   r r)rrreturnNone)r%zExprMetaNameSpace | Exprrbool)rr)r?rrr)rI Literal[True]rstr)rILiteral[False]r str | None)rIrrr)rQzSchemaDict | Nonerz list[Expr])rz list[str])rr)rz pl.Selector).)rjrrgzLiteral['binary']rbytes)rjrrgzLiteral['json']rr)rjIOBase | str | Pathrgrrrr)rjIOBase | str | Path | Nonergrrzbytes | str | None)rjrrr)rjrrr)rjrrr)r}rrQNone | SchemaDictrr)r}rrQrrr)r}rrQrrr) rrrzstr | Path | Nonerrrztuple[float, float]rQrrr)__name__ __module__ __qualname____firstlineno____doc__ _accessorrr&r*r-r0r5r9r=rCrGrrLrUrYr]rdrkryrrr__static_attributes__r)r rrrsS4I$3!3 " 8-$ 7=B$EL49<6DHUU VV;?@26E,.* ; J?B+< QQ JM'4G  ,04A'/ 4A(4A$ 4A  4Al66 @@MN3O3,/$( )"   NR#0:K  +0T#'9J 4)- '3$(& & ' &  & % & "&  & & r r)! __future__rtypingrrrpolars._reexport _reexportr`polars._utils.deprecationrpolars._utils.serderpolars._utils.variousr polars._utils.wrapr polars.exceptionsr sysior pathlibr polarsrpolars._typingrr version_infowarningstyping_extensionsrr)r rrsR"33073(*> 7"'0b b r