gT nddlmZddlZddlmZddlmZmZmZddlm Z ddl m Z m Z ddlmZddlmZmZdd lmZmZdd lmZdd lmZmZdd lmZdd lmZddlm Z m!Z!m"Z"m#Z#m$Z$m%Z%mZm&Z&e rddl'm(Z(ddl)m*Z*ddlm+Z+ddlm,Z,ejZZ.ddddddddd ddZGddZ/ej`ejbejdejfejhejjejlejnejpejriZ:ddZ;ddZd 'o')+)- j ceZdZdZ d dfd ZddZddZdddZddZddZ ddZ dd Z dd Z dd Z dd Zdd ZddZddZddZddZddZddZdddZddZdddZxZS) r)zzThis class is used to instantiate an inspector. Inspectors iterate on objects members to extract data from them. c t |||_ ||_ ||_ ||_ d|_ ||_ |xsi|_ |xs t|_ |xs t|_ y)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: The docstring parsing options. lines_collection: A collection of source code lines. modules_collection: A collection of modules. N) super__init__r+r r"r#currentr$r%r r&r r') selfr+r r"r#r$r%r&r' __class__s r,r2zInspector.__init__ds.  +%- #&04%+ ='+ 1/?*1B1Hb,1A1V_EV05G5^K\K^&r.c t|jdd}|y t|}t ||j |jS#t$rYywxYw#t$rYywxYw)N__doc__)parserparser_options)getattrobj ExceptionrAttributeErrorrr$r%)r4nodevaluecleaneds r,_get_docstringzInspector._get_docstrings~ DHHi6E = uoG ((11      s"A A AA A%$A%c|jr|j|jvry t|j\}}||dj |jjdzfS#tt f$rYywxYw)N)NN ) r r&rr;OSError TypeErrorjoinrstripcount)r4r>lineslinenos r, _get_linenoszInspector._get_linenoss{}} T5J5J J *4884ME6v 5 5 7 = =d CCCC#  sA22BBc|j}|j|jjd|}t|xsd}|jr||jj}t |j dD]}|j}|jjdk(r |j}||vr|jd|t||}d}|j8|jjjdD]}td||}t||j|}|j||jjS)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.r2r)namer#r#)r+r#pathlistr rangerIsteminsertrsplitr r-r3module) r4r! import_path parent_path_r? parent_nodepart module_nodes r,r*zInspector.get_modules3&& ;; "![[--.a }=KL.B/  ==--..K;,,S12)00 3}}!!Z/)00 ,.##A{3{L9  ;; " ((..s3(DM 4 (8(8M  [!||"""r.cXt|d|j|j|y)zpExtend the base inspection with extensions. Parameters: node: The node to inspect. inspect_N)r:kindgeneric_inspectr4r>s r,r-zInspector.inspects) D ,d.B.BCDIr.c H|jD]}|jx}ro|jr||jjd|j k(rt |jdr_tjd|t|j d|jj|j|j|j|j|j }|j#||jj%|j |jj%t'|j |}|jj%|j ||jj)d||||j+|y)zxExtend the base generic inspection with extensions. Parameters: node: The node to inspect. rN__file__z;Module %s is not discoverable on disk, inspecting right nowN)r r#r"r$r%r&r'on_alias)aliasr>agent)childrenalias_target_path is_moduler3rRrPhasattrr;rdebugr)rXr"r$r%r&r'inspect_module set_memberrcallr-)r4r>child target_path inspectorrgs r,rbzInspector.generic_inspects= ]]E#555{5??{9J9J8K1UZZL6Y'Y"599j9 %bdop$-!JJ%)#'<<#6#6'+-1-B-B.2.D.D-1-B-B/3/F/F % "007 // IOO((5tSW(X U#;#r.cH|jjd|||jjd||t|j|j|j |j ||j|jx|_ }|jjd||||jjd||||j||jjd ||||jjd |||y ) zVInspect a module. Parameters: node: The node to inspect. on_noder>rhon_module_node)rPr r# docstringr&r' on_instancer>r;rhon_module_instance)r>modrh on_memberson_module_membersN) r"rprr+r r#rAr&r'r3rb)r4r>rXs r,rnzInspector.inspect_modules YT> -DE &!!]];;))$/!22#66 !   v ]6N 1&PTU T" \&M 0ttTr.c@|jjd|||jjd||g}|jjD]5}|tur |j |j d|j7|j|\}}t|j|j||||}|jj|j|||_ |jjd||||jjd||| |j||jjd ||||jjd ||| |jj|_ y ) zUInspect a class. Parameters: node: The node to inspect. rurv on_class_noderN)rPrxbasesrK endlinenoryrzon_class_instance)r>clsrhr}on_class_membersN)r"rpr; __bases__objectappend __module__ __qualname__rLrrPrAr3rorbr#)r4r>rbaserKrclass_s r, inspect_classzInspector.inspect_class+si YT> _4tDHH&&Dv~ LLDOO,Ad.?.?-@A B' !--d3 ))$/    62  ]6N 0ttT T" \&M /ddS||** r.c*|j|dhy)z]Inspect a static method. Parameters: node: The node to inspect. staticmethodNhandle_functionrcs r,inspect_staticmethodzInspector.inspect_staticmethodKs TN#34r.c*|j|dhy)z\Inspect a class method. Parameters: node: The node to inspect. classmethodNrrcs r,inspect_classmethodzInspector.inspect_classmethodSs TM?3r.c*|j|dhy)zaInspect a method descriptor. Parameters: node: The node to inspect. zmethod descriptorNrrcs r,inspect_method_descriptorz#Inspector.inspect_method_descriptor[s T$7#89r.c*|j|dhy)z^Inspect a builtin method. Parameters: node: The node to inspect. builtinNrrcs r,inspect_builtin_methodz Inspector.inspect_builtin_methodc TI;/r.c&|j|y)zVInspect a method. Parameters: node: The node to inspect. Nrrcs r,inspect_methodzInspector.inspect_methodk T"r.c*|j|dhy)zYInspect a coroutine. Parameters: node: The node to inspect. asyncNrrcs r,inspect_coroutinezInspector.inspect_coroutiness TG9-r.c*|j|dhy)z`Inspect a builtin function. Parameters: node: The node to inspect. rNrrcs r,inspect_builtin_functionz"Inspector.inspect_builtin_function{rr.c&|j|y)zXInspect a function. Parameters: node: The node to inspect. Nrrcs r,inspect_functionzInspector.inspect_functionrr.c,|j|ddhy)z_Inspect a cached property. Parameters: node: The node to inspect. cachedpropertyNrrcs r,inspect_cached_propertyz!Inspector.inspect_cached_propertys THj#9:r.c*|j|dhy)zXInspect a property. Parameters: node: The node to inspect. rNrrcs r,inspect_propertyzInspector.inspect_propertys TJ<0r.c |jjd|||jjd|| t|j}t |j j Dcgc]}t||jc}}|j}|turdnt||j}|j|\}} |xs t}d|vr+t|j d||j#||| } n*t%|j |||j#||| } | xj&|zc_|jj)|j | |jjd || | | j*r |jjd || | y|jjd || |ycc}w#t$rd}d}Y6wxYw)zHandle a function. Parameters: node: The node to inspect. labels: Labels to add to the data object. rurvon_function_noderQNr)rPr? annotationrxrKr)rP parametersreturnsrxrKrryrzon_attribute_instancer>attrrhon_function_instance)r>funcrh)r"rp getsignaturer;rrvalues_convert_parameterr3return_annotation_empty_convert_object_to_annotationr<rLsetrrPrArlabelsro is_attribute) r4r>rr parameterrrrrKrr;s r,rzInspector.handle_functions YT> /d$G $TXX.I$V_VjVjVqVqVstVs$Yt||DVstJ!* ; ; %.23DT\\Z  !--d3 35  YY"--d3# CYY%--d3# C f   3/ ]3dK    OO !8t#UY Z OO !7dTX YKu JG  sG)4G$) G:9G:c&|j|y)zZInspect an attribute. Parameters: node: The node to inspect. N)handle_attributercs r,inspect_attributezInspector.inspect_attributes d#r.c|jjd|||jjd|||j}t}|jt j ur|jdnw|jt jur|jdnI|jt jur-|jdk7ry|j}|jd t|j} |j|}t!|j||| }|xj"|zc_|j%|j||jd k(rt|j|_|jjd ||| |jjd |||y#t$rd}YwxYw#t$rd}YwxYw)zHandle an attribute. Parameters: node: The node to inspect. annotation: A potential annotation. rurvon_attribute_noderXclassr2Ninstance)rPr?rrx__all__ryrzrr)r"rpr3rrarMODULEaddCLASSFUNCTIONrPr#reprr;r<rArrroexports)r4r>rr#rr?rx attributes r,rzInspector.handle_attributes YT> 0t4H5 ;;$++ % JJx [[DJJ & JJw  [[DMM ){{j(]]F JJz " NE ++D1I!  F"$))Y/ 99 ! ]FN ]9DQ 44iW[\' E  I s$9GG# G G # G10G1)NNNNN)r+strr Path | Noner"rr# Module | Noner$ Parser | Noner%dict[str, Any] | Noner&LinesCollection | Noner'ModulesCollection | NonereturnNone)r>r rzDocstring | None)r>r rz#tuple[int, int] | tuple[None, None])N)r!Sequence[str | Path] | Nonerr)r>r rr)r>r rz set | Nonerr)r>r rstr | Expr | Nonerr)__name__rrr7r2rArLr*r-rbrnrrrrrrrrrrrrrr __classcell__)r5s@r,r)r)^s!%*.37377;2'2'2' 2'  2' ( 2'12'12'52' 2'h ,D.#`J#$JU,+@54:0#.0#;18Zt$-]-]r.r)cb|j}|jturdnt|j|}t|j }|j turd}nBt|j dr|j j}nt|j }t||||S)NrQr)rradefault) rPrrr _kind_maprarrlrrr)rr#rPrrars r,rrs >>D$$.4QR[RfRfou4v Y^^ $DF" ""J /##,,y(() TjtW MMr.ct|ts$t|dr |j}n t |} t |ddt jd}t|j|S#t$r|cYSwxYw)Nrevalz<>)modefilenameflagsoptimizerQ) isinstancerrlrrcompileast PyCF_ONLY_AST SyntaxErrorrbody)r;r#annotation_nodes r,rr&su c3  3 #,,Cs)C!#FTIZIZefg 33F CC  sA++ A98A9)r+rr rr!rr"zExtensions | Noner#rr$rr%rr&rr'rrr)rSignatureParameterr#Module | Classrr)r;r r#rrr)= __future__rrr-rrrrrrrtypingr r _griffe.agents.nodes.runtimer _griffe.collectionsr r _griffe.enumerationsrr_griffe.expressionsr_griffe.extensions.baserr_griffe.importerr_griffe.loggerr_griffe.modelsrrrrrrrcollections.abcrpathlibrrremptyrr)POSITIONAL_ONLYpositional_onlyPOSITIONAL_OR_KEYWORDpositional_or_keywordVAR_POSITIONALvar_positional KEYWORD_ONLY keyword_only VAR_KEYWORD var_keywordrrrrOr.r,rsO# 377-%3B43?+!fff(+(  !04$( &*/3/337;;;. ; " ;  ;$;-;-;1; ;|l]l]` && (E(E,,m.Q.Q%%}'C'C##]%?%?""M$=$=    N Dr.