.dg:dZddlZddlZddlZddlZddlZddlmZddlm Z dZ dZ dZ dZ d ZGd d Zd Zed z ZdaddZGddZdZedey)an Optional IPython extension for working with Parameters. This extension offers extended but completely optional functionality for IPython users. From within IPython, it may be loaded using: %load_ext param.ipython This will register the %params line magic to allow easy inspection of all the parameters defined on a parameterized class or object: %params All parameters of the class or object will be listed in the IPython pager together with all their corresponding attributes and docstrings. Note that the class or object to be inspected must already exist in the active namespace. N)register_display_accessor)async_executorFz %sz %sz %sz %scBeZdZdZd dZd dZd dZdZd dZdZ dZ y ) ParamPagerz} Callable class that displays information about the supplied Parameterized object or class in the IPython pager. c$gd|_||_y)z If metaclass is set to True, the checks for Parameterized classes objects are disabled. This option is for use in ParameterizedMetaclass for automatic docstring generation. )namechangedvaluetypeboundsmodeN)order metaclass)selfrs -lib/python3.12/site-packages/param/ipython.py__init__zParamPager.__init__/sL "c*t|jjd}t|tr2g}|j Dcic]\}}||j }}}|}nYt|jjdj}|jj}|j}|s1|j D cic]\}} ||jvr|| }}} |jd|||fScc}}wcc} }w)z Get the parameter dictionary, the list of modifed parameters and the dictionary of parameter values. If include_super is True, parameters are also collected from the super classes. existingT) onlychangedr) dictparamobjects isinstancer itemsdefaultlistvalueskeys __class____dict__pop) robj include_superparamsr kpval_dict self_classvs rget_param_infozParamPager.get_param_info:s cii'' 34 c$ G17@1!)) H@J399+++=BBDEGyy'')HJ'-||~3~eqj111c~F3  6'**A3s D Dc|\}}}g}g}|j|D]} |r| |vr |j| || f!td|Ddz} t|D]\} \} } d| z} t j | j dn | j }trM|jdsz.ParamPager.param_docstrings..`sD3Ca#d)3Csz%s: Nz< No docstring available > zQMulti-line docstring for %r is incorrectly formatted (should start with newline) r)sort_by_precedenceappendmax enumeratetextwrapdedentdocWARN_MISFORMATTED_DOCSTRINGS startswithr/ splitlinesrmainwarningljustextendredbluejoin)rinfo max_col_len only_changedr%r(r contentsdisplayed_paramsr right_shiftir'heading unindentedlineslinetail all_linesels rparam_docstringszParamPager.param_docstringsRs  '+#7++F3DG 3  # #T6$<$8 94 D3CDDQF %&67LAyatmG!)E\]\a\abJ,"--d3Z=R=R=T9UXY9Y ""$BCGI''-'^ ''-))+E5zA~BG)L)$3+-.tf5)L%mmK858CDtK Uq%mmK858CD  1u9 =9Rb9 =>I >IbrI >?184yy""M!> >s:G8%G= H cN|jDcgc] \}}||f }}}d}t||}tj||}|D cgc]\}} t | } }} | D cgc]} | D]} | ddk7s| d|vr| d} } } | Scc}}wcc} }wcc} } w)z Sort the provided dictionary of parameters by their precedence value, preserving the original ordering for parameters with the same precedence. cB|dj|djSdS)Nr5g:0yE>) precedence)xs rz/ParamPager.sort_by_precedence..s!adoo.I1Q4??StSr)keyrr)rsorted itertoolsgroupbyr)r parametersr'pobjr%key_fn sorted_paramsgroupsr1grpordered_groupsgrouprUordered_paramss rr7zParamPager.sort_by_precedences ,6+;+;+=>+=41d)+=>Sv62 ""=f=4:;FC$s)F;-;G^Ee evoA*1DQ%e%^G?<GsBB."B!c .gi}}|\}}} |D cic]} | d} } |j|} | D]K} || }|r| | vr|jrdnd}|jrdnd}t|dr|jrdnd}|d ||}t || }t ||d z kDr |d |d z d z}| |jj||d }t|drk|jdn |j\}}d\}}t|dr#|j\}}|||}d}|||}d}||fdk7r||f|| <d|d|d|d<|D]#}t| |t ||g}|| |<%|j| |fN|j|| | ||Scc} w)z Collect the information about parameters needed to build a properly formatted table and then tabulate it. rCVRORW allow_Nonez ANr6Nz...)rr r r r )NN)FFget_soft_boundsT(z, ))r7constantreadonlyhasattrrnreprr/r __name__r rqr9r8 _tabulate)rrHrrIrJ info_list bounds_dictr%r(r r& col_widthsorderingrr'rtrurnr r p_dictlboundubound mark_lbound mark_ubound soft_lbound soft_uboundcol max_widths r _build_tablezParamPager._build_tables "$R; &*#7#()5aac5 )**62Dt AG 3jjscH zzttH")!\":q||QSJZq :,7D$(E5z[1_-n{1}-5"AKK,@,@"U4Fq(#010@ahh+7( [1/0/0/@/@/B,K~+*A!,&* ~+*A!,&* F#{2)4k(BK%)*6("VHA'>F8$C#fSk2B CD "+ 3   dF^ ,QT~~iWe[QQ[*s Fcgg}}|D chc]\}} | D]} | } } }} |D cgc] } | | vs|  } } g}t| D]U\}} || dz}| j} |dk(r| j|n| j|}|j |W|j t dj |zdz|D]\} }g}t| D]\}} || dz}| |vr|| nd}|dk(r|j|n|j|}| dk(r|j| drq|| \}}|jd\}}|jd\}}|jd \}}|r|dzt|zzn|}|rt|zd z|zn|}|d|}|j |dj |}| |vr t|z}|j | dj ||zScc} } }wcc} w) a Returns the supplied information as a table suitable for printing or paging. info_list: List of the parameters name, type and mode. col_widths: Dictionary of column widths in characters changed: List of parameters modified from their defaults. order: The order of the table columns bound_dict: Dictionary of appropriately formatted bounds r3rror4r F,rrrs) r: capitalizerCcenterr8rFrGgetrsplitcyanrE) rrzr|r rr{rKrSr1rowr& column_setrcolumns title_rowrNwidth formattedrHrow_listvalrrlvaluvallspacelstrustruspacerrrow_texts rryzParamPager._tabulatesR$&/=iFAsAaai ="'=%33*+<3%= (FAssOA%E.."C,-F %( 58II   Y ' ) rwwy11$67#ICH"7+#"3)$'4Kd3ib011CIIe,#**U:K (?{s5'A1 OOH %+#.yy$''I>=sG< HHc.d}|jst|tj}t|txrt |tj}|s|s t dy|rW|jj}tjd|zdz|j}|rdnd|jz}d|d|}|d |jz}d t|z}|d |d } |j|d } | dst| z} | dS|j| |j dd} |j#| dd} d}t| z} | dt$|zzz } | dt&dzzz } | dz } d} | d d t| z}t|z}| d| d|d| S)z Given a Parameterized object or class, display information about the parameters in the IPython pager. Nz.Object is not a Parameterized class or object.^z[0-9]+$roz %rzParameters of z instancezParameters of %r=r4T)r$rz Object has no parameters.(F)rIrJdz?Parameters changed from their default values are marked in red.z %sz%Soft bound values are marked in cyan.zB C/V= Constant/Variable, RO/RW = ReadOnly/ReadWrite, AN=Allow NonezParameter docstrings:z )rrr Parameterizedr issubclassprintr rxrematchrr/r+greenrrrVrEr)r param_objtitleparameterized_objectparameterized_class class_name default_nameobj_name heading_line heading_text param_info top_headingtable docstringsdflt_msgheading_stringdocstring_headings r__call__zParamPager.__call__s ~~#-i9L9L#M #-i#=$R(29U=P=P(Q ),?FG#&0099 !xxJy(@)..Q !-2EINN4J(izJ =&7ESZ' <.3 (($(G !},.K!]"=> >!!*djjb/4"6**:3UZ*[ T|+ vx00 v(O!OPP \\ . (>C#l2C,C+DE"^3d5'.?-@ZLQQrN)FT)rF)rF) rx __module__ __qualname____doc__rr+rVr7rryrrrrr)s/ #+0*#Z  4Rn0(f.RrrzDWelcome to the param IPython extension! (https://param.holoviz.org/)z Available magics: %paramscddlm}m}mddlm|Gfdd|}|rt ttsda|j|yy)Nr)Magics magics_class line_magic)pagec<eZdZdZfdZWdfd ZxZS)+load_ipython_extension..ParamMagicsz~ Implements the %params line magic used to inspect the parameters of a parameterized class or object. cBt||i|t|_yr.)superrr param_pager)rargskwargsr s rrz4load_ipython_extension..ParamMagics.__init__<s G d -f -)|D rc|dk(r tdy|jj|}|jdurtd|zyj |j |j y)aj The %params line magic accepts a single argument which is a handle on the parameterized object to be inspected. If the object can be found in the active namespace, information about the object's parameters is displayed in the IPython pager. Usage: %params roz$Please specify an object to inspect.NFz%Object %r not found in the namespace.)rshell _object_findfoundrrr#)r parameter_s namespacesr#rs rr%z2load_ipython_extension..ParamMagics.paramsAsfB<=**))+6CyyE!= KL IId&&sww/ 0r)roN)rxrrrrr% __classcell__)r rrs@r ParamMagicsr5s!  ,  1  1rrT) IPython.core.magicrrr IPython.corerrmessage_loadedregister_magics)ipverboserrrrrs @@rload_ipython_extensionr/sPCC!1f11Dg  ;' rc eZdZdZdZdZdZy)IPythonDisplayz1Reactive display handler that updates the output.Tc||_yr.) _reactive)rreactives rrzIPythonDisplay.__init__es !rcddlm}ddlm}m}ddlm}dt|j|r<|jj||jjddifd}n#|j||ddifd} }||urd}t|tjj y#t$rt wxYw) Nr)depends) Undefined resolve_ref)rxwatchTc8jyyr.updaterrcbhandles r update_handlez.IPythonDisplay.__call__..update_handlep%MM"$'&rc8jyyr.rrs rrz.IPythonDisplay.__call__..update_handlevrr) display_id) param.dependsrparam.parameterizedrrparam.reactiverrr _callback_paramsdisplayuuiduuid4hex TypeErrorNotImplementedError) rrrrrrr#rrs @@rrzIPythonDisplay.__call__hs)>% dnnb )))B dnn,, 9D 9 (: (B k"o 2T 2 (3 ( &$CiSTZZ\-=-=>F &% % &s 6CCN)rxrrrenabledrrrrrrr`s;G"&rrc.d} t}|jr[ddlm}|j }|j }|j r|j|y|j|y t|y#ttf$rYwxYw)Nr)IOLoop) get_ipythonkerneltornado.iolooprcurrent asyncio_loop is_running add_callbackrun_until_complete NameErrorAttributeErrorr)func event_looprrioloops ripython_async_executorr sJ  ] 99 -^^%F,,J$$&##D) --df5  4 ~ &   sABBBB_ipython_display_r)rrr^r;rr param.displayr param._utilsrr>rErFrrrrrrrr rrrrs&  3' % ~R~RB U (( .(b & &D$-~>r