nbexporter

Tools for exporting Google Colab notebooks from gdrive to .ipynb files in a git repo.

Features

• export notebooks from google drive (requires google oauth client setup, and provide secrets as ENV vars)

Usage

# list all the notebook-like files in a folder gdrive
./nbexporter.py --list <gdrive folder id>

# export multiple notebooks specified in a YTML manifest file
./nbexporter.py --manifest <path>

# same as above but also writes a README.md with binder and colab links
./nbexporter.py --manifest <path> --readme

TODOs

• add nbviewer links too
• package as a reusable CLI program
• implement archive and diff commands

Roadmap

• export to ordinary .py scripts (see https://github.com/minireference/noBSLAnotebooks/blob/master/util/makepynb.sh )
• diffs on text-based .py scripts
• export to MyST, see https://jupyterbook.org/intro.html

Stretch goals

• process notebooks to create learner version (no solutions) and solutions version see https://github.com/NeuromatchAcademy/nmaci/blob/main/scripts/process_notebooks.py#L226-L298