bokeh.application.application¶
Provide the Application
class.
Application instances are factories for creating new Bokeh Documents.
When a Bokeh server session is initiated, the Bokeh server asks the Application
for a new Document to service the session. To do this, the Application first
creates a new empty Document, then it passes this new Document to the
modify_document
method of each of its handlers. When all handlers have
updated the Document, it is used to service the user session.
- class Application(*handlers: Handler, metadata: Dict[str, Any] | None = None)[source]¶
An Application is a factory for Document instances.
Public Data Attributes:
The ordered list of handlers this Application is configured with.
Arbitrary user-supplied metadata to associate with this application.
Path to any (optional) static resources specified by handlers.
Public Methods:
__init__
(*handlers[, metadata])Application factory.
add
(handler)Add a handler to the pipeline used to initialize new documents.
Creates and initializes a document using the Application's handlers.
initialize_document
(doc)Fills in a new document using the Application's handlers.
on_server_loaded
(server_context)Invoked to execute code when a new session is created.
on_server_unloaded
(server_context)Invoked to execute code when the server cleanly exits.
on_session_created
(session_context)Invoked to execute code when a new session is created.
on_session_destroyed
(session_context)Invoked to execute code when a session is destroyed.
process_request
(request)Processes incoming HTTP request returning a dictionary of additional data to add to the session_context.
- __init__(*handlers: Handler, metadata: Dict[str, Any] | None = None) None [source]¶
Application factory.
- Parameters
handlers (seq[Handler]) – List of handlers to call. The URL is taken from the first one only.
- Keyword Arguments
metadata (dict) –
arbitrary user-supplied JSON data to make available with the application.
The server will provide a URL
http://applicationurl/metadata
which returns a JSON blob of the form:{ "data": { "hi": "hi", "there": "there" }, "url": "/myapp" }
The user-supplied metadata is returned as-is under the
"data"
key in the blob.
- add(handler: Handler) None [source]¶
Add a handler to the pipeline used to initialize new documents.
- Parameters
handler (Handler) – a handler for this Application to use to process Documents
- create_document() bokeh.document.document.Document [source]¶
Creates and initializes a document using the Application’s handlers.
- initialize_document(doc: bokeh.document.document.Document) None [source]¶
Fills in a new document using the Application’s handlers.
- on_server_loaded(server_context: bokeh.application.application.ServerContext) None [source]¶
Invoked to execute code when a new session is created.
This method calls
on_server_loaded
on each handler, in order, with the server context passed as the only argument.
- on_server_unloaded(server_context: bokeh.application.application.ServerContext) None [source]¶
Invoked to execute code when the server cleanly exits. (Before stopping the server’s
IOLoop
.)This method calls
on_server_unloaded
on each handler, in order, with the server context passed as the only argument.Warning
In practice this code may not run, since servers are often killed by a signal.
- async on_session_created(session_context: bokeh.application.application.SessionContext) None [source]¶
Invoked to execute code when a new session is created.
This method calls
on_session_created
on each handler, in order, with the session context passed as the only argument.May return a
Future
which will delay session creation until theFuture
completes.
- async on_session_destroyed(session_context: bokeh.application.application.SessionContext) None [source]¶
Invoked to execute code when a session is destroyed.
This method calls
on_session_destroyed
on each handler, in order, with the session context passed as the only argument.Afterwards,
session_context.destroyed
will beTrue
.
- process_request(request: tornado.httputil.HTTPServerRequest) Dict[str, Any] [source]¶
Processes incoming HTTP request returning a dictionary of additional data to add to the session_context.
- Parameters
request – HTTP request
- Returns
A dictionary of JSON serializable data to be included on the session context.
- property handlers: Tuple[Handler, ...]¶
The ordered list of handlers this Application is configured with.
- class ServerContext[source]¶
A harness for server-specific information and tasks related to collections of Bokeh sessions.
This base class is probably not of interest to general users.
- abstract property sessions: List[ServerSession]¶
SessionContext
instances belonging to this application.Subclasses must implement this method.
- class SessionContext(server_context: bokeh.application.application.ServerContext, session_id: ID)[source]¶
A harness for server-specific information and tasks related to Bokeh sessions.
This base class is probably not of interest to general users.
- __init__(server_context: bokeh.application.application.ServerContext, session_id: ID) None [source]¶
- abstract with_locked_document(func: Callable[[bokeh.document.document.Document], Awaitable[None]]) Awaitable[None] [source]¶
Runs a function with the document lock held, passing the document to the function.
Subclasses must implement this method.
- Parameters
func (callable) – function that takes a single parameter (the Document) and returns
None
or aFuture
- Returns
a
Future
containing the result of the function
- abstract property destroyed: bool¶
If
True
, the session has been discarded and cannot be used.A new session with the same ID could be created later but this instance will not come back to life.
- property id: ID¶
The unique ID for the session associated with this context.
- property server_context: bokeh.application.application.ServerContext¶
The server context for this session context