o ii @sNUddlmZddlZddlZddlZddlZddlZddlmZ ddlm Z m Z m Z m Z ddlmZddlmZmZddlmZddlmZmZdd lmZmZmZdd lmZmZmZmZm Z dd l!m"Z"m#Z#dd l$m%Z%dd l&m'Z'ddl(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.mZm/Z/m0Z0m1Z1m2Z2erddl3m4Z4ddl5m6Z6ddl7m8Z8m9Z9ddlm:Z:de;d<zddlYnweee j?Z@ddddddddddDd*d+ZGd,d-d-ZAe jBejCe jDejEe jFejGe jHejIe jJejKiZLdd.dEd5d6ZMdd.dFd:d;ZNdRDZSdd.dGd@dAZTdd.dFdBdCZUdS)H) annotationsN) Parameter) Signaturecleandocgetsourcelinesunwrap) signature) TYPE_CHECKINGAny) ObjectNode)LinesCollectionModulesCollection)Kind ParameterKindTypeParameterKind)Expr ExprBinOp ExprSubscript ExprTuplesafe_get_annotation) Extensionsload_extensions)dynamic_import)logger) Alias AttributeClass DocstringFunctionModuler Parameters TypeAlias TypeParameterTypeParameters)Sequence)Path)DocstringOptionsDocstringStyle)Parserztuple[types.ModuleType, ...]_TYPING_MODULES)filepath import_paths extensionsparentdocstring_parserdocstring_optionslines_collectionmodules_collection module_namestrr* Path | Noner+Sequence[str | Path] | Noner,Extensions | Noner- Module | Noner.DocstringStyle | Parser | Noner/DocstringOptions | Noner0LinesCollection | Noner1ModulesCollection | Nonereturnrc Cs$t|||pt|||||d|S)aUInspect a module. Sometimes we cannot get the source code of a module or an object, typically built-in modules like `itertools`. The only way to know what they are made of is to actually import them and inspect their contents. Sometimes, even if the source code is available, loading the object is desired because it was created or modified dynamically, and our static agent is not powerful enough to infer all these dynamic modifications. In this case, we load the module using introspection. Griffe therefore provides this function for dynamic analysis. It uses a [`NodeVisitor`][ast.NodeVisitor]-like class, the [`Inspector`][griffe.Inspector], to inspect the module with [`inspect.getmembers()`][inspect.getmembers]. The inspection agent works similarly to the regular [`Visitor`][griffe.Visitor] agent, in that it maintains a state with the current object being handled, and recursively handle its members. Important: This function is generally not used directly. In most cases, users can rely on the [`GriffeLoader`][griffe.GriffeLoader] and its accompanying [`load`][griffe.load] shortcut and their respective options to load modules using dynamic analysis. Parameters: module_name: The module name (as when importing [from] it). filepath: The module file path. import_paths: Paths to import the module from. extensions: The extensions to use when inspecting the module. parent: The optional parent of this module. docstring_parser: The docstring parser to use. By default, no parsing is done. docstring_options: Docstring parsing options. lines_collection: A collection of source code lines. modules_collection: A collection of modules. Returns: The module, with its members populated. )r.r/r0r1) Inspectorr get_module) r2r*r+r,r-r.r/r0r1r?g/var/www/html/karishye-ai-python/venv/lib/python3.10/site-packages/griffe/_internal/agents/inspector.pyinspect7s2 rAcseZdZdZ     dNdOfdd ZdPddZdQddZdRdSd"d#ZdTd$d%ZdTd&d'Z dTd(d)Z dTd*d+Z dTd,d-Z dTd.d/Z dTd0d1ZdTd2d3ZdTd4d5ZdTd6d7ZdTd8d9ZdTd:d;ZdTdd?ZdTd@dAZdRdUdDdEZdTdFdGZdTdHdIZdRdVdLdMZZS)Wr=zzThis class is used to instantiate an inspector. Inspectors iterate on objects members to extract data from them. Nr2r3r*r4r,rr-r7r.r8r/r9r0r:r1r;r<Nonec sdt||_ ||_ ||_ ||_ d|_ ||_ |p i|_ |p't |_ |p.t |_ dS)aInitialize the inspector. Parameters: module_name: The module name. filepath: The optional filepath. extensions: Extensions to use when inspecting. parent: The module parent. docstring_parser: The docstring parser to use. docstring_options: Docstring parsing options. lines_collection: A collection of source code lines. modules_collection: A collection of modules. N) super__init__r2r*r,r-currentr.r/r r0r r1) selfr2r*r,r-r.r/r0r1 __class__r?r@rD{s&    zInspector.__init__noder Docstring | NonecCshz t|jdd}Wn tyYdSw|durdSzt|}Wn ty*YdSwt||j|jdS)N__doc__)parserparser_options)getattrobj ExceptionrAttributeErrorrr.r/)rFrIvaluecleanedr?r?r@_get_docstrings"   zInspector._get_docstring#tuple[int, int] | tuple[None, None]c Cs^|jr |j|jvr dSz t|j\}}Wn ttfy YdSw||d|dfS)N)NN ) r*r0rrOOSError TypeErrorjoinrstripcount)rFrIlineslinenor?r?r@ _get_linenosszInspector._get_linenosr+r5rc Cs|j}|jdur|jjd|}t|pd}|jr>|jj}t|dD]}|j}q%|jjdkr4|j}||vr>|d|t ||}d}|jdur[|jj dD] }t d||d}qQt ||j|d}| ||j jS)a4Build and return the object representing the module attached to this inspector. This method triggers a complete inspection of the module members. Parameters: import_paths: Paths replacing `sys.path` to import the module. Returns: A module instance. N.r?rDr)namer-)r-)r2r-pathlistr*ranger\steminsertrsplitr rArEmodule) rFr+ import_path parent_path_rR parent_nodepart module_noder?r?r@r>s(       zInspector.get_modulecCst|d|j|j|dS)zpExtend the base inspection with extensions. Parameters: node: The node to inspect. inspect_N)rNkindgeneric_inspectrFrIr?r?r@rAszInspector.inspectc Cs|jD]f}|j}rd|jrI||jjd|jkrIt|jdsHt d|t |jd|jj |j |j |j|j|jd}|||j|j|jj qt|j|dd}|j|j||j jd|||d q||qdS) zxExtend the base generic inspection with extensions. Parameters: node: The node to inspect. r`__file__z;Module %s is not discoverable on disk, inspecting right nowN)r*r-r,r.r/r0r1dynamic)analysison_alias_instance)aliasrIagent)childrenalias_target_path is_modulerErbrahasattrrOrdebugr=rhr,r.r/r0r1inspect_module set_memberrcallrA)rFrIchild target_path inspectorrwr?r?r@rqs.      zInspector.generic_inspectc Cs|jjd||d|jjd||dt|j|j|j|||j|jdd|_ }|jjd|||d|jjd|||d | ||jjd |||d|jjd |||d d S) zVInspect a module. Parameters: node: The node to inspect. on_noderIrxon_module_nodert)rar*r- docstringr0r1ru on_instancerIrOrxon_module_instance)rImodrx on_memberson_module_membersN) r,rrr2r*r-rTr0r1rErq)rFrIrhr?r?r@r~,s    zInspector.inspect_modulec Cs|jjd||d|jjd||dg}|jjD]}|turq||jd|jq||\}}t |j | ||t t |j|j|j d||dd}|j|j |||_|jjd|||d |jjd |||d |||jjd |||d |jjd |||d |jj|_dS)zUInspect a class. Parameters: node: The node to inspect. rr on_class_noder`r-memberrt)rarbasestype_parametersr^ endlinenorurron_class_instance)rIclsrxron_class_membersN)r,rrO __bases__objectappend __module__ __qualname__r_rrarTr#_convert_type_parametersrErrqr-)rFrIrbaser^rclass_r?r?r@ inspect_classCs2   zInspector.inspect_classcC||dhdS)z]Inspect a static method. Parameters: node: The node to inspect. staticmethodNhandle_functionrrr?r?r@inspect_staticmethodezInspector.inspect_staticmethodcCr)z\Inspect a class method. Parameters: node: The node to inspect. classmethodNrrrr?r?r@inspect_classmethodmrzInspector.inspect_classmethodcCr)zaInspect a method descriptor. Parameters: node: The node to inspect. zmethod descriptorNrrrr?r?r@inspect_method_descriptorurz#Inspector.inspect_method_descriptorcCr)z^Inspect a builtin method. Parameters: node: The node to inspect. builtinNrrrr?r?r@inspect_builtin_method}rz Inspector.inspect_builtin_methodcC||dS)zVInspect a method. Parameters: node: The node to inspect. Nrrrr?r?r@inspect_methodzInspector.inspect_methodcCr)zYInspect a coroutine. Parameters: node: The node to inspect. asyncNrrrr?r?r@inspect_coroutinerzInspector.inspect_coroutinecCr)z`Inspect a builtin function. Parameters: node: The node to inspect. rNrrrr?r?r@inspect_builtin_functionrz"Inspector.inspect_builtin_functioncCr)zXInspect a function. Parameters: node: The node to inspect. Nrrrr?r?r@inspect_functionrzInspector.inspect_functioncCs||ddhdS)z_Inspect a cached property. Parameters: node: The node to inspect. cachedpropertyNrrrr?r?r@inspect_cached_propertysz!Inspector.inspect_cached_propertycCr)zXInspect a property. Parameters: node: The node to inspect. rNrrrr?r?r@inspect_propertyrzInspector.inspect_propertycCr)zbInspect a get/set descriptor. Parameters: node: The node to inspect. rNrrrr?r?r@inspect_getset_descriptorrz#Inspector.inspect_getset_descriptorlabels set | Nonec sljjddjjddztj}Wn ty&d}d}Yn"wtfdd|jD}|j}|t ur?dnt |j j d} \}}|pSt}d|vrhtj d|||d d } ntj ||ttjj j d||d d } | j|O_j j | jjd | d | jrjjd| ddSjjd| ddS)zHandle a function. Parameters: node: The node to inspect. labels: Labels to add to the data object. rron_function_nodeNcsg|] }t|jjdqSr)_convert_parameterrEra).0 parameterrIrFr?r@ sz-Inspector.handle_function..rrrt)rarR annotationrr^rru)ra parametersreturnsrrr^rrurron_attribute_instancerIattrrxon_function_instance)rIfuncrx)r,r getsignaturerOrPr rvaluesreturn_annotation_empty_convert_object_to_annotationrErar_setrrTrr#rrr is_attribute) rFrIrrrrrr^rrOr?rr@rs`     zInspector.handle_functionc Cs|jjd||d|jjd||d||\}}t|jt|jj|j|jd||t t |j|j|jd| ||jdd}|j |j||jjd|||d|jjd |||d d S) zZInspect a type alias. Parameters: node: The node to inspect. rron_type_alias_noderrt)rarRr^rrrr-rurron_type_alias_instance)rI type_aliasrxN) r,rr_r!ra_convert_type_to_annotationrO __value__rEr#rrTr)rFrIr^rrr?r?r@inspect_type_aliass  zInspector.inspect_type_aliascCr)zZInspect an attribute. Parameters: node: The node to inspect. N)handle_attributerrr?r?r@inspect_attributerzInspector.inspect_attributerstr | Expr | NonecCsH|jjd||d|jjd||d|j}t}|jtjur$|dn!|jtjur0|dn|jtj urE|j dkr=dS|j }|dzt |j }Wn tyWd}Ynwz||}Wn tyjd}Ynwt|j |||d d }|j|O_||j ||j d krt|j |_|jjd |||d |jjd|||ddS)zHandle an attribute. Parameters: node: The node to inspect. annotation: A potential annotation. rron_attribute_nodezmodule-attributezclass-attributerDNzinstance-attributert)rarRrrru__all__rrrr)r,rrErrprMODULEaddCLASSFUNCTIONrar-reprrOrPrTrrrrcexports)rFrIrr-rrRr attributer?r?r@r sH           zInspector.handle_attribute)NNNNN)r2r3r*r4r,rr-r7r.r8r/r9r0r:r1r;r<rB)rIr r<rJ)rIr r<rU)N)r+r5r<r)rIr r<rB)rIr rrr<rB)rIr rrr<rB)__name__rrrKrDrTr_r>rArqr~rrrrrrrrrrrrrrrr __classcell__r?r?rGr@r=us<  4  0  %  "            B r=rrSignatureParameterModule | Classr str | NonercCsn|j}|jtur dnt|j||d}t|j}|jturd}nt|jdr*|jj}nt |j}t ||||dS)Nrr)rrpdefault) rarrr_parameter_kind_maprprr|rrr)rr-rrarrprr?r?r@rZs      rrOr rcCszt|tr|}nt|}t|drd|vr|jn|}n|}z t|ddtjdd}Wn ty4|YSwt |j ||dS)Nr<evalz<>)modefilenameflagsoptimizer) isinstancer3rr|rcompileast PyCF_ONLY_AST SyntaxErrorrbody)rOr-rrobj_reprannotation_noder?r?r@rqs   rcCs0i|]\}}tD] }t||rt|||qqSr?)r)r|rN)rrrRrhr?r?r@ s r)TypeVar TypeVarTuple ParamSpeclist[TypeParameter]c st|}t|ds gSg}|jD]H}t|dd}|dur#t|d}fddt|ddD}t|dd d rCt|jd}nd}|t|jt t |||pSd|d q|S) N__type_params__ __bound__rcg|] }t|dqSrr)r constraintrr-r?r@rs z,_convert_type_parameters..__constraints__r? has_defaultcSsdS)NFr?r?r?r?r@sz*_convert_type_parameters..)rpbound constraintsr) rr|rrNr __default__rr"r_type_parameter_kind_maptype)rOr-rrtype_parameterrrrr?rr@rs8       rcst|}|durt|dSfddt|D}|tjur*tdd|St|d}|dur7dSt |t |ddS)Nrcrrr)rargrr?r@rsz/_convert_type_to_annotation..cSs t|d|S)N|)r)leftrightr?r?r@rs z-_convert_type_to_annotation..T)implicit) typing get_originrget_argstypes UnionType functoolsreducerrr)rOr-roriginargsr?rr@rs   r)r2r3r*r4r+r5r,r6r-r7r.r8r/r9r0r:r1r;r<r)rrr-rrrr<r)rOr r-rrrr<r)rOr r-rrrr<r)V __future__rrrsysrrrArrrrrrrrr r %griffe._internal.agents.nodes.runtimer griffe._internal.collectionsr r griffe._internal.enumerationsrrrgriffe._internal.expressionsrrrrr griffe._internal.extensions.baserrgriffe._internal.importerrgriffe._internal.loggerrgriffe._internal.modelsrrrrrrr r!r"r#collections.abcr$pathlibr%#griffe._internal.docstrings.parsersr&r'r(__annotations__typing_extensions ImportErrorr)emptyrr=POSITIONAL_ONLYpositional_onlyPOSITIONAL_OR_KEYWORDpositional_or_keywordVAR_POSITIONALvar_positional KEYWORD_ONLY keyword_only VAR_KEYWORD var_keywordrrrtype_vartype_var_tuple param_specitemsr rrr?r?r?r@s~     4      >` +