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.
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.
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)
| File | Size | Uploaded | |
|---|---|---|---|
| notebook_parameterizer-0.0.4.tar.gz | 3.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|