➤ nbsafety
About
nbsafety adds a layer of protection to computational notebooks by solving the
stale dependency problem when executing cells out-of-order. Here's an
example in action:
When the first cell is rerun, the second cell now contains a reference to an
updated f and is suggested for re-execution with a turquoise highlight. The
third cell contains a reference to a stale y -- y is stale due to its
dependency on an old value of f. As such, the third cell is marked as unsafe
for re-execution with a red highlight. Once the second cell is rerun, it is
now suggested to re-execute the third cell in order to refresh its stale
output.
nbsafety accomplishes its magic using a combination of a runtime tracer (to
build the implicit dependency graph) and a static checker (to provide warnings
before running a cell), both of which are deeply aware of Python's data model.
In particular, nbsafety requires minimal to no changes in user
behavior, opting to get out of the way unless absolutely necessary and letting
you use notebooks the way you prefer.
Install
pip install nbsafety
Interface
The kernel ships with an extension that highlights cells with live references to stale symbols using red UI elements. It furthermore uses turquoise highlights for cells with live references to updated symbols, as well as for cells that resolve staleness.
Running
To run an nbsafety kernel in Jupyter, select "Python 3 (nbsafety)" from the
list of notebook types in Jupyter's "New" dropdown dialogue. For JupyterLab,
similarly select "Python 3 (nbsafety)" from the list of available kernels in
the Launcher tab.
| Jupyter Notebook Entrypoint: | Jupyter Lab Entrypoint: |
|---|---|
 |
 |
Uninstall
pip uninstall nbsafety
License
Code in this project licensed under the BSD-3-Clause License.
➤ Contributors
 |
 |
 |
|---|---|---|
| Stephen Macke | Ray Gong | Shreya Shankar |
1 maintainer
Metadata
1 maintainer
Release files for nbsafety 0.0.87
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| nbsafety-0.0.87.tar.gz | 155.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| nbsafety-0.0.87-py2.py3-none-any.whl | Python 3, Python 2 | none | any | Details |
Total release size: 313.3 kB
Release files / nbsafety-0.0.87.tar.gz
| Download URL | nbsafety-0.0.87.tar.gz |
|---|---|
| Size | 155.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4203067e5a5adf6601c60030185e442623478813bbbfbe6b6f61daeee76da2b3
|
|
BLAKE2b-256 checksum How to use checksums |
350d84166f0506ac7bcd5825814f950ce0788d0bcb204f5186d692bde6ab1300
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.8.0 pkginfo/1.8.2 readme-renderer/34.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.9 tqdm/4.63.1 importlib-metadata/4.11.3 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.9.7
|
Release files / nbsafety-0.0.87-py2.py3-none-any.whl
| Download URL | nbsafety-0.0.87-py2.py3-none-any.whl |
|---|---|
| Size | 157.8 kB |
| Tags | Python 2 Python 3 |
|
SHA-256 checksum How to use checksums |
f204ea8c56035d721bcf43d58bc6ef6618af4080a420d559d127a8a52c0bab19
|
|
BLAKE2b-256 checksum How to use checksums |
4d30dcbc3bdd778fae08f6f1916074838e2085142bcd9dc589f27bad68768345
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.8.0 pkginfo/1.8.2 readme-renderer/34.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.9 tqdm/4.63.1 importlib-metadata/4.11.3 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.9.7
|
