ujMdZddlmZddlZddlmZmZddlZddlZddl m Z ddl Z ddl Z ddl mZmZmZmZmZmZddlZddlmZddlmZdd lmZmZdd lmZmZm Z m!Z!m"Z"dd l#m$Z$dd l%m&Z&er0dd l'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-ddl.m/Z/m0Z0m1Z1m2Z2m3Z3m4Z4ddl5m6Z6m7Z7m8Z8ddl9m:Z:dEdZ;dFdZdIdZ?dJdZ@dJdZAdJdZBdJdZCdKdZDe dL dMdZEedLdNdZEdOdNdZE dO dPdZFdQdZGdRd ZHdSd!ZIdSd"ZJdTd#ZKdUd$ZLdVd%ZMdWd&ZNdXd'ZOedYd(ZPe dZd)ZP dO d[d*ZPed+ZQe d\d,ZRe d]d-ZR d^d.ZRd_d/ZS d`d0ZTej da dbd1ZVdcd2ZWiejd3ejd4ejd5ejd6ejd7ejd3ejd3ejd8ejd8ejd9ejd9ejd:ejd:ejd;ejd;ejd<ejd<ejd4ejd4ejd5ejd5ejd=ejd=ejd>ejd>iZnddd?Zoded@ZpeqdAdBDZrdfdCZsdgdDZty)hzh Misc tools for implementing data structures Note: pandas.core.common is *not* part of the public API. ) annotationsN)abc defaultdict)partial) TYPE_CHECKINGAny ConcatenateTypeVarcastoverload)lib)'construct_1d_object_array_from_listlike) is_bool_dtype is_integer)ABCExtensionArrayABCIndex ABCMultiIndexABCNumpyExtensionArray ABCSeries)iterable_not_string) Expression)Callable Collection GeneratorHashableIterableSequence) AnyArrayLike ArrayLikeNpDtypeP RandomStateT) DataFrameIndexSeries)NDFramec#dK|D]%}t|rt|Ed{"|'y7 w)a 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 ]/var/www/html/python-recuperauto-other/env/lib/python3.12/site-packages/pandas/core/common.pyr)r)Ks5" w 'w' ' 'M  's 0. 0c|dj}|ddD]} |j|k7rd}|S|S#t$rd}Y|SwxYw)Nr)name ValueError)objsr/objs r,consensus_name_attrr3csn 7<znot_none..s 3C3?C 3srNargss r,not_nonerUs 44 33rEc&td|DS)z? Returns a boolean indicating if any argument is None. c3$K|]}|du ywrMrNrOs r,rRzany_none..+ssd{+anyrSs r,any_noner\ +d+ ++rEc&td|DS)zA Returns a boolean indicating if all arguments are None. c3$K|]}|du ywrMrNrOs r,rRzall_none..rXrYallrSs r,all_nonerbr]rEc&td|DS)zC Returns a boolean indicating if any argument is not None. c3$K|]}|du ywrMrNrOs r,rRzany_not_none../3s$/rYrZrSs r, any_not_nonerf /$/ //rEc&td|DS)zE Returns a boolean indicating if all arguments are not None. c3$K|]}|du ywrMrNrOs r,rRzall_not_none..rerYr`rSs r, all_not_nonerjrgrEc&td|DS)z; Returns the count of arguments that are not None. c3$K|]}|du ywrMrN)rPxs r,rRz!count_not_none..s+q}+rY)sumrSs r,count_not_noneror]rEcyrMrNvaluesr9s r,asarray_tuplesaferssrEcyrMrNrqs r,rsrssSVrEct|ttfst|ds t|}n8t|tr |j St|t r |j St|tr#|tjtfvr t|S tj||}t|jjt rtj|t}|j"dk(r#|Dcgc] }t|}}t|}|S#t$rt|cYSwxYwcc}w)N __array__r9)r6r=tuplehasattrr_valuesrr7r:objectrr;r0 issubclassr9r?strndim)rrr9resultrms r,rsrss ve} -1Mf FH %~~ FI &~~&$Ebjj&-A$A6v>>?F%0&,,##S)F&1 {{a$*+q%(++8@ M ? 7v>> ?,sD%D?%D<;D<ct|ttfr|g}t|ttj fs t|}t||}|S#t $r|g}YwxYw)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 rw)r6r~ryr=r7r8 TypeErrorrs)labelsr9rlabelss r,index_labels_to_arrayrse&3,' ftRZZ0 1 &\F e4G N  XF s A A$#A$c<|t|ttfs|gS|SrM)r6ryr=r2s r,maybe_make_listr2s  z#t}=u JrEct|tjr%t|tjs t |St d|}|S)zB If obj is Iterable but not list-like, consume into list. r)r6rrSizedr=r rs r,maybe_iterable_to_listr8s:#s||$ZSYY-GCy |S !C JrEct|txr.|jduxr|jduxr|jduS)z We have a null slice. Nr6slicestartstopsteprs r, is_null_slicerBsH 3  II   HH   HH  rEct|txr9|jduxr)|jduxr|j|jk(S)z> We have an empty slice, e.g. no values are selected. N)r6rrrrs r,is_empty_slicerNsL 3 " IIT ! " HHD  " II ! rEc#ZK|D]"}t|txr t| $yw)z; Find non-trivial slices in "line": yields a bool. N)r6rr)r*ks r,is_true_slicesrZs1<E";=+;';;.f&s ;!9 HrE)rmrreturnr)r6rrr)rrs` r,get_rename_functionr s'  6CKK#;<1H&HrEct|ttjtt t fr|St|tjrt|ts t|S|gS)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. ) r6r=r7r8rrrrrr~)rrs r,convert_to_list_liker/sK&4XyBSTU FCLL )*VS2IF| 8OrEc#K|rt||}t||| ||rt||yy#|rt||wwxYww)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)r2attrvalue condition old_values r, temp_setattrr>sU.C& T5!*  Cy ) 9 Cy ) sA 4A AA czt|t|k7r$tdt|dt|dy)zC Check the length of data matches the length of the index. zLength of values (z") does not match length of index ()N)r>r0)dataindexs r,require_length_matchr_sI 4yCJ D {E |1   rErnmaxminrar[meanprodstdvarmediancumprodcumsumc,tj|S)zH if we define an internal function for this argument, return it ) _cython_tableget)rQs r,get_cython_funcrs   S !!rEcXt|Dcgc]\}}|d|n|c}}Scc}}w)a 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)namesir/s r,fill_missing_namesrs2CLEBR Swq$DLfQCLd 2 SS Ss&c#hK|]*}|tjvstj|,ywrM)disopmap)rPr/s r,rRrRs(4399CTCIIdOs22) STORE_SUBSCR STORE_SLICEc tjd}|jj|j t vS#t$rYywxYw)a Helper function used in detecting chained assignment. Whether the frame calling ``__setitem__`` is executing a subscript assignment (``obj[key] = value``) right now. The refcount check can only tell a temporary apart from a named object for calls coming from the interpreter, because it relies on the extra reference the interpreter holds on its value stack. Code compiled with Cython calls ``PyObject_SetItem`` directly, so it has one reference less and a perfectly valid ``df[col] = value`` there looks exactly like chained assignment (GH#51315). Such a call leaves no Python frame of its own, and the nearest Python frame is executing a call rather than a subscript assignment, so checking the opcode filters those out. rxF)sys _getframer0f_codeco_codef_lasti_SETITEM_OPCODES)frames r,!is_setitem_syntax_in_caller_framersJ  a  <<   .2B BB sA A  A cxtjd}|jjD]}||usyy)a 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). rxTF)rrf_localsrr)r2rvs r,is_local_in_caller_framers=& MM! E ^^ " " $ 8 rE)r*rrGenerator[Any])r1zlist[Series | DataFrame]rzHashable | None)rArrbool)rIrrr)rTr|rzGenerator[object])rTr|rr)rTr|rint).)rrzArrayLike | list | tuple | zipr9NpDtype | Noner np.ndarray)rrrr9rrrrM)rznp.ndarray | Iterabler9rrr)r2rrzlist | tuple | None)r2zIterable[T] | TrzCollection[T] | T)r2r|rr)r*z abc.Iterablerzabc.Generator[bool, None, None])r2r|r*rrr)r2r|r str | None)rrr2rrrrr)rztype | abc.Mappingrztype | partial)rnp.random.Generatorrr)rzHint | np.ndarray | np.random.BitGenerator | np.random.RandomState | Nonerznp.random.RandomState)rzRandomState | Nonerz+np.random.RandomState | np.random.Generator) r2rrzCallable[Concatenate[_T, P], T]rTzP.argsrzP.kwargsrr#) r2rrztuple[Callable[..., T], str]rTrrrrr#) r2rrz>Callable[Concatenate[_T, P], T] | tuple[Callable[..., T], str]rTrrrrr#)rrrr)rrz"Hashable | Iterable | AnyArrayLikerzlist | AnyArrayLike)T) r2rrr~rrrrrr)rrrr%rNone)rQrrr)rzSequence[Hashable | None]rzlist[Hashable])rr)r2r'rr)u__doc__ __future__rbuiltins collectionsrr contextlibr functoolsrrrtypingrrr r r r numpyr7 pandas._libsr pandas.core.dtypes.castrpandas.core.dtypes.commonrrpandas.core.dtypes.genericrrrrrpandas.core.dtypes.inferencerpandas.core.colrcollections.abcrrrrrrpandas._typingrrr r!r"r#pandasr$r%r&pandas.core.genericr'r)r3rDrJrUr\rbrfrjrorsrrrrrrrrrrrrrrrcontextmanagerrrrnrrrar[nansumrnanmeanrnanprodrnanstdrnanvarr nanmediannanmaxnanminr nancumprodr nancumsumrrr frozensetrrrrNrEr,rsM #  K=& ,0 5p,4,,00, DG *3A  V V@<@ !*8:   < "&@ H H  S    !%" " 0" J T]   )            &         &* &* H&* &* &*  &*R I  .   7;* ** #*04***@   LL% LL% LL%FFE  FFE  FFE IIuGGVJJGGVJJFFEIIuFFEIIu IIx!"LL(#$FFEIIuFFEIIuJJ MM9IIxLL(3 :"T( ? C.rE