IPython notebooks to YAML
This simple project allows one to convert IPython notebooks to easily editable YAML files. This is very similar to the notedown and ipymd packages but supports all IPython outputs as well.
The advantage of using this package is that you get complete compatibility with IPython notebooks and the ability to edit the files in any text editor.
The format is YAML so it is not as pretty as Markdown but is a reasonable compromise.
An example IPython notebook with the corresponding YAML file both with the outputs and without the outputs is available in the examples directory.
Installation
Install the package as follows:
$ pip install ipyaml
Usage
Run the command ipyaml to convert between the two formats:
$ ipyaml notebook.ipynb notebook.ipyml # or notebook.ipyaml $ ipyaml notebook.ipyml notebook.ipynb
If you do not want to store the cell outputs in your YAML files you may also run the ipyaml script as follows:
$ ipyaml --no-output notebook.ipynb notebook.ipyml
This will not write any of the outputs. By default, all the outputs are also written to the output. Take a look at the output without output to see that it is very easy to manually remove the outputs if they are not desired. Using --no-output does not remove the IPython kernelspec and nbformat metadata at the end of the file but that may also be safely removed if one does not desire it.
If you want jupyter to automatically load and save the .ipyml files. Add the following to your jupyter_notebook_config.py:
c.NotebookApp.contents_manager_class = 'ipyaml.api.YAMLContentsManager'
The jupyter_notebook_config.py can be found by running:
$ jupyter --config-dir
If you don’t see a jupyter_notebook_config.py you can do this:
$ jupyter notebook --generate-config
1 maintainer
Metadata
1 maintainer
Release files for ipyaml 0.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ipyaml-0.3.tar.gz | 15.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ipyaml-0.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 26.1 kB
Release files / ipyaml-0.3.tar.gz
| Download URL | ipyaml-0.3.tar.gz |
|---|---|
| Size | 15.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
028e6b90da7f902a25525892265a4ee1372b875084f973cc32a174fe1bdbb027
|
|
BLAKE2b-256 checksum How to use checksums |
7ecd1bee66262f597e11c45d4fa8c9a601e609a16d12d8732ccee18a668ec1c7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Release files / ipyaml-0.3-py3-none-any.whl
| Download URL | ipyaml-0.3-py3-none-any.whl |
|---|---|
| Size | 10.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ffc6ef7370c816fabab0b7454abd2c485c24d7020feaadd135a98eae1e4d9426
|
|
BLAKE2b-256 checksum How to use checksums |
6c4466da645612336a41b06322ed0e53d160f4fa756333e1de1eafccd103a8d4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
