-e!dZddlmZddlZejeZddlZddlm Z m Z ddl m Z mZddlm Z mZmZmZmZmZmZmZmZddlmZdd lmZdd lmZdd lmZm Z dd l!m"Z"e rdd l#m$Z$dZ%eGdde"Z&Gdde&Z'Gdde&Z(Gdde(Z)Gdde&Z*dS)z Client-side interactivity. ) annotationsN) TYPE_CHECKINGAny)HasPropsabstract) rAnyRefAutoBoolDictEitherInstanceRequiredString)Init) Intrinsic)error)INVALID_PROPERTY_VALUENOT_A_PROPERTY_OF)Model)PathLike)CallbackOpenURLCustomJSSetValuec$eZdZdZdfd ZxZS)rz+ Base class for interactive callback. returnNonec:tj|i|dSNsuper__init__selfargskwargs __class__s 6lib/python3.11/site-packages/bokeh/models/callbacks.pyr#zCallback.__init__G%$)&)))))rr__name__ __module__ __qualname____doc__r# __classcell__r(s@r)rr@sG **********r+rcXeZdZdZd fd ZeddZedd ZxZ S) rz4 Open a URL in a new or current tab or window. rrc:tj|i|dSr r!r$s r)r#zOpenURL.__init__Pr*r+zhttp://z The URL to direct the web browser to. This can be a template string, which will be formatted with data from the data source. helpFz Open URL in a new (`False`, default) or current (`True`) tab or window. For `same_tab=False`, whether tab or window will be opened is browser dependent. r,) r.r/r0r1r#rurlr same_tabr2r3s@r)rrJsy ****** &"   C tE!   HHHHHr+rc$eZdZdZdfd ZxZS) CustomCode rrc:tj|i|dSr r!r$s r)r#zCustomCode.__init__br*r+r,r-r3s@r)r;r;^sB G**********r+r;ceZdZdZdfd ZeeeidZe edZ e e e d d ZeddZxZS)raU Execute a JavaScript function. .. warning:: The explicit purpose of this Bokeh Model is to embed *raw JavaScript code* for a browser to execute. If any part of the code is derived from untrusted user inputs, then you must take appropriate care to sanitize the user input prior to passing to Bokeh. rrc:tj|i|dSr r!r$s r)r#zCustomJS.__init__qr*r+z A mapping of names to Python objects. In particular those can be bokeh's models. These objects are made available to the callback's code snippet as the values of named parameters to the callback. )defaultr7a A snippet of JavaScript code to execute in the browser. This can be interpreted either as a JavaScript function or a module, depending on the ``module`` property: 1. A JS function. The code is made into the body of a function, and all of of the named objects in ``args`` are available as parameters that the code can use. Additionally, a ``cb_obj`` parameter contains the object that triggered the callback an optional ``cb_data`` parameter that contains any tool-specific data (i.e. mouse coordinates and hovered glyph indices for the ``HoverTool``) and additional document context in ``cb_context`` argument. 2. An ES module. A JavaScript module (ESM) exporting a default function with the following signature: .. code-block: javascript export default function(args, obj, data, context) { // program logic } where ``args`` is a key-value mapping of user-provided parameters, ``obj`` refers to the object that triggered the callback, ``data`` is a key-value mapping of optional parameters provided by the caller, and ``context`` is an additional document context. The additional document context is composed of the following members: * ``index``: The view manager governing all views in the current instance of ``Bokeh``. If only one instance of ``Bokeh`` is loaded, then this is equivalent to using ``Bokeh.index``. This function can be an asynchronous function (``async function () {}`` or ``async () => {}``) if for example external resources are needed, which would require usage of one of the asynchronous Web APIs, for example: .. code-block: javascript const response = await fetch("/assets/data.csv") const data = await response.text() r6autoz Whether to interpret the code as a JS function or ES module. If set to ``"auto"``, the this will be inferred from the code. pathrr&anyc $tj|}|jdkrd}n |jdkrd}ntd|t |d5}|}dddn #1swxYwYt ||| S) a Construct a ``CustomJS`` instance from a ``*.js`` or ``*.mjs`` file. For example, if we want to construct a ``CustomJS`` instance from a JavaScript module ``my_module.mjs``, that takes a single argument ``source``, then we would use: .. code-block: python from bokeh.models import ColumnDataSource, CustomJS source = ColumnDataSource(data=dict(x=[1, 2, 3])) CustomJS.from_file("./my_module.mjs", source=source) z.jsFz.mjsTz#expected a *.js or *.mjs file, got zutf-8)encodingN)coder&module)pathlibPathsuffix RuntimeErroropenreadr)clsrBr&rGfilerFs r) from_filezCustomJS.from_files |D!! ;%  FF [F " "FFKTKKLL L $ ) ) ) T99;;D               TV<<<rusg#"""""g!!,,,,,,,,0///////                      '&&&&&000000######NNNNNNNN&%%%%%%   *****u** *     h   (********f=f=f=f=f=zf=f=f=P!U!U!U!U!Ux!U!U!U!U!Ur+