+ ܳj^FRt^RIHt^RIt^RIHtHt^RIHtH t H t H t H t H t ^RIt^RIHt^RIt^RIt^RIHtHtHtHtHtHt^RIt^RIHt^RIHt^R I H!t!H"t"^R I#H$t$H%t%H&t&H't'H(t(^R I)H*t*^R I+H,t,]'d^R I-H.t.H/t/H0t0H1t1H2t2H3t3^RI4H5t5Rt6Rt7RRlt8Rt9Rt:RRlt;RRltRRlt?]RZRR ll4t@]RZR!R"ll4t@R[R#R$llt@R[R%R&lltAR'tBR(R)ltCR*R+ltDR,R-ltER.R/ltFR0R1ltGR2tHR3tIR4tJ]R5R6l4tK]R7R8l4tKR[R9R:lltK]!R;4tL]R<R=l4tM]R>R?l4tMR@RAltMRBtNRCRDltO]PR\RERFll4tQRGRHltR/]PRIb]PRJb]PRKb]PRLb]PRMb]PRIb]PRIb]PRNb]PRNb]PROb]PROb]PRPb]PRPb]PRQb]PRQb]PRRb]PRRb]PRJ]PRJ]PRK]PRK]PRS]PRS]PRT]PRT/CtiRURVltjRWRXltkRYtlR#)]zh Misc tools for implementing data structures Note: pandas.core.common is *not* part of the public API. ) annotationsN)abc defaultdict)Callable Collection GeneratorHashableIterableSequence)partial) TYPE_CHECKINGAny ConcatenateTypeVarcastoverload)lib)'construct_1d_object_array_from_listlike) is_bool_dtype is_integer)ABCExtensionArrayABCIndex ABCMultiIndexABCNumpyExtensionArray ABCSeries)iterable_not_string) Expression) AnyArrayLike ArrayLikeNpDtypeP RandomStateT)Indexc#x"VF-p\V4'd\V4RjxL K)VxK/ R#L5i)z Flatten an arbitrarily nested sequence. Parameters ---------- line : sequence The non string sequence to flatten Notes ----- This doesn't consider strings sequences. Returns ------- flattened : generator N)rflatten)lineelements& S/home/luca/screen-checking/.venv/lib/python3.14/site-packages/pandas/core/common.pyr%r%Ds2" w ' 'w' ' 'M  's %:8:cV^,PpVR,FpVPV8wdRpV#K V# \dRpT#i;i):NNN)name ValueError)objsr,objs& r(consensus_name_attrr0\si 7<not_none..s 34CCC4s r6argss*r(not_nonerYs 44 33r9cV^8dQhRR/#r2r4r5r6)r7s"r(r8r8,,t,r9cj\;QJdRV4F 'gK R# R#!RV44#)z7 Returns a boolean indicating if any argument is None. c3("TFqRJxK R#5irQr6rRs& r(rUany_none..+dsd{dTFanyrWs*r(any_nonerd- 3+d+33+3+3+d+ ++r9cV^8dQhRR/#r[r6)r7s"r(r8r8r\r9cj\;QJdRV4F 'dK R# R#!RV44#)z9 Returns a boolean indicating if all arguments are None. c3("TFqRJxK R#5irQr6rRs& r(rUall_none..r`raFTallrWs*r(all_nonerlrer9cV^8dQhRR/#r[r6)r7s"r(r8r80040r9cj\;QJdRV4F 'gK R# R#!RV44#)z; Returns a boolean indicating if any argument is not None. c3("TFqRJxK R#5irQr6rRs& r(rUany_not_none../$3$$raTFrbrWs*r( any_not_noners- 3/$/33/3/3/$/ //r9cV^8dQhRR/#r[r6)r7s"r(r8r8rnr9cj\;QJdRV4F 'dK R# R#!RV44#)z= Returns a boolean indicating if all arguments are not None. c3("TFqRJxK R#5irQr6rRs& r(rUall_not_none..rrraFTrjrWs*r( all_not_noneryrtr9cV^8dQhRR/#)r2r4intr6)r7s"r(r8r8s,,S,r9c&\RV44#)z3 Returns the count of arguments that are not None. c3("TFqRJxK R#5irQr6)rSxs& r(rU!count_not_none..s+d}dra)sumrWs*r(count_not_noners +d+ ++r9c$V^8dQhRRRRRR/#)r2valueszArrayLike | list | tuple | zipr?NpDtype | Noner4 np.ndarrayr6)r7s"r(r8r8s$ *3Ar9cR#rQr6rr?s&&r(asarray_tuplesafersr9c$V^8dQhRRRRRR/#r2rr r?rr4rr6)r7s"r(r8r8sVVhV~V Vr9cR#rQr6rs&&r(rrsSVr9c$V^8dQhRRRRRR/#rr6)r7s"r(r8r8s!h~r9c\V\\34'g\VR4'g \V4pMD\V\4'd VP #\V\ 4'd VP #\V\4'd'V\P\39d \V4#\P!WR7p\TPP\ 4'd\P!T\R7pTP"^8Xd&TUu.uFp\T4NK pp\T4pT# \d\T4u#i;iuupi) __array__r?)r<rCtuplehasattrr_valuesrr=r@objectrrAr- issubclassr?rEstrndim)rr?resultr~s&& r(rrs ve} - -1M1Mf FH % %~~ FI & &~~&$Ebjj&-A$A6v>>?F0&,,##S))F&1 {{a$*+Fq%(F+8@ M ? 7v>> ?,s<E.E-E*)E*c$V^8dQhRRRRRR/#)r2labelsznp.ndarray | Iterabler?rr4rr6)r7s"r(r8r8s$ !*8r9c\V\\34'dV.p\V\\P 34'g \V4p\WR7pV# \ dT.pLi;i)z Transform label or iterable of labels to array, for use in Index. Parameters ---------- dtype : dtype If specified, use as dtype of the resulting array, otherwise infer. Returns ------- array r)r<rrrCr=r> TypeErrorr)rr?rlabelss&& r(index_labels_to_arrayrsi&3,'' ftRZZ0 1 1 &\F 4G N  XF s A A10A1cLVe \V\\34'gV.#V#rQ)r<rrCr/s&r(maybe_make_listr+s# z#t}==u Jr9c V^8dQhRRRR/#)r2r/zIterable[T] | Tr4zCollection[T] | Tr6)r7s"r(r8r81s4Er9c\V\P4'd,\V\P4'g \ V4#\ \ V4pV#)z: If obj is Iterable but not list-like, consume into list. )r<rr SizedrCrrrs&r(maybe_iterable_to_listr1s@#s||$$ZSYY-G-GCy z3 C Jr9cV^8dQhRR/#r[r6)r7s"r(r8r8;s  $ r9c\V\4;'d;VPRJ;'d%VPRJ;'dVPRJ#)z We have a null slice. Nr<slicestartstopsteprs&r( is_null_slicer;sW 3   II    HH    HH  r9cV^8dQhRR/#r[r6)r7s"r(r8r8Gs  4 r9c\V\4;'dFVPRJ;'d0VPRJ;'dVPVP8H#)z6 We have an empty slice, e.g. no values are selected. N)r<rrrrs&r(is_empty_slicerGs[ 3 " " IIT ! " " HHD  " " II ! r9c V^8dQhRRRR/#)r2r&z abc.Iterabler4zabc.Generator[bool, None, None]r6)r7s"r(r8r8Ss<<<*Irandom BitGeneratorr!rr-rs&r(rrs(%Jurzz299;Q;Q.RSSyy$$U++ E29900 1 1 E299.. / / yy +  r9_Tc ,V^8dQhRRRRRRRRR R /#) r2r/rrzCallable[Concatenate[_T, P], T]rXzP.argsrzP.kwargsr4r"r6)r7s"r(r8r8s:   )       r9cR#rQr6r/rrXrs&&*,r(piper r9c ,V^8dQhRRRRRRRRRR/#) r2r/r rztuple[Callable[..., T], str]rXrr4r"r6)r7s"r(r8r8s:   &       r9cR#rQr6rs&&*,r(rrrr9c ,V^8dQhRRRRRRRRRR /#) r2r/rrz>Callable[Concatenate[_T, P], T] | tuple[Callable[..., T], str]rXr rr4r"r6)r7s"r(r8r8s:&*&* &* H&* &* &*  &*r9c\V\4'd'VwrEWS9dV R2p\V4hWV&V!V/VB#V!V.VO5/VB#)a# Apply a function ``func`` to object ``obj`` either by passing obj as the first argument to the function or, in the case that the func is a tuple, interpret the first element of the tuple as a function and pass the obj to that function as a keyword argument whose key is the value of the second element of the tuple. Parameters ---------- func : callable or tuple of (callable, str) Function to apply to this object or, alternatively, a ``(callable, data_keyword)`` tuple where ``data_keyword`` is a string indicating the keyword of ``callable`` that expects the object. *args : iterable, optional Positional arguments passed into ``func``. **kwargs : dict, optional A dictionary of keyword arguments passed into ``func``. Returns ------- object : the return type of ``func``. z/ is both the pipe target and a keyword argument)r<rr-)r/rrXrfunc_targetmsgs&&*, r(rrsa:$   HKLCS/ !vd%f%%C)$)&))r9cdaV3Rlp\S\P\34'dV#S#)zj Returns a function that will map names/labels, dependent if mapper is a dict, Series or just a function. c(<VS9d SV,#V#rQr6)r~mappers&r(fget_rename_function..fs ;!9 Hr9)r<rrr)rrsf r(get_rename_functionrs*  6CKK#;<<1H&Hr9c V^8dQhRRRR/#)r2rz"Hashable | Iterable | AnyArrayLiker4zlist | AnyArrayLiker6)r7s"r(r8r8&s   .  r9c\V\\P\\ \ 34'dV#\V\P4'd"\V\4'g \V4#V.#)z Convert list-like or scalar input to list-like. List, numpy and pandas array-like inputs are returned unmodified whereas others are converted to list. ) r<rCr=r>rrrrr r)rs&r(convert_to_list_liker&sT&4XyBSTUU FCLL ) )*VS2I2IF| 8Or9c$V^8dQhRRRRRR/#)r2attrr conditionr5r4zGenerator[None]r6)r7s"r(r8r86s!**C*4*?*r9c#"V'd\W4p\WV4VxV'd\WX4R#R# T'd\YX4ii;i5i)a Temporarily set attribute on an object. Parameters ---------- obj : object Object whose attribute will be modified. attr : str Attribute to modify. value : Any Value to temporarily set attribute to. condition : bool, default True Whether to set the attribute. Provided in order to not have to conditionally use this context manager. Yields ------ object : obj with modified attribute. N)getattrsetattr)r/rvaluer old_values&&&& r( temp_setattrr5sL*C& 5!*  Cy ) 9 Cy ) s A?AAAc V^8dQhRRRR/#)r2indexr#r4Noner6)r7s"r(r8r8Ts   e    r9c\V4\V48wd%\R\V4 R\V4 R24hR#)z; Check the length of data matches the length of the index. zLength of values (z") does not match length of index ()N)rDr-)datars&&r(require_length_matchrTsI 4yCJ D {E |1   r9rmaxminrkrcmeanprodstdvarmediancumprodcumsumc V^8dQhRRRR/#)r2rTrr4z str | Noner6)r7s"r(r8r8~s"""j"r9c,\PV4#)z@ if we define an internal function for this argument, return it ) _cython_tableget)rTs&r(get_cython_funcr~s   S !!r9c V^8dQhRRRR/#)r2nameszSequence[Hashable | None]r4zlist[Hashable]r6)r7s"r(r8r8sTT7TNTr9c^\V4UUu.uFwrVfRV 2MTNK upp#uuppi)z If a name is missing then replace it by level_n, where n is the count Parameters ---------- names : list-like list of column names or None values. Returns ------- list list of column names with the None values replaced. level_) enumerate)rir,s& r(fill_missing_namesr s6CLEBR SBRwqDLfQCLd 2BR SS Ss)c\P!^4pVPP4F pW JgK R# R#)aQ Helper function used in detecting chained assignment. If the pandas object (DataFrame/Series) is a local variable in the caller's frame, it should not be a case of chained assignment or method call. For example: def test(): df = pd.DataFrame(...) df["a"] = 1 # not chained assignment Inside ``df.__setitem__``, we call this function to check whether `df` (`self`) is a local variable in `test` frame (the frame calling setitem). If so, we know it is not a case of chained assignment (even when the refcount of `df` is below the threshold due to optimization of local variables). TF)sys _getframef_localsr)r/framevs& r(is_local_in_caller_framers6& MM! E ^^ " " $ 8% r9).rQ)T)m__doc__ __future__rbuiltins collectionsrrcollections.abcrrrrr r contextlib functoolsr rrtypingr r rrrrnumpyr= pandas._libsrpandas.core.dtypes.castrpandas.core.dtypes.commonrrpandas.core.dtypes.genericrrrrrpandas.core.dtypes.inferencerpandas.core.colrpandas._typingrrrr r!r"pandasr#r%r0rIrNrYrdrlrsryrrrrrrrrrrrrrrrrrcontextmanagerrrrrrrkrcnansumrnanmeanrnanprodrnanstdrnanvarr nanmediannanmaxnanminr nancumprodr nancumsumrrr rr6r9r(r1s # K=&0 5p,4,,00,   V V>:   < "&@ H H     F T]        &*R I  **<   LL% LL% LL%FFE  FFE  FFE IIuGGVJJGGVJJFFEIIuFFEIIu IIx!"LL(#$FFEIIuFFEIIuJJ MM9IIxLL(3 :"T"r9