Skip to content

PainterQubits/jupyterlab-datalogs

JupyterLab DataLogs

PyPI Latest Release PyPI Python Versions License CI

JupyterLab extension for DataLogs.

Installation

Install the latest version of JupyterLab DataLogs using pip:

pip install -U jupyterlab-datalogs

This extension should run alongside JupyterLab version 4 (included with the jupyterlab extra). There are also a set of packages required for analysis using DataLogs notebooks (included with the analysis extra), and a set of recommended JupyterLab plugins (included with the plugins extra).

To automatically install with all of these extras, use the all extra:

pip install -U "jupyterlab-datalogs[all]"

While the Real-Time Collaboration extension is included in the plugins extra for JupyterLab Open Warning to work, the collaboration functionality can be disabled by running JupyterLab with the following option:

jupyter lab --YDocExtension.disable_rtc True

Development

To develop, the following dependencies must be installed:

Then, run

hatch run ci:jlpm

to install Node.js dependencies, and

hatch run dev

to build the extension and start up a JupyterLab server. The first time you do this, also go to the Extension Manager tab in JupyterLab (the puzzle piece icon on the left) to enable 3rd party extensions. Now the extension should be activated. When the source code changes, it should automatically rebuild, and the updated extension will be used when the page is reloaded.

Note

On Windows, symbolic links must be activated for hatch run dev to work. On Windows 10 or above for Python version 3.8 or higher, this can be done by activating developer mode.

Alternatively, you can run hatch run build to rebuild and reinstall the extension each time the source code changes, and hatch run jupyter lab to start a new JupyterLab server.