A JupyterLab debugger UI extension. This extension is under active development.
- JupyterLab 2.0+
- xeus-python 0.7.1+
- notebook 6+
A kernel with support for debugging is required to be able to use the debugger.
It is generally recommended to create a new conda
environment to install the dependencies:
conda create -n jupyterlab-debugger -c conda-forge xeus-python=0.7.1 notebook=6 jupyterlab=2 ptvsd
conda activate jupyterlab-debugger
Then, run the following command to install the extension:
jupyter labextension install @jupyterlab/debugger
# Create a new conda environment
conda create -n jupyterlab-debugger -c conda-forge nodejs xeus-python=0.7.1 ptvsd jupyterlab=2
# Activate the conda environment
conda activate jupyterlab-debugger
# Install dependencies
jlpm
# Build TypeScript source
jlpm build
# Link your development version of the extension with JupyterLab
jupyter labextension link .
# Rebuild TypeScript source after making changes
jlpm build
# Rebuild JupyterLab after making any changes
jupyter lab build
# Start JupyterLab with the kernel logs enabled and watch mode enabled
XEUS_LOG=1 jupyter lab --no-browser --watch
To run the tests:
# [Optional] to enable the logs for xeus-python
export XEUS_LOG=1
jlpm run test
To run tests for a specific test suite name:
jlpm run test --testNamePattern=<regex>
To run tests for a specific test module name:
jlpm run test --testPathPattern=<regex>
The kernelspy extension for JupyterLab can be used to inspect the debug messages sent between the debugger UI and the kernel.
To install it:
jupyter labextension install jupyterlab-kernelspy