|h-~dZddlZddlZddlZddlZddlmZGddZdZdZ dZ d Z d Z d Z d Zd ZdZy)z-Inspection utility functions for Python Fire.N) docstringsceZdZdZ ddZy) FullArgSpeczBThe arguments of a function, as in Python 3's inspect.FullArgSpec.Nc|xsg|_||_||_|xsd|_|xsg|_|xsi|_|xsi|_y)aiConstructs a FullArgSpec with each provided attribute, or the default. Args: args: A list of the argument names accepted by the function. varargs: The name of the *varargs argument or None if there isn't one. varkw: The name of the **kwargs argument or None if there isn't one. defaults: A tuple of the defaults for the arguments that accept defaults. kwonlyargs: A list of argument names that must be passed with a keyword. kwonlydefaults: A dictionary of keyword only arguments and their defaults. annotations: A dictionary of arguments and their annotated types. N)argsvarargsvarkwdefaults kwonlyargskwonlydefaults annotations)selfrr r r r r rs P/var/www/html/test/engine/venv/lib/python3.12/site-packages/fire/inspectutils.py__init__zFullArgSpec.__init__sN DIDLDJNDM &BDO(.BD"(bD)NNNNNNN)__name__ __module__ __qualname____doc__rrrrrrsJCGAE)rrc>d}tj|rd}||fStj|r|jdu}||fStj|r*t |jt jsd}||fStj|sd}||fS)aGives information pertaining to computing the ArgSpec of fn. Determines if the first arg is supplied automatically when fn is called. This arg will be supplied automatically if fn is a bound method or a class with an __init__ method. Also returns the function who's ArgSpec should be used for determining the calling parameters for fn. This may be different from fn itself if fn is a class with an __init__ method. Args: fn: The function or class of interest. Returns: A tuple with the following two items: fn: The function to use for determining the arg spec of this function. skip_arg: Whether the first argument will be supplied automatically, and hence should be skipped when supplying args from a Fire command. FTN) inspectisclassismethod__self__ isbuiltin isinstancetypes ModuleType isfunction)fnskip_args r_GetArgSpecInfor#2s&( __RH X{{$&H X bkk5#3#3 4h X   b !H Xrc  tj|ddtj}g}d}d}g}d}i}d}i}|j |j ur|j |d<|jjD](} | j} | j} | tjur|j| n| tjur:|j| | j| j ur|| jfz }nt| tjur| }n_| tj ur9|j| | j| j ur$| j|| <n| tj"ur| }| j$| j us| j$|| <+|sd}|sd}tj&|||||||S#t$r t dwxYw)aA alternative to the builtin getfullargspec. The builtin inspect.getfullargspec uses: `skip_bound_args=False, follow_wrapped_chains=False` in order to be backwards compatible. This function instead skips bound args (self) and follows wrapped chains. Args: fn: The function or class of interest. Returns: An inspect.FullArgSpec namedtuple with the full arg spec of the function. T)skip_bound_argfollow_wrapper_chainssigclszUnsupported callable.Nrreturn)r_signature_from_callable Signature Exception TypeErrorreturn_annotationempty parametersvalueskindname_POSITIONAL_ONLYappend_POSITIONAL_OR_KEYWORDdefault_VAR_POSITIONAL _KEYWORD_ONLY _VAR_KEYWORD annotationr) r!sigrr r r r r kwdefaultsparamr1r2s rPy3GetFullArgSpecr>Xs -  * * "   "C $ ' %* (+ (*#))+11K~~$$&+e ::D ::D w''' kk$ '00 0 kk$ ekk )U]]$$ ')) )g ''' ' ekk ) == 4 '&& &e u{{***k$)+. J H   T7E8'[ BB_ - + ,,-s 'G Gc |}t|\}} tjdddk\rt|\}}}}}}} nt j |\}}}}}}} tjddd k(} | r|r|r|jdt||||||| S#t $rWt j|rtddcYSt|dd} | tt|  cYStcYSwxYw) z4Returns a FullArgSpec describing the given callable.r)varskwargs)r r _fieldsN)r)rA) r#sys version_infor>rgetfullargspecr,rrgetattrlistpop) r! original_fnr"rr r r r r rfieldsskip_arg_requireds rGetFullArgSpecrPs+ $,"h! !&2CB2G0tWeX>;3:2H2H2L0tWeX>;<&&q+v58HHQK T7E8 >>? x 88[)T 2F  d6l ++ =3sAB+C7$C7* C76C7ctj|ry tj|} tj|\}}|dz}||fS#t$rYywxYw#t t f$rd}Y||fSwxYw)a#Returns the filename and line number of component. Args: component: A component to find the source information for, usually a class or routine. Returns: filename: The name of the file where component is defined. lineno: The line number where component is defined. )NNN)rr getsourcefiler, findsourceOSError IndexError) componentfilename unused_code lineindexlinenos rGetFileAndLiner\s y! $$Y/H$// :K ]F 6    :  F 6 s"AA AAA54A5cX ddlm}|j}|j|}|ddk(rd|d< t j|\}}|dz|d<d|vrtj|d|d<|S#t$rt |}YXwxYw#ttf$rd|d<YQwxYw) aReturns a dict with information about the given component. The dict will have at least some of the following fields. type_name: The type of `component`. string_form: A string representation of `component`. file: The file in which `component` is defined. line: The line number at which `component` is defined. docstring: The docstring of `component`. init_docstring: The init docstring of `component`. class_docstring: The class docstring of `component`. call_docstring: The call docstring of `component`. length: The length of `component`. Args: component: The component to analyze. Returns: A dict with information about the component. r)oinspect docstringzNrRlinedocstring_info) IPython.corer^ Inspectorinfo ImportError _InfoBackuprrTr,rUrparse)rWr^ inspectorrdrYrZs rInforis& "%""$I >>) $D K,,d;$// :Kq=DLD'--d;.?@D  + " y !D" W DLs"4A8 B8BBB)(B)ci}t|j|d<t||d<t|\}}||d<||d<t j ||d< tt ||d<|S#ttf$rY|SwxYw)aReturns a dict with information about the given component. This function is to be called only in the case that IPython's oinspect module is not available. The info dict it produces may contain less information that contained in the info dict produced by oinspect. Args: component: The component to analyze. Returns: A dict with information about the component. type_name string_formfiler`r_length) typerstrr\rgetdoclenr,AttributeError)rWrdrXr[s rrfrfs $9o..${I$}#I.(F$v,$v,nnY/${ Y(DN + ^ $  + sA33BBcTt|tsytt|dd}|S)a$Return true if the component is a namedtuple. Unfortunately, Python offers no native way to check for a namedtuple type. Instead, we need to use a simple hack which should suffice for our case. namedtuples are internally implemented as tuples, therefore we need to: 1. Check if the component is an instance of tuple. 2. Check if the component has a _fields attribute which regular tuples do not have. Args: component: The component to analyze. Returns: True if the component is a namedtuple or False otherwise. FrEN)rtupleboolrJ)rW has_fieldss r IsNamedTuplerx7s* Iu % GIy$78* rctj|sytj|}|Dcic]}|j|c}Scc}w)zEGets the attributes of the component class, as a dict with name keys.N)rrclassify_class_attrsr2)rWclass_attrs_list class_attrs rGetClassAttrsDictr}MsM  # 11)<)  ooz!  sAc< tj|S#YyxYw)NF)asyncioiscoroutinefunction)r!s rIsCoroutineFunctionrXs"  & &r ** s)rrrrGrfirerrr#r>rPr\rirfrxr}rrrrrsV4 ))2#LFBV->`6'T>,r