σ mάJ]c @`s[dZddlmZmZmZmZddlZejeƒZ ddl m Z e dƒZ d(Z defd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZd efd!„ƒYZd"efd#„ƒYZd$efd%„ƒYZd&efd'„ƒYZdS()uν Provide events that represent various changes to Bokeh Documents. These events are used internally to signal changes to Documents. For information about user-facing (e.g. UI or tool) events, see the reference for :ref:`bokeh.events`. i(tabsolute_importtdivisiontprint_functiontunicode_literalsNi(timport_optionalupandasuColumnDataChangedEventuColumnsStreamedEventuColumnsPatchedEventuDocumentChangedEventuDocumentPatchedEventuModelChangedEventuRootAddedEventuRootRemovedEventuSessionCallbackAddeduSessionCallbackRemoveduTitleChangedEventtDocumentChangedEventcB`s/eZdZddd„Zd„Zd„ZRS(uX Base class for all internal events representing a change to a Bokeh Document. cC`s||_||_||_dS(uΞ Args: document (Document) : A Bokeh document that is to be updated. 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. callback_invoker (callable, optional) : A callable that will invoke any Model callbacks that should be executed in response to the change that triggered this event. (default: None) N(tdocumenttsettertcallback_invoker(tselfRRR((s4lib/python2.7/site-packages/bokeh/document/events.pyt__init__Es  cC`stS(u (tFalse(R tevent((s4lib/python2.7/site-packages/bokeh/document/events.pytcombineascC`s#t|dƒr|j|ƒndS(u‡ Dispatch handling of this event to a receiver. This method will invoke ``receiver._document_changed`` if it exists. u_document_changedN(thasattrt_document_changed(R treceiver((s4lib/python2.7/site-packages/bokeh/document/events.pytdispatchgsN(t__name__t __module__t__doc__tNoneR R R(((s4lib/python2.7/site-packages/bokeh/document/events.pyR?s tDocumentPatchedEventcB`s eZdZd„Zd„ZRS(u] A Base class for events that represent updating Bokeh Models and their properties. cC`s9tt|ƒj|ƒt|dƒr5|j|ƒndS(u‡ Dispatch handling of this event to a receiver. This method will invoke ``receiver._document_patched`` if it exists. u_document_patchedN(tsuperRRRt_document_patched(R R((s4lib/python2.7/site-packages/bokeh/document/events.pyRvscC`s tƒ‚dS(uΧ Create a JSON representation of this event suitable for sending to clients. *Sub-classes must implement this method.* Args: references (dict[str, Model]) : If the event requires references to certain models in order to function, they may be collected here. **This is an "out" parameter**. The values it contains will be modified in-place. buffers (set) : If the event needs to supply any additional Bokeh protocol buffers, they may be added to this set. **This is an "out" parameter**. The values it contains will be modified in-place. N(tNotImplementedError(R t referencestbuffers((s4lib/python2.7/site-packages/bokeh/document/events.pytgenerate€s(RRRRR(((s4lib/python2.7/site-packages/bokeh/document/events.pyRps tModelChangedEventcB`s;eZdZdddd„Zd„Zd„Zd„ZRS(u: A concrete event representing updating an attribute and value of a specific Bokeh Model. This is the "standard" way of updating most Bokeh model attributes. For special casing situations that can optimized (e.g. streaming, etc.), a ``hint`` may be supplied that overrides normal mechanisms. c C`sƒ|dkr-t|ttfƒr-|j}ntt|ƒj||| ƒ||_||_ ||_ ||_ ||_ ||_ dS(u Args: document (Document) : A Bokeh document that is to be updated. model (Model) : A Model to update attr (str) : The name of the attribute to update on the model. old (object) : The old value of the attribute new (object) : The new value of the attribute serializable_new (object) : A serialized (JSON) version of the new value. It may be ``None`` if a hint is supplied. hint (DocumentPatchedEvent, optional) : When appropriate, a secondary event may be supplied that modifies the normal update process. For example, in order to stream or patch data more efficiently than the standard update mechanism. setter (ClientSession or ServerSession or None, optional) : This is used to prevent "boomerang" updates to Bokeh apps. (default: None) See :class:`~bokeh.document.events.DocumentChangedEvent` for more details. callback_invoker (callable, optional) : A callable that will invoke any Model callbacks that should be executed in response to the change that triggered this event. (default: None) N(Rt isinstancetColumnsStreamedEventtColumnsPatchedEventRRRR tmodeltattrtoldtnewtserializable_newthint( R RR!R"R#R$R%R&RR((s4lib/python2.7/site-packages/bokeh/document/events.pyR ’s+!      cC`s«t|tƒstS|j|jkr)tS|j|jkr?tS|jr[|jj|jƒS|j|jkr§|j|jkr§|j |_ |j |_ |j |_ t StS(u ( RRR RRR&R R!R"R$R%RtTrue(R R ((s4lib/python2.7/site-packages/bokeh/document/events.pyR Χs $   cC`s9tt|ƒj|ƒt|dƒr5|j|ƒndS(u• Dispatch handling of this event to a receiver. This method will invoke ``receiver._document_model_dhanged`` if it exists. u_document_model_changedN(RRRRt_document_model_changed(R R((s4lib/python2.7/site-packages/bokeh/document/events.pyRνscC`s₯ddlm}|jdk r2|jj||ƒS|j}t||ƒƒ}|j|kro|j|jƒn|j|ƒidd6|jj d6|j d6|d6S( u€ Create a JSON representation of this event suitable for sending to clients. Args: references (dict[str, Model]) : If the event requires references to certain models in order to function, they may be collected here. **This is an "out" parameter**. The values it contains will be modified in-place. buffers (set) : If the event needs to supply any additional Bokeh protocol buffers, they may be added to this set. **This is an "out" parameter**. The values it contains will be modified in-place. i(tcollect_modelsu ModelChangedukindumodeluattrunewN( R!R)R&RRR%tsettdiscardtupdatetrefR"(R RRR)tvaluet value_refs((s4lib/python2.7/site-packages/bokeh/document/events.pyRψs     N(RRRRR R RR(((s4lib/python2.7/site-packages/bokeh/document/events.pyR˜s 5  tColumnDataChangedEventcB`s2eZdZdddd„Zd„Zd„ZRS(uˆ A concrete event representing efficiently replacing *all* existing data for a :class:`~bokeh.models.sources.ColumnDataSource` cC`s2tt|ƒj|||ƒ||_||_dS(u] Args: document (Document) : A Bokeh document that is to be updated. column_source (ColumnDataSource) : cols (list[str]) : optional explicit list of column names to update. If None, all columns will be updated (default: None) setter (ClientSession or ServerSession or None, optional) : This is used to prevent "boomerang" updates to Bokeh apps. (default: None) See :class:`~bokeh.document.events.DocumentChangedEvent` for more details. callback_invoker (callable, optional) : A callable that will invoke any Model callbacks that should be executed in response to the change that triggered this event. (default: None) N(RR0R t column_sourcetcols(R RR1R2RR((s4lib/python2.7/site-packages/bokeh/document/events.pyR 2s cC`s9tt|ƒj|ƒt|dƒr5|j|ƒndS(uŠ Dispatch handling of this event to a receiver. This method will invoke ``receiver._column_data_changed`` if it exists. u_column_data_changedN(RR0RRt_column_data_changed(R R((s4lib/python2.7/site-packages/bokeh/document/events.pyRQscC`sZddlm}||jjd|d|jƒ}idd6|jjd6|d6|jd 6S( uΥ Create a JSON representation of this event suitable for sending to clients. .. code-block:: python { 'kind' : 'ColumnDataChanged' 'column_source' : 'new' : 'cols' : } Args: references (dict[str, Model]) : If the event requires references to certain models in order to function, they may be collected here. **This is an "out" parameter**. The values it contains will be modified in-place. buffers (set) : If the event needs to supply any additional Bokeh protocol buffers, they may be added to this set. **This is an "out" parameter**. The values it contains will be modified in-place. i(ttransform_column_source_dataRR2uColumnDataChangedukindu column_sourceunewucols(tutil.serializationR4R1tdataR2R-(R RRR4t data_dict((s4lib/python2.7/site-packages/bokeh/document/events.pyR[s !  N(RRRRR RR(((s4lib/python2.7/site-packages/bokeh/document/events.pyR0,s RcB`s/eZdZddd„Zd„Zd„ZRS(u| A concrete event representing efficiently streaming new data to a :class:`~bokeh.models.sources.ColumnDataSource` c`sott|ƒj|||ƒ||_trYtˆtjƒrY‡fd†ˆjDƒ‰nˆ|_||_ dS(ul Args: document (Document) : A Bokeh document that is to be updated. column_source (ColumnDataSource) : The data source to stream new data to. data (dict or DataFrame) : New data to stream. If a DataFrame, will be stored as ``{c: df[c] for c in df.columns}`` rollover (int) : A rollover limit. If the data source columns exceed this limit, earlier values will be discarded to maintain the column length under the limit. setter (ClientSession or ServerSession or None, optional) : This is used to prevent "boomerang" updates to Bokeh apps. (default: None) See :class:`~bokeh.document.events.DocumentChangedEvent` for more details. callback_invoker (callable, optional) : A callable that will invoke any Model callbacks that should be executed in response to the change that triggered this event. (default: None) c`si|]}ˆ||“qS(((t.0tc(R6(s4lib/python2.7/site-packages/bokeh/document/events.pys ­s N( RRR R1tpdRt DataFrametcolumnsR6trollover(R RR1R6R=RR((R6s4lib/python2.7/site-packages/bokeh/document/events.pyR ˆs !  cC`s9tt|ƒj|ƒt|dƒr5|j|ƒndS(u‡ Dispatch handling of this event to a receiver. This method will invoke ``receiver._columns_streamed`` if it exists. u_columns_streamedN(RRRRt_columns_streamed(R R((s4lib/python2.7/site-packages/bokeh/document/events.pyR²scC`s,idd6|jjd6|jd6|jd6S(uΖ Create a JSON representation of this event suitable for sending to clients. .. code-block:: python { 'kind' : 'ColumnsStreamed' 'column_source' : 'data' : 'rollover' : } Args: references (dict[str, Model]) : If the event requires references to certain models in order to function, they may be collected here. **This is an "out" parameter**. The values it contains will be modified in-place. buffers (set) : If the event needs to supply any additional Bokeh protocol buffers, they may be added to this set. **This is an "out" parameter**. The values it contains will be modified in-place. uColumnsStreamedukindu column_sourceudataurollover(R1R-R6R=(R RR((s4lib/python2.7/site-packages/bokeh/document/events.pyRΌs   N(RRRRR RR(((s4lib/python2.7/site-packages/bokeh/document/events.pyR‚s* R cB`s/eZdZddd„Zd„Zd„ZRS(u A concrete event representing efficiently applying data patches to a :class:`~bokeh.models.sources.ColumnDataSource` cC`s2tt|ƒj|||ƒ||_||_dS(u Args: document (Document) : A Bokeh document that is to be updated. column_source (ColumnDataSource) : The data source to apply patches to. patches (list) : setter (ClientSession or ServerSession or None, optional) : This is used to prevent "boomerang" updates to Bokeh apps. (default: None) See :class:`~bokeh.document.events.DocumentChangedEvent` for more details. callback_invoker (callable, optional) : A callable that will invoke any Model callbacks that should be executed in response to the change that triggered this event. (default: None) N(RR R R1tpatches(R RR1R?RR((s4lib/python2.7/site-packages/bokeh/document/events.pyR δs cC`s9tt|ƒj|ƒt|dƒr5|j|ƒndS(u† Dispatch handling of this event to a receiver. This method will invoke ``receiver._columns_patched`` if it exists. u_columns_patchedN(RR RRt_columns_patched(R R((s4lib/python2.7/site-packages/bokeh/document/events.pyRscC`s"idd6|jjd6|jd6S(u‘ Create a JSON representation of this event suitable for sending to clients. .. code-block:: python { 'kind' : 'ColumnsPatched' 'column_source' : 'patches' : } Args: references (dict[str, Model]) : If the event requires references to certain models in order to function, they may be collected here. **This is an "out" parameter**. The values it contains will be modified in-place. buffers (set) : If the event needs to supply any additional Bokeh protocol buffers, they may be added to this set. **This is an "out" parameter**. The values it contains will be modified in-place. uColumnsPatchedukindu column_sourceupatches(R1R-R?(R RR((s4lib/python2.7/site-packages/bokeh/document/events.pyR s  N(RRRRR RR(((s4lib/python2.7/site-packages/bokeh/document/events.pyR ήs tTitleChangedEventcB`s/eZdZddd„Zd„Zd„ZRS(uS A concrete event representing a change to the title of a Bokeh Document. cC`s)tt|ƒj|||ƒ||_dS(uΦ Args: document (Document) : A Bokeh document that is to be updated. title (str) : The new title to set on the Document setter (ClientSession or ServerSession or None, optional) : This is used to prevent "boomerang" updates to Bokeh apps. (default: None) See :class:`~bokeh.document.events.DocumentChangedEvent` for more details. callback_invoker (callable, optional) : A callable that will invoke any Model callbacks that should be executed in response to the change that triggered this event. (default: None) N(RRAR ttitle(R RRBRR((s4lib/python2.7/site-packages/bokeh/document/events.pyR 1scC`s[t|tƒstS|j|jkr)tS|j|jkr?tS|j|_|j|_tS(u (RRAR RRRBRR'(R R ((s4lib/python2.7/site-packages/bokeh/document/events.pyR Ls  cC`sidd6|jd6S(u7 Create a JSON representation of this event suitable for sending to clients. .. code-block:: python { 'kind' : 'TitleChanged' 'title' : } Args: references (dict[str, Model]) : If the event requires references to certain models in order to function, they may be collected here. **This is an "out" parameter**. The values it contains will be modified in-place. buffers (set) : If the event needs to supply any additional Bokeh protocol buffers, they may be added to this set. **This is an "out" parameter**. The values it contains will be modified in-place. u TitleChangedukindutitle(RB(R RR((s4lib/python2.7/site-packages/bokeh/document/events.pyR[s N(RRRRR R R(((s4lib/python2.7/site-packages/bokeh/document/events.pyRA+s tRootAddedEventcB`s&eZdZddd„Zd„ZRS(uq A concrete event representing a change to add a new Model to a Document's collection of "root" models. cC`s)tt|ƒj|||ƒ||_dS(uέ Args: document (Document) : A Bokeh document that is to be updated. model (Model) : The Bokeh Model to add as a Document root. setter (ClientSession or ServerSession or None, optional) : This is used to prevent "boomerang" updates to Bokeh apps. (default: None) See :class:`~bokeh.document.events.DocumentChangedEvent` for more details. callback_invoker (callable, optional) : A callable that will invoke any Model callbacks that should be executed in response to the change that triggered this event. (default: None) N(RRCR R!(R RR!RR((s4lib/python2.7/site-packages/bokeh/document/events.pyR scC`s.|j|jjƒƒidd6|jjd6S(u8 Create a JSON representation of this event suitable for sending to clients. .. code-block:: python { 'kind' : 'RootAdded' 'title' : } Args: references (dict[str, Model]) : If the event requires references to certain models in order to function, they may be collected here. **This is an "out" parameter**. The values it contains will be modified in-place. buffers (set) : If the event needs to supply any additional Bokeh protocol buffers, they may be added to this set. **This is an "out" parameter**. The values it contains will be modified in-place. u RootAddedukindumodel(R,R!RR-(R RR((s4lib/python2.7/site-packages/bokeh/document/events.pyR™s N(RRRRR R(((s4lib/python2.7/site-packages/bokeh/document/events.pyRCystRootRemovedEventcB`s&eZdZddd„Zd„ZRS(u| A concrete event representing a change to remove an existing Model from a Document's collection of "root" models. cC`s)tt|ƒj|||ƒ||_dS(uα Args: document (Document) : A Bokeh document that is to be updated. model (Model) : The Bokeh Model to remove as a Document root. setter (ClientSession or ServerSession or None, optional) : This is used to prevent "boomerang" updates to Bokeh apps. (default: None) See :class:`~bokeh.document.events.DocumentChangedEvent` for more details. callback_invoker (callable, optional) : A callable that will invoke any Model callbacks that should be executed in response to the change that triggered this event. (default: None) N(RRDR R!(R RR!RR((s4lib/python2.7/site-packages/bokeh/document/events.pyR ΎscC`sidd6|jjd6S(u: Create a JSON representation of this event suitable for sending to clients. .. code-block:: python { 'kind' : 'RootRemoved' 'title' : } Args: references (dict[str, Model]) : If the event requires references to certain models in order to function, they may be collected here. **This is an "out" parameter**. The values it contains will be modified in-place. buffers (set) : If the event needs to supply any additional Bokeh protocol buffers, they may be added to this set. **This is an "out" parameter**. The values it contains will be modified in-place. u RootRemovedukindumodel(R!R-(R RR((s4lib/python2.7/site-packages/bokeh/document/events.pyRΩs N(RRRRR R(((s4lib/python2.7/site-packages/bokeh/document/events.pyRDΈstSessionCallbackAddedcB`s eZdZd„Zd„ZRS(u A concrete event representing a change to add a new callback (e.g. periodic, timeout, or "next tick") to a Document. cC`s#tt|ƒj|ƒ||_dS(uΑ Args: document (Document) : A Bokeh document that is to be updated. callback (SessionCallback) : The callback to add N(RRER tcallback(R RRF((s4lib/python2.7/site-packages/bokeh/document/events.pyR ύs cC`s9tt|ƒj|ƒt|dƒr5|j|ƒndS(u• Dispatch handling of this event to a receiver. This method will invoke ``receiver._session_callback_added`` if it exists. u_session_callback_addedN(RRERRt_session_callback_added(R R((s4lib/python2.7/site-packages/bokeh/document/events.pyR s(RRRR R(((s4lib/python2.7/site-packages/bokeh/document/events.pyREχs tSessionCallbackRemovedcB`s eZdZd„Zd„ZRS(u‹ A concrete event representing a change to remove an existing callback (e.g. periodic, timeout, or "next tick") from a Document. cC`s#tt|ƒj|ƒ||_dS(uΔ Args: document (Document) : A Bokeh document that is to be updated. callback (SessionCallback) : The callback to remove N(RRHR RF(R RRF((s4lib/python2.7/site-packages/bokeh/document/events.pyR s cC`s9tt|ƒj|ƒt|dƒr5|j|ƒndS(u— Dispatch handling of this event to a receiver. This method will invoke ``receiver._session_callback_removed`` if it exists. u_session_callback_removedN(RRHRRt_session_callback_removed(R R((s4lib/python2.7/site-packages/bokeh/document/events.pyR+s(RRRR R(((s4lib/python2.7/site-packages/bokeh/document/events.pyRHs ( uColumnDataChangedEventuColumnsStreamedEventuColumnsPatchedEventuDocumentChangedEventuDocumentPatchedEventuModelChangedEventuRootAddedEventuRootRemovedEventuSessionCallbackAddeduSessionCallbackRemoveduTitleChangedEventuTitleChangedEvent(Rt __future__RRRRtloggingt getLoggerRtlogtutil.dependenciesRR:t__all__tobjectRRRR0RR RARCRDRERH(((s4lib/python2.7/site-packages/bokeh/document/events.pyt s8"    1(”V\MN??