a oDf5@sdZddlmZddlZddlmZmZddlmZm Z m Z m Z ddl mZmZddlZddlmZmZmZdd lmZmZmZdd lmZdd lmZdd lmZmZdd l m!Z!m"Z"erddl#m$Z$ej%Z%ddZ&GdddeZ'Gddde(Z)e'*Z+e+j,dddZ-gdZ.dS)aL Interact with functions using widgets. The interact Pane implemented in this module mirrors ipywidgets.interact in its API and implementation. Large parts of the code were copied directly from ipywidgets: Copyright (c) Jupyter Development Team and PyViz Development Team. Distributed under the terms of the Modified BSD License. ) annotationsN)IterableMapping) Parameter getcallargsgetfullargspec signature) TYPE_CHECKINGClassVar)ColumnPanelRow)HTMLPaneBasepanel)ReplacementPane)Viewable)ButtonWidget)fixedwidget)Modelc cs|j}|j}|j}|j}|ttf}|tjtjfvr||vrF||}nH|turdt j j dt |}n*|tur|}t |ttfrt|}n|V|||fVn6|tjkr|D]\}} |||| tfVqdS)z-Get an abbreviation for a function parameter.zUsing function annotations to implicitly specify interactive controls is deprecated. Use an explicit keyword argument for the parameter instead.N)namekind annotationdefaultemptyrPOSITIONAL_OR_KEYWORD KEYWORD_ONLYpopparammainwarningDeprecationWarning isinstancerrr VAR_KEYWORDcopyitems) parameterkwargsrrannr not_foundvaluekvr0[/nfs/NAS7/SABIOD/METHODE/ermites/ermites_venv/lib/python3.9/site-packages/panel/interact.py"_yield_abbreviations_for_parameter$s.      r2cseZdZUejeeddZejdddZ ej ddZ eje dZ dd iZd ed <iffd d Zd,ddZejddddddddZeddZddZd-dddfdd Zed d!Zd"d#Zd$d%Zd&d'Zed(d)Zed*d+ZZS). interactiveF)rclass_Z is_instancez: Whether to update manually by clicking on button.)rdoc Run Interact)r)r4_paneNz"ClassVar[Mapping[str, str | None]]_renamec sNtdurtdtj|fi||dd|_||}z t|WntyZYn0t |fidd|D| |}|j r| dt |jdft||_|jfi|j}t|tr||_d|_nt||jd|_d|_t|j|_d d |D}d |vr |d td |jt||_|j|jg|j_ |!|"dS)Nz`interact requires either recent Python version (>=3.3 or IPython to inspect function signatures. throttledFcSsi|]\}}}||qSr0r0).0nr/_r0r0r1 `z(interactive.__init__..manual)rTcSsg|]\}}t|tr|qSr0)r%r)r:r<rr0r0r1 nr>z(interactive.__init__..rrz

%s

)#r ImportErrorsuper__init__r r9find_abbreviations check_argspec TypeErrorrwidgets_from_abbreviations manual_updateappendr manual_namedict_widgetsobjectr*r%rr7 _internalrrr _inner_layoutinsertrr Z widget_boxlayoutZobjects _link_widgets _sync_layout)selfrMparamsr* new_kwargswidgetspane __class__r0r1rCNs8         zinteractive.__init__cCs|j||||SN)rO _get_model)rTr5rootparentZcommr0r0r1r\zszinteractive._get_modelz_pane.sizing_modez_pane.width_policyz_pane.height_policyT)watchcCsHt|dsdSdd|jjD}|jj||jj|dS)NrOcSsi|]\}}|dvr||qS))Z sizing_modeZ width_policyZ height_policyr0r:r.r/r0r0r1r=sz,interactive._sync_layout..)hasattrr7r!valuesr(rOupdaterQ)rToptsr0r0r1rS}s zinteractive._sync_layoutcCsgSr[r0rTr0r0r1_synced_paramsszinteractive._synced_paramscsjrdjdfg}n j}|D]X\}}fdd}jrPt|drPd}nd}|dkr`dn|}|j||}j|q&dS)Nr?csNjfij}t|jj\}}|dur4dS|_|jd<|_dS)Nr)rMr*rZ_update_from_objectr7rNrO)ZchangeZ new_objectZnew_paneZinternalrer0r1 update_panes  z.interactive._link_widgets..update_paneZvalue_throttledr-Zclicks) rHrLr(r9rar!r_Z_internal_callbacksrI)rTrWr widget_objrgr/ZpnameZwatcherr0rer1rRs   zinteractive._link_widgetsz Model | NoneNone)r]returncs|j|t|dSr[)rO_cleanuprB)rTr]rYr0r1rks zinteractive._cleanupcCsdd|jDS)NcSs i|]\}}|dkr||jqS)r?)r-)r:r.rr0r0r1r=s z&interactive.kwargs..)rLr(rer0r0r1r*szinteractive.kwargscCs t|jSr[)rrMrer0r0r1rszinteractive.signaturec Csg}z |}Wn(ttfy8dd|DYS0|jD]@}t||D]0\}}}|turrtd|| |||fqRqD|S)zqFind the abbreviations for the given function and kwargs. Return (name, abbrev, default) tuples. cSsg|]\}}|||fqSr0r0)r:keyr-r0r0r1r@r>z2interactive.find_abbreviations..z5cannot find widget or abbreviation for argument: {!r}) r ValueErrorrFr( parametersrbr2rformatrI)rTr*rVsigr)rr-rr0r0r1rDs zinteractive.find_abbreviationscCsrg}|D]d\}}}t|tr"|}nt|||d}t|ts^t|ts^|durPqntdt|||fq|S)zQGiven a sequence of (name, abbrev, default) tuples, return a sequence of Widgets.)rrNz{!r} is not a ValueWidget)r%rrrrFrorI)rTseqresultrZabbrevrrhr0r0r1rGs z&interactive.widgets_from_abbreviationscCs t|tjSr[)r%types FunctionType)clsrMr0r0r1appliesszinteractive.appliescCstddd}t||S)NFr6rHrJ)rK_InteractFactory)ruoptionsr0r0r1factorys zinteractive.factory)NNN)N) __name__ __module__ __qualname__r!Z ClassSelectorr r Zdefault_layoutBooleanrHStringrJrr7r8__annotations__rCr\dependsrSpropertyrfrRrkr*rrDrG classmethodrvrz __classcell__r0r0rYr1r3@s0   ,     r3c@s4eZdZdZd ddZddZd ddZd d ZdS) rxax Factory for instances of :class:`interactive`. Arguments --------- cls: class The subclass of :class:`interactive` to construct. options: dict A dict of options used to construct the interactive function. By default, this is returned by ``cls.default_options()``. kwargs: dict A dict of **kwargs to use for widgets. NcCs||_||_|pi|_dSr[rurdr*)rTruryr*r0r0r1rCsz_InteractFactory.__init__cCs|j||jfi|jS)a Return an interactive function widget for the given function. The widget is only constructed, not displayed nor attached to the function. Returns ------- An instance of ``self.cls`` (typically :class:`interactive`). Parameters ---------- f : function The function to which the interactive widgets are tied. r)rTfr0r0r1rs z_InteractFactory.widgetc s|rjttjt|j}|fdd|Dt|jfifdd|D}t||j ||}}|durz|Sdt |j vrt d| |}z ||_ Wn$tyfdd}||_ Yn0|jS) ae Make the given function interactive by adding and displaying the corresponding :class:`interactive` widget. Expects the first argument to be a function. Parameters to this function are widget abbreviations passed in as keyword arguments (``**kwargs``). Can be used as a decorator (see examples). Returns ------- f : __interact_f with interactive widget attached to it. Parameters ---------- __interact_f : function The function to which the interactive widgets are tied. The `**kwargs` should match the function signature. Passed to :func:`interactive()` **kwargs : various, optional An interactive widget is created for each keyword argument that is a valid widget abbreviation. Passed to :func:`interactive()` Examples -------- Render an interactive text field that shows the greeting with the passed in text:: # 1. Using interact as a function def greeting(text="World"): print("Hello {}".format(text)) interact(greeting, text="IPython Widgets") # 2. Using interact as a decorator @interact def greeting(text="World"): print("Hello {}".format(text)) # 3. Using interact as a decorator with named parameters @interact(text="IPython Widgets") def greeting(text="World"): print("Hello {}".format(text)) Render an interactive slider widget and prints square of number:: # 1. Using interact as a function def square(num=1): print("{} squared is {}".format(num, num*num)) interact(square, num=5) # 2. Using interact as a decorator @interact def square(num=2): print("{} squared is {}".format(num, num*num)) # 3. Using interact as a decorator with named parameters @interact(num=5) def square(num=2): print("{} squared is {}".format(num, num*num)) csi|]\}}|vr||qSr0r0r`rUr0r1r=Cr>z-_InteractFactory.__call__..csi|]\}}|vr||qSr0r0r`rr0r1r=Dr>Nr9z1A function cannot have "throttled" as an argumentcs|i|Sr[r0)argsr*)_InteractFactory__interact_fr0r1_r>z+_InteractFactory.__call__..)listr3r!rKr*rcr(rdtyperurErrmrAttributeErrorrQ)rTrr*kwrdrwr0)rrUr1__call__s$2  $     z_InteractFactory.__call__cKsJt|j}|D]&}||vr(td|||||<qt||j||jS)z Change options for interactive functions. Returns ------- A new :class:`_InteractFactory` which will apply the options when called. zinvalid option {!r})rKrdrmrorrur*)rTkwdsrdr.r0r0r1rycs  z_InteractFactory.options)N)N)r{r|r}__doc__rCrrryr0r0r0r1rxs   UrxTr6rw)interactinteract_manualr3)/r __future__rrscollections.abcrrinspectrrrrErtypingr r r!rQr r rrXrrrZ pane.baserZviewablerrWrrZwidgets.widgetrrZ bokeh.modelrrr2r3rMrxrzrryr__all__r0r0r0r1s.    ,