;g5 b d Z ddlmZ ddlZddlmZmZ ddlmZm Z m
Z m Z ddl
mZmZ ddlZddlmZmZmZ dd lmZmZmZ dd
lmZ dd lm Z dd l m Z m Z dd
l m!Z!m"Z" erddl#m$Z$ ejJ Z%d Z& G d de Z' G d d Z(e'jS Z*e*jW dd Z,g dZ-y)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)HTMLPanepanel)ReplacementPane)Viewable)Button
WidgetBase)fixedwidget)Modelc # K | j }| j }| j }| j }|t t f}|t
j t
j fv r||v r|j | }ni|t ur1t j j j dt |}n0|t ur$|}t |t t f rt! | }n| ||f y|t
j" k( rC|j% j' D ]! \ }} |j | || t f # yyw)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
annotationdefaultemptyr POSITIONAL_OR_KEYWORD KEYWORD_ONLYpopparammainwarningDeprecationWarning
isinstancer r r VAR_KEYWORDcopyitems)
parameterkwargsr r annr not_foundvaluekvs
.lib/python3.12/site-packages/panel/interact.py"_yield_abbreviations_for_parameterr3 $ s >>D >>D
C Gue$I //1G1GHH 6>JJt$E
JJ $ $ &]^p
rE
E
!E%(G!45 e OUG$$
&& &KKM'')DAq JJqMQ+ *
's D>E c | e Zd ZU ej eed Z ej dd Z ej d Z ej e Z
dd iZd
ed < i f fd Zd d
Z ej$ ddddd d Zed Zd Zd d fd
Zed Zd Zd Zd Ze d Z e d Z xZ S ) interactiveF)r class_ is_instancez:
Whether to update manually by clicking on button.)r doc Run Interact)r )r6 _paneNz"ClassVar[Mapping[str, str | None]]_renamec t t d t | |fi | |j dd | _ | j
| } t | t |fi |D ci c] \ }}}|| c}}} | j | }| j r'|j dt | j f t | | _ | j" d i | j$ } t' | t( r| | _ d| _ n#t/ | | j0 | _ d| _ t3 | j* | _ |D
cg c] \ }}
t' |
t6 s|
}}}
d|v r)|j9 dt; d | j0 d
t= | | _ | j> | j4 g| j@ _! | jE | jG y c c}}}w # t $ r Y w xY wc c}
}w ) Nz`interact requires either recent Python version (>=3.3 or IPython to inspect function signatures. throttledFmanual)r Tr r zz
)$r ImportErrorsuper__init__r" r= find_abbreviations
check_argspecr TypeErrorwidgets_from_abbreviations
manual_updateappendr manual_namedict_widgetsobjectr, r' r r: _internalr r r
_inner_layoutr insertr r
widget_boxlayoutobjects
_link_widgets _sync_layout) selfrL paramsr,
new_kwargsnr1 _widgetspaner __class__s r2 rB zinteractive.__init__N s R S
S *6* K7,,V4
A & !
@J"?J51Qq1Q3J"? @11*= NNHf$2B2B&CD E W
t{{)T[[) dH % DJ "DN t$))4DJ !DN _+2U7iaj6T67U V NN1dT$))E#: ; < '* #0B0B C ) #@ $ Vs$ G4 %G- H$H4 H Hc > | j j |||| S N)rN
_get_model)rU r8 rootparentcomms r2 r_ zinteractive._get_modelz s !!,,S$EE z_pane.sizing_modez_pane.width_policyz_pane.height_policyT)watchc P t | d sy | j j j j D ci c] \ }}|dv r|| }}}| j
j j
| | j j j
| y c c}}w )NrN ) sizing_mode width_policy
height_policy)hasattrr: r# valuesr* rN updaterQ )rU r0 r1 optss r2 rT zinteractive._sync_layout} s t_- !ZZ - - 4 4 6 < < >
>TQDD
qD >
''- &
s B"c g S r^ r? rU s r2 _synced_paramszinteractive._synced_params s rc c P j rd j d fg}n j j }|D ]g \ }} fd} j rt |d rd}nd}|dk( rdn|}|j
j
|| } j j | i y )Nr> c j di j }t j |j j
\ }}|y |_ |j d< |_ y )Nr r? )rL r, r _update_from_objectr: rM rN )change
new_objectnew_paneinternalrU s r2 update_panez.interactive._link_widgets..update_pane si (T[[ 74;; 7
%4%H%H
DNN&"( # &
(0""1%!)rc value_throttledr/ clicks) rG rK r* r= ri r# rd _internal_callbacksrH )rU rZ r
widget_objrw r1 pnamewatchers ` r2 rS zinteractive._link_widgets s $--"9:;Gmm))+G ' D*
* ~~'*6G"H% $ 0HaE &&,,[%@G $ $ + +G 4- !(rc c Z | j j | t | | y r^ )rN _cleanuprA )rU r` r\ s r2 r zinteractive._cleanup s$ ##D)
rc c | j j D ci c] \ }}|dk7 r
||j c}}S c c}}w )Nr> )rK r* r/ )rU r0 r s r2 r, zinteractive.kwargs sG 15 1D1D1F "1FIAv= 6<<1F " " "s >c , t | j S r^ )r rL rn s r2 r zinteractive.signature s %%rc c l g } | j }|j j D ]A }t
|| D ]0 \ }}}|t u rt d| |j |||f 2 C |S # t t f$ r0 |j D cg c]
\ }}|||f nc c}}w c}}cY S w xY w)zqFind the abbreviations for the given function and kwargs.
Return (name, abbrev, default) tuples.
z1cannot find widget or abbreviation for argument: ) r
ValueErrorrE r*
parametersrj r3 r rH ) rU r, rW sigkeyr/ r+ r r s r2 rC z interactive.find_abbreviations s
L.."C
..0I(J9V\(]$eWE>$'XY]X`%abb!!4"89 )^ 1
I& L;A<<>K>ZS%c5%(>K K Ls A4 4"B3B&% B32B3c g }|D ]o \ }}}t |t r|}nt ||| }t |t s%t |t s|Kt t d |j ||f q |S )zQGiven a sequence of (name, abbrev, default) tuples, return a sequence of Widgets.)r r z is not a ValueWidget)r' r r r rE rH )rU seqresultr abbrevr r{ s r2 rF z&interactive.widgets_from_abbreviations s} %( !D&'&%( #
#Fw G
z:6*ZQV:W % #vj0E$FGG MM4, - &)
rc c 6 t |t j S r^ )r' types FunctionType)clsrL s r2 applieszinteractive.applies s &%"4"455rc c 4 t dd }t | | S )NFr9 rG rI )rJ _InteractFactory)r optionss r2 factoryzinteractive.factory s UG W--rc )NNNr^ )r` z Model | NonereturnNone) __name__
__module__ __qualname__r#
ClassSelectorr
r default_layoutBooleanrG StringrI r r: r; __annotations__rB r_ dependsrT propertyro rS r r, r rC rF classmethodr r
__classcell__)r\ s @r2 r5 r5 @ s (U((5:M %,,~6K E x 0E3:D/G
/A&( & XF U]]7 /1EG\dhi' j' 5< " "&$ 6 6 . .rc r5 c , e Zd ZdZddZd ZddZd Zy)r az
Factory for instances of :class:`interactive`.
Parameters
----------
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.
Nc 6 || _ || _ |xs i | _ y r^ r rl r, )rU r r r, s r2 rB z_InteractFactory.__init__ s l rc c R | j || j fi | j S )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 )rU fs r2 r z_InteractFactory.widget s$ txx4994 44rc c
|rt t j }t | j }|j |j
D ci c]
\ }}||vs || c}} t | j fi |j
D ci c]
\ }}||v s || c}}} t | | j || } }|| S dt | j v r t d | j | } | |_
| j S c c}}w c c}}w # t $ r fd}| |_
Y | j S w xY w)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))
r= z1A function cannot have "throttled" as an argumentc | i |S r^ r? )argsr, _InteractFactory__interact_fs r2 z+_InteractFactory.__call__.._ s d(Ef(Erc )listr5 r# rJ r, rk r* rl typer rD r r r AttributeErrorrQ )
rU r r, rV kwr0 r1 rl r ws
` r2 __call__z_InteractFactory.__call__ s, d +++,Fdkk"B II J1!6/q!tJ K Vv||~%U~tq!fad~%UVD 4:dhhb1D 9 K
M! , 1 1
1 PQ Q
KKN AH xx= K%U0 FAAHxx s* D
D
D D>D E ?E c t | j }|D ] }||vrt d| || ||< t | | j || j
S )z
Change options for interactive functions.
Returns
-------
A new :class:`_InteractFactory` which will apply the
options when called.
zinvalid option )rJ rl r r r r, )rU kwdsrl r0 s r2 r z_InteractFactory.optionsc s` DIIA} ?1%!8991gDG tDz$((D$++66rc r^ )r r r __doc__rB r r r r? rc r2 r r s
#
5 Sj
7rc r Tr9 r )interactinteract_manualr5 ).r
__future__r r collections.abcr r inspectr r r rD r typingr
r r# rQ r
r r r[ r r r pane.baser viewabler rZ r r widgets.widgetr r bokeh.modelr r r3 r5 r r r r r __all__r? rc r2 r s # - + & & # # & ' )! 8h.$ h.VE7 E7P "">"R 9rc