Skip to main content

The coolest way to transform Jupyter Notebooks.

Project description

=============
NotebookToAll
=============


.. image:: https://img.shields.io/pypi/v/notebooktoall.svg
:target: https://pypi.python.org/pypi/notebooktoall

.. image:: https://img.shields.io/travis/notebooktoall/notebooktoall.svg
:target: https://travis-ci.org/notebooktoall/notebooktoall

.. image:: https://readthedocs.org/projects/notebooktoall/badge/?version=latest
:target: https://notebooktoall.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status

.. image:: https://pyup.io/repos/github/notebooktoall/notebooktoall/shield.svg
:target: https://pyup.io/repos/github/notebooktoall/notebooktoall/
:alt: Updates


The coolest way to turn a Jupyter Notebook into sharable files.

Turn your Jupyter Notebook into a .py executable file and an .html file with a one-line command. You can create both or either file type at the same time! Under the hood, this package uses Jupyter nbconvert.

nbconvert is great for command line transformations, but it takes a bit of work to use in a program. NotebookToAll to the rescue.

Quick Start
-----------

Install
_______

Install from PyPI.

pip install notebooktoall

Use
___

Make sure your notebook doesn't have magic commands in it if you want to create an executable .py script.::


from notebooktoall.transform import transform_notebook

transform_notebook(ipynb_file="my_jupyter_notebook.ipynb", export_list=["html", "py"])



Run your code and your .html and .py files should appear in your current working directory.

You can pass a Jupyter notebook URL to transform_notebook().

License
_______

* Free software: GNU General Public License v3

Docs
____

* Documentation: https://notebooktoall.readthedocs.io.


Credits:
________

The Cookiecutter_ `audreyr/cookiecutter-pypackage`_ project template.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage


=======
History
=======

0.0.1 (2019-02-11)
------------------

* First release on PyPI.

0.1.0 (2019-02-11)
_________________

* Add Code of Conduct
* Improve docs
* Fix badges
* Cover multiple python versions

0.1.1 (2019-02-11)
_________________

* Bump version

0.1.2 (2019-02-11)
_________________

* Add missing dependency
* Update ReadTheDocs usage

0.1.3 (2019-02-11)
_________________

* Improve rst doc formatting
* Wheel

0.1.4 (2019-02-11)
_________________

* Nada

0.1.5 (2019-02-11)
_________________

* Add requirements to setup.py

0.1.6 (2019-02-12)
_________________

* One requirements file

0.1.7 (2019-02-12)
_________________

* Fix setup.py

0.1.8 (2019-02-13)
_________________

* Update coverage

0.2.0 (2019-02-14)
_________________

* API change to transform_notebook() from transform_notebooks()
* More Tests

0.2.1 (2019-02-15)
__________________

* RTD improvements
* Fewer packages required for install
* Doc fixes


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

notebooktoall-0.2.2.tar.gz (15.7 kB view hashes)

Uploaded Source

Built Distribution

notebooktoall-0.2.2-py2.py3-none-any.whl (3.5 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page