Jupyter extension to serve bokeh resources (js and css files).
Project description
bokeh-resources
Bokeh (https://bokeh.org/) Python plotting library has two main modes for serving static content: CDN and inline.
-
'cdn' (=content distribution network) mode needs internet connection every time you open the notebook
-
'inline' mode increases the size of ipynb files by 6Mb
bokeh-resources
is a jupyter extension that makes jupyter serve bokeh files locally.
It keeps the size of ipynb files small and works offline as well.
Installation:
Install the nbextensions if you haven't already:
pip install jupyter_contrib_nbextensions && jupyter contrib nbextensions install
Then either
pip install bokeh-resources
python -m bokeh_resources.install
Or
git clone https://github.com/axil/bokeh-resources
cd bokeh_resources/bokeh_resources
python install.py
This will install the extension to jupyter and to create the symlink (see 'Updating' below)
After this the package itself can be safely uninstalled (pip uninstall bokeh-resources
).
To uninstall the extension run
jupyter nbextensions uninstall bokeh_resources
Usage:
In bokehlab:
%bokehlab local
In bokeh:
from bokeh.io import output_notebook
from bokeh.resources import Resources
output_notebook(Resources('server', root_url='/nbextensions/bokeh_resources'))
Updating:
Serving is performed through a symbolic link (or a directory junction on Windows).
This means that it is resilient to bokeh updates.
(= the extension does not need to be updated when bokeh
is updated to the next version).
The extension needs to be updated when switching to a different python version. Use argument -f/--force to force overwriting of the symlink to the uptodate bokeh resources directory witin the current python version:
python -m bokeh_resources.install -f
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for bokeh_resources-0.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 80273d56f388411d599e50e88a1acfaa742098886be083d84368f00fc2c3fbd5 |
|
MD5 | 713f31970b37348f31e99cf8e63dcbe1 |
|
BLAKE2b-256 | 77dac9fdb8284a9d922be8b9b2ee130075585120b002360e2315e9780d802ca0 |