Skip to content
An extension for rendering Bokeh content in JupyterLab notebooks
TypeScript Python JavaScript Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
conda.recipe Simplify version handling (#80) Oct 28, 2019
examples Rename test_cases -> examples Oct 23, 2019
jupyter_bokeh Ensure model updates include setter to avoid events bouncing Nov 11, 2019
scripts Simplify version handling (#80) Oct 28, 2019
src Simplify version handling (#80) Oct 28, 2019
.gitignore
.travis.yml Work around bad design of eslint (#76) Oct 19, 2019
LICENSE.txt
MANIFEST.in Add support for jupyter wigets (#71) Oct 19, 2019
README.md Fix typo in installation instructions. Oct 30, 2019
eslint.json Improve quality of *.ts files (#70) Oct 16, 2019
jupyter_bokeh.json
package-lock.json
package.json bump version to 1.1.1 Nov 14, 2019
setup.cfg
setup.py bump version to 1.1.1 Nov 14, 2019
tsconfig.json Improve quality of *.ts files (#70) Oct 16, 2019
webpack.config.js Simplify version handling (#80) Oct 28, 2019

README.md

jupyter_bokeh

A Jupyter extension for rendering Bokeh content.

Prerequisites

  • Jupyter Lab or Notebook

Installation

To install the latest version in Jupyter Lab:

conda install -c bokeh jupyter_bokeh
jupyter labextension install @jupyter-widgets/jupyterlab-manager
jupyter labextension install @bokeh/jupyter_bokeh

To install a specific version:

jupyter labextension install @bokeh/jupyter_bokeh@x.y.x

On slow or limited memory systems, one can use --minimize=False to reduce compilation times or make Jupyter Lab build runtime bundles at all.

jupyter_bokeh is automatically installed in Jupyter Notebook. In case of a non-standard setup, one can install the extensions with:

jupyter nbextension install --sys-prefix --symlink --py jupyter_bokeh
jupyter nbextension enable jupyter_bokeh --py --sys-prefix

Compatibility

The core Bokeh library is generally version independent of JupyterLab and this jupyter_bokeh extension for versions of bokeh>=0.12.0.

Our goal is that jupyter_bokeh minor releases (using the SemVer pattern) are made to follow JupyterLab minor release bumps and micro releases are for new jupyter_bokeh features or bug fix releases. We've been previously inconsistent with having the extension release minor version bumps track that of JupyterLab, so users seeking to find extension releases that are compatible with their JupyterLab installation may refer to the below table.

Compatible JupyterLab and jupyter_bokeh versions
JupyterLab jupyter_bokeh
0.34.x 0.6.2
0.35.x 0.6.3
1.0.x 1.0.0

Development

For a development install (requires npm version 6 or later), do the following in the repository directory:

npm install
jupyter labextension link .

To rebuild the package and the JupyterLab app:

npm run build
jupyter lab build

To incrementally rebuild the extension and JupyterLab after changes you can run

npm run watch

and in another terminal run

jupyter lab --watch

When making a new release for compatibility with a new JupyterLab minor release series, please make a minor release bump in this extension (i.e. 0.6.3 -> 0.7.0). Conversely, when creating a release for a new feature or bug fix, please make a micro release bump (i.e. 0.6.3 -> 0.6.4).

Testing

There is a directory named examples which contains a collection of notebooks that cover the various jupyter_bokeh functionalities. If you update the extension for new JupyterLab releases, please manually execute each and check that the expected behavior occurs. If you extend the jupyter_bokeh, please add a new notebook that covers the new functionality.

You can’t perform that action at this time.