ttj^FZdZddlmZddlZddlmZmZddlmZm Z m Z m Z m Z m Z ddlZddlmZddlZddlZddlmZmZmZmZmZmZddlZddlmZdd lmZdd l m!Z!m"Z"dd l#m$Z$m%Z%m&Z&m'Z'm(Z(dd l)m*Z*dd l+m,Z,erddl-m.Z.m/Z/m0Z0m1Z1m2Z2m3Z3ddl4m5Z5dZ6dZ7dtdZ8dZ9dZ:dudZ;dudZdvdZ?e dwdxd%Z@edwdyd(Z@dzdyd)Z@ dzd{d,ZAd-ZBd|d1ZCdud2ZDdud3ZEd}d7ZFd~d8ZGd9ZHd:ZId;ZJedd>ZKeddAZKdzddCZKedDZLeddLZMeddNZMddPZMdQZNddTZOejPdddZZQdd^ZRiejSd_ejTd`ejUdaejVdbejWdcejSd_ejXd_ejYddejZddej[deej\deej]dfej^dfej_dgej`dgejadhejbdhejTd`ejcd`ejUdaejddaejediejfdiejgdjejhdjiZiddnZjddrZkdsZldS)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#fK|D]+}t|rt|Ed{V'|V,dS)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 P/var/www/html/CA-Chatbot/venv/lib/python3.11/site-packages/pandas/core/common.pyr&r&Ds_" w ' ' w'' ' ' ' ' ' ' ' 'MMMM c|dj}|ddD]%} |j|krd}n#t$rd}YnwxYw|S)Nr)name ValueError)objsr-objs r)consensus_name_attrr1\su 7znot_none..s" 3 3C3?C???? 3 3r*rMargss r)not_nonerTs 4 34 3 3 33r*c4td|DS)z? Returns a boolean indicating if any argument is None. c3K|]}|duV dSrLrMrNs r)rQzany_none..&++ssd{++++++r*anyrRs r)any_nonerZ! ++d+++ + ++r*c4td|DS)zA Returns a boolean indicating if all arguments are None. c3K|]}|duV dSrLrMrNs r)rQzall_none..rWr*allrRs r)all_noner`r[r*c4td|DS)zC Returns a boolean indicating if any argument is not None. c3K|]}|duV dSrLrMrNs r)rQzany_not_none..&//3s$//////r*rXrRs r) any_not_nonerd! //$/// / //r*c4td|DS)zE Returns a boolean indicating if all arguments are not None. c3K|]}|duV dSrLrMrNs r)rQzall_not_none..rcr*r^rRs r) all_not_nonerhrer*intc4td|DS)z; Returns the count of arguments that are not None. c3K|]}|duV dSrLrMrOxs r)rQz!count_not_none..s&++q}++++++r*)sumrRs r)count_not_noneror[r*.valuesArrayLike | list | tuple | zipr:NpDtype | None np.ndarraycdSrLrMrpr:s r)asarray_tuplesafervs Cr*r rcdSrLrMrus r)rvrvsSVSVr*ct|ttfs t|dst|}n8t|tr|jSt|t r|jSt|tr$|tjtfvrt|S tj ||}n#t$rt|cYSwxYwt|jjt rtj |t}|jdkrd|D}t|}|S)N __array__r:c,g|]}t|SrM)tuplerls r) z%asarray_tuplesafe..s+++q%((+++r*)r7r>r}hasattrr_valuesrr8r;objectrr<r. issubclassr:r@strndim)rpr:results r)rvrvsF ve} - -1M1Mf FH % %~ FI & &~&$?Ebj&-A$A$A6v>>>?F%000 ??? 7v>>>>> ?&,#S))2F&111 {a++F+++8@@ Ms/CC"!C"labelsnp.ndarray | Iterablect|ttfr|g}t|ttjfs$ t|}n#t $r|g}YnwxYwt||}|S)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 rz)r7rr}r>r8r9 TypeErrorrv)rr:rlabelss r)index_labels_to_arrayrs&3,'' ftRZ0 1 1 &\\FF   XFFF  e444G NsA A"!A"cH|t|ttfs|gS|SrL)r7r}r>r0s r)maybe_make_listr+s% z#t}==u Jr*r0Iterable[T] | TCollection[T] | Tct|tjr)t|tjst |St t |}|S)zB If obj is Iterable but not list-like, consume into list. )r7rr Sizedr>rrrs r)maybe_iterable_to_listr1sK#s|$$ZSY-G-GCyy z3  C Jr*cbt|to|jduo|jduo|jduS)z We have a null slice. Nr7slicestartstopsteprs r) is_null_slicer;sE 3  I   H   H  r*cpt|to!|jduo|jduo|j|jkS)z> We have an empty slice, e.g. no values are selected. N)r7rrrrs r)is_empty_slicerGsG 3 " IT ! " HD  " I ! r*r' abc.Iterableabc.Generator[bool, None, None]c#bK|D])}t|tot| V*dS)z; Find non-trivial slices in "line": yields a bool. N)r7rr)r'ks r)is_true_slicesrSsJ<<E"";=+;+;';;;;;<t|trt t|jSt |}t|tj std||tkrtd|S)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) inspectisclassr7rr default_factoryr@rrMappingr)intos r)standardize_mappingrs* ?4  dK ( ( >;(<== =Dzz dCK ( (53T33444 {IJJJ Kr*statenp.random.GeneratorcdSrLrMrs r) random_statersEHSr*Hint | np.ndarray | np.random.BitGenerator | np.random.RandomState | Nonenp.random.RandomStatecdSrLrMrs r)rrs  Cr*RandomState | Nonecrt|s+t|tjtjjfrtj|St|tjjr|St|tjjr|S| tjStd)aq 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 Nzdrandom_state must be an integer, array-like, a BitGenerator, Generator, a numpy RandomState, or None) rr7r8r9random BitGeneratorr"rr.rs r)rrs(%  Jurz29;Q.RSS  y$$U+++ E290 1 1   E29. / /  y +   r*_TrCallable[Concatenate[_T, P], T]rSP.argsrP.kwargsr#cdSrLrMr0rrSrs r)piper r*tuple[Callable[..., T], str]cdSrLrMrs r)rrrr*>Callable[Concatenate[_T, P], T] | tuple[Callable[..., T], str]ct|tr*|\}}||vr|d}t||||<||i|S||g|Ri|S)as 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)r7r}r.)r0rrSrfunc_targetmsgs r)rrs:$ * v V  LLLCS// !vud%f%%%tC)$)))&)))r*cXfd}ttjtfr|nS)zv Returns a function that will map names/labels, dependent if mapper is a dict, Series or just a function. c |vr|S|SrLrM)rmmappers r)fzget_rename_function..fs ;;!9 Hr*)r7rrr)rrs` r)get_rename_functionrs>  6CK#;<< H11&Hr*"Hashable | Iterable | AnyArrayLikelist | AnyArrayLikect|ttjtt t fr|St|tjr$t|tst|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. ) r7r>r8r9rrrrr r)rps r)convert_to_list_liker&sa&4XyBSTUU FCL ) )*VS2I2IF|| 8Or*Tattrr conditionGenerator[None]c#K|r!t||}t||| |V|rt|||dSdS#|rt|||wwxYw)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)r0rvaluer old_values r) temp_setattrr5s*"C&& T5!!!*  * Cy ) ) ) ) ) * *9 * Cy ) ) ) ) *s AAindexr$Nonect|t|kr0tdt|dt|ddS)zC Check the length of data matches the length of the index. zLength of values (z") does not match length of index ()N)r?r.)datars r)require_length_matchrTsg 4yyCJJ D   E       r*rnmaxminr_rYmeanprodstdvarmediancumprodcumsumrPr str | Nonec6t|S)zH if we define an internal function for this argument, return it ) _cython_tableget)rPs r)get_cython_funcr~s   S ! !!r*namesSequence[Hashable | None]list[Hashable]c4dt|DS)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. c&g|]\}}|d|n|S)Nlevel_rM)rOir-s r)r~z&fill_missing_names..s* S S Swq$DLLQLLLd S S Sr*) enumerate)rs r)fill_missing_namesrs! T S)EBRBR S S SSr*cttjd}|jD] }||urdS dS)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). r{TF)sys _getframef_localsrp)r0framevs r)is_local_in_caller_framersJ& M!  E ^ " " $ $ 8844  5r*)r2rr3r4)r3r4)r3ri).)rprqr:rrr3rs)rpr r:rrr3rrL)rrr:rrr3rs)r0rr3r)r'rr3r)r'rir3r4)rrr3r)rrr3r)rr) r0rrrrSrrrr3r#) r0rrrrSrrrr3r#) r0rrrrSrrrr3r#)rprr3r)T)rrrr4r3r)rr$r3r)rPrr3r)rrr3r)m__doc__ __future__rbuiltins collectionsrrcollections.abcrrrr r r contextlib functoolsr rrtypingr rrrrrnumpyr8 pandas._libsrpandas.core.dtypes.castrpandas.core.dtypes.commonrrpandas.core.dtypes.genericrrrrrpandas.core.dtypes.inferencerpandas.core.colrpandas._typingrrr r!r"r#pandasr$r&r1rDrIrTrZr`rdrhrorvrrrrrrrrrrrrrrrcontextmanagerrrrnrrr_rYnansumrnanmeanrnanprodrnanstdrnanvarr nanmediannanmaxnanminr nancumprodr nancumsumrrrrrMr*r)r"s #""""" KKKKKK=<<<<<&&&&&& 0   5555p,444,,,,,,,,00000000,,,, DG  VVVV V@<@:         <<<<    "&@ HHH H           F WT]]            &*&*&*&*R I I I     *****<      L% L% L%FE  FE  FE IuGVJGVJFEIuFEIu Ix!"L(#$FEIuFEIuJ M9IxL(3 :""""TTTT"r*