Skip to main content
https://travis-ci.org/rasmunk/notebook_parameterizer.svg?branch=master https://badge.fury.io/py/notebook-parameterizer.svg

A tool to generate parameterized Jupyter Notebooks. This tool is similar to that of Papermill, but acts as a compliment to parameterize a Notebook not based on a preset cell that contains the parameters, but allows for parameterization throughout a Notebook without having to specify so.

Instead the notebook_parameterizer uses a parameters YAML file to define which variables should be set to what value. With these preset variables in the parameters file, the notebook_parameterizer searches every cell for variable assignments that match the given key in the parameters file.

Usage

An example of how to use the notebook_parameterizer can be seen below:

$ notebook_parameterizer -h
Usage: notebook_parameterizer [OPTIONS] NOTEBOOK_PATH PARAMETERS_PATH

Options:
-o, --output_notebook_path TEXT
                                Path to the parameterized output notebook
-e, --expand_env_values         Should ENV_ prefixed parameter values be
                                expanded to their matching OS environment
                                variable value

-h, --help                      Show this message and exit.

The NOTEBOOK_PATH is the path to the Notebook that should be parameterized.

The PARAMETERS_PATH is the path to the YAML file that contains the variables that should be parameterized.

For instance, given the following Notebook in example/notebooks/hello_world.ipynb.

res/hello_world.png

We can paramterize the Notebook with the example/parameters/hello_world.yml parameters file:

num: 1000
div_by: 4

This is achived by executing the following command:

$ notebook_parameterizer example/notebooks/hello_world.ipynb \
 example/parameters/hello_world.yml \
 -o new_hello_world.ipynb

After applying the notebook_parameterizer, the generated new_hello_world.ipynb Notebook has the following content.

res/parameterized_hello_world.png

Release files for notebook-parameterizer 0.0.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for notebook-parameterizer 0.0.4
File Size Uploaded
notebook_parameterizer-0.0.4.tar.gz 3.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for notebook-parameterizer 0.0.4
File Interpreter ABI Platform
notebook_parameterizer-0.0.4-py3-none-any.whl Python 3 none any Details

Total release size: 9.0 kB

Release files / notebook_parameterizer-0.0.4.tar.gz

Download URL notebook_parameterizer-0.0.4.tar.gz
Size 3.7 kB
Tags Source
SHA-256 checksum
How to use checksums
8d0cdd53466218364b48c55b6d24963dc7591d7be894deb869f62d80cf861e95
BLAKE2b-256 checksum
How to use checksums
3f6f4ec54495daecd9c3bb2b4490127ee1b489875dd6c7b62f4abbe4bf7d7e49
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/53.0.0 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.6.7

Release files / notebook_parameterizer-0.0.4-py3-none-any.whl

Download URL notebook_parameterizer-0.0.4-py3-none-any.whl
Size 5.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fe5a9894ae5acb610f4aa7be83229aef7853f17c4ae2dfca488c1f4ef9e5d369
BLAKE2b-256 checksum
How to use checksums
ede09ceb73aa30e01319d63af67ac9cb5ef5d032c5d5957c4f96622f2562e451
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/53.0.0 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.6.7

Release history Release notifications | RSS feed

This release

0.0.4 This release

2 release files

0.0.3

3 release files

0.0.2

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page