Mh)DbSrSSKJr SSKrSSKJrJr SSKJrJ r J r J r J r SSK r SSKJr SSKrSSKJrJrJrJrJr SSKrSSKrSSKJr SS KJr SS KJr SS K J!r!J"r" SS K#J$r$J%r%J&r&J'r' SS K(J)r) \(aSSK*J+r+J,r,J-r-J.r.J/r/ SSK0J1r1 Sr2Sr3SASjr4Sr5Sr6SBSjr7SBSjr8SBSjr9SBSjr:SCSjr;\SDSESjj5r<\SDSFSjj5rSISjr?SBS jr@SBS!jrASJS"jrBSKS#jrCS$rDS%rES&rF\SLS'j5rG\SMS(j5rGSGSNS)jjrGSOS*jrHS+rISPS,jrJ\ RSQSRS-jj5rLSSS.jrM\R\R\R\RR\R\RR0rT\RS/\RS0\RS10rU0\RS2_\RS3_\RS4_\RS5_\RS6_\RS2_\RS2_\RS7_\RS7_\RS8_\RS8_\RS9_\RS9_\RS:_\RS:_\RS;_\RS;_\RS3\RS3\RS4\RS4\RS<\RS<\RS=\RS=0EriSTS>jrjS?rkSUS@jrlg)Vzh Misc tools for implementing data structures Note: pandas.core.common is *not* part of the public API. ) annotationsN)abc defaultdict) Collection GeneratorHashableIterableSequence)partial) TYPE_CHECKINGAnyCallablecastoverload)lib)np_version_gte1p24)'construct_1d_object_array_from_listlike) is_bool_dtype is_integer)ABCExtensionArrayABCIndex ABCMultiIndex ABCSeries)iterable_not_string) AnyArrayLike ArrayLikeNpDtype RandomStateT)Indexc#t# UH,n[U5(a[U5ShvN M(Uv M. gN7f)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 D/var/www/html/env/lib/python3.13/site-packages/pandas/core/common.pyr"r">s2" w ' 'w' ' 'M  's $868cUSRnUSSHnURU:waSnMM U$![a SnM-f=f)Nr)name ValueError)objsr(objs r%consensus_name_attrr,VsW 7<cSU5$)zD Returns a generator consisting of the arguments that are not None. c3.# UH ocMUv M g7fN.0args r% not_none..s 34CCC4s rGargss r%not_nonerOs 44 33r>c&[SU55$)z7 Returns a boolean indicating if any argument is None. c3(# UHoSLv M g7frFrGrHs r%rKany_none..+dsd{danyrMs r%any_nonerW +d+ ++r>c&[SU55$)z9 Returns a boolean indicating if all arguments are None. c3(# UHoSLv M g7frFrGrHs r%rKall_none..rSrTallrMs r%all_noner^rXr>c&[SU55$)z; Returns a boolean indicating if any argument is not None. c3(# UHoSLv M g7frFrGrHs r%rKany_not_none../$3$$rTrUrMs r% any_not_nonerc /$/ //r>c&[SU55$)z= Returns a boolean indicating if all arguments are not None. c3(# UHoSLv M g7frFrGrHs r%rKall_not_none..rbrTr\rMs r% all_not_nonerhrdr>c&[SU55$)z3 Returns the count of arguments that are not None. c3(# UHoSLv M g7frFrG)rIxs r%rK!count_not_none..s+d}drT)sumrMs r%count_not_nonernrXr>cgrFrGvaluesr2s r%asarray_tuplesaferrsr>cgrFrGrps r%rrrrr>c[U[[45(d[US5(d [U5nOB[U[5(a UR $[U[ 5(a UR $[U[5(a%U[R[4;a [U5$[R"5 [(d%[R"S[R5 [R "XS9nSSS5 [%WR&R([*5(a[R "U[S9nUR,S:Xa&UVs/sHn[U5PM nn[U5nU$!,(df  N=f!["a [U5s$f=fs snf)N __array__ignorer2)r/r6tuplehasattrr_valuesrr0r3objectrwarningscatch_warningsr simplefilterVisibleDeprecationWarningr4r) issubclassr2r8strndim)rqr2resultrks r%rrrrsD ve} - -1M1Mf FH % %~~ FI & &~~&$Ebjj&-A$A6v>> ?  $ $ &%%%%h0L0LMZZ4F '&,,##S))F&1 {{a$*+Fq%(F+8@ M)' & ? 7v>> ?,s76F# AFF#.F> F F# F##F;:F;c[U[[45(aU/n[U[[R 45(d [U5n[XS9nU$![ a U/nNf=f)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 rx)r/rrzr6r0r1 TypeErrorrr)labelsr2s r%index_labels_to_arrayr si&3,'' ftRZZ0 1 1 &\Fv 3F M  XF s A A+*A+cHUb[U[[45(dU/$U$rF)r/rzr6r+s r%maybe_make_listr's# z#t}==u Jr>c[U[R5(a*[U[R5(d [ U5$[ [ U5nU$)z: If obj is Iterable but not list-like, consume into list. )r/rr Sizedr6rrrs r%maybe_iterable_to_listr-s@#s||$$ZSYY-G-GCy z3 C Jr>c[U[5=(a8 URSL=(a# URSL=(a URSL$)z We have a null slice. Nr/slicestartstopsteprs r% is_null_slicer7sH 3  II   HH   HH  r>c[U[5=(aC URSL=(a. URSL=(a URUR:H$)z6 We have an empty slice, e.g. no values are selected. N)r/rrrrs r%is_empty_slicerCsL 3 " IIT ! " HHD  " II ! r>c|UVs/sH*n[U[5=(a [U5(+PM, sn$s snf)zP Find non-trivial slices in "line": return a list of booleans with same length. )r/rr)r#ks r%is_true_slicesrOs5DH H4aJq% 9q)9%9 94 HH Hs19c[U[5=(a: URS:H=(a$ URU:H=(a URSL$)z We have a full length slice. rNr)r+r#s r% is_full_slicerWsG 3  IIN  HH   HH  r>c[US5(a [US5$[U[5(a[ UR 5$[ U5(a[U5R$g)N__name__) r{getattrr/r get_callable_namefunccallabler8rrs r%rrcsVsJsJ''#w **}}Cy!!! r>c 8[U5(a U"U40UD6$U$)z Evaluate possibly callable input using obj and kwargs if it is callable, otherwise return as it is. Parameters ---------- maybe_callable : possibly a callable obj : NDFrame **kwargs )r)maybe_callabler+kwargss r%apply_if_callablerts%c,V,, r>c4[R"U5(d:[U[5(a[ [UR 5$[ U5n[U[R5(d[SU35eU[:Xa [S5eU$)a Helper function to standardize a supplied mapping. Parameters ---------- into : instance or subclass of collections.abc.Mapping Must be a class, an initialized collections.defaultdict, or an instance of a collections.abc.Mapping subclass. Returns ------- mapping : a collections.abc.Mapping subclass or other constructor a callable object that can accept an iterator to create the desired Mapping. See Also -------- DataFrame.to_dict Series.to_dict zunsupported type: z/to_dict() only accepts initialized defaultdicts) inspectisclassr/rr default_factoryr8rrMappingr)intos r%standardize_mappingrsy* ??4 dK ( (;(<(<= =Dz dCKK ( (,TF344 {IJJ Kr>cgrFrGstates r% random_staterrtr>cgrFrGrs r%rrsr>c[U5(d9[U[R[RR 45(a[RR U5$[U[RR 5(aU$[U[RR5(aU$Uc[R$[S5e)a9 Helper function for processing random_state arguments. Parameters ---------- state : int, array-like, BitGenerator, Generator, np.random.RandomState, None. If receives an int, array-like, or BitGenerator, passes to np.random.RandomState() as seed. If receives an np.random RandomState or Generator, just returns that unchanged. If receives `None`, returns np.random. If receives anything else, raises an informative ValueError. Default None. Returns ------- np.random.RandomState or np.random.Generator. If state is None, returns np.random zdrandom_state must be an integer, array-like, a BitGenerator, Generator, a numpy RandomState, or None) rr/r0r1random BitGeneratorrrr)rs r%rrs(%Jurzz299;Q;Q.RSSyy$$U++ E29900 1 1 E299.. / / yy +  r>c[U[5(a%UupXC;aUS3n[U5eXU'U"U0UD6$U"U/UQ70UD6$)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/rzr))r+rrNrtargetmsgs r%pipersa4$   HKLCS/ !vT$V$$C)$)&))r>cb^U4Sjn[T[R[45(aU$T$)zj Returns a function that will map names/labels, dependent if mapper is a dict, Series or just a function. c>UT;aTU$U$rFrG)rkmappers r%fget_rename_function..fs ;!9 Hr>)r/rrr)rrs` r%get_rename_functionrs*  6CKK#;<<1H&Hr>c[U[[R[[ [ 45(aU$[U[R5(a [U[5(d [U5$U/$)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/r6r0r1rrrrr r)rqs r%convert_to_list_likersT&4XyBSTUU FCLL ) )*VS2I2IF| 8Or>c## U(a[X5n[XU5 Uv U(a [XW5 gg!U(a [XW5 ff=f7f)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)rsetattr)r+attrvalue condition old_values r% temp_setattrrsL.C& 5!*  Cy ) 9 Cy ) sA;AAAc|[U5[U5:wa$[S[U5S[U5S35eg)z; Check the length of data matches the length of the index. zLength of values (z") does not match length of index ()N)r7r))dataindexs r%require_length_matchr8sI 4yCJ D {E |1   r>znp.sumznp.maximum.reduceznp.minimum.reducermmaxminr]rVmeanprodstdvarmediancumprodcumsumc,[RU5$)z@ if we define an internal function for this argument, return it ) _cython_tablegetrJs r%get_cython_funcrrs   S !!r>c,[RX5$)zX if we define a builtin function for this argument, return it, otherwise return the arg )_builtin_tablerrs r%is_builtin_funcrys   c ''r>c^[U5VVs/sHupUcSU3OUPM snn$s snnf)a If a name is missing then replace it by level_n, where n is the count .. versionadded:: 1.4.0 Parameters ---------- names : list-like list of column names or None values. Returns ------- list list of column names with the None values replaced. level_) enumerate)namesir(s r%fill_missing_namesrs6 CLEBR SBRwqDLfQCLd 2BR SS Ss))r:r returnbool)rr)rint).)rqzArrayLike | list | tuple | zipr2NpDtype | Noner np.ndarray)rqr r2rrrrF)rznp.ndarray | Iterabler2rrr)r+zIterable[T] | TrzCollection[T] | T)rz list[bool])r#rrr)rnp.random.Generatorrr)rzHint | np.ndarray | np.random.BitGenerator | np.random.RandomState | Nonerznp.random.RandomState)rzRandomState | None)rz/Callable[..., T] | tuple[Callable[..., T], str]rr)rqz"Hashable | Iterable | AnyArrayLikerzlist | AnyArrayLike)T)rrrrrzGenerator[None, None, None])rr rNone)rJrrz str | None)rzSequence[Hashable | None]rzlist[Hashable])m__doc__ __future__rbuiltins collectionsrrcollections.abcrrrr r contextlib functoolsr rtypingr r rrrr~numpyr0 pandas._libsrpandas.compat.numpyrpandas.core.dtypes.castrpandas.core.dtypes.commonrrpandas.core.dtypes.genericrrrrpandas.core.dtypes.inferencerpandas._typingrrrrrpandasr r"r,r=rCrOrWr^rcrhrnrrrrrrrrrrrrrrrrcontextmanagerrrrmrmaximumreducerminimumr_builtin_table_aliasr]rVnansumrnanmeanrnanprodrnanstdrnanvarr nanmediannanmaxnanminr nancumprodr nancumsumrrrrrGr>r%r s #2K =04n,4,,00, DG *3A    H<@ !*8:   I ""@    S   F"*>"*"*J I  .   -1**&** **@  " LL"&& LL"**## LL"**## LL( LL% LL%  LL% LL% LL%FFE  FFE  FFE IIuGGVJJGGVJJFFEIIuFFEIIu IIx!"LL(#$FFEIIuFFEIIuJJ MM9IIxLL(3 :"(Tr>