a @DfE @sUdZddlmZddlZeeZddlmZm Z m Z m Z m Z m Z mZmZddlmZddlmZmZmZmZmZddlmZmZdd lmZdd lmZmZdd l m!Z!d d l"m#Z#m$Z$d dl%m&Z&m'Z'd dl(m)Z)m*Z*m+Z+m,Z,m-Z-d dl.m/Z/er*ddl0m1Z1ddl2m3Z3ddl4m5Z5ddlm6Z6dZ7e eefZ8de9d<e e e8e:e;e8ffZde9d<ddddddd Z?edQd"d#d$ddd%d&d'Z@edRd"d#d(dd)d%d*d'Z@edSd+d#d$dd,d%d-d'Z@edTd+d#d(dd.d%d/d'Z@edUd0d#d$dd1d%d2d'Z@edVd0d#d(dd3d%d4d'Z@dWd6d#d#dd7d%d8d'Z@dXeidd9d9d:d;dd?dd#d#dd@ dAdBZAGdCdDdDe ZBdYd"dEddDdFdGdHZCdIddJdKdLZDdMd=ddNdOdPZEdS)Zz ) annotationsN) TYPE_CHECKINGAnyLiteralSequence TypedDictUnioncastoverload) __version__) AUTOLOAD_JS AUTOLOAD_TAGFILEMACROSROOT_DIV) DEFAULT_TITLEDocument)Model) Resources ResourcesLike)Theme)Scriptbundle_for_objs_and_resources)html_page_for_render_itemsscript_for_render_items) FromCurdocOutputDocumentFor RenderRootstandalone_docs_json%standalone_docs_json_and_render_items)wrap_in_onload)Template) TypeAlias)ID)DocJson)autoload_static components file_html json_itemr$ ModelLikeModelLikeCollection ThemeLikezModel | Documentrstrztuple[str, str])model resources script_pathreturnc Cst|tr|g}nt|tr$|j}ntdt| t|g\}\}Wdn1sZ0Ytd|}|t t ||gt t |j \}}ttj||d} tj||d} | | fS)a Return JavaScript code and a script tag that can be used to embed Bokeh Plots. The data for the plot is stored directly in the returned JavaScript code. Args: model (Model or Document) : resources (Resources) : script_path (str) : Returns: (js, tag) : JavaScript code to be saved at ``script_path`` and a `` Only the Bokeh core library ``bokeh-x.y.z.min.js`` is always required. The other scripts are optional and only need to be included if you want to use corresponding features: * The ``"bokeh-widgets"`` files are only necessary if you are using any of the :ref:`Bokeh widgets `. * The ``"bokeh-tables"`` files are only necessary if you are using Bokeh's :ref:`data tables `. * The ``"bokeh-api"`` files are required to use the :ref:`BokehJS API ` and must be loaded *after* the core BokehJS library. * The ``"bokeh-gl"`` files are required to enable :ref:`WebGL support `. * the ``"bokeh-mathjax"`` files are required to enable :ref:`MathJax support `. Args: models (Model|list|dict|tuple) : A single Model, a list/tuple of Models, or a dictionary of keys and Models. wrap_script (boolean, optional) : If True, the returned javascript is wrapped in a script tag. (default: True) wrap_plot_info (boolean, optional) : If True, returns ``
`` strings. Otherwise, return :class:`~bokeh.embed.RenderRoot` objects that can be used to build your own divs. (default: True) theme (Theme, optional) : Applies the specified theme when creating the components. If None, or not specified, and the supplied models constitute the full set of roots of a document, applies the theme of that document to the components. Otherwise applies the default theme. Returns: UTF-8 encoded *(script, div[s])* or *(raw_script, plot_info[s])* Examples: With default wrapping parameter values: .. code-block:: python components(plot) # => (script, plot_div) components((plot1, plot2)) # => (script, (plot1_div, plot2_div)) components({"Plot 1": plot1, "Plot 2": plot2}) # => (script, {"Plot 1": plot1_div, "Plot 2": plot2_div}) Examples: With wrapping parameters set to ``False``: .. code-block:: python components(plot, wrap_script=False, wrap_plot_info=False) # => (javascript, plot_root) components((plot1, plot2), wrap_script=False, wrap_plot_info=False) # => (javascript, (plot1_root, plot2_root)) components({"Plot 1": plot1, "Plot 2": plot2}, wrap_script=False, wrap_plot_info=False) # => (javascript, {"Plot 1": plot1_root, "Plot 2": plot2_root}) FTN apply_theme)rBrr.)rootr2cSstj|tdS)N)rMmacros)rr=r)rMrCrCrD div_for_rootsz components..div_for_rootcsg|] }|qSrCrC).0rMrOrCrD zcomponents..r)r5r_check_models_or_docsdict __class__keyslistvaluesrr!rr8rrscriptsr6ziptuple) r>rFrGrHZwas_single_objectZ model_keys dict_typer?r@r3scriptresultsresultrCrQrDr(s4\   ,     F)templatetemplate_variablesrHsuppress_callback_warning _always_newz"Model | Document | Sequence[Model]zResourcesLike | Nonez str | NonezTemplate | strzdict[str, Any]) r>r0titlerarbrHrcrdr2c Csg}t|tr|g}n,t|tr>t|jdkr6td|j}n|}t|}t|||dJ} t ||d\} } t ||}t | g|} t | | | |||dWdS1s0YdS)a* Return an HTML document that embeds Bokeh Model or Document objects. The data for the plot is stored directly in the returned HTML, with support for customizing the JS/CSS resources independently and customizing the jinja2 template. Args: models (Model or Document or seq[Model]) : Bokeh object or objects to render typically a Model or Document resources (ResourcesLike) : A resources configuration for Bokeh JS & CSS assets. title (str, optional) : A title for the HTML document ```` tags or None. (default: None) If None, attempt to automatically find the Document title from the given plot objects. template (Template, optional) : HTML document template (default: FILE) A Jinja2 Template, see bokeh.core.templates.FILE for the required template parameters template_variables (dict, optional) : variables to be used in the Jinja2 template. If used, the following variable names will be overwritten: title, bokeh_js, bokeh_css, plot_script, plot_div theme (Theme, optional) : Applies the specified theme to the created html. If ``None``, or not specified, and the function is passed a document or the full set of roots of a document, applies the theme of that document. Otherwise applies the default theme. suppress_callback_warning (bool, optional) : Normally generating standalone HTML from a Bokeh Document that has Python callbacks will result in a warning stating that the callbacks cannot function. However, this warning can be suppressed by setting this value to True (default: False) Returns: UTF-8 encoded HTML r���zDocument has no root Models)rL���Z always_new)rc���)re���ra���rb���N) r5���r���r���lenr6���r7���r���buildr���r!���_title_from_modelsr���r���) r>���r0���re���ra���rb���rH���rc���rd���Z models_seqdocr?���Z render_itemsr3���rC���rC���rD���r)���&��s ����4      r)���c�������������������@��s.���e�Zd�ZU�ded<�ded<�ded<�ded<�d S�) StandaloneEmbedJson ID | None target_idr%���root_idr&���ri���r.���versionN)__name__ __module__ __qualname____annotations__rC���rC���rC���rD���rj���m��s��� rj���rk���)r/���targetrH���r2���c�����������������C��sd���t�|�g|d&}d|_t|�g�\}W�d���n1�s:0����Y��|d�d�d�}t|||tdS�)a�� Return a JSON block that can be used to embed standalone Bokeh content. Args: model (Model) : The Bokeh object to embed target (string, optional) A div id to embed the model into. If None, the target id must be supplied in the JavaScript call. theme (Theme, optional) : Applies the specified theme to the created html. If ``None``, or not specified, and the function is passed a document or the full set of roots of a document, applies the theme of that document. Otherwise applies the default theme. Returns: JSON-like This function returns a JSON block that can be consumed by the BokehJS function ``Bokeh.embed.embed_item``. As an example, a Flask endpoint for ``/plot`` might return the following content to embed a Bokeh plot into a div with id *"myplot"*: .. code-block:: python @app.route('/plot') def plot(): p = make_plot('petal_width', 'petal_length') return json.dumps(json_item(p, "myplot")) Then a web page can retrieve this JSON and embed the plot by calling ``Bokeh.embed.embed_item``: .. code-block:: html <script> fetch('/plot') .then(function(response) { return response.json(); }) .then(function(item) { Bokeh.embed.embed_item(item); }) </script> Alternatively, if is more convenient to supply the target div id directly in the page source, that is also possible. If `target_id` is omitted in the call to this function: .. code-block:: python return json.dumps(json_item(p)) Then the value passed to ``embed_item`` is used: .. code-block:: javascript Bokeh.embed.embed_item(item, "myplot"); rK����Nr6���r���id)rl���rm���ri���rn���)r���re���r ���rY���rj���r ���)r/���rs���rH���ri���Zdoc_jsonrm���rC���rC���rD���r*���s��s����:.r*���zModelLike | ModelLikeCollection)r>���r2���c�����������������C��s���d}t�|�ttfr|�g}�t�|�tr8tdd�|�D�r8d}t�|�trrtdd�|��D�rrtdd�|��D�rrd}|s~td|�S�)z Fc�����������������s��s���|�]}t�|ttfV��qd�S�rI���r5���r���r���rP���xrC���rC���rD��� <genexpr>��rS���z(_check_models_or_docs.<locals>.<genexpr>Tc�����������������s��s���|�]}t�|tV��qd�S�rI���)r5���r.���rw���rC���rC���rD���ry�����rS���c�����������������s��s���|�]}t�|ttfV��qd�S�rI���rv���rw���rC���rC���rD���ry�����rS���zwInput must be a Model, a Document, a Sequence of Models and Document, or a dictionary from string to Model and Document) r5���r���r���r���allrU���rW���rY���r7���)r>���Zinput_type_validrC���rC���rD���rT�����s ���� rT���zSequence[Model | Document])r>���re���r2���c�����������������C��sX���|d�ur |S�|�D�]}t�|tr|j��S�qttt�|�D�]}|jd�ur8|jj��S�q8tS�rI���)r5���r���re���r ���r���r���documentr���)r>���re���prC���rC���rD���rh�����s����   rh���)...)...)...)...)...)...)TTN)NN)NN)F__doc__ __future__r���logging getLoggerro���logtypingr���r���r���r���r���r���r ���r ���rt���r ���Zcore.templatesr ���r���r���r���r���Zdocument.documentr���r���r/���r���r0���r���r���Zthemesr���r3���r���r���elementsr���r���utilr���r���r���r ���r!���wrappersr"���Zjinja2r#���Ztyping_extensionsr$���Z core.typesr%���r&���__all__r+���rr���rU���r.���r,���typer-���r'���r(���r)���rj���r*���rT���rh���rC���rC���rC���rD���<module>���s���  (         2��������������� ��"GO