-eh` U d Z ddlmZ ddlZ ej e ZddlZddlZddl Z ddl
m Z m Z m
Z
mZmZmZmZmZmZ ddlmZ e r ddlmZ ddlmZ dd lmZ dd
l m Z dd l m Z d d
l m!Z! e r2ddl"m#Z# ddl$m%Z% ddl&m'Z'm(Z(m)Z)m*Z*m+Z+ ddl,m-Z- ddl.m/Z/ ddl0m1Z1 d dl m2Z2 dZ3dZ4dZ5dZ6dZ7dZ8ed Z9 G d d Z: G d d e Z; G d d!e Z< G d" d#e Z= G d$ d%e Z> dwdxd0Z?dddd1dyd8Z@dzd>ZAd{dAZBd|dEZCd}dFZD d~ddNZEdddOddVZFe
eeGdf geHf ZIdWeJdX< e7dfdd`ZKeddc ZLedde ZLdddfZLi ZMdgeJdh< daNdIeJdi< dddpZOddrZPddtZQdduZRddvZSdS )z
) annotationsN)
TYPE_CHECKINGAnyCallableLiteralProtocol TypedDictUnioncastoverload)uuid4Comm) TypeAlias )ID)make_id)warn )curstate) Application)Document)ColumnDataChangedEventColumnsPatchedEventColumnsStreamedEventDocumentPatchedEventModelChangedEvent)Bundle)Model Resources)State text/htmlzapplication/javascriptz$application/vnd.bokehjs_load.v0+jsonz$application/vnd.bokehjs_exec.v0+jsonzlocalhost:8888) CommsHandledestroy_server get_commsinstall_notebook_hookinstall_jupyter_hooks
load_notebookpublish_display_data
push_notebookrun_notebook_hookshow_appshow_doc)jupyterzeppelinc e Zd ZU dZi Zded< ded< ded< d d
Zd dZed d Z ed d Z
d dZ d!dZ d"dZ
d#dZdS )$r$
r _json
int | None_cellnor _doccommsr cell_docreturnNonec d | _ ddlm} | }|J |j }|J t t | dd d }|| _ n2# t $ r%}t d| Y d }~nd }~ww xY w|| _
|| _ | j d S )Nr ) get_ipythonr T)include_latestz.Could not get Notebook cell number, reason: %s)
r5 IPythonr< history_managernextiterget_tail Exceptionlogdebug_commsr6 hold)selfr7 r8 r< iphmp_promptes 1lib/python3.11/site-packages/bokeh/io/notebook.py__init__zCommsHandle.__init__l s K + + + + + + B>>>#B>>>DQt!D!D E EFFqIH#DLL K K K IIF J J J J J J J J K
s A A' '
B1BBstrc * | j d| j dS dS )Nz2<Bokeh Notebook handle for In[z]>
z1<Bokeh Notebook handle>
)r5 rH s rM _repr_html_zCommsHandle._repr_html_ s# < #o ooo oFF c | j S N)rF rQ s rM r7 zCommsHandle.comms s
{rS c | j S rU )r6 rQ s rM doczCommsHandle.doc s
yrS eventr c x |j j | j j v r!| j j | d S d S rU modelidrW models callbackstrigger_on_changerH rX s rM _document_model_changedz#CommsHandle._document_model_changed < ;>TX_ , , H 0 0 7 7 7 7 7 - ,rS r c x |j j | j j v r!| j j | d S d S rU rZ r` s rM _column_data_changedz CommsHandle._column_data_changed rb rS r c x |j j | j j v r!| j j | d S d S rU rZ r` s rM _columns_streamedz CommsHandle._columns_streamed rb rS r c x |j j | j j v r!| j j | d S d S rU rZ r` s rM _columns_patchedz CommsHandle._columns_patched rb rS N)r7 r r8 r r9 r: )r9 rO )r9 r )r9 r )rX r r9 r: )rX r r9 r: )rX r r9 r: )rX r r9 r: )__name__
__module__ __qualname____doc__r3 __annotations__rN rR propertyr7 rW ra rd rf rh rS rM r$ r$ d s EOOOONNN *G G G G X X8 8 8 88 8 8 88 8 8 88 8 8 8 8 8rS r$ c e Zd Zd d
Zd S )
Load resourcesr! verbosebool hide_banner load_timeoutintr9 r: c d S rU ro )rH rr rs ru rv s rM __call__z
Load.__call__ rS N)
rr r! rs rt ru rt rv rw r9 r: ri rj rk ry ro rS rM rq rq s nnnnnnrS rq c e Zd Zd
dZd S ) ShowDocobjr stater" notebook_handler$ r9 c d S rU ro )rH r~ r r s rM ry zShowDoc.__call__ rz rS Nr~ r r r" r r$ r9 r$ r{ ro rS rM r} r} s bbbbbbrS r} c e Zd Zd
d Zd S )ShowAppappr r r" notebook_urlstr | ProxyUrlFunckwr r9 r: c d S rU ro )rH r r r r s rM ry zShowApp.__call__ rz rS N)
r r r r" r r r r r9 r: r{ ro rS rM r r s pppppprS r c . e Zd ZU ded< ded< ded< dS )Hooksrq loadr} rW r r N)ri rj rk rm ro rS rM r r s+ JJJLLLLLLLLrS r F
notebook_type NotebookTyper r. r- overwritert r9 r: c v | t v r|st d| d t ||| t | < dS )ax Install a new notebook display hook.
Bokeh comes with support for Jupyter notebooks built-in. However, there are
other kinds of notebooks in use by different communities. This function
provides a mechanism for other projects to instruct Bokeh how to display
content in other notebooks.
This function is primarily of use to developers wishing to integrate Bokeh
with new notebook types.
Args:
notebook_type (str) :
A name for the notebook type, e.e. ``'Jupyter'`` or ``'Zeppelin'``
If the name has previously been installed, a ``RuntimeError`` will
be raised, unless ``overwrite=True``
load (callable) :
A function for loading BokehJS in a notebook type. The function
will be called with the following arguments:
.. code-block:: python
load(
resources, # A Resources object for how to load BokehJS
verbose, # Whether to display verbose loading banner
hide_banner, # Whether to hide the output banner entirely
load_timeout # Time after which to report a load fail error
)
show_doc (callable) :
A function for displaying Bokeh standalone documents in the
notebook type. This function will be called with the following
arguments:
.. code-block:: python
show_doc(
obj, # the Bokeh object to display
state, # current bokeh.io "state"
notebook_handle # whether a notebook handle was requested
)
If the notebook platform is capable of supporting in-place updates
to plots then this function may return an opaque notebook handle
that can be used for that purpose. The handle will be returned by
``show()``, and can be used by as appropriate to update plots, etc.
by additional functions in the library that installed the hooks.
show_app (callable) :
A function for displaying Bokeh applications in the notebook
type. This function will be called with the following arguments:
.. code-block:: python
show_app(
app, # the Bokeh Application to display
state, # current bokeh.io "state"
notebook_url, # URL to the current active notebook page
**kw # any backend-specific keywords passed as-is
)
overwrite (bool, optional) :
Whether to allow an existing hook to be overwritten by a new
definition (default: False)
Returns:
None
Raises:
RuntimeError
If ``notebook_type`` is already installed and ``overwrite=False``
zhook for notebook type z already exists)r rW r N)_HOOKS RuntimeErrorr )r r r. r- r s rM r' r' sN X y U]UUUVVV !tx H H HF=rS )documentr handler Document | Noner State | Noner CommsHandle | Nonec , ddl m} |t }| s|j } | st d dS ||j }|st d dS t
|j j j }t | dk rdS g |j j _ | dt t d | }|j
|j |j
|j |j
|j |j D ]e}t' j |j }| }|j
| |j
|g fdS )
a6 Update Bokeh plots in a Jupyter notebook output cells with new data
or property values.
When working the the notebook, the ``show`` function can be passed the
argument ``notebook_handle=True``, which will cause it to return a
handle object that can be used to update the Bokeh output later. When
``push_notebook`` is called, any property updates (e.g. plot titles or
data source values, etc.) since the last call to ``push_notebook`` or
the original ``show`` call are applied to the Bokeh output in the
previously rendered Jupyter output cell.
Several example notebooks can be found in the GitHub repository in
the :bokeh-tree:`examples/output/jupyter/push_notebook` directory.
Args:
document (Document, optional):
A |Document| to push from. If None uses ``curdoc()``. (default:
None)
state (State, optional) :
A :class:`State` object. If None, then the current default
state (set by |output_file|, etc.) is used. (default: None)
Returns:
None
Examples:
Typical usage is typically similar to this:
.. code-block:: python
from bokeh.plotting import figure
from bokeh.io import output_notebook, push_notebook, show
output_notebook()
plot = figure()
plot.circle([1,2,3], [4,6,5])
handle = show(plot, notebook_handle=True)
# Update the plot title in the earlier cell
plot.title.text = "New Title"
push_notebook(handle=handle)
r )r NzNo document to pushzzCannot find a last shown plot to update. Call output_notebook() and show(..., notebook_handle=True) before push_notebook()r z PATCH-DOCr )buffers)protocolr r r r last_comms_handlelistrW r^ _held_eventslencreater r7 send header_json
metadata_json content_jsonr jsondumpsrefto_bytes) r r r
BokehProtocoleventsmsgbufferheaderpayloads rM r+ r+ s d 544444 }
">
"###
~( J K K K
&*&3
4
4F
6{{a(*FJ%
-//
d48N3OQW.X.X
Y
YC
Lco&&&
Lc'(((
Lc&'''+ - -FJ''//## &!!! 7),,,, - -rS action Literal['load', 'doc', 'app']argsr kwargsc | t vrt d| t | | t d| d|d t | | |i |S )a Run an installed notebook hook with supplied arguments.
Args:
noteboook_type (str) :
Name of an existing installed notebook hook
actions (str) :
Name of the hook action to execute, ``'doc'`` or ``'app'``
All other arguments and keyword arguments are passed to the hook action
exactly as supplied.
Returns:
Result of the hook action, as-is
Raises:
RuntimeError
If the hook or specific action is not installed
z,no display hook installed for notebook type Nznotebook hook for z did not install z action)r r )r r r r s rM r, r, [ sv * F""[-[[\\\
m V$,c
ccRXcccddd - ($ 9& 9 99rS server_idr c t j | d }| t d| dS | D ]}| | t j | = dS # t $ r+}t d| d| Y d}~dS d}~ww xY w)z Given a UUID id of a div removed or replaced in the Jupyter
notebook, destroy the corresponding server sessions and stop it.
Nz#No server instance found for uuid: z Could not destroy server for id z: ) r uuid_to_servergetrD rE get_sessionsdestroystoprC )r serversessionrL s rM r% r% z s
ZZ
&
*
*9d
;
;F
~ E EEFFFI **,, G OO
JJ %i 0 0 0 I I I GYGGAGGHHHHHHHHHIs
AB
C) CC target_namerO r c ( ddl m} || i S )a Create a Jupyter comms object for a specific target, that can
be used to update Bokeh documents in the Jupyter notebook.
Args:
target_name (str) : the target name the Comms object should connect to
Returns
Jupyter Comms
r r )r data)ipykernel.commr )r r s rM r& r& s+ $##### 4Kb 1 1 11rS c H t dt t t dS )r2 r/ N)r' r) r. r- ro rS rM r( r( s )]HhGGGGGrS rr Resources | Noners ru rv rw c ddl m} ddlm} ddlm} ddlm} ddlm} ddl m
} | || } |s| j d
k rd
}
d
} nXt | j
d k r
| j
d n| j
}
t | j d k r
| j d n| j } d
| j D } t r|r| d | }
| |
||
| || }nd}
d}| a |d| }t' ||
|d }t' ||
|d }|t) d|i t) t* |t, |i dS )a Prepare the IPython notebook for displaying Bokeh plots.
Args:
resources (Resource, optional) :
how and where to load BokehJS from (default: CDN)
verbose (bool, optional) :
whether to report detailed settings (default: False)
hide_banner (bool, optional):
whether to hide the Bokeh banner (default: False)
load_timeout (int, optional) :
Timeout in milliseconds when plots assume load timed out (default: 5000)
.. warning::
Clearing the output cell containing the published BokehJS
resources HTML code may cause Bokeh CSS styling to be removed.
Returns:
None
r ) __version__)
NOTEBOOK_LOAD) bundle_for_objs_and_resourcesr )settings) make_globally_unique_css_safe_idN)modeinliner r c 8 g | ]}|j d k
d|j z S )r z Warning: )typetext).0r s rM
z!load_notebook.. s, ___sCHX^L^L^K#(*L^L^L^rS z"Warning: BokehJS previously loaded)
element_idrs js_infocss_info
bokeh_versionwarningsT)
register_mimeFr# ) r core.templatesr embed.bundler rr r! r util.serializationr r r js_files css_filesmessages_NOTEBOOK_LOADEDappendrender _loading_jsr* JS_MIME_TYPELOAD_MIME_TYPE)rr rs ru rv r r r r! r r r r r r htmlbundlenb_jsjl_jss rM r) r) s 6 ......<<<<<<%%%%%%######EEEEEE I8#5#5#7#7888
>X % %'/G(0HH/293E/F/F!/K/Ki(++QZQcG14Y5H1I1IQ1N1Ny*1--T]TgH__i6H___ B B OO @ A A A5577
## & # # $ ' $
$
*
*4
;
;F
L M M ME
L N N NE k4 0111 rS ) transientr dict[str, Any]metadatadict[Any, Any] | Noner dict[str, Any] | Nonec * ddl m} || |fd|i| dS )r2 r )r* r N)IPython.displayr* )r r r r r* s rM r* r* s<
544444xGG9GGGGGGrS r ProxyUrlFuncr r r" r r portr c t j ddlm} ddlm} | }t | }t | r |d }nt | } |d| if|||gd|} t t j }
| t j |
< | t | r || j } nt# || j } t j d| t j d | dd
lm} | | d }
t+ t, |
t. d it. d
|
ii dS )al Embed a Bokeh server application in a Jupyter Notebook output cell.
Args:
app (Application or callable) :
A Bokeh Application to embed inline in a Jupyter notebook.
state (State) :
** Unused **
notebook_url (str or callable) :
The URL of the notebook server that is running the embedded app.
If ``notebook_url`` is a string, the value string is parsed to
construct the origin and full server URLs.
If notebook_url is a callable, it must accept one parameter,
which will be the server port, or None. If passed a port,
the callable must generate the server URL, otherwise if passed
None, it must generate the origin URL for the server.
If the environment variable JUPYTER_BOKEH_EXTERNAL_URL is set
to the external URL of a JupyterHub, notebook_url is overridden
with a callable which enables Bokeh to traverse the JupyterHub
proxy without specifying this parameter.
port (int) :
A port for the embedded server will listen on.
By default the port is 0, which results in the server listening
on a random dynamic port.
Any additional keyword arguments are passed to :class:`~bokeh.server.Server` (added in version 1.1)
Returns:
None
r )IOLoopr )ServerN/)io_loopr allow_websocket_originzServer URL is zOrigin URL is )server_document)rr r r r )logging basicConfigtornado.ioloopr
server.serverr current _update_notebook_url_from_envcallable _origin_urlr r
hexr r startr _server_urlrE embedr r* HTML_MIME_TYPEEXEC_MIME_TYPE)r r r r r r r looporiginr r urlr scripts rM r- r- s X %%%%%%&&&&&& >> D0 >>L + d## \**
VS#J
_4QWPX
_
_\^
_
_F577;I+1HJJ i(
LLNNN 5l6;'', 44 M(3(())) M+6++,,,''''''
_SD
1
1
1F i0 rS r~ r c d S rU ro )r~ r s rM r. r. R s 03rS r c d S rU ro )r~ r r s rM r. r. T s UXUXrS c | |j j vr|j | ddlm} |rt nd} || | \ }}}t
t |i t
t |t dit d| j
ii |rEt t | | }|j j
| ||_ |S dS )r2 r )notebook_contentNr r\ r )r rootsadd_rootembed.notebookr
r r* r r r r\ r$ r& r^ on_change_dispatch_tor ) r~ r r r
comms_targetr divr8 r s rM r. r. W s %.&&&
$$$111111 /97999TL . .sL A AVS(.#.///,C~`dfifl_mNnoooo
Y| 4 4h??
66v>>>"(
4rS zdict[str, Hooks]r r Tr r r ID | Noner c B ddl m} | | |d|| S )r2 r )AUTOLOAD_NB_JST)r elementidforcetimeoutr )r r r )r r rv r r s rM r r x sB 0///// % ! rS r c f | d r| d d } | S )r2 httpz//r )
startswithsplit)r s rM r r s1 ~~f !iiooa JrS r4 c |d| nd}| d r"| dd d | d S d| d d | d S ) r2 N:r r r r r zhttp://)r rsplitr )r r port_s rM r r s| *JJJJE
~~f 9**S!$$Q'5555583 *8E83888rS c ( t j d }t j | j }| |S t j d }d| }t j || }t j || }|S )a Callable to configure Bokeh's show method when a proxy must be
configured. If port is None we're asking about the URL
for the origin header.
Taken from documentation here:
https://docs.bokeh.org/en/latest/docs/user_guide/output/jupyter.html#jupyterhub
and made an implicit override when JUPYTER_BOKEH_EXTERNAL_URL is defined in
a user's environment to the external hostname of the hub, e.g. https://our-hub.edu
Args:
port (int):
random port generated by bokeh to avoid re-using recently closed ports
Returns:
str:
URL capable of traversing the JupyterHub proxy to return to this notebook session.
JUPYTER_BOKEH_EXTERNAL_URLNJUPYTERHUB_SERVICE_PREFIXzproxy/)osenvironurllibparseurlparsenetlocurljoin)r base_urlhostservice_url_pathproxy_url_pathuser_urlfull_urls rM _remote_jupyter_proxy_urlr2 s ( z67H < * * 1D | z"=>$d__N|##H.>??H|##Hn==H OrS c t j d r,| t k rt d t S | S )a If the environment variable ``JUPYTER_BOKEH_EXTERNAL_URL`` is defined, returns a function which
generates URLs which can traverse the JupyterHub proxy. Otherwise returns ``notebook_url`` unmodified.
A warning is issued if ``notebook_url`` is not the default and
``JUPYTER_BOKEH_EXTERNAL_URL`` is also defined since setting the
environment variable makes specifying ``notebook_url`` irrelevant.
Args:
notebook_url (str | ProxyUrlFunc):
Either a URL string which defaults or a function that given a port
number will generate a URL suitable for traversing the JupyterHub proxy.
Returns:
str | ProxyUrlFunc
Either a URL string or a function that generates a URL string given a port number. The
latter function may be user supplied as the input parameter or defined internally by Bokeh
when ``JUPYER_BOKEH_EXTERNAL_URL`` is set.
r# z[Environment var 'JUPYTER_BOKEH_EXTERNAL_URL' is defined. Ignoring 'notebook_url' parameter.)r% r& r DEFAULT_JUPYTER_URLrD warningr2 )r s rM r r sF (
z~~233 . . . KKu v v v((rS )F) r r r rq r. r} r- r r rt r9 r: )r r r r r r r9 r: )
r r r r r r r r r9 r )r r r9 r: )r rO r9 r )r9 r: )NFFr )
rr r rs rt ru rt rv rw r9 r: rU )
r r r r r r r r r9 r: ) r r r r" r r r rw r r r9 r: )r~ r r r" r9 r: r )r~ r r r" r r r9 r )r T)
r r r r rv rw r rt r9 rO )r rO r9 rO )r rO r r4 r9 rO )r r4 r9 rO )r r r9 r )Trl
__future__r r getLoggerri rD r r% r' typingr r r r r r r
r r uuidr
r r typing_extensionsr
core.typesr r r
util.warningsr r r application.applicationr document.documentr document.eventsr r r r r r r r[ r rr r! r" r r r r r4 __all__r r$ rq r} r r r' r+ r, r% r& r( r) r* rw rO r rm r- r. r r r r r r2 r ro rS rM rA si # " " " " " g!!
,######++++++ ( ( ( ( ( (
555555,,,,,, &%%%%% %%%%%% ) 77& $ ,- >8 >8 >8 >8 >8 >8 >8 >8@o o o o o8 o o oc c c c ch c c cq q q q qh q q q I .3NI NI NI NI NI` 26T%)W- W- W- W- W- W-r: : : :>I I I I&
2
2
2
2 H H H H GL7;O O O O ObH ~B H H H H H H #E#t)$4#5s#:; ; ; ; ;
,? R R R R Rh
3 3 3
3 X X X
X : %) ) ) ) ) 9 9 9 9! ! ! !H rS