o i@sUdZddgZddlmZddlmZddlmZddlZddl Z ddlZddl Z ddl Z ddl Z ddlZddlZddlZddlmZmZmZmZmZmZejd krYdd lmZndd lmZdd lmZdd lmZdd lm Z ddl!m"Z"ddl!m#Z#ddl$m%Z%ddl&m'Z'ddl(m)Z)ddl*m+Z+ddl*m,Z,ddl-m.Z.m/Z/m0Z0ddl1m2Z2ddl3m4Z4ddl5m6Z6ddl7m8Z8ddl9m:Z:ddl;meee>e>ffZ?ee@d<ee>e>fZAee@d<eGdd d ZBd!d"ZCejDjEjZFeGjHjZId#d$ejJejKejDeLfDZMeNeOZPeNe>jQZRe.ZSe"jTZUgd%ZVd&d'ZWd(d)ZXd*ee>dffd+d,ZYdBd*ee>dffd.d/ZZd0d1Z[e6d2d3Z\e6d4d5Z]e6dCd7d8Z^d9d:Z_d*e>fd;d<Z`d=d>ZaGd?dde4Zbd*e>fd@dAZcdS)DzTools for inspecting Python objects. Uses syntax highlighting for presenting the various information elements. Similar in spirit to the inspect module, but all calls take a name argument to reference the name under which an object is being read. Inspector InspectColors) dataclass) signature)dedentN)AnyOptionalDictUnionListTuple) ) TypeAlias)page)pretty) skip_doctest) PyColorize)openpy) safe_hasattr) compress_user)indent)list_namespace) typestr2type) TermColors ColorSchemeColorSchemeTable) cast_unicode) Colorable)undoc) highlight) PythonLexer) HtmlFormatter__custom_documentations__UnformattedBundleBundlec@sJeZdZUeed<eed<eed<eeed<eed<eed<ddZd S) OInfoismagicisaliasfound namespaceparentobjcCs t||S)zGet a field from the object for backward compatibility with before 8.12 see https://github.com/h5py/h5py/issues/2253 )getattr)selffieldr0P/var/www/edux/Edux_v2/venv/lib/python3.10/site-packages/IPython/core/oinspect.pygetHs z OInfo.getN) __name__ __module__ __qualname__bool__annotations__rstrrr2r0r0r0r1r&?s   r&cCst|ttddS)NT) noclasses)r r!r")coder0r0r1pylightYsr;cCsh|]}t|qSr0)inspectgetdoc).0tr0r0r1 _s r@) type_name base_class string_formr*lengthfile definition docstringsourceinit_definitionclass_docstringinit_docstringcall_defcall_docstringr'r(isclassr)namecKsddtD}|||S)z1Make an object info dict with all fields present.cSsi|]}|dqSNr0)r>kr0r0r1 ~zobject_info..) info_fieldsupdate)kwinfodictr0r0r1 object_info|s rXcCstt|}|dur dS|drdStj|sdSt|d}t|j \}}Wd|S1s3wY|S)znGet encoding for python source file defining obj Returns None if obj is not defined in a sourcefile. Nz.soz.dllz.pydrb) find_fileendswithospathisfile stdlib_ioopenrdetect_encodingreadline)r,ofilebufferencodinglinesr0r0r1 get_encodings   rhreturncCsBz|}Wn tyYn wt|trt|St|}|S)a=Stable wrapper around inspect.getdoc. This can't crash because of attribute problems. It also attempts to call a getdoc() method on the given object. This allows objects which provide their docstrings via non-standard mechanisms (like Pyro proxies) to still be inspected by ipython's ? system. )r= Exception isinstancer8r<cleandoc)r,dsdocstrr0r0r1r=s     r=c Cst|trTg}dD]A}t||}|durJt|}|rd|nd}|dd||ft|r>t|}|r=|t |q |d||t |fq |rRd|SdSt |}zt|}W|St yz t|j }WY|Stt fy~YYdSwtyYdSw)alWrapper around inspect.getsource. This can be modified by other projects to provide customized source extraction. Parameters ---------- obj : object an object whose source code we will attempt to extract oname : str (optional) a name under which the object is known Returns ------- src : unicode or None )fgetfsetfdelNz%s.roz# z %s%s = %s  )rkpropertyr-rhappendjoinr< isfunction getsourcerr _get_wrapped TypeError __class__OSError) r,onamesourcesattrnamefnrf oname_prefix_srcsrcr0r0r1rxsD       rxcCs(t|pt|pt|tpt|tS)zTrue if obj is a function ())r<rwismethodrk_builtin_func_type_builtin_meth_typer,r0r0r1is_simple_callables rcCs2tjdtddt|drt|s|j}t|S)zWrapper around :func:`inspect.getfullargspec` In addition to functions and methods, this can also handle objects with a ``__call__`` attribute. DEPRECATED: Deprecated since 7.10. Do not use, will be removed. z]`getargspec` function is deprecated as of IPython 7.10and will be removed in future versions. stacklevel__call__)warningswarnDeprecationWarningrrrr<getfullargspecrr0r0r1 getargspecs   rcCs0tjdtddt|d|d|d|dS)a Format argspect, convenience wrapper around inspect's. This takes a dict instead of ordered arguments and calls inspect.format_argspec with the arguments in the necessary order. DEPRECATED (since 7.10): Do not use; will be removed in future versions. za`format_argspec` function is deprecated as of IPython 7.10and will be removed in future versions.rrargsvarargsvarkwdefaults)rrrr< formatargspec)argspecr0r0r1format_argspecs   rTc Cstjdtdd|d}|durd}n*z |dddk}Wn ttfy)Yn w|r6|dd d|d<|d t|}|d }|durL|d }|durV|d d}||fS)z?DEPRECATED since 6.0. Extract call tip data from an oinfo dict.zZ`call_tip` function is deprecated as of IPython 6.0and will be removed in future versions.rrrNrrr.rOrMrKrGro)rrrr2KeyError IndexErrorr)oinfo format_callr call_linehas_selfdocr0r0r1call_tips,    rcCs:|}d}t|dr|j}|d7}|dkr|St|ds |S)aNGet the original object if wrapped in one or more @decorators Some objects automatically construct similar objects on any unrecognised attribute access (e.g. unittest.mock.call). To protect against infinite loops, this will arbitrarily cut off after 100 levels of obj.__wrapped__ attribute access. --TK, Jan 2016 r __wrapped__rd)rr)r,orig_objir0r0r1ry<s  ryc Cst|}d}z t|}Wt|Sty5zt|j}Wn ttfy*YnwYt|SYt|Sty@Yt|Sw)a^Find the absolute path to the file where an object was defined. This is essentially a robust wrapper around `inspect.getabsfile`. Returns None if no file can be found. Parameters ---------- obj : any Python object Returns ------- fname : str The absolute path to the file where the object was defined. N)ryr< getabsfilerzr{r|r)r,fnamer0r0r1r[Ns&   r[c Csrt|}z t|d}W|Sty/z t|jd}WY|Sttfy.YYdSwty8YdSw)aWFind the line number in a file where an object was defined. This is essentially a robust wrapper around `inspect.getsourcelines`. Returns None if no file can be found. Parameters ---------- obj : any Python object Returns ------- lineno : int The line number where the object definition starts. rN)ryr<getsourcelinesrzr{r|)r,linenor0r0r1find_source_linesqs  rc sfeZdZeejddddffdd Zd6deedffddZ defd d Z d d Z d dZ d6ddZ ed7ddZd6ddZd6ddZd8dedefddZdedefddZdededefdd Zdefd!d"Z     #d9d$ed%ed&eedefd'd(Z     ) #d:d&eefd*d+Zd;d,d-Zd;deeeffd.d/Z e!d0d1Z"gd2d2fd2d3d4d5Z#Z$S)`` tag containing the input text. - if ``formatter`` is not None, it must be a callable transforming the input text into a mime bundle. Default values for ``text/plain`` and ``text/html`` representations are the ones described above. Note: Formatters returning strings are supported but this behavior is deprecated. z
z
 text/plain text/htmlN)htmlescaperkdict)r.rrr formattedr0r0r1 _mime_format0s zInspector._mime_formatbundlec Cs>t|dts J|dD] }t|tsJq i}g}tdd|dD}|dD])\}}|d}d|vr9dnd}|||d|t|d||q*d||d<d|vrt|dtshJ|dD] }t|tsuJqlt|dttfrddd|dD|d<| D] } | d vrq|| }q|S) zRFormat a mimebundle being created by _make_info_unformatted into a real mimebundlercss|] \}}t|VqdSrPlen)r>r_r0r0r1 [z(Inspector.format_mime..rsr:rcss$|] \}}d|d|VqdS)z

z

Nr0)r>rbodyr0r0r1rns")rr) rklisttuplemaxstriprurrrvkeys) r.ritemnew_brg_lenrrdelimrQr0r0r1 format_mimeRs4  (   zInspector.format_mimetitlekeyc Csd||vs||vr dS||}|dur0|||}|d||df|d||dfdSdS)z^Append an info value to the unformatted mimebundle being constructed by _make_info_unformattedNrr)rru) r.rrrinfo omit_sectionsrr/formatted_fieldr0r0r1_append_info_fieldxs  zInspector._append_info_fieldc sggd} d-dtdtdtffdd }dtffd d }d r+||d d |SdrJ|dkr;||dd|n||dd|||dd|SdsRt|r||dd|||dd|||dd||dkrwdrw||dd|n||dd|||dd||dd||dd |S||dd|||d!d"|||dd||d#d d$d%kr||d&d$||d'd(||dd|dkrԈdr||dd|n||dd|||d)d*|||dd|||d+d,||S).z;Assemble the mimebundle as unformatted lists of informationrNrrrcsj||||ddS)N)rrrrr)r)rrrrrrr.r0r1 append_fields z6Inspector._make_info_unformatted..append_fieldrics|t|dS)Nr)rr;)r)r.r0r1code_formattersz8Inspector._make_info_unformatted..code_formatterr(ReprrCr'rSourcerH DocstringrGFilerErN SignaturerFzInit signaturerIzInit docstringrKTyperA Subclasses subclasseszCall signaturerLz String formr* Interactive NamespaceLengthrDzClass docstringrJzCall docstringrMrP)r$r8r%r) r.r,rr detail_levelrrrrr0rr1_make_info_unformatteds^  / (         z Inspector._make_info_unformattedr0r,r}rc Cs0|j||||d}|j|||||d}||S)a9Retrieve an info dict and format it. Parameters ---------- obj : any Object to inspect and return info from oname : str (default: ''): Name of the variable pointing to `obj`. formatter : callable info already computed information detail_level : integer Granularity of detail level, if set to 1, give more information. omit_sections : container[str] Titles or keys to omit from output (can be set, tuple, etc., anything supporting `in`) r}rr)rr)rrr) r.r,r}rrrr info_dictrr0r0r1 _get_infos zInspector._get_infoTc Cs:|dusJ|j||||||d}|s|d=t|dS)a Show detailed information about an object. Optional arguments: - oname: name of the variable pointing to the object. - formatter: callable (optional) A special formatter for docstrings. The formatter is a callable that takes a string as an input and returns either a formatted string or a mime type bundle in the form of a dictionary. Although the support of custom formatter returning a string instead of a mime type bundle is deprecated. - info: a structure with some information fields which may have been precomputed already. - detail_level: if set to 1, more information is given. - omit_sections: set of section keys and titles to omit N)rr)r r) r.r,r}rrrenable_html_pagerrinfo_br0r0r1pinfos ! zInspector.pinfocCs"tjdtdd|j||||dS)z Inspector.info() was likely improperly marked as deprecated while only a parameter was deprecated. We "un-deprecate" it. zThe `Inspector.info()` method has been un-deprecated as of 8.0 and the `formatter=` keyword removed. `Inspector._info` is now an alias, and you can just call `.info()` directly.rrr)rrrr)r.r,r}rrr0r0r1_info&s zInspector._infoc!Cs |dur d}d}d}n |j}|j}|j}|dd}d} d} |r8|jdur8t|jtr8t|jt} | |d} t |d||dd} | rF| } n8|rqt |s`zd|d } Wn)d t |} Ynd t |} |j rp| d |j 7} n t |}|dur|d } n|} | | } d}t|dd}|rd| d<n|rd| d<nt|j| d<z |j}t || d<WnY||jkrz8t |}d}|st||kr|d|d|| d}ddt|dd|dD}|| |<WnY|r|| d<z t t|| d<Wn ty Ynwd}t|}|durd}n|dr%d}n|dr-d}t|| d <|rbtzt|tsD|sVt||}|durR|}|| d!<Wn tyaYnw| rs| | d!| ss| | d"<t!"|rd| d#<z|#||}Wn t$yd}Ynwz|j%}Wn t$yd}Yn$w|durz|#||}Wn t$yYnwt |}|t&krd}|r|| d$<|r|| d%<d&d't'|D}t|d(krd)|}n d)|dd(d*g}|| d+<n|#||}|r || d,<| r3zt|d-}Wnd}Ynt |}|t(vr'd}|r3| |kr3|| d.<zt |j%}|t&kr@d}Wn t$yMd}Ynw|rU|| d%<t)|d/rt*|s|#|j+|}|rv|| d,krv|| d0<t |j+} | t,krd} | r| | d1<t-d2i| S)3aCompute a dict with detailed information about an object. Parameters ---------- obj : any An object to find information about oname : str (default: '') Name of the variable pointing to `obj`. info : (default: None) A struct (dict like with attr access) with some information fields which may have been precomputed already. detail_level : int (default:0) If set to 1, more information is given. Returns ------- An object info dict with known fields from `info_fields`. Keys are strings, values are string or None. NFro.T)rOr)r(r'rz!Alias to the system command: %srzAlias: z Alias to z Docstring: zrzMagic functionrAz System aliasrBrCz <...> rsrcss|]}|VqdSrP)r)r>qr0r0r1rsz!Inspector.info..r*rDrYzz9Dynamically generated function. No source code available.rErHrGrNrIrKcSsg|]}|jqSr0)r3)r>subr0r0r1 rSz"Inspector.info..r, z...rrFr{rJrrLrMr0).r'r(r*splitr+r HOOK_NAMEr-r2rrr8__doc__r=inttyper3r{rr expandtabsrvrjr[r\rrrrkrtrxrstrip_source_contains_docstringr<rNrAttributeErrorr_object_init_docstring__subclasses___builtin_type_docstringsrrr_func_call_docstringrX)!r.r,r}rrr'r(ospaceatt_name parents_docspreludeparents_docs_dictrrm ds_or_None string_maxshalfbclassostrstr_head binary_filerrinit_defobj_initrnames all_namesdeflnclsclass_dsrLrr0r0r1r5s,                          zInspector.infocCs8ztt|j\}t||kWStyYdSw)z Check whether the source *src* contains the docstring *doc*. This is is helper function to skip displaying the docstring if the source already contains it, avoiding repetition of information. F)astparserr get_docstringrj)rrdef_noder0r0r1rs  z$Inspector._source_contains_docstringF) list_typescCsd}d}|rtdttdS|} t| } | dkr#| d}n| dkr,| \}}ntd||D]} | |vrDtd | |fq4tt} } |D]"}||}t || vr[qN| t |t |||||d }| |qNtdt| dS) aSearch namespaces with wildcards for objects. Arguments: - pattern: string containing shell-like wildcards to use in namespace searches and optionally a type specification to narrow the search to objects of that type. - ns_table: dict of name->namespaces for search. Optional arguments: - ns_search: list of namespace names to include in search. - ignore_case(False): make the search case-insensitive. - show_all(False): show all names, including those starting with underscores. - list_types(False): list all available object types for object matching. allrorsNrrrz)invalid argument string for psearch: <%s>z'invalid namespace <%s>. Valid names: %s) ignore_caseshow_all) rrvsortedrrr ValueErrorrsetidaddrrU)r.patternns_table ns_searchr=r>r; type_patternfiltercmdslen_cmdsrO search_resultnamespaces_seenns_namenstmp_resr0r0r1psearch(s>     zInspector.psearchro)roNrP)roNNrr0)roNNrTr0)roNr)%r3r4r5rrANSICodeColorsrr r8rrrrrrrrrrrr$r%rrrrrr&r r rr r staticmethodrrP __classcell__r0r0rr1rsz     9 "&  R ' )c cCs g}d}d}|jD]6}|jtjjkrd}n |r |dd}|jtjjkr*d}n|jtjjkr:|r:|dd}|t |q |rI|dt |t dd|Ddkrgd |d d d|D}n d |d |}|jtjurt|j}|d |7}|S)z This was mostly taken from inspect.Signature.__str__. Look there for the comments. The only change is to add linebreaks when this gets too long. FT/*css|] }t|dVqdS)rNrr>rr0r0r1rrz$_render_signature..Kz{}( {})rocss|]}d|VqdS)z {}, N)rrWr0r0r1rs  z{}({})rz -> {}) parametersvalueskindr< ParameterPOSITIONAL_ONLYruVAR_POSITIONAL KEYWORD_ONLYr8rsumrrvreturn_annotation_emptyformatannotation) obj_signatureobj_nameresultpos_onlykw_onlyparamrenderedannor0r0r1rks4      rrQ)T)dr__all__ dataclassesrr<rtextwraprr7rior`rr]systypesrtypingrrr r r r version_infotyping_extensionsr IPython.corerIPython.lib.prettyrIPython.testing.skipdoctestr IPython.utilsrrIPython.utils.dir2rIPython.utils.pathrIPython.utils.textrIPython.utils.wildcardrrIPython.utils.coloransirrrIPython.utils.py3compatrIPython.utils.colorablerIPython.utils.decoratorsrpygmentsr pygments.lexersr!pygments.formattersr"rr8r$r7r%r&r; FunctionTyperr#objectrr  ModuleType MethodTypertr"rr<rupperrColorsrRrrTrXrhr=rxrrrrryr[rrrr0r0r0r1s                          ?   %#`