Class: ThebeManager
thebe-core / Exports / ThebeManager
Hierarchy¶
WidgetManager↳
ThebeManager
Table of contents¶
Constructors¶
Properties¶
Accessors¶
Methods¶
- _create_comm
- _get_comm_info
- _handleKernelChanged
- _handleKernelConnectionStatusChange
- _handleKernelStatusChange
- _loadFromKernel
- _loadFromKernelModels
- _loadFromNotebook
- _make_model
- _registerWidgets
- addWidgetFactories
- build_widgets
- callbacks
- clear_state
- create_view
- disconnect
- display_view
- dispose
- filterExistingModelState
- get_model
- get_state
- get_state_sync
- handle_comm_open
- has_model
- inline_sanitize
- loadClass
- loadModelClass
- loadViewClass
- new_model
- new_widget
- register
- register_model
- removeWidgetFactories
- resolveUrl
- restoreWidgets
- setDirty
- setViewOptions
- set_state
Constructors¶
constructor¶
• new ThebeManager(kernel)
Parameters¶
| Name | Type |
|---|---|
kernel | IKernelConnection |
Overrides¶
JupyterLabManager.constructor
Defined in¶
packages/core/src/manager.ts:38
Properties¶
_handleCommOpen¶
• Protected _handleCommOpen: (comm: IComm, msg: ICommOpenMsg<"iopub" | "shell">) => Promise<void>
Type declaration¶
▸ (comm, msg): Promise<void>
Parameters¶
| Name | Type |
|---|---|
comm | IComm |
msg | ICommOpenMsg<"iopub" | "shell"> |
Returns¶
Promise<void>
Inherited from¶
JupyterLabManager._handleCommOpen
Defined in¶
node_modules/@jupyter-widgets/jupyterlab-manager/lib/manager.d.ts:102
_kernelRestoreInProgress¶
• Protected _kernelRestoreInProgress: boolean
Inherited from¶
JupyterLabManager._kernelRestoreInProgress
Defined in¶
node_modules/@jupyter-widgets/jupyterlab-manager/lib/manager.d.ts:105
_loader¶
• _loader: RequireJsLoader
Defined in¶
packages/core/src/manager.ts:36
_restored¶
• Protected _restored: Signal<ThebeManager, void>
Inherited from¶
JupyterLabManager._restored
Defined in¶
node_modules/@jupyter-widgets/jupyterlab-manager/lib/manager.d.ts:103
_restoredStatus¶
• Protected _restoredStatus: boolean
Inherited from¶
JupyterLabManager._restoredStatus
Defined in¶
node_modules/@jupyter-widgets/jupyterlab-manager/lib/manager.d.ts:104
comm_target_name¶
• Readonly comm_target_name: "jupyter.widget"
The comm target name to register
Inherited from¶
JupyterLabManager.comm_target_name
Defined in¶
node_modules/@jupyter-widgets/base-manager/lib/manager-base.d.ts:171
id¶
• id: string
Defined in¶
packages/core/src/manager.ts:35
Accessors¶
context¶
• get context(): IContext<INotebookModel>
Returns¶
IContext<INotebookModel>
Inherited from¶
JupyterLabManager.context
Defined in¶
node_modules/@jupyter-widgets/jupyterlab-manager/lib/manager.d.ts:161
isDisposed¶
• get isDisposed(): boolean
Get whether the manager is disposed.
Notes¶
This is a read-only property.
Returns¶
boolean
Inherited from¶
JupyterLabManager.isDisposed
Defined in¶
node_modules/@jupyter-widgets/jupyterlab-manager/lib/manager.d.ts:51
kernel¶
• get kernel(): null | IKernelConnection
Returns¶
null | IKernelConnection
Inherited from¶
JupyterLabManager.kernel
Defined in¶
node_modules/@jupyter-widgets/jupyterlab-manager/lib/manager.d.ts:162
onUnhandledIOPubMessage¶
• get onUnhandledIOPubMessage(): ISignal<this, IIOPubMessage<IOPubMessageType>>
A signal emitted for unhandled iopub kernel messages.
Returns¶
ISignal<this, IIOPubMessage<IOPubMessageType>>
Inherited from¶
JupyterLabManager.onUnhandledIOPubMessage
Defined in¶
node_modules/@jupyter-widgets/jupyterlab-manager/lib/manager.d.ts:81
rendermime¶
• get rendermime(): IRenderMimeRegistry
Returns¶
IRenderMimeRegistry
Inherited from¶
JupyterLabManager.rendermime
Defined in¶
node_modules/@jupyter-widgets/jupyterlab-manager/lib/manager.d.ts:65
restored¶
• get restored(): ISignal<this, void>
A signal emitted when state is restored to the widget manager.
Notes¶
This indicates that previously-unavailable widget models might be available now.
Returns¶
ISignal<this, void>
Inherited from¶
JupyterLabManager.restored
Defined in¶
node_modules/@jupyter-widgets/jupyterlab-manager/lib/manager.d.ts:72
restoredStatus¶
• get restoredStatus(): boolean
Whether the state has been restored yet or not.
Returns¶
boolean
Inherited from¶
JupyterLabManager.restoredStatus
Defined in¶
node_modules/@jupyter-widgets/jupyterlab-manager/lib/manager.d.ts:76
Methods¶
_create_comm¶
▸ _create_comm(target_name, model_id, data?, metadata?, buffers?): Promise<IClassicComm>
Create a comm.
Parameters¶
| Name | Type |
|---|---|
target_name | string |
model_id | string |
data? | any |
metadata? | any |
buffers? | ArrayBuffer[] | ArrayBufferView[] |
Returns¶
Promise<IClassicComm>
Inherited from¶
JupyterLabManager._create_comm
Defined in¶
node_modules/@jupyter-widgets/jupyterlab-manager/lib/manager.d.ts:40
_get_comm_info¶
▸ _get_comm_info(): Promise<any>
Get the currently-registered comms.
Returns¶
Promise<any>
Inherited from¶
JupyterLabManager._get_comm_info
Defined in¶
node_modules/@jupyter-widgets/jupyterlab-manager/lib/manager.d.ts:44
_handleKernelChanged¶
▸ Protected _handleKernelChanged(«destructured»): void
Register a new kernel
Parameters¶
| Name | Type |
|---|---|
«destructured» | IKernelChangedArgs |
Returns¶
void
Inherited from¶
JupyterLabManager._handleKernelChanged
Defined in¶
node_modules/@jupyter-widgets/jupyterlab-manager/lib/manager.d.ts:30
_handleKernelConnectionStatusChange¶
▸ _handleKernelConnectionStatusChange(status): void
Parameters¶
| Name | Type |
|---|---|
status | ConnectionStatus |
Returns¶
void
Inherited from¶
JupyterLabManager._handleKernelConnectionStatusChange
Defined in¶
node_modules/@jupyter-widgets/jupyterlab-manager/lib/manager.d.ts:140
_handleKernelStatusChange¶
▸ _handleKernelStatusChange(status): void
Parameters¶
| Name | Type |
|---|---|
status | Status |
Returns¶
void
Inherited from¶
JupyterLabManager._handleKernelStatusChange
Defined in¶
node_modules/@jupyter-widgets/jupyterlab-manager/lib/manager.d.ts:141
_loadFromKernel¶
▸ Protected _loadFromKernel(): Promise<void>
Returns¶
Promise<void>
Inherited from¶
JupyterLabManager._loadFromKernel
Defined in¶
node_modules/@jupyter-widgets/jupyterlab-manager/lib/manager.d.ts:36
_loadFromKernelModels¶
▸ Protected _loadFromKernelModels(): Promise<void>
Old implementation of fetching widget models one by one using the request_state message on each comm.
This is a utility function that can be used in subclasses.
Returns¶
Promise<void>
Inherited from¶
JupyterLabManager._loadFromKernelModels
Defined in¶
node_modules/@jupyter-widgets/base-manager/lib/manager-base.d.ts:129
_loadFromNotebook¶
▸ _loadFromNotebook(notebook): Promise<void>
Load widget state from notebook metadata
Parameters¶
| Name | Type |
|---|---|
notebook | INotebookModel |
Returns¶
Promise<void>
Inherited from¶
JupyterLabManager._loadFromNotebook
Defined in¶
node_modules/@jupyter-widgets/jupyterlab-manager/lib/manager.d.ts:152
_make_model¶
▸ _make_model(options, serialized_state?): Promise<WidgetModel>
Parameters¶
| Name | Type |
|---|---|
options | RequiredSome<IModelOptions, "model_id"> |
serialized_state? | any |
Returns¶
Promise<WidgetModel>
Inherited from¶
JupyterLabManager._make_model
Defined in¶
node_modules/@jupyter-widgets/base-manager/lib/manager-base.d.ts:130
_registerWidgets¶
▸ Private _registerWidgets(): void
Returns¶
void
Defined in¶
packages/core/src/manager.ts:156
addWidgetFactories¶
▸ addWidgetFactories(rendermime): void
Parameters¶
| Name | Type |
|---|---|
rendermime | IRenderMimeRegistry |
Returns¶
void
Defined in¶
packages/core/src/manager.ts:50
build_widgets¶
▸ build_widgets(): Promise<void>
Returns¶
Promise<void>
Defined in¶
packages/core/src/manager.ts:65
callbacks¶
▸ callbacks(view?): ICallbacks
Default callback handler to emit unhandled kernel messages.
Parameters¶
| Name | Type |
|---|---|
view? | WidgetView |
Returns¶
ICallbacks
Inherited from¶
JupyterLabManager.callbacks
Defined in¶
node_modules/@jupyter-widgets/jupyterlab-manager/lib/manager.d.ts:26
clear_state¶
▸ clear_state(): Promise<void>
Close all widgets and empty the widget state.
Returns¶
Promise<void>
Promise that resolves when the widget state is cleared.
Inherited from¶
JupyterLabManager.clear_state
Defined in¶
node_modules/@jupyter-widgets/jupyterlab-manager/lib/manager.d.ts:171
create_view¶
▸ create_view<VT>(model, options?): Promise<VT>
Creates a promise for a view of a given model
Notes¶
The implementation must trigger the Lumino 'after-attach' and 'after-show' events when appropriate, which in turn will trigger the view's 'displayed' events.
Make sure the view creation is not out of order with any state updates.
Type parameters¶
| Name | Type |
|---|---|
VT | extends DOMWidgetView<VT> = DOMWidgetView |
Parameters¶
| Name | Type |
|---|---|
model | DOMWidgetModel |
options? | any |
Returns¶
Promise<VT>
Inherited from¶
JupyterLabManager.create_view
Defined in¶
node_modules/@jupyter-widgets/base-manager/lib/manager-base.d.ts:64
▸ create_view<VT>(model, options?): Promise<VT>
Type parameters¶
| Name | Type |
|---|---|
VT | extends WidgetView<VT> = WidgetView |
Parameters¶
| Name | Type |
|---|---|
model | WidgetModel |
options? | any |
Returns¶
Promise<VT>
Inherited from¶
JupyterLabManager.create_view
Defined in¶
node_modules/@jupyter-widgets/base-manager/lib/manager-base.d.ts:65
disconnect¶
▸ disconnect(): void
Disconnect the widget manager from the kernel, setting each model's comm as dead.
Returns¶
void
Inherited from¶
JupyterLabManager.disconnect
Defined in¶
node_modules/@jupyter-widgets/jupyterlab-manager/lib/manager.d.ts:35
display_view¶
▸ display_view(msg, view, options): Promise<Widget>
Parameters¶
| Name | Type |
|---|---|
msg | any |
view | any |
options | any |
Returns¶
Promise<Widget>
Defined in¶
packages/core/src/manager.ts:101
dispose¶
▸ dispose(): void
Dispose the resources held by the manager.
Returns¶
void
Inherited from¶
JupyterLabManager.dispose
Defined in¶
node_modules/@jupyter-widgets/jupyterlab-manager/lib/manager.d.ts:156
filterExistingModelState¶
▸ Protected filterExistingModelState(serialized_state): any
Filter serialized widget state to remove any ID's already present in manager.
Parameters¶
| Name | Type |
|---|---|
serialized_state | any |
Returns¶
any
A copy of the state, with its 'state' attribute filtered
Inherited from¶
JupyterLabManager.filterExistingModelState
Defined in¶
node_modules/@jupyter-widgets/base-manager/lib/manager-base.d.ts:200
get_model¶
▸ get_model(model_id): Promise<WidgetModel>
Get a promise for a model by model id.
Notes¶
If the model is not found, the returned Promise object is rejected.
If you would like to synchronously test if a model exists, use .has_model().
Parameters¶
| Name | Type |
|---|---|
model_id | string |
Returns¶
Promise<WidgetModel>
Inherited from¶
JupyterLabManager.get_model
Defined in¶
node_modules/@jupyter-widgets/base-manager/lib/manager-base.d.ts:78
get_state¶
▸ get_state(options?): Promise<IManagerState>
Asynchronously get the state of the widget manager.
This includes all of the widget models, and follows the format given in the @jupyter-widgets/schema package.
Parameters¶
| Name | Type | Description |
|---|---|---|
options? | IStateOptions | The options for what state to return. |
Returns¶
Promise<IManagerState>
Promise for a state dictionary
Inherited from¶
JupyterLabManager.get_state
Defined in¶
node_modules/@jupyter-widgets/base-manager/lib/manager-base.d.ts:145
get_state_sync¶
▸ get_state_sync(options?): ReadonlyPartialJSONValue
Synchronously get the state of the live widgets in the widget manager.
This includes all of the live widget models, and follows the format given in the @jupyter-widgets/schema package.
Parameters¶
| Name | Type | Description |
|---|---|---|
options? | IStateOptions | The options for what state to return. |
Returns¶
ReadonlyPartialJSONValue
A state dictionary
Inherited from¶
JupyterLabManager.get_state_sync
Defined in¶
node_modules/@jupyter-widgets/jupyterlab-manager/lib/manager.d.ts:101
handle_comm_open¶
▸ handle_comm_open(comm, msg): Promise<WidgetModel>
Handle when a comm is opened.
Parameters¶
| Name | Type |
|---|---|
comm | IClassicComm |
msg | ICommOpenMsg<"iopub" | "shell"> |
Returns¶
Promise<WidgetModel>
Inherited from¶
JupyterLabManager.handle_comm_open
Defined in¶
node_modules/@jupyter-widgets/base-manager/lib/manager-base.d.ts:89
has_model¶
▸ has_model(model_id): boolean
Returns true if the given model is registered, otherwise false.
Notes¶
This is a synchronous way to check if a model is registered.
Parameters¶
| Name | Type |
|---|---|
model_id | string |
Returns¶
boolean
Inherited from¶
JupyterLabManager.has_model
Defined in¶
node_modules/@jupyter-widgets/base-manager/lib/manager-base.d.ts:85
inline_sanitize¶
▸ inline_sanitize(source): string
Parameters¶
| Name | Type |
|---|---|
source | string |
Returns¶
string
Inherited from¶
JupyterLabManager.inline_sanitize
Defined in¶
node_modules/@jupyter-widgets/base-manager/lib/manager-base.d.ts:167
loadClass¶
▸ loadClass(className, moduleName, moduleVersion): Promise<typeof WidgetModel | typeof WidgetView>
Parameters¶
| Name | Type |
|---|---|
className | string |
moduleName | string |
moduleVersion | string |
Returns¶
Promise<typeof WidgetModel | typeof WidgetView>
Overrides¶
JupyterLabManager.loadClass
Defined in¶
packages/core/src/manager.ts:114
loadModelClass¶
▸ Protected loadModelClass(className, moduleName, moduleVersion): Promise<typeof WidgetModel>
Parameters¶
| Name | Type |
|---|---|
className | string |
moduleName | string |
moduleVersion | string |
Returns¶
Promise<typeof WidgetModel>
Inherited from¶
JupyterLabManager.loadModelClass
Defined in¶
node_modules/@jupyter-widgets/base-manager/lib/manager-base.d.ts:176
loadViewClass¶
▸ Protected loadViewClass(className, moduleName, moduleVersion): Promise<typeof WidgetView>
Parameters¶
| Name | Type |
|---|---|
className | string |
moduleName | string |
moduleVersion | string |
Returns¶
Promise<typeof WidgetView>
Inherited from¶
JupyterLabManager.loadViewClass
Defined in¶
node_modules/@jupyter-widgets/base-manager/lib/manager-base.d.ts:177
new_model¶
▸ new_model(options, serialized_state?): Promise<WidgetModel>
Create and return a promise for a new widget model
Example
widget_manager.new_model({
model_name: 'IntSlider',
model_module: '@jupyter-widgets/controls',
model_module_version: '1.0.0',
model_id: 'u-u-i-d'
}).then((model) => { console.log('Create success!', model); },
(err) => {console.error(err)});Parameters¶
| Name | Type | Description |
|---|---|---|
options | IModelOptions | the options for creating the model. |
serialized_state? | any | attribute values for the model. |
Returns¶
Promise<WidgetModel>
Inherited from¶
JupyterLabManager.new_model
Defined in¶
node_modules/@jupyter-widgets/base-manager/lib/manager-base.d.ts:114
new_widget¶
▸ new_widget(options, serialized_state?): Promise<WidgetModel>
Create a comm and new widget model.
Parameters¶
| Name | Type | Description |
|---|---|---|
options | IWidgetOptions | same options as new_model but comm is not required and additional options are available. |
serialized_state? | JSONObject | serialized model attributes. |
Returns¶
Promise<WidgetModel>
Inherited from¶
JupyterLabManager.new_widget
Defined in¶
node_modules/@jupyter-widgets/base-manager/lib/manager-base.d.ts:96
register¶
▸ register(data): void
Parameters¶
| Name | Type |
|---|---|
data | IWidgetRegistryData |
Returns¶
void
Inherited from¶
JupyterLabManager.register
Defined in¶
node_modules/@jupyter-widgets/jupyterlab-manager/lib/manager.d.ts:82
register_model¶
▸ register_model(model_id, modelPromise): void
Register a widget model.
Parameters¶
| Name | Type |
|---|---|
model_id | string |
modelPromise | Promise<WidgetModel> |
Returns¶
void
Inherited from¶
JupyterLabManager.register_model
Defined in¶
node_modules/@jupyter-widgets/jupyterlab-manager/lib/manager.d.ts:166
removeWidgetFactories¶
▸ removeWidgetFactories(rendermime): void
Parameters¶
| Name | Type |
|---|---|
rendermime | IRenderMimeRegistry |
Returns¶
void
Defined in¶
packages/core/src/manager.ts:61
resolveUrl¶
▸ resolveUrl(url): Promise<string>
Resolve a URL relative to the current notebook location.
Parameters¶
| Name | Type |
|---|---|
url | string |
Returns¶
Promise<string>
Inherited from¶
JupyterLabManager.resolveUrl
Defined in¶
node_modules/@jupyter-widgets/jupyterlab-manager/lib/manager.d.ts:160
restoreWidgets¶
▸ restoreWidgets(notebook, «destructured»?): Promise<void>
Restore widgets from kernel and saved state.
Parameters¶
| Name | Type |
|---|---|
notebook | INotebookModel |
«destructured» | Object |
› loadKernel | boolean |
› loadNotebook | boolean |
Returns¶
Promise<void>
Inherited from¶
JupyterLabManager.restoreWidgets
Defined in¶
node_modules/@jupyter-widgets/jupyterlab-manager/lib/manager.d.ts:145
setDirty¶
▸ setDirty(): void
Set the dirty state of the notebook model if applicable.
TODO: perhaps should also set dirty when any model changes any data
Returns¶
void
Inherited from¶
JupyterLabManager.setDirty
Defined in¶
node_modules/@jupyter-widgets/jupyterlab-manager/lib/manager.d.ts:177
setViewOptions¶
▸ setViewOptions(options?): any
Modifies view options. Generally overloaded in custom widget manager implementations.
Parameters¶
| Name | Type |
|---|---|
options? | any |
Returns¶
any
Inherited from¶
JupyterLabManager.setViewOptions
Defined in¶
node_modules/@jupyter-widgets/base-manager/lib/manager-base.d.ts:53
set_state¶
▸ set_state(state): Promise<WidgetModel[]>
Set the widget manager state.
Parameters¶
| Name | Type | Description |
|---|---|---|
state | IManagerState | a Javascript object conforming to the application/vnd.jupyter.widget-state+json spec. Reconstructs all of the widget models in the state, merges that with the current manager state, and then attempts to redisplay the widgets in the state. |
Returns¶
Promise<WidgetModel[]>
Inherited from¶
JupyterLabManager.set_state
Defined in¶
node_modules/@jupyter-widgets/base-manager/lib/manager-base.d.ts:155