-emdZddlmZddlZejeZddlZddlZddl m Z ddl m Z m Z mZddlmZddlmZdd lmZdd lmZmZdd lmZmZmZmZdd lmZdd lm Z ddl!m"Z"m#Z#ddl$m%Z%ddl&m'Z'ddl(m)Z)m*Z*m+Z,ddl-m.Z.ddl/m0Z0ddl1m2Z2ddl3m4Z4m5Z5m6Z6m7Z7m8Z8ddl$m9Z9m:Z:m;Z;mZ>ddl?m@Z@ddlAmBZBe r&ddlCmDZDmEZEddlmFZFddlmGZGddlHmIZImJZJmKZKmLZLddl$mMZMd ZNd!ZOGd"d#ZPdS)$aE Provide the ``Document`` class, which is a container for Bokeh Models to be reflected to the client side BokehJS library. As a concrete example, consider a column layout with ``Slider`` and ``Select`` widgets, and a plot with some tools, an axis and grid, and a glyph renderer for circles. A simplified representation of this document might look like the figure below: .. figure:: /_images/document.svg :align: center :width: 65% A Bokeh Document is a collection of Bokeh Models (e.g. plots, tools, glyphs, etc.) that can be serialized as a single collection. ) annotationsN)loads) TYPE_CHECKINGAnyIterable)Template)HoldPolicyType is_DataModel)findis_single_string_selector) Deserializer Serialized SerializerUnknownReferenceError)FILE)ID)check_integrityprocess_validation_issues)Event)Model)Themebuilt_in_themesdefault)make_id) nice_join) __version__)CallbackDocumentCallbackManager EventCallbackJSEventCallbackMessageCallback)DocumentPatchedEventRootAddedEventRootRemovedEventTitleChangedEvent)DocJson PatchJson)DocumentModelManager)DocumentModuleManager)SessionContextSessionDestroyedCallback)Setter) SelectorType)NextTickCallbackPeriodicCallbackSessionCallbackTimeoutCallback)DocumentChangeCallbackzBokeh Application)DocumentceZdZUdZded<ded<ded<ded <d ed <d ed <ded<ded<ded<eedd}dZed~dZ eddZ eddZ e j ddZ edd!Z edd"Zej dd$Zedd%Zedd&Zej dd(Zedd)Zej dd*Zdd.Zdd2Zddd8Zdd;Zd3d<dd?Zdd@ZddCZeddFZeddHZddLZddNZdddRZddTZddVZ ddZZ!dd\Z"dd_Z#ddaZ$ddcZ%dddZ&ddeZ'ddfZ(dddgZ)ddhZ*ddjZ+ddnZ,ddoZ-ddrZ.dddsZ/dtduddxZ0ddyZ1ddzZ2dd|Z3d3S)r6a The basic unit of serialization for Bokeh. Document instances collect Bokeh models (e.g. plots, layouts, widgets, etc.) so that they may be reflected into the BokehJS client runtime. Because models may refer to other models (e.g., a plot *has* a list of renderers), it is not generally useful or meaningful to convert individual models to JSON. Accordingly, the ``Document`` is thus the smallest unit of serialization for Bokeh. r! callbacksr+modelsr,modules list[Model]_rootsr_themestr_titler _templatez,weakref.ReferenceType[SessionContext] | None_session_contextdict[str, Any]_template_variables)themetitlerDrEreturnNonect||_t||_t ||_g|_t|_i|_ ||_ ||_ d|_ dSN) r!r8r+r9r,r:r<rr@rCr=r?rA)selfrDrEs 7lib/python3.11/site-packages/bokeh/document/document.py__init__zDocument.__init__sa066*400 ,T22  #%   $c*t|jS)z: A list of all the root models in this Document. )listr<rJs rKrootszDocument.rootss DK   rMlist[SessionCallback]c|jjS)zA A list of all the session callbacks for this document. )r8session_callbacksrPs rKrTzDocument.session_callbackss ~//rMset[SessionDestroyedCallback]c|jjS)zN A list of all the on_session_destroyed callbacks for this document. r8session_destroyed_callbacksrPs rKrXz$Document.session_destroyed_callbackss ~99rMc||j_dSrIrWrJr8s rKrXz$Document.session_destroyed_callbackss5>222rMSessionContext | Nonec<|j|ndS)z4 The ``SessionContext`` for this document. N)rArPs rKsession_contextzDocument.session_contexts$ +/*?*Kt$$&&&QUUrMc|jS)z@ A Jinja2 template to use for rendering this document. )r@rPs rKtemplatezDocument.templates ~rMr_cjt|ttfstd||_dS)Nz5document template must be Jinja2 template or a string) isinstancerr> ValueErrorr@)rJr_s rKr_zDocument.templates3(XsO44 VTUU U!rMc|jS)z_ A dictionary of template variables to pass when rendering ``self.template``. )rCrPs rKtemplate_variableszDocument.template_variabless ''rMc|jS)aD The current ``Theme`` instance affecting models in this Document. Setting this to ``None`` sets the default theme. (i.e this property never returns ``None``.) Changing theme may trigger model change events on the models in the document if the theme modifies any model properties. )r=rPs rKrDzDocument.themes {rMTheme | str | Nonec|tn|}t|trC t|}n4#t$r't |dt twxYwt|tst d|j|urdS||_|j D]}|j |dS)Nz/ is not a built-in theme; available themes are z8Theme must be a string or an instance of the Theme class) default_themerar>rKeyErrorrbrrr=r9apply_to_model)rJrDmodels rKrDzDocument.themes!& E eS ! ! x x'. x x x E!v!vZcdsZtZt!v!vwww x%'' YWXX X ;%   F [ . .E K & &u - - - - . .s 01A!c|jS)z A title for this document. This title will be set on standalone HTML documents, but not e.g. when ``autoload_server`` is used. )r?rPs rKrEzDocument.titles {rMc0||dSrI) set_title)rJrEs rKrEzDocument.titles urMcallbackr r1czddlm}|dt}|j||dS)a Add callback to be invoked once on the next tick of the event loop. Args: callback (callable) : A callback function to execute on the next tick. Returns: NextTickCallback : can be used with ``remove_next_tick_callback`` .. note:: Next tick callbacks only work within the context of a Bokeh server session. This function will no effect when Bokeh outputs to standalone HTML or Jupyter notebook cells. r )r1N)ro callback_idTone_shot)server.callbacksr1rr8add_session_callback)rJror1cbs rKadd_next_tick_callbackzDocument.add_next_tick_callbacksL 877777  t C C C~222x$2OOOrMperiod_millisecondsintr2c|ddlm}|d|t}|j||dS)a_ Add a callback to be invoked on a session periodically. Args: callback (callable) : A callback function to execute periodically period_milliseconds (int) : Number of milliseconds between each callback execution. Returns: PeriodicCallback : can be used with ``remove_periodic_callback`` .. note:: Periodic callbacks only work within the context of a Bokeh server session. This function will no effect when Bokeh outputs to standalone HTML or Jupyter notebook cells. r )r2N)roperiodrqFrr)rtr2rr8ru)rJrorxr2rvs rKadd_periodic_callbackzDocument.add_periodic_callbacksR& 877777  t4GU\U^U^ _ _ _~222x%2PPPrMNrkrsetter Setter | Nonec||jvrdS|j5|j|dddn #1swxYwY|jt |||dS)a Add a model as a root of this Document. Any changes to this model (including to other models referred to by it) will trigger ``on_change`` callbacks registered on this document. Args: model (Model) : The model to add as a root of this document. setter (ClientSession or ServerSession or None, optional) : This is used to prevent "boomerang" updates to Bokeh apps. (default: None) In the context of a Bokeh server application, incoming updates to properties will be annotated with the session that is doing the updating. This value is propagated through any subsequent change notifications that the update triggers. The session can compare the event setter to itself, and suppress any updates that originate from itself. N)r<r9freezeappendr8trigger_on_changer&rJrkr}s rKadd_rootzDocument.add_root's. DK   F [   ! ! & & K  u % % % & & & & & & & & & & & & & & & ((eV)L)LMMMMMA  AAtimeout_millisecondsr4c|ddlm}|d|t}|j||dS)ac Add callback to be invoked once, after a specified timeout passes. Args: callback (callable) : A callback function to execute after timeout timeout_milliseconds (int) : Number of milliseconds before callback execution. Returns: TimeoutCallback : can be used with ``remove_timeout_callback`` .. note:: Timeout callbacks only work within the context of a Bokeh server session. This function will no effect when Bokeh outputs to standalone HTML or Jupyter notebook cells. r )r4N)rotimeoutrqTrr)rtr4rr8ru)rJrorr4rvs rKadd_timeout_callbackzDocument.add_timeout_callbackFsQ& 766666 _d4HV]V_V_ ` ` `~222x$2OOOrMr} patch_json!PatchJson | Serialized[PatchJson]ctt|j| |}nU#t$rH}|j|jr#tjd|jdYd}~dSd}~wwxYw|d}t|tsJ|D]}tj ||||j fddS)a@ Apply a JSON patch object and process any resulting events. Args: patch (JSON-data) : The JSON-object containing the patch to apply. setter (ClientSession or ServerSession or None, optional) : This is used to prevent "boomerang" updates to Bokeh apps. (default: None) In the context of a Bokeh server application, incoming updates to properties will be annotated with the session that is doing the updating. This value is propagated through any subsequent change notifications that the update triggers. The session can compare the event setter to itself, and suppress any updates that originate from itself. Returns: None rzFDropping a patch because it contains a previously known reference (id=z). Most of the time this is harmless and usually a result of updating a model on one side of a communications channel while it was being removed on the other end.Neventsc0| SrI)has_ref)rk deserializers rKz+Document.apply_json_patch..s<3G3G3N3N/NrM) rrOr9 deserializerseenidloggingwarningrar% handle_event flush_synced)rJrr}patcherrorreventrs @rKapply_json_patchzDocument.apply_json_patch]s#,$D$5$5fEEE  +77 CCEE$   {)) !GLx!!!  x&$''''' C CE -dE6 B B B B   !N!N!N!NOOOOOs< B> > ;%  DK N , ,->tUF-S-S T T T T T rMTdeferredrboolcdtjD}t|}||}||j}||jj}tt|j |}|r||d<|jjr||d<|j |S)zc Convert this document to a JSON-serializble object. Return: DocJson c0g|]}t||Sr ).0rks rK z$Document.to_json..s'jjj%UabgUhUhjjjjrMr)versionrErQrr8) rmodel_class_reverse_mapvaluesrencoder<r8_js_event_callbacksr)rrEr9r)rJr data_models serializerrrQr8rs rKto_jsonzDocument.to_jsonskj5+H+O+O+Q+Qjjj 222   --!!$+..%%dn&HII *     $#HV  > - .$-H[ !   """rMc8|jdS)zo Turn off any active document hold and apply any collected events. Returns: None N)r8unholdrPs rKrzDocument.unholds rMc~|jD]4}|}t|}t|5dS)ze Perform integrity checks on the modes in this document. Returns: None N)rQ referencesrr)rJrrefsissuess rKvalidatezDocument.validate sJ . .A<<>>D$T**F %f - - - -  . .rMdest_doccR||urtd|g}|j5|jrRt t |j}|||||jRdddn #1swxYwY|D]}|j td|zt|jdkrtd|j|D]}| ||j |_ dS)z Move all data in this doc to the dest_doc, leaving this doc empty. Args: dest_doc (Document) : The Bokeh document to populate with data from this one Returns: None z-Attempted to overwrite a document with itselfNzSomehow we didn't detach %rrz#_all_models still had stuff in it: ) RuntimeErrorrr9rrQrrrrdocumentrrrE)rJrrQrs rKrzDocument._destructively_moves t  NOO O  [   ! !  * dj))**  ### Q*                 H HAz%"#@A#FGGG& t{  q TT[TTUU U ! !A   a sAB))B-0B-)rDrrEr>rFrG)rFr;)rFrR)rFrU)r8rUrFrG)rFr[)rFr)r_rrFrG)rFrB)rFr)rDrfrFrG)rFr>)rEr>rFrG)ror rFr1)ror rxryrFr2rI)rkrr}r~rFrG)ror rryrFr4)rrr}r~rFrG)rFrG)rrrFrG)rrrFr6)rr>rFr6)rrrFr)rr>rFr)r)rr rFrG)r8r5rFrG)rrrFrG)rrr8r"rFrG)rrr8r#rFrG)rr>r8r$rFrG)r8r.rFrG)rr1rFrG)r8rrFrG)rr>ror$rFrG)rr2rFrG)rr4rFrG)rr)rFrG)rr0rFr)rr0rFr)rrrrBrFrG)rEr>r}r~rFrG)rrrFr))rr6rFrG)4__name__ __module__ __qualname____doc____annotations__rh DEFAULT_TITLErLpropertyrQrTrXr}r]r_rdrDrErwr|rrrrr classmethodrrrrrrrrrrrrrrrrrrrrrrnrrrrrrMrKr6r6os<  '&&&    """"MMMKKKBBBB'''')6] % % % % % %!!!X! 000X0 :::X: !'???('?VVVXV X _"""_" (((X(   X  \...\.(X \\ PPPP(QQQQ.NNNNN>PPPP.jn,P,P,P,P,P,P\ $ $ $ $    [6 * * *[ * / / / / 1 1 1 1'$'$'$'$'$R----7777 3333 6666 8888 8888 = = = =4444==== = = = =PPPPP> = = = = . . . .++++"(''''&UUUUU+/8     . . . .%$%$%$%$%$%$rMr6)Qr __future__rr getLoggerrlogrweakrefrrtypingrrrjinja2r core.enumsr core.has_propsr core.queryr rcore.serializationrrrrcore.templatesr core.typesrcore.validationrrrrrkrthemesrrrrhutil.serializationr util.stringsr util.versionrr8r r!r"r#r$r%r&r'r(r)r*r9r+r:r,application.applicationr-r.r/r0rtr1r2r3r4r5r __all__r6rrMrKr6sd(#"""""g!! //////////('''''))))))88888888 "!!!!!HHHHHHHHEEEEEEEEEE(((((($$$$$$&&&&&& %$$$$$$$((((((****** /RRRRRRRR'''''')))))) /..... $  O $O $O $O $O $O $O $O $O $O $rM