Skip to main content

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

bokeh-resources-0.4.tar.gz (2.9 kB view details)

Uploaded Source

Built Distribution

bokeh_resources-0.4-py3-none-any.whl (3.1 kB view details)

Uploaded Python 3

File details

Details for the file bokeh-resources-0.4.tar.gz.

File metadata

  • Download URL: bokeh-resources-0.4.tar.gz
  • Upload date:
  • Size: 2.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.1

File hashes

Hashes for bokeh-resources-0.4.tar.gz
Algorithm Hash digest
SHA256 62efacb6c0ce947e333669888b78b1f25f3822516137a5bccf2fc0149a6353b8
MD5 c2aa9563d9cec9aaeba1cd6e823265d2
BLAKE2b-256 0f65ade79c25766d4ea914d2cc9762b10fb1ce8f03d0d9f84302e8eec7318b09

See more details on using hashes here.

Provenance

File details

Details for the file bokeh_resources-0.4-py3-none-any.whl.

File metadata

File hashes

Hashes for bokeh_resources-0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 80273d56f388411d599e50e88a1acfaa742098886be083d84368f00fc2c3fbd5
MD5 713f31970b37348f31e99cf8e63dcbe1
BLAKE2b-256 77dac9fdb8284a9d922be8b9b2ee130075585120b002360e2315e9780d802ca0

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page