U /eC @sdZddlmZddlZeeZddlmZm Z m Z m Z m Z m Z mZmZmZmZddlmZddlmZmZddlmZdd lmZmZmZmZmZdd lm Z m!Z!dd l"m#Z#dd l$m%Z%m&Z&m'Z'dd l(m)Z)ddl*m+Z+m,Z,ddl-m.Z.m/Z/ddl0m1Z1m2Z2m3Z3m4Z4m5Z5ddl6m7Z7er8ddl8m9Z9ddlm:Z:dZ;ee#e!fZede)ee1fZ?dddddddZ@edNddd d!dd"d#d$ZAedOddd%d!d&d"d'd$ZAedPd(dd d!d)d"d*d$ZAedQd(dd%d!d+d"d,d$ZAedRd-dd d!d.d"d/d$ZAedSd-dd%d!d0d"d1d$ZAdTd3ddd!d4d"d5d$ZAdeidd6d6fd7d8d9d:d;d!dddd< d=d>ZBGd?d@d@eZCdUddAd!d@dBdCdDZDdEdFdGdHdIZEdJd9ddKdLdMZFdS)Vz ) annotationsN) TYPE_CHECKINGAnyDictListSequenceTupleTypeUnioncastoverload)Template)Literal TypedDict) __version__) AUTOLOAD_JS AUTOLOAD_TAGFILEMACROSROOT_DIV) DEFAULT_TITLEDocument)Model) CSSResources JSResources Resources)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)ID)DocJson)autoload_static components file_html json_itemzUnion[Model, Document]rstrzTuple[str, str])model resources script_pathreturnc Cst|tr|g}nt|tr$|j}ntdt|t|g\}\}W5QRXtd|}|t t ||gt |j d\}}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 `` The ``"-widgets"``, ``"-tables"``, and ``"-mathjax"`` files are only necessary if your document includes :ref:`Bokeh widgets `, :ref:`data tables `, or :ref:`math text `, respectively. 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)rAr%r/)rootr3cSstj|tdS)N)rMmacros)rr<r)rMrBrBrC div_for_root sz components..div_for_rootc3s|]}|VqdSrIrB).0rMrOrBrC szcomponents..r)r6r_check_models_or_docsdict __class__keysr:valuesr$r'r r9rr"scriptsr7ziptuple) r=rFrGrHZwas_single_objectZ model_keys dict_typer>r?r4scriptresultsresultrBrQrCr,s4P       Fz"Model | Document | Sequence[Model]zAResources | Tuple[JSResources | None, CSSResources | None] | Nonez str | NonezTemplate | strzDict[str, Any]) r=r1titletemplatetemplate_variablesrHsuppress_callback_warning _always_newr3c Csg}t|tr|g}nt|tr(|j}n|}t|||dH} t||d\} } t||}t| g|} t| | | |||dW5QRSQRXdS)aY 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 (Resources or tuple(JSResources or None, CSSResources or None)) : A resource 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 )rL���Z always_new)rb���)r_���r`���ra���N) r6���r���r���r7���r$���r'���_title_from_modelsr ���r!���) r=���r1���r_���r`���ra���rH���rb���rc���Z models_seqdocr>���Z render_itemsr4���rB���rB���rC���r-�����s����4     �r-���c�������������������@��s.���e�Zd�ZU�ded<�ded<�ded<�ded<�d S�) StandaloneEmbedJson ID | None target_idr)���root_idr*���re���r/���versionN)__name__ __module__ __qualname____annotations__rB���rB���rB���rC���rf���`��s��� rf���rg���)r0���targetrH���r3���c�������������� ���C��sZ���t�|�g|d}d|_t|�g}W�5�Q�R�X�t|�d�}|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����r���r7���Zroot_ids)rh���ri���re���rj���)r$���r_���r&���r:���rW���rf���r���)r0���ro���rH���re���r>���Zdoc_jsonri���rB���rB���rC���r.���f��s����:r.���z%Union[ModelLike, ModelLikeCollection]ModelLikeCollection)r=���r3���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���r6���r���r���rP���xrB���rB���rC���rR�����s�����z(_check_models_or_docs.<locals>.<genexpr>Tc�����������������s��s���|�]}t�|tV��qd�S�rI���)r6���r/���rs���rB���rB���rC���rR�����s�����c�����������������s��s���|�]}t�|ttfV��qd�S�rI���rr���rs���rB���rB���rC���rR�����s�����zwInput must be a Model, a Document, a Sequence of Models and Document, or a dictionary from string to Model and Document) r6���r���r���r���allrT���rV���rW���r8���)r=���Zinput_type_validrB���rB���rC���rS�����s ���� rS���z Sequence[Union[Model, Document]])r=���r_���r3���c�����������������C��sX���|d�k r |S�|�D�]}t�|tr|j��S�qttt�|�D�]}|jd�k r8|jj��S�q8tS�rI���)r6���r���r_���r ���r���r���documentr���)r=���r_���prB���rB���rC���rd�����s����   rd���)...)...)...)...)...)...)TTN)NN)G__doc__ __future__r���logging getLoggerrk���logtypingr���r���r���r���r���r���r ���r ���r ���r ���Zjinja2r ���Ztyping_extensionsr���r���rp���r���Zcore.templatesr���r���r���r���r���Zdocument.documentr���r���r0���r���r1���r���r���r���Zthemesr���r4���r���r ���elementsr!���r"���utilr#���r$���r%���r&���r'���wrappersr(���Z core.typesr)���r*���__all__Z ModelLiker/���rq���rE���r+���r,���r-���rf���r.���rS���rd���rB���rB���rB���rC���<module>���s���  0        2���������������������� CP