an opinionated, nbdev-enabled, batteries-included jupyter environment to faciliate notebook usage, maintenance, and interoperation
this has been tested on ubuntu linux 22.04 and macOS Monterey running Nix 2.3.x
these versions should correspond to the hand-locked versions specified in the shell.nix environment
$ jupyter --version
Selected Jupyter core packages...
IPython : 8.11.0
ipykernel : 6.21.2
ipywidgets : not installed
jupyter_client : 8.0.3
jupyter_core : 5.2.0
jupyter_server : 2.3.0
jupyterlab : not installed
nbclient : 0.7.2
nbconvert : 7.2.9
nbformat : 5.7.3
notebook : 6.2.0
qtconsole : not installed
traitlets : 5.9.0
a working Nix package manager environment
mac users must manually install quarto for now, because the quarto package is marked as unsupported in the nix repository.
if using nix >= 2.4 with nix command enabled (how to enable), enter the environment with nix develop; otherwise, enter withnix-shell.
once in the shell, you should be able to run jupyter notebook and any of the nbdev_* functions
This environment installs all packages necessary to run a working nbdev notebook environment, including the 2 recommended extensions (Collapsible headings and TOC2) listed in the tutorial.
In total, this install enables these useful extensions:
- bash kernel for IPython
- jupytext
- LC multi outputs (whacked's fork): keeps repeated execution of the same cell into separate, timestamped tabs
- nbextensions manager tab inthe jupyter main view
- Collapsible Headings: collapse markdown sections
- Codefolding: fold code in cells
- ExecuteTime: shows last executed time + execution duration
- toggle line numbers in cells
- Freeze: mark cells read-only / frozen
- Scratchpad: throw-away / temporary code execution area
- Autopep8: auto-format / clean up cell code using pep8 (note this extension causes an annoying popup to appear when opening bash kernel notebooks)
- datestamper: install current datestamp
- Table of Contents (2): shows navigation panel to jump to markdown section headings
- Variable Inspector