-e *UdZddlmZddlZejeZddlZddlm Z ddl m Z m Z ddl mZddlmZdd lmZmZe rdd l mZdd lmZd d lmZmZdZGddZddZe dGddZdaded<dS)a Encapsulate implicit state that is useful for Bokeh plotting APIs. .. note:: While ``State`` objects can also be manipulated explicitly, they are automatically configured when the output functions like |output_file| from :ref:`bokeh.io` are used. Therefore, manipulating ``State`` objects is usually not necessary. Generating output for Bokeh plots requires coordinating several things: |Document| Groups together Bokeh models that may be shared between plots (e.g., range or data source objects) into one common structure. :class:`~bokeh.resources.Resources` Control how JavaScript and CSS for the client library BokehJS are included and used in the generated output. It is possible to handle the configuration of these things manually, and some examples of doing this can be found in ``examples/models`` directory. When developing sophisticated applications, it may be necessary or desirable to work at this level. However, for general use this would quickly become burdensome. This module provides a ``State`` class that encapsulates these objects and ensures their proper configuration in many common usage scenarios. ) annotationsN) dataclass) TYPE_CHECKINGcast)PathLike)Document) Resources ResourcesMode)ID)Server) CommsHandle NotebookType)curstateStatec"eZdZUdZded<ded<ded<ded <d ed <d)dZed*dZejd+dZed,dZ ed-dZ ed.dZ e jd/dZ d0d1d#Z d2d/d%Z d)d&Zd)d'Zd+d(ZdS)3rz8 Manage state related to controlling Bokeh output. FileConfig | None_filebool _notebookNotebookType | None_notebook_typezCommsHandle | Nonelast_comms_handlezdict[ID, Server]uuid_to_serverreturnNonecJd|_i|_|dSN)rrresetselfs .lib/python3.11/site-packages/bokeh/io/state.py__init__zState.__init__Vs#!%  r c|jS)zA A default |Document| to use for all output operations.  _documentr!s r#documentzState.document] ~r%docc||_dSrr'r"r+s r#r)zState.documentds r%c|jS)z A structure with the default configuration for file output (READ ONLY) See :class:`~bokeh.io.state.FileConfig`. )rr!s r#filez State.filehs zr%c|jS)zN Whether to generate notebook output on show operations. (READ ONLY) )rr!s r#notebookzState.notebookqr*r%c|jS)z Notebook type )rr!s r# notebook_typezState.notebook_typexs ""r%r3rc|t|tstdtd||_dS)z Notebook type, acceptable values are 'jupyter' as well as any names defined by external notebook hooks that have been installed. NzNotebook type must be a stringr) isinstancestr ValueErrorrlowerrr"r3s r#r3zState.notebook_typesL  =#(F(F =>> >">=3F3F3H3HIIr% Bokeh PlotNfilenamertitler6modeResourcesMode | Noneroot_dirPathLike | Nonect|t||||_tj|r t d|ddSdS)aT Configure output to a standalone HTML file. Calling ``output_file`` does not clear the effects of any other calls to |output_notebook|, etc. It adds an additional output destination (publishing to HTML files). Any other active output modes continue to be active. Args: filename (PathLike, e.g. str, Path) : a filename for saving the HTML document title (str, optional) : a title for the HTML document mode (str, optional) : how to include BokehJS (default: ``'cdn'``) One of: ``'inline'``, ``'cdn'``, ``'relative(-dev)'`` or ``'absolute(-dev)'``. See :class:`~bokeh.resources.Resources` for more details. root_dir (str, optional) : root dir to use for absolute resources (default: None) This value is ignored for other resource types, e.g. ``INLINE`` or ``CDN``. .. warning:: The specified output file will be overwritten on every save, e.g., every time ``show()`` or ``save()`` is called. )r=r?)r; resourcesr<zSession output file 'z&' already exists, will be overwritten.N) FileConfigr rospathisfileloginfo)r"r;r<r=r?s r# output_filezState.output_filesy< TH===    7>>( # # _ HH]X]]] ^ ^ ^ ^ ^ _ _r%jupyterc"d|_||_dS)aW Generate output in notebook cells. Calling ``output_notebook`` does not clear the effects of any other calls to |output_file|, etc. It adds an additional output destination (publishing to notebook output cells). Any other active output modes continue to be active. Returns: None TN)rr3r9s r#output_notebookzState.output_notebooks*r%cH|tdS)z Deactivate all currently active output modes and set ``curdoc()`` to a fresh empty ``Document``. Subsequent calls to ``show()`` will not render until a new output mode is activated. Returns: None N)_reset_with_docr r!s r#r z State.resets" XZZ(((((r%c0d|_d|_d|_dS)zE Reset output modes but DO NOT replace the default Document NF)rrrr!s r#_reset_keeping_doczState._reset_keeping_docs  "r%c<||_|dS)zA Reset output modes but DO replace the default Document N)r(rPr-s r#rNzState._reset_with_docs# !!!!!r%)rr)rr )r+r rr)rr)rr)rr)r3rrr)r:NN) r;rr<r6r=r>r?r@rr)rJ)__name__ __module__ __qualname____doc____annotations__r$propertyr)setterr/r1r3rIrLr rPrNr%r#rrJsOOO''''))))$$$$X __XX ###X# JJJJrfs<#"""""g!! !!!!!!&&&&&&&&"!!!!!000000004&&&&&&33333333  S"S"S"S"S"S"S"S"j      $r%