Skip to main content

Visualize Python code execution in Jupyter Notebook cells

Project description

Nbtutor

Visualize Python code execution (line-by-line) in Jupyter Notebook cells. Inspired by Online Python Tutor

Usage Example

Binder

Install

Note: installing directly off this repo won't work, as we don't ship the built JavaScript and CSS assets. See more about developing below.

pip

pip install nbtutor
jupyter nbextension install --overwrite --py nbtutor
jupyter nbextension enable --py nbtutor

conda

conda install -c conda-forge nbtutor
jupyter nbextension install --overwrite --py nbtutor
jupyter nbextension enable --py nbtutor

Usage (Jupyter Notebook)

First load the nbtutor IPython kernel extension at top of the Notebook by executing the following magic in a CodeCell:

%load_ext nbtutor

Then to visualize the execute of code in a CodeCell add the following magic to the top of the CodeCell and execute it again:

%%nbtutor

Optional Arguments

There are also optional arguments that can be used with the cell magic:

  • Reset the IPython user namespace

    %%nbtutor -r/--reset
    
  • Suppress the confirmation message from -r/--reset

    %%nbtutor -r/--reset -f/--force
    
  • Specify the maximum frame depth to visualize (default: 3)

    %%nbtutor -d/--depth N
    
  • Specify the maximum number of elements to visualize for "sequence" type objects (default: 5)

    %%nbtutor --max_size S
    
  • Step through all frames (including frames from other cells and other global scopes altogether)

    %%nbtutor --step_all
    

Notes

  • If you find a problem please feel free to submit a GitHub Issue

Develop

Please see the DEVELOPMENT.md file

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

nbtutor-2.0.3.tar.gz (618.5 kB view hashes)

Uploaded Source

Built Distribution

nbtutor-2.0.3-py2.py3-none-any.whl (190.7 kB view hashes)

Uploaded Python 2 Python 3

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