B j]\w/@s\dZddlmZddlZddlZddlmZmZmZm Z m Z m Z m Z m Z dZd)ddZd d Zd d Zd dZddZeZddZddZddZddZd*ddZd+ddZedkrXGdd d eZeeejeeej eed!dd"eed#eed$dd"eed%eed&eed'eed(eee!eee!dS),z,Utilities and wrappers around inspect module)print_functionN)is_text_stringbuiltins get_meth_funcget_meth_class_instget_meth_classget_func_defaultsto_text_stringPY2z[^\'\"a-zA-Z0-9_.]FcCsd}x@dD]8\}}||r ||}|r ||d}|d|}q Wtt|}d}yxx |dksntt|rx|}qZW|dr|dd}|drdS|r||||t|7}||7}|r|SWnt k rdSXdS)z+Return the last valid object name in string)z[]z()N.) endswithrfindresplitSYMBOLSmatchpop startswithlen IndexError)ZtxtZlastZtxt_endZ startcharZendcharpostokenstokenr>lib/python3.7/site-packages/spyder_kernels/utils/dochelpers.pygetobjs.        rcCsddt|DS)z For standard objects, will simply return dir(obj) In special cases (e.g. WrapITK package), will return only string elements of result returned by dir(obj) cSsg|]}t|r|qSr)r).0itemrrr <szgetobjdir..)dir)objrrr getobjdir6sr#c Cs(t|pt|pd}y t|}Wn YnXddd|d}t|r$y |j}Wntk rp||d<|SXt|rt|}t |dk rdt |j j|d<nd|j|d<t |}n"t |drd |j |d<nd |d<|j|d <t|rtr,t|\}}}}tj||||d d d|d<n:t|\}}}}} } } tj||||| | | dd d|d<|dkr|d|d <|ddd|d<nrt|d} | r| |d<|d |d} |dd}|d}|| kr|d| dd|d<nd|d<|d} | dddd|d<|S)ac Return text documentation from an object. This comes in a form of dictionary with four keys: name: The name of the inspected object argspec: It's argspec note: A phrase describing the type of object (function or method) we are inspecting, and the module it belongs to. docstring: It's docstring r )nameargspecnote docstringr'NzMethod of %s instancer&zUnbound %s method __module__zFunction of %s moduleZFunctionr$cSs dt|S)N=)repr)orrryszgetdoc..)Z formatvaluer%cSs dt|S)Nr))r*)r+rrrr,szz lambda r z rz(...)z(self)z()z(self, ()inspectgetdocZ getcommentsr callable__name__AttributeErrorismethodrr __class__rhasattrr( isfunctionr Z getargspecZ formatargspecZgetfullargspecgetargspecfromtextrstripreplacelstrip)r"r'docr$ZimclassargsZvarargsZvarkwdefaultsZ kwonlyargsZkwonlydefaultsZ annotationsr% signatureZdocstring_blocks first_blockrrrr0?sh                r0c CsnyPytt|}Wn8tk rLt|dr@tt|j}nt|}YnX|Sttfk rhdSXdS)z Wrapper around inspect.getsourcer5N)r r/ getsource TypeErrorr6r5r0IOError)r"srcrrrrAs rAcCs|t|tr|dd}|d}|d}d}|s2d}t|d||}ddt|||D}||}|rt|d SdSd S) zGet object signatures from text (object documentation) Return a list containing a single string in most cases Example of multiple signatures: PyQt5 objectsr'r z!\([^\)].+?(?<=[\w\]\}\'"])\)(?!,)z\([^\)]+(?<=[\w\]\}\'"])\)(?!,)z((%s\([^\)]+(\),\n.+)+(?<=[\w\]\}\'"])\))|cSsg|] }|dqS)rr)rgrrrr sz(getsignaturefromtext..rN) isinstancedictgetrfindall)textobjnameZ oneline_reZ multiline_reZmultiline_end_parenleft_reZsigs_1Zsigs_2Zall_sigsrrrgetsignaturefromtexts  rMcCs |d}|d}t|dS)z Try to get the formatted argspec of a callable from the first block of its docstring This will return something like '(foo, bar, k=1)' z rr )rr9rM)rKZblocksr@rrrr8s  r8cCs2t||}|r.||ddd}|dSdS)z.Get arguments from text (object documentation)r.r-r ,N)rMfindr)rKrLr?Zargtxtrrrgetargsfromtexts rPcCs|jdk rt|j|jSdS)zGet arguments from object docN)__doc__rPr2)r"rrrgetargsfromdocs rRc CsZt|st|r|}n8t|r.t|}n$t|rNt|drNt|d}ngSt|dsxt|}|dk rp|St|St |j \}}}|st|Sx0t |D]$\}}t |t rdd|||<qWt|}|dk rxindexdefaultrrrrXs8      ,  rXTcCst|}|rd}d}xpt|D]d\}}|dkr4dg}|d|7<|t|dkr|d|7<t|ddksx|r|dqWt|st|rt|dkrdSd||kr|d||SdS)z Get the names and default values of a function's arguments Return list with separators (', ') formatted for calltips z, Nr r r- rU)rXrYrappendr/rVr4r\)r"Zone_arg_per_liner=sepZtextlistr^r_rrr getargtxts$  rec Cs(|dkrt}|d}|d}t|dkr2dS|tjkr||kr|ry.t|t|}|tkrl|t|<|||<Wqtk rdSXndSx|D]}yt t ||| }Wnt t fk rdSX|r|ryt|d|t|Wnt t fk r dSXndS|d|7}qWdS)z_Return True if object is defined in namespace If namespace is None --> namespace = locals()Nr rFT)localsrrrr__dict__ __import__globals Exceptionr6eval SyntaxErrorr3 ImportError)r" force_import namespaceZ attr_listbasemoduleattrZattr_not_foundrrr isdefined's<       rs__main__c@seZdZdddZdS)TestcCsdS)Nr)rUxyrrrmethodNsz Test.methodN)rv)r2r( __qualname__ryrrrrruMsruz numpy.take)rnrhz.keysrizglobals().keysz+scipy.signal.z4.)F)T)FN)"rQZ __future__rr/rZspyder_kernels.py3compatrrrrrrr r rrr#r0rArMZgetsignaturesfromtextr8rPrRrXrersr2objectruprintrSrysortedrrrr s< (  a '  %