fUdZddgZddlmZddlmZddlmZddlZddl Z ddlZddl Z ddl Z ddl Z ddlZddlZddlZddlmZmZmZmZmZmZej0d krdd 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 ZBd!ZCejjjZFeGjjZIejejejeLfDchc]}ej|c}ZNeOePZQeOe>jZSe.ZTe"jZVgd"ZWd#ZXd$ZYd%ee>dffd&ZMd1d%ee>dffd'ZZd(Z[e6d)Z\e6d*Z]e6d2d+Z^d,Z_d%e>fd-Z`d.ZaGd/de4Zbd%e>fd0Zcycc}w)3zTools 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__UnformattedBundleBundlecVeZdZUeed<eed<eed<eeed<eed<eed<dZy) OInfoismagicisaliasfound namespaceparentobjct||S)zGet a field from the object for backward compatibility with before 8.12 see https://github.com/h5py/h5py/issues/2253 )getattr)selffields P/var/www/cvtools/html/venv/lib/python3.12/site-packages/IPython/core/oinspect.pygetz OInfo.getHstU##N) __name__ __module__ __qualname__bool__annotations__r strrr4r5r3r(r(?s* M M K} K H$r5r(c@t|ttdS)NT) noclasses)r!r"r#)codes r3pylightr@Ys T;=-$*G HHr5) type_name base_class string_formr,lengthfile definition docstringsourceinit_definitionclass_docstringinit_docstringcall_defcall_docstringr)r*isclassr+namec ZtDcic]}|d}}|j||Scc}w)z1Make an object info dict with all fields present.N) info_fieldsupdate)kwkinfodicts r3 object_inforV|s/ +,1$,H, OOB O-s (c"t|}|y|jdrytjj |syt j |d5}tj|j\}}ddd|S#1swYSxYw)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.ofilebufferencodingliness r3 get_encodingrgs cNE } / 0 WW^^E " ^^E4 ( FF$44V__EOHe F Fs #BBreturnc |j}t|trtj|Stj|}|S#t $rY"wxYw)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. )getdoc isinstancer;inspectcleandoc Exception)r.dsdocstrs r3rjrjsV( ZZ\ b# ##B' ' ^^C F M    sA AAc t|trg}dD]}t||}|t|}|rd|znd}|j dj d||ft j|r)t|}|sl|j t||j ||dt|d|rdj |Syt|} t j|}|S#t$r: t j|j}Y|S#ttf$rYYywxYwt$rYywxYw)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.z# z =  )rkpropertyr0rgappendjoinrl isfunction getsourcerr _get_wrapped TypeError __class__OSError) r.onamesourcesattrnamefnre oname_prefix_srcsrcs r3r{r{s@&#x 0 Hh'B~'+27 R rwwlH'EFG%%b)$R=Dvd|4NN)5xL " 99W% % 3 ##C(C   '' 6  Y'    s0 C77 ED##D62E5D66 EEctj|xs9tj|xs"t|txst|t S)zTrue if obj is a function ())rlrzismethodrk_builtin_func_type_builtin_meth_typer.s r3is_simple_callablersK   s # Ww'7'7'< W s. / W3=cCU3VXr5ctjdtdt|drt |s |j }t j|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__)warningswarnDeprecationWarningrrrrlgetfullargspecrs r3 getargspecrsJ MM<=O\]_C$-?-Dll  ! !# &&r5ctjdtdtj|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)rrrrl formatargspec)argspecs r3format_argspecrsO MM<=O\]_  ')2D!(!17:3F HHr5c^tjdtd|jd}|d}n+ |dddk(}|r |dd d|d< |d t |z}|jd }||jd }||jd d}||fS#tt f$rY^wxYw)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.rrrNrrr1rOrMrKrGru)rrrr4KeyError IndexErrorr)oinfo format_callr call_linehas_selfdocs r3call_tiprs MM 2 ii "G  6vq)V3H")&/!""5&M."99  ))$ %C {ii() {ii B' c>!*%   s BB,+B,cp|}d}t|dr%|j}|dz }|dkDr|St|dr%|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_objis r3r|r|<sIH A sM *oo Q s7O sM * Jr5c$t|}d} tj|}t |S#t$rC tj|j}n#t tf$rYnwxYwYt |St $r Yt |SwxYw)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)r|rl getabsfiler}r~rr)r.fnames r3rZrZNs s C E  ""3'    &&s}}5E#          s8/ BABA+(B*A++B:BBct|} tj|d}|S#t$r= tj|jd}Y|S#t tf$rYYywxYwt $rYywxYw)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)r|rlgetsourcelinesr}r~r)r.linenos r3find_source_linesrqs s C '',Q/ M  ++CMM:1=F M #   s,' A7"AA)%A7(A)) A76A7c jeZdZeej ddddffd Zd deedffdZ defdZ dZ dZ d d Z ed!d Zd d Zd d Zd"d edefdZdedefdZdededefdZdefdZ d#dededeedefdZ d$deefdZd%dZd%deeeffdZ e!dZ"gddfdddZ#xZ$S)&rNrctt| ||||_t j d|||_|j j|_||_|j|y)N)r-configr;)outr-style) superr__init__ color_tablerParserparserformatstr_detail_levelset_active_scheme)r1rcode_color_tableschemerr-rr~s r3rzInspector.__init__s^ i'vf'E& ''E$fM kk(( 0 v&r5rhc< tt||S#YyxYw)zReturn the call signature for any callable object. If any exception is generated, None is returned instead and the exception is suppressed.N)_render_signaturer)r1r.rs r3_getdefzInspector._getdefs"  $Ys^U; ; sc|jjj||jjjS)z*Return a header string with proper colors.)r active_colorsheadernormal)r1hs r3__headzInspector.__heads:++99@@++99@@B Br5c|A|jj||jjj|yyN)rrr)r1rs r3rzInspector.set_active_schemes9      . .v 6 KK # # 5 5f = r5cZtd|zd|rtd|zyty)z-Generic message when no information is found.z No %s found endzfor %sN)print)r1msgrs r3noinfozInspector.noinfos& mc!s+  (U" # Gr5c t|s tdyd}tj|r|j d}|j ||}||j d|yt||j|dy)zwPrint the call signature for any callable object. If the object is a class, print the constructor information.zObject is not callable.NruzClass constructor information: zdefinition headerrr)callablerrlrN_Inspector__headrrr)r1r.rroutputs r3pdefzInspector.pdefsr } + ,  ??3 [[!CDFc%( > KK+E 2 &V,# 6r5c|j}g}t|}|r||jd|}|r1|j|d|jt |t j |rUt|drIt|j}||j|d|jt |nTt|drHt|j}|r1|j|d|jt ||s|jd|ytjd j|y) aPrint the docstring for any object. Optional: -formatter: a function to run the docstring through for specially formatted docstrings. Examples -------- In [1]: class NoInit: ...: pass In [2]: class NoDoc: ...: def __init__(self): ...: pass In [3]: %pdoc NoDoc No documentation found for NoDoc In [4]: %pdoc NoInit No documentation found for NoInit In [5]: obj = NoInit() In [6]: %pdoc obj No documentation found for obj In [5]: obj2 = NoDoc() In [6]: %pdoc obj2 No documentation found for obj2 z plain/textzClass docstring:rNzInit docstring:rzCall docstring: documentationrv) rrjr4rxrrlrNhasattrrrrrry) r1r.r formatterheadrfroinit_dscall_dss r3pdoczInspector.pdocsD{{ C[ 2""<4B LL01 2 LL $ ??3 GC$<S\\*G" T"345 VG_- S $S\\*G T"345 VG_- KK . IIdii& 'r5ctj t||}||j d|yt j |j |y#t$rd}YGwxYw)z$Print the source code for an object.)rNrH) linecache checkcacher{rnrrr)r1r.rrs r3psourcezInspector.psource sa  Cu-C ; KK% ( IIdkk#& '  C s A A+*A+cpt|}||jd|yt|}|jdrt d|zyt j j|st d|zytj|jtj|d|dz y) z0Show the whole file where an object was defined.NrErXz File %r is binary, not printing.z%File %r does not exist, not printing.F)skip_encoding_cookier) rrrZr[rr\r]r^rrr read_py_file)r1r.rrrcs r3pfilezInspector.pfiles#3' > KK & # >>1 2 4u< =& 9EA B IIdkk&"5"5eRW"XY[ade[e fr5textc|dtj|dd}||S||}t|ts |d|ddSt|fi|S)aRReturn a mime bundle representation of the input text. - if `formatter` is None, the returned mime bundle has a ``text/plain`` field, with the input text. a ``text/html`` field with a ``
`` 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/html)htmlescaperkdict)r1rrr	formatteds     r3_mime_formatzInspector._mime_format0sm" T!2 36:

O!$Ii.'0i[PV>WXXH2	22r5bundlect|dtsJ|dD]}t|trJi}g}td|dD}|dD]X\}}|j	d}d|vrdnd}|j|j
|dz|t|z
dz||Zdj||d<d|vrht|dtsJ|dD]}t|trJt|dttfrdjd|dD|d<|jD]}	|	dvr||	}|S)	zRFormat a mimebundle being created by _make_info_unformatted into a real mimebundlerc38K|]\}}t|ywrlen).0r_s   r3	z(Inspector.format_mime..[s;da3q6;rvr:rc32K|]\}}d|d|yw)z
z

Nr<)rrbodys   r3rz(Inspector.format_mime..ns!XLT4tD6/Xs)rr)
rklisttuplemaxstriprxrrrykeys)
r1ritemnew_brf_lenrrdelimrTs
          r3format_mimezInspector.format_mimeRs&.555<(	+DdE***	+;f\&:;; .	JD$::d#D DLDcELL;;tCx()4#d)+;S*@)A%O
	#ii.l& f[14888{+
/!$...
/&-e}=%)YYXF;DWX&k"	"A//q			"
r5titlekeyc||vs||vry||}|E|j||}|dj||df|dj||dfyy)z^Append an info value to the unformatted mimebundle being constructed by _make_info_unformattedNrr)rrx)	r1rrrinfo
omit_sectionsrr2formatted_fields	         r3_append_info_fieldzInspector._append_info_fieldxsvM!SM%9S	"//yAO< ''0M(NO;&&{/K'LMr5cggd}	d*dtdtdtffd
}dtffd}dr||d	d
|Sdr(|dkDr||d
d|n||dd|||dd|Sdst|rb||dd|||dd|||dd||dkDrdr||d
d|n||dd|||dd||dd||dd|S||dd|||dd|||dd||d d
d!d"k7r
||d#d!||d$d%||dd|dkDrdr||d
d|n||dd|||d&d'|||dd|||d(d)||S)+z;Assemble the mimebundle as unformatted lists of informationrrrrc4j||||y)N)rrrrr)r)rrrrrrr1s    r3append_fieldz6Inspector._make_info_unformatted..append_fields*
##+#

$
r5rhc>j|t|dS)Nr)rr@)rr1s r3code_formatterz8Inspector._make_info_unformatted..code_formatters "kk$/$T]
r5r*ReprrCr)rSourcerH	DocstringrGFilerErN	SignaturerFzInit signaturerIzInit docstringrKTyperA
Subclasses
subclasseszCall signaturerLzString formr,Interactive	NamespaceLengthrDzClass docstringrJzCall docstringrMr)r%r;r&r)	r1r.rrdetail_levelrrrrs	` `  `   r3_make_info_unformattedz Inspector._make_info_unformatteds
%
HL
	%
	.1
	8;
		F		?7^
[)_aVXxHV[+yI0P
M)_ 23 7lNK!13DnUk9EaDNVXxHV%57GS05|<4
-
lNK!1:~N5
>K M1V[+>840aDNVXxHV[+yI!24EyQ!13CYO!13CYO
r5r.rrcz|j||||}|j|||||}|j|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`)
        rrr")r"r)rr#r
)	r1r.rrrr"r	info_dictrs	         r3	_get_infozInspector._get_infosQ4IIcTIU	,,%'-
''r5cn|J|j||||||}|s|d=tj|y)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)	r1r.rrrr"enable_html_pagerrinfo_bs	         r3pinfozInspector.pinfosJB	4](
!{#		&r5cdtjdtd|j||||S)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)r1r.rrr"s     r3_infozInspector._info&s7	


B
	
yyErzMagic functionrAzSystem aliasrBrCz <...> rvrc3<K|]}|jywr)r)rqs  r3rz!Inspector.info..s Eq Esr,rDrXzz9Dynamically generated function. No source code available.rErHrGrNrIrKr, z...rrFr~rJrrLrMr<).r)r*r,splitr-r	HOOK_NAMEr0r4rrr;__doc__rjinttyper6r~rr
expandtabsryrnrZr[rrrrkrwr{rstrip_source_contains_docstringrlrNrAttributeErrorr_object_init_docstring__subclasses___builtin_type_docstringsrrr_func_call_docstringrV)"r1r.rrr"r)r*ospaceatt_nameparents_docspreludeparents_docs_dictrro
ds_or_None
string_maxshalfbclassostrstr_headbinary_filerrinit_defobj_initrsubnames	all_namesdeflnclsclass_dsrLrs"                                  r3rzInspector.info5s*<GGFllGllG^^F;;s#B'DKK+Y0O 'Y ?,004@LdGWQU
B
C=.=AFB!3s8+;;*S[[88BJ!%
r\
Z!^q()/C
-C#Cy11C	]]F #FC
4000	
3x(#D	*(<<)3dE67mCD 3X-@-@-B)C#CC D EDJJt4D EE $H
%C	CMCM
#=K~~56"
+S'.CK
  "
c8,K#C/C!jjl$'CMd55cggh6GL!C??3!C	N
 <<U3

#<<##'<<%#@!*44"G)1%&(/$%-1-@-@-EFcS\\FEF5zB IIe,	 IIeCRj%&89	 )CLLe,E$)L!+!#k2C &c{H77#Hh-5C)*
 .44"G(/$%C,5G5L<<e<SWW\-B!B'/C
O .22"G,3C()!S!!c."SX-B:	
		:

"
 
 *"

*G($#H"

s=RR$0A5R,-R4"5SS-S6<S&
T9T
' TR!$R),R14	SS	SSS#"S#&	S32S36TT
TT&%T&c	tjt|j\}tj||k(S#t
$rYywxYw)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_docstringrn)rrdef_nodes   r3r=z$Inspector._source_contains_docstringsK	))F3K055KX$$X.#55			sAA	AAF)
list_typescrd}d}|r2tjdjtty|j	}	t|	}
|
dk(r|	d}n|
dk(r|	\}}nt
d|z|D]%}||vst
d	|d
|jtt}
}|D]P}||}t||
vr|
jt|t|||||}|j|Rtjdjt|y)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.
        allrurvNrrrz)invalid argument string for psearch: <%s>zinvalid namespace . Valid names: )ignore_caseshow_all)
rrysortedrr6r
ValueErrorrsetidaddrrR)r1patternns_table	ns_searchr_r`r\type_patternfiltercmdslen_cmdsrO
search_resultnamespaces_seenns_namenstmp_ress                 r3psearchzInspector.psearch(s<4IIdii| 456}}Yq=!WF
]"&F<H$%&
&	9D8# "&x}}"899	9*-
 	*G'"B"v(2'$Rv0;hPG  )	*	
		$))F=123r5ru)ruNr)ruNNrr<)ruNNrTr<)ruNr)%r6r7r8rrANSICodeColorsrrr;rrrrrrrrrrrr%r&r
rr#rr	r(r'r+r-r
rstaticmethodr=rr
__classcell__)r~s@r3rrs#0",";";"#T	
'eCHoB#B
>
7,7(7(r
(g. 3 3 3D$"3$$LN!NN	N$L	Ld $"(
"("(
uo"(
"(N $'
uo'R
Q`"S#X`"D 13!5@4@E@4@4r5chg}d}d}|jjD]}|jtjj
k(rd}n|r|j
dd}|jtjjk(rd}n<|jtjjk(r|r|j
dd}|j
t||r|j
dt|td|DzdkDr)dj|djd	|D}n!d
j|dj|}|jtjur3tj |j}|dj|z
}|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/*c38K|]}t|dzyw)rNrrrs  r3rz$_render_signature..s6!3q6A:6rKz{}(
{})ruc3>K|]}dj|yw)z    {},
N)rr{s  r3rz$_render_signature..s 73&'Kq!73sz{}({})r5z -> {})
parametersvalueskindrl	ParameterPOSITIONAL_ONLYrxVAR_POSITIONALKEYWORD_ONLYr;rsumrryreturn_annotation_emptyformatannotation)
obj_signatureobj_nameresultpos_onlykw_onlyparamrenderedannos        r3rrksnFHG))002
"::**:::H
MM#H::**999G
ZZ7,,99
9gMM#G

c%j!
"

c8}s6v666;$$Xrww73+17303
??8TYYv->?&&gnn<''
(G(GHHOOD))Or5rs)T)dr8__all__dataclassesrrlrtextwraprrXrior_rr\systypesrtypingrr	r
rr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.decoratorsr pygmentsr!pygments.lexersr"pygments.formattersr#r7r;r%r:r&r(r@FunctionTyperrBobjectrr?
ModuleType
MethodTyperwrjrAr:r^rupperrColorsrtrrQrVrgr{rrrrr|rZrrr)ts0r3rs4
'"
	
::w+ %4$ +,%1/MM0-*'-'	 $CeCHo)>$>?9?cN	"$$$2I))22::00 % 0 0%2B2B % 2 2H >NGNN1
#Y#))_
))
.5T?*<c$h<~X
''"HH ""J$ c F>X4	X4v(#(Y s$H