U /eb@sdZddlmZddlZeeZddlZddlm Z ddl m Z m Z m Z mZmZddlmZmZe rddlmZd d lmZmZd Zed e d e fdZGdddeeZd ddddZdZGdddZdS)z ) annotationsN)wraps) TYPE_CHECKINGAnyCallableTypeVarcast)LiteralProtocol)NextTickCallback)CallbackDocument)UnlockedDocumentProxywithout_document_lockF.)boundc@seZdZUded<ded<dS)NoLockCallbackr__call__z Literal[True]nolockN)__name__ __module__ __qualname____annotations__rr:/tmp/pip-unpacked-wheel-f5fndrjf/bokeh/document/locking.pyr9s rzNoLockCallback[F])funcreturncs`tr*tddddfdd }ntddddfdd }ttt|}d|_|S)ap Wrap a callback function to execute without first obtaining the document lock. Args: func (callable) : The function to wrap Returns: callable : a function wrapped to execute without a |Document| lock. While inside an unlocked callback, it is completely *unsafe* to modify ``curdoc()``. The value of ``curdoc()`` inside the callback will be a specially wrapped version of |Document| that only allows safe operations, which are: * :func:`~bokeh.document.Document.add_next_tick_callback` * :func:`~bokeh.document.Document.remove_next_tick_callback` Only these may be used safely without taking the document lock. To make other changes to the document, you must add a next tick callback and make your changes to ``curdoc()`` from that second callback. Attempts to otherwise access or change the Document will result in an exception being raised. ``func`` can be a synchronous function, an async function, or a function decorated with ``asyncio.coroutine``. The returned function will be an async function if ``func`` is any of the latter two. rNone)argskwrcs||IdHdSNrr r!rrr_wrapper\sz'without_document_lock.._wrappercs||dSr"rr#r$rrr%`sT)asyncioiscoroutinefunctionrrrrr)rr%wrapperrr$rr=s rzOnly 'add_next_tick_callback' may be used safely without taking the document lock; to make other changes to the document, add a next tick callback and make your changes from that callback.c@sPeZdZdZdddddZddd d d Zd d dddZd ddddZdS)rz Wrap a Document object so that only methods that can safely be used from unlocked callbacks or threads are exposed. Attempts to otherwise access or change the Document results in an exception. rr)docrcCs ||_dSz N)_doc)selfr)rrr__init__wszUnlockedDocumentProxy.__init__strr)attrrcCs ttdSr*)AttributeErrorUNSAFE_DOC_ATTR_USAGE_MSG)r,r/rrr __getattr__}sz!UnlockedDocumentProxy.__getattr__rr )callbackrcCs |j|S)zW Add a "next tick" callback. Args: callback (callable) : )r+add_next_tick_callbackr,r3rrrr4sz,UnlockedDocumentProxy.add_next_tick_callbackcCs|j|dS)zZ Remove a "next tick" callback. Args: callback (callable) : N)r+remove_next_tick_callbackr5rrrr6sz/UnlockedDocumentProxy.remove_next_tick_callbackN)rrr__doc__r-r2r4r6rrrrrps  r)r7 __future__rlogging getLoggerrlogr& functoolsrtypingrrrrrZtyping_extensionsr r Zserver.callbacksr documentrr__all__rrrr1rrrrrs"      -