jupyterlab_bokeh v0.6.3

jupyterlab_bokeh

A JupyterLab extension for rendering Bokeh content

Prerequisites

• JupyterLab

Installation

To install the latest version:

jupyter labextension install jupyterlab_bokeh

To install a specific version:

jupyter labextension install jupyterlab_bokeh@x.y.x

Compatibility

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

Our goal is that jupyterlab_bokeh minor releases (using the SemVer pattern) are made to follow JupyterLab minor release bumps and micro releases are for new jupyterlab_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 jupyterlab_bokeh versions

Development

For a development install (requires npm version 4 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 test_cases which contains a collection of notebooks that cover the various jupyterlab_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 jupyterlab_bokeh, please add a new notebook that covers the new functionality.