e!6dZddlmZddlZddlmZddlmZmZddl m Z m Z m Z mZddlmZmZddlZdd lmZmZmZdd lmZmZmZdd lmZdd lmZdd lm Z m!Z!ddl"m#Z#m$Z$erddl%m&Z&e j'Z'dZ(GddeZ)Gdde*Z+e),Z-e-.ddZ/gdZ0dS)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) OrderedDict)IterableMapping) Parameter getcallargsgetfullargspec signature) TYPE_CHECKINGClassVar)ColumnPanelRow)HTMLPaneBasepanel)ReplacementPane)Viewable)ButtonWidget)fixedwidget)Modelc#zK|j}|j}|j}|j}|ttf}|t jt jfvr||vr||}nq|tur-tj j dt|}n;|tur.|}t|ttfrt!|}n|V|||fVdS|t jkrM|D](\}} |||| tfV'dSdS)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_foundvaluekvs .lib/python3.11/site-packages/panel/interact.py"_yield_abbreviations_for_parameterr4%s] >D >D  CGue$I /1GHHH 6>>JJt$$EE    J  $ $&]^p r r rEE E ! !E%(G!455 %e OOOUG$$$$$$ & & &KKMM''))  DAq JJqMMMQ+     ' &  ceZdZUejeedZejddZ ej dZ eje Z dd iZd ed <iffd Zd!d ZejddddddZedZdZd"d#fd ZedZdZdZdZedZed ZxZS)$ interactiveF)rclass_ is_instancez: Whether to update manually by clicking on button.)rdoc Run Interact)r)r8_paneNz"ClassVar[Mapping[str, str | None]]_renamec ttdtj|fi||dd|_||} t|t|fid|Dn#t$rYnwxYw| |}|j r*| dt|jft||_|jd i|j}t'|t(r||_d|_n"t/||j|_d|_t3|j|_d|D}d |vr+|d t9d |jzt;||_|j|jg|j_ |!|"dS) Nz`interact requires either recent Python version (>=3.3 or IPython to inspect function signatures. throttledFci|] \}}}|| SrA).0nr2_s r3 z(interactive.__init__..as "?"?"?51Qq1Q"?"?"?r5manual)rTcBg|]\}}t|t|SrA)r(r)rBrDrs r3 z(interactive.__init__..os+QQQiaj6P6PQ6QQQr5rrz

%s

rA)#r ImportErrorsuper__init__r#r?find_abbreviations check_argspecr TypeErrorwidgets_from_abbreviations manual_updateappendr manual_namer_widgetsobjectr-r(rr< _internalrrr _inner_layoutinsertrr widget_boxlayoutobjects _link_widgets _sync_layout)selfrTparamsr- new_kwargswidgetspane __class__s r3rKzinteractive.__init__Os  RSS S **6***K77,,V44  A & ! ! !  @ @"?"?J"?"?"? @ @ @ @     D  11*==   F NNHf$2B&C&C&CD E E E#G,, t{))T[)) dH % % "DJ"DNNt$)444DJ!DN __QQ7QQQ V   NN1d=49#<== > > > '*#0BC   s#B BBc<|j||||SN)rV _get_model)r]r:rootparentcomms r3rezinteractive._get_model{s!,,S$EEEr5z_pane.sizing_modez_pane.width_policyz_pane.height_policyT)watchct|dsdSd|jjD}|jj||jj|dS)NrVc"i|] \}}|dv || S)) sizing_mode width_policy height_policyrA)rBr1r2s r3rEz,interactive._sync_layout..s4   QDDD qDDDr5)hasattrr<r$valuesr+rVupdaterY)r]optss r3r\zinteractive._sync_layout~st_--  F  !Z-4466<<>>     ''---   &&&&&r5cgSrdrAr]s r3_synced_paramszinteractive._synced_paramss r5c:jrdjdfg}nj}|D]e\}}fd}jrt |drd}nd}|dkrdn|}|j||}j|fdS)NrFcjdij}tj|jj\}}|dS|_|jd<|_dS)NrrA)rTr-r_update_from_objectr<rUrV)change new_objectnew_paneinternalr]s r3 update_panez.interactive._link_widgets..update_panesl(T[774;77 %4%H DN&&"(#F& (0"1%!)r5value_throttledr0clicks) rPrSr+r?ror$ri_internal_callbacksrQ)r]r`r widget_objr}r2pnamewatchers` r3r[zinteractive._link_widgetss   , $-"9:;GGm))++G ' 5 5 D* * * * * *~ '*6G"H"H % $ 0 0HHaE &,,[%@@G  $ + +G 4 4 4 4- 5 5r5rf Model | NonereturnNonec~|j|t|dSrd)rV_cleanuprJ)r]rfrbs r3rzinteractive._cleanups8 ##D))) r5cHd|jDS)Nc0i|]\}}|dk ||jS)rF)r0)rBr1rs r3rEz&interactive.kwargs..s0"""IAv==6< ==r5)rSr+rts r3r-zinteractive.kwargss0""1D1D1F1F""" "r5c*t|jSrd)r rTrts r3r zinteractive.signatures%%%r5cg} |}n5#ttf$r!d|DcYSwxYw|jD]\}t ||D]I\}}}|tur"td|| |||fJ]|S)zqFind the abbreviations for the given function and kwargs. Return (name, abbrev, default) tuples. cg|] \}}|||f SrArA)rBkeyr0s r3rHz2interactive.find_abbreviations..s#KKKZS%c5%(KKKr5z5cannot find widget or abbreviation for argument: {!r}) r ValueErrorrNr+ parametersrpr4r formatrQ)r]r-r_sigr,rr0rs r3rLzinteractive.find_abbreviationss  L..""CCI& L L LKK6<<>>KKK K K K L..00 : :I(J9V\(](] : :$eWE>>$%\%c%cdh%i%ijjj!!4"89999 :s/A  A cFg}|D]\}}}t|tr|}nt|||}t|ts?t|ts*|]t dt|||f|S)zQGiven a sequence of (name, abbrev, default) tuples, return a sequence of Widgets.)rrNz{!r} is not a ValueWidget)r(rrrrNrrQ)r]seqresultrabbrevrrs r3rOz&interactive.widgets_from_abbreviationss%( . . !D&'&%(( H# #FwGGG z622 PjU6S6S P%#$?$F$Fv$N$NOOO MM4, - - - - r5c6t|tjSrd)r(types FunctionType)clsrTs r3applieszinteractive.appliess&%"4555r5cDtdd}t||S)NFr;rPrR)dict_InteractFactory)roptionss r3factoryzinteractive.factorys$UGGGW---r5)NNNrd)rfrrr) __name__ __module__ __qualname__r$ ClassSelectorrrdefault_layoutBooleanrPStringrRrr<r=__annotations__rKredependsr\propertyrur[rr-r rLrO classmethodrr __classcell__)rbs@r3r7r7As(U(5:<<>>M%,~666K E x 0 0 0E3:D/GAAAA&(&&&&&&XFFFFU]7/1EG\dhiii''ji'X555<""X"&&&$ 66[6..[.....r5r7c.eZdZdZddZdZddZdZdS)rax 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. Nc4||_||_|pi|_dSrdrrrr-)r]rrr-s r3rKz_InteractFactory.__init__s l r5c4|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)r]fs r3rz_InteractFactory.widgets$tx4944 444r5c @|rttjt|j}|fd|Dt|jfifd|D}t||j ||}}||Sdt|j vrtd| |} ||_ n#t$rfd}||_ YnwxYw|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)) c$i|] \}}|v || SrArArBr1r2r^s r3rEz-_InteractFactory.__call__..Ds$JJJ1!6//q!///r5c$i|] \}}|v || SrArArs r3rEz-_InteractFactory.__call__..Es$%U%U%Utq!far5Nr?z1A function cannot have "throttled" as an argumentc|i|SrdrA)argsr-_InteractFactory__interact_fs r3z+_InteractFactory.__call__..`s d(Ef(E(Er5)listr7r$rr-rqr+rrtyperrMrrrAttributeErrorrY)r]rr-kwrrrwr^s ` @r3__call__z_InteractFactory.__call__sAd  2++,,Fdk""B IIJJJJ JJJ K K K VV%U%U%U%Uv||~~%U%U%UVVD4::dhb11D  9K M!,,1 1 1PQQ Q KKNN AHH   FEEEAAHHH   xs5C==DDc t|j}|D]3}||vr"td|||||<4t ||j||jS)z Change options for interactive functions. Returns ------- A new :class:`_InteractFactory` which will apply the options when called. zinvalid option {!r})rrrrrrrr-)r]kwdsrrr1s r3rz_InteractFactory.optionsdssDI  A}} !6!=!=a!@!@AAA1gDGGtDzz$(D$+666r5rd)rrr__doc__rKrrrrAr5r3rrsi  #### 5 5 5SSSSj 7 7 7 7 7r5rTr;r)interactinteract_manualr7)1r __future__rr collectionsrcollections.abcrrinspectrrr rMr typingr r r$rYrrrrarrr pane.baserviewablerr`rrwidgets.widgetrr bokeh.modelrr r4r7rTrrrrr__all__rAr5r3rs  #""""" ######--------+******* &&&&&&&&&&''''''''''&&&&&&########))))))))"!!!!!!8h.h.h.h.h.(h.h.h.VE7E7E7E7E7vE7E7E7P    "">"RR 9 8 8r5