h;SSKJr SSKrSSKJrJrJr SSKJrJ r SSK J r SSK Jr SSKJr SSKJr \R("\5 SSKJr SSS5 \(aSSK Jr SS KJr SS KJrJrJr S S S SS .SS jjrSSjr S S.SSjjr!SS.S Sjjr"SS.S!Sjjr#S S.S"Sjjr$S#Sjr%S$Sjr&S S.S%Sjjr'S&Sjr(S'Sjr)S(Sjr*g!,(df  N=f))) annotationsN) CollectionIterableMapping) TYPE_CHECKINGAny) functions)qualified_type_name) ComputeError)Expr)PyExpr)ColumnNameOrSelectorIntoExprPolarsDataTypeF) str_as_litlist_as_series structifydtypec[U[R5(a UnU(a [U5nUR$[U[5(a)U(d"[ R "U5nUR$[U[5(a<U(a5[ R"[R"U5US9nUR$[ R"XS9nUR$)aR Parse a single input into an expression. Parameters ---------- input The input to be parsed as an expression. str_as_lit Interpret string input as a string literal. If set to `False` (default), strings are parsed as column names. list_as_series Interpret list input as a Series literal. If set to `False` (default), lists are parsed as list literals. structify Convert multi-column expressions to a single struct expression. dtype If the input is expected to resolve to a literal with a known dtype, pass this to the `lit` constructor. Returns ------- PyExpr )r) isinstanceplr _structify_expressionstrFcollistlitSeries_pyexpr)inputrrrrexprs R/home/james-whalen/.local/lib/python3.13/site-packages/polars/_utils/parse/expr.pyparse_into_expressionr#s>%!! (.D << E3   uuU| << E4 ^uuRYYu%U3 <<uuU( <<cJURR5nURR5(aBURR5n[R "U5R U5nU$U$![a [R "U5nU$f=fN)meta undo_aliaseshas_multiple_outputs output_namerstructaliasr )r!unaliased_expr expr_names r"rrCsYY++-N//11 = --/I88N+11)D K  "sA>> B"!B") __structifycZ[XS9nU(a[X S9nURU5 U$)a Parse multiple inputs into a list of expressions. Parameters ---------- *inputs Inputs to be parsed as expressions, specified as positional arguments. **named_inputs Additional inputs to be parsed as expressions, specified as keyword arguments. The expressions will be renamed to the keyword used. __structify Convert multi-column expressions to a single struct expression. Returns ------- list of PyExpr r)_parse_positional_inputs_parse_named_inputsextend)r/inputs named_inputsexprs named_exprss r"parse_into_list_of_expressionsr9Os,, %V CE),N  [! Lr$TstrictcD[U[5(aSSKJn UR U/US9$[U[ R 5(aU$[U[ R5(aURR5$S[U5<S3n[U5e)Nr require_allz cannot turn z into selector) rrpolars.selectors selectorsby_namerSelectorr r' as_selectorr TypeError)ir;csmsgs r"parse_into_selectorrHms !S%zz1#6z22 Ar{{ # # Arww  vv!!##036nEnr$c^[U[5(a[U[5(d{SSKJn [ [ SU55nURX1S9n[U5[U5:XaU$[U5S:XaUR5nUHnU[XQS9-nM U$[XS9$)Nrc"[U[5$r&)rr)rEs r"*parse_list_into_selector..s 1c(:r$r=r:) rrrr?r@rfilterrAlenemptyrH)r5r;rFcolumnsselectorrEs r"parse_list_into_selectorrRs &*%%j.E.E%v:FCD::g:: w<3v; &O w<1 xxzHA +A= =H"699r$r1cV[U5nUVs/sH n[X1S9PM sn$s snfNr1)_parse_inputs_as_iterabler#)r5r inputs_iteres r"r2r2s, ,F3KCN O;a !! 9; OO Os&cU(d/$[U5S:Xa%[US[5(a Sn[U5e[U5S:Xa[ US5(aUS$U$)Nru8Cannot pass a dictionary as a single positional argument. If you merely want the *keys*, use: • df.method(*your_dict.keys()) If you need the key value pairs, use one of: • unpack as keywords: df.method(**your_dict) • build expressions: df.method(expr.alias(k) for k, expr in your_dict.items()))rNrrrD _is_iterable)r5rGs r"rUrUsl   6{aJvay':: e n 6{aL33ay Mr$c[U[5=(a* [U[[[R 45(+$r&)rrrbytesrr)r s r"rZrZs2 eX & z UBII&0,r$c#r# UR5Hup#[X1S9RU5v M! g7frT)itemsr#r,)r6rnamer s r"r3r3s2$))+ #E?EEdKK,s57ct[U5nU(a[U5nURU5 [U5$)a Parse predicates and constraints into a single expression. The result is an AND-reduction of all inputs. Parameters ---------- *predicates Predicates to be parsed, specified as positional arguments. **constraints Constraints to be parsed, specified as keyword arguments. These will be converted to predicates of the form "keyword equals input value". Returns ------- PyExpr )r2_parse_constraintsr4_combine_predicates) predicates constraintsall_predicatesconstraint_predicatess r",parse_predicates_constraints_into_expressionrgs6*.j9N 2; ?34 ~ ..r$c## UR5H6up[R"U5RU5Rv M8 g7fr&)r^rreqr)rdr_values r"raras7"((* eeDknnU#++++sA Ac~U(d Sn[U5e[U5S:XaUS$[R"U5$)Nz5at least one predicate or constraint must be providedrYr)rDrNplrall_horizontal)rcrGs r"rbrbs; En :!!}   j ))r$) r rrboolrrnrrnrzPolarsDataType | Nonereturnr )r!r ror )r5IntoExpr | Iterable[IntoExpr]r/rnr6rro list[PyExpr])rErr;rnro pl.Selector)r5z7ColumnNameOrSelector | Collection[ColumnNameOrSelector]r;rnrorr)r5z0tuple[IntoExpr, ...] | tuple[Iterable[IntoExpr]]rrnrorq)r5z&tuple[Any, ...] | tuple[Iterable[Any]]roz Iterable[Any])r zAny | Iterable[Any]rorn)r6dict[str, IntoExpr]rrnroIterable[PyExpr])rcrprdrror )rdrsrort)rcrqror )+ __future__r contextlibcollections.abcrrrtypingrrpolars._reexport _reexportrpolarsr rpolars._utils.variousr polars.exceptionsr suppress ImportError polars._plr_plrrlr r polars._typingrrrr#rr9rHrRr2rUrZr3rgrarbr$r"rs"99%!5*%&"MM  #' + ++ +  + ! + +\  * B  *: C: : :8P <PP P 22=BL%L59LL/.// /<, *}&%s C;; D