`Vg%  dZddlmZddlZddlZddlmZddlZddlZddl Z ddl Z ddl Z ddl mZddlmZddlmZ d dd Zdd Zdd Zeejd d eee j0e j0dZddZGddZy)z Module for scope operations ) annotationsN)StringIO) Timestamp) DeepChainMap)UndefinedVariableErrorScopec (t|dz||||S)z.Ensure that we are grabbing the correct scope.) global_dict local_dict resolverstarget)r)levelr r r rkwargss ^/var/www/html/hubwallet-dev/venv/lib/python3.12/site-packages/pandas/core/computation/scope.py ensure_scopers$     cf t|}t|S#t$r|}Yt|SwxYw)z Replace a number with its hexadecimal representation. Used to tag temporary variables with their calling scope's id. )ord TypeErrorhex)xhexins r _replacerr"s<A u:  u: s  00ctjdt|}dj|Dcgc] }t |c}Scc}w)z,Return the padded hexadecimal id of ``obj``.z@P)structpackidjoinr)objpackedrs r _raw_hex_idr#2s9[[r#w 'F 77&1QIaL1 221sATF)rdatetimeTrueFalselisttupleinfInfcdt}tj|||jS)z Return a prettier version of obj. Parameters ---------- obj : object Object to pretty print Returns ------- str Pretty print object repr )stream)rpprintgetvalue)r!sios r_get_pretty_stringr0Es% *C MM#c" <<>rceZdZUdZgdZded<ded<ded<ded < d dd Zdd Zedd Z ddZ dddZ ddZ ddZ ddZeddZeddZy )ra Object to hold scope, with a few bells to deal with some custom syntax and contexts added by pandas. Parameters ---------- level : int global_dict : dict or None, optional, default None local_dict : dict or Scope or None, optional, default None resolvers : list-like or None, optional, default None target : object Attributes ---------- level : int scope : DeepChainMap target : object temps : dict )rscoperr tempsintrrr2r dictr3NcZ|dz|_ttj|_||_t |tr]|jj|j|j |j |_|j|jtj|j} |jj||n |jj}t||_t |tsG|jj||n |jj}t||_~t |tr"|t|j j"z }t||_i|_y#~wxYw)Nr )rrDEFAULT_GLOBALScopyr2r isinstancerupdate_updatesys _getframe new_child f_globalsf_localsr(r mapsr3) selfrr r r rframe scope_global scope_locals r__init__zScope.__init__ssSQY "/"6"6"89  j% ( JJ  j.. /  ,(// LL)) * djj)  ::// + 7U__RRTL&l3DJj%0"jj22#-#9Zu~~SSU *+6  j% ( z33889 9I%y1 s BF''F*ctt|jj}tt|jj}t |j d|d|dS)Nz(scope=z , resolvers=))r0r'r2keysr type__name__)rB scope_keysres_keyss r__repr__zScope.__repr__s\'TZZ__->(?@ %d4>>+>+>+@&ABt*%%&gj\hZqQQrc>tt|jS)z Return whether we have any extra scope. For example, DataFrames pass Their columns as resolvers during calls to ``DataFrame.eval()`` and ``DataFrame.query()``. Returns ------- hr : bool )boollenr rBs r has_resolverszScope.has_resolverssC'((rc |r|j|S|jr|j|S|s |jrJ|j|S#t$r1 |j|cYS#t$r}t |||d}~wwxYwwxYw)a Resolve a variable name in a possibly local context. Parameters ---------- key : str A variable name is_local : bool Flag indicating whether the variable is local or not (prefixed with the '@' symbol) Returns ------- value : object The value of a particular variable N)r2rSr KeyErrorr3r)rBkeyis_localerrs rresolvez Scope.resolves" Ezz#&!!~~c** (:(: ::::c? " E Ezz#& E,S(;D E  Es9A A A BA(%B( B1 A>>BBc|jr.|jj|jjz}n|jj}|j |j |D] }||vs|||<yy)a] Replace a variable name, with a potentially new value. Parameters ---------- old_key : str Current variable name to replace new_key : str New variable name to replace `old_key` with new_value : object Value to be replaced along with the possible renaming N)rSr rAr2appendr3)rBold_keynew_key new_valuerAmappings rswapkeyz Scope.swapkeysj   >>&&8D::??D DJJ G'!#,  rctj||}|D]F\}\}}}}}} t|d|z}t|jj ||_~Hy#~wxYw)a Get specifically scoped variables from a list of stack frames. Parameters ---------- stack : list A list of stack frames as returned by ``inspect.stack()`` scopes : sequence of strings A sequence containing valid stack frame attribute names that evaluate to a dictionary. For example, ('locals', 'globals') f_N) itertoolsproductgetattrrr2r>)rBstackscopes variablesr2rC_ds r _get_varszScope._get_varsss%%fe4 -6  )E)E1aAq E4%<0)$***>*>q*AB  s 8A##A&c|dz}tj} |j|d|dg|dd=~y#|dd=~wxYw)z Update the current scope by going back `level` levels. Parameters ---------- level : int r Nlocals)rg)inspectrfrk)rBrslrfs rr;z Scope._updatesJQY   NN5":xjN 9a%a%s 9Act|jd|jdt|}||jvsJ||j|<||jvsJ|S)a# Add a temporary variable to the scope. Parameters ---------- value : object An arbitrary object to be assigned to a temporary variable. Returns ------- str The name of the temporary variable created. ri)rJrKntempsr#r3)rBvaluenames radd_tmpz Scope.add_tmpsju+&&'q Q{47H6IJ4::%%%  4tzz!!! rc,t|jS)z/The number of temporary variables in this scope)rQr3rRs rrqz Scope.ntemps1s4::rc|jg|jjz|jjz}t |S)z Return the full scope for use with passing to engines transparently as a mapping. Returns ------- vars : DeepChainMap All variables in this scope. )r3r rAr2r)rBrAs r full_scopezScope.full_scope6sA ZZLnn!! "jjoo  T""rNNN)rr4returnNonerzstr)rzrP)rVr}rWrP)N)r\r}r]r}rzr{)rgz list[str]rzr{)rzr4)rzr)rK __module__ __qualname____doc__ __slots____annotations__rFrNpropertyrSrYr`rkr;rtrqrwryrrrrXs(CI J  KSW&& &PR  ) )%EN2. (0##rrx)rr4rzrr|)r __future__rr$rniorrcr-rr<numpynppandas._libs.tslibsrpandas.compat.chainmapr pandas.errorsrrrr#r'r(r)r7r0rryrrrs# )/0IM       3!!     66 66 &r#r#r