a gDf:@sdZddlZddlZddlZddlZddlZddlmZddlm Z dZ dZ dZ dZ d ZGd d d Zd Zed 7ZdadddZGdddZddZededS)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 %sc@sPeZdZdZdddZdddZdd d Zd d ZdddZddZ ddZ dS) ParamPagerz} Callable class that displays information about the supplied Parameterized object or class in the IPython pager. FcCsgd|_||_dS)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)selfr rZ/nfs/NAS7/SABIOD/METHODE/ermites/ermites_venv/lib/python3.9/site-packages/param/ipython.py__init__/s zParamPager.__init__Tcst|jd}t|tr6g}dd|D}|n&t|jjdd}|j}|j |svfdd|D}| d|||fS)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. existingcSsi|]\}}||jqSr)default).0kprrr Dz-ParamPager.get_param_info..T)Z onlychangedcs i|]\}}|jvr||qSr)__dict__)rrvZ self_classrrrLs  r) dictparamZobjects isinstanceritemslistvalueskeys __class__pop)r obj include_superparamsrval_dictrrrget_param_info:s   zParamPager.get_param_infodcs|\}}}g}g}||D]$} |r.| |vr.q|| || fqtdd|Ddt|D]\} \} } d| } t| jdurdn| j} tr| dst | dkrt j d | | dr| dd} q| }t |dkrfd d |ddD}| |d g|}n(t |dkrB| |d g}ng}| drf|d d |Dq`|dd |Dq`d|S)z Build a string to that presents all of the parameter docstrings in a clean format (alternating red and blue for readability). css|]\}}t|VqdSN)len)rr_rrr brz.ParamPager.param_docstrings..z%s: Nz< No docstring available > zQMulti-line docstring for %r is incorrectly formatted (should start with newline)csg|]}d|qS) r)rlineZ right_shiftrr rrz/ParamPager.param_docstrings..rcSsg|] }t|qSr)redrelrrrr4zrcSsg|] }t|qSr)bluer6rrrr4|r)sort_by_precedenceappendmax enumeratetextwrapdedentdocWARN_MISFORMATTED_DOCSTRINGS startswithr+ splitlinesrmainwarningljustextendjoin)r info max_col_len only_changedr&r'rcontentsZdisplayed_paramsrirheadingZ unindentedlinestailZ all_linesrr3rparam_docstringsSs@    zParamPager.param_docstringscsXddD}dd}t||d}tj||d}dd|D}fdd|D}|S)z Sort the provided dictionary of parameters by their precedence value, preserving the original ordering for parameters with the same precedence. cSsg|]\}}||fqSrr)rrZpobjrrrr4rz1ParamPager.sort_by_precedence..cSs|djdur|djSdS)Nr0g:0yE>) precedence)xrrrrz/ParamPager.sort_by_precedence..)keycSsg|]\}}t|qSr)r)rr,grprrrr4rcs6g|].}|D]$}|ddks(|dvr |dq qS)rrr)rgroupr7 parametersrrr4s)rsorted itertoolsgroupby)r rXr&Zkey_fnZ sorted_paramsgroupsZordered_groupsZordered_paramsrrWrr9s zParamPager.sort_by_precedence(cCsgi}}|\}}} dd|D} ||} | D]} || } |rL| | vrLq0| jrVdnd}| jrddnd}t| dr|| jr|dnd }|d ||}t|| }t||d kr|d |d d }| | jj||d}t| dr| j d urdn| j \}}d\}}t| drP| \}}|d ur4|d ur4|}d}|d urP|d urP|}d}||fdkr||f|| <d|d|d|d<|D]&}t | |t||g}|| |<q| | |fq0| || | ||S)z Collect the information about parameters needed to build a properly formatted table and then tabulate it. cSsi|] }|dqS)rr)rrrrrrrz+ParamPager._build_table..CVZROZRW allow_Nonez ANr1Nz...)rrr rr )NN)FFget_soft_boundsT(z, ))r9constantreadonlyhasattrr`reprr+r"__name__r rcr;r: _tabulate)r rHr rIrJ info_list bounds_dictr&r'r col_widthsZorderingrrrfrgr`r rZp_dictlboundubound mark_lbound mark_uboundZ soft_lboundZ soft_uboundcol max_widthrrr _build_tablesJ           zParamPager._build_tablecsgg}}dd|Dfdd|D}g} t|D]B\} } || d} | } | dkrd| | n| | } | | q6|td| d|D]\}}g}t|D]\} } || d} | |vr|| nd}| dkr|| n|| } | d kr||d r||\}}| d \}}|d \}}|d \}}|rT|d t |n|}|rnt |d |n|}|d |} || qd|}||vrt |}||qd||S)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 cSsh|]\}}|D]}|qqSrr)rr,rowrrrr rz'ParamPager._tabulate..csg|]}|vr|qSrr)rrsZ column_setrrr4rz(ParamPager._tabulate..r.rrar/r F,rdre) r< capitalizerEcenterr:r8rGgetrsplitcyanr5)r rlrnrr rmrKrOcolumnsZ title_rowrLrswidth formattedrvrHZrow_listvalrqrrZlvalZuvalZlspaceZlstrZustruspacerorpZrow_textrrxrrks<         zParamPager._tabulatecCsnd}|jst|tj}t|to*t|tj}|s@|s@tddS|r|jj}t d|d|j }|rjdnd|j }d|d|}|durd |j }d t |}|d |d } |j |d d } | dst| } | dS|j| |jddd} |j| ddd} d}t| } | dt|7} | dtd7} | d7} d} | d d t | }t|}| 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]+$raz %rzParameters of z instancezParameters of %r=r/T)r%rz Object has no parameters.r]F)rIrJr)z?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 )r rrZ Parameterizedr issubclassprintr"rjrematchrr+r(greenrur rPr5r~)r Z param_objtitleZparameterized_objectZparameterized_class class_name default_nameZobj_nameZ heading_lineZ heading_textZ param_infoZ top_headingtableZ docstringsZdflt_msgZheading_stringZdocstring_headingrrr__call__sF       zParamPager.__call__N)F)T)r)F)r]F) rj __module__ __qualname____doc__rr(rPr9rurkrrrrrr)s  . 84rzDWelcome to the param IPython extension! (https://param.holoviz.org/)z Available magics: %paramsTcs\ddlm}m}mddlm|Gfddd|}|rFtttsXda| |dS)Nr)Magics magics_class line_magicpagecs2eZdZdZfddZdfdd ZZS) z+load_ipython_extension..ParamMagicsz~ Implements the %params line magic used to inspect the parameters of a parameterized class or object. cstj|i|t|_dSr*)superrr param_pager)r argskwargsr"rrr?sz4load_ipython_extension..ParamMagics.__init__raNcsP|dkrtddS|j|}|jdur:td|dS||jdS)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 raz$Please specify an object to inspect.NFz%Object %r not found in the namespace.)rshellZ _object_findfoundrrr$)r Z parameter_s namespacesr$rrrr&Ds    z2load_ipython_extension..ParamMagics.params)raN)rjrrrrr& __classcell__rrrrr ParamMagics9s rT) ZIPython.core.magicrrrZ IPython.corerrmessage_loadedZregister_magics)ipverboserrrrrrload_ipython_extension3s ! rc@s$eZdZdZdZddZddZdS)IPythonDisplayz; Reactive display handler that updates the output. TcCs ||_dSr*) _reactive)r ZreactiverrrrjszIPythonDisplay.__init__csddlm}ddlm}m}ddlm}dt|j|rb|jj ||jj ddifdd}n&|j||ddifd d}z(}||urd}t |t jd WntytYn0dS) Nr)depends) Undefined resolve_ref)rxZwatchTcsdurdSr*updaterrcbhandlerr update_handleusz.IPythonDisplay.__call__..update_handlecsdurdSr*rrrrrr{s)Z display_id)Z param.dependsrZparam.parameterizedrrZparam.reactiverrrZ _callback_paramsZdisplayuuiduuid4hex TypeErrorNotImplementedError)r rrrrrr$rrrrms$    zIPythonDisplay.__call__N)rjrrrenabledrrrrrrrcsrc Csxd}zPt}|jrRddlm}|}|j}|r@||n ||WdSWnt t fyjYn0t |dS)Nr)IOLoop) Z get_ipythonkernelZtornado.iolooprcurrentZ asyncio_loopZ is_runningZ add_callbackZrun_until_complete NameErrorAttributeErrorr)funcZ event_looprrZiolooprrripython_async_executors    rZ_ipython_display_)T)rrrZr=rrZ param.displayrZ param._utilsrr@r5r8rr~rrrrrrrrrrs,   0$