Merge pull request #23 from dleen/master

Add new nb function

Author: jph00

execnb/_modidx.py

@@ -50,6 +50,7 @@
                              'execnb.nbio.dict2nb': 'https://fastai.github.io/execnb/nbio.html#dict2nb',
                              'execnb.nbio.nb2dict': 'https://fastai.github.io/execnb/nbio.html#nb2dict',
                              'execnb.nbio.nb2str': 'https://fastai.github.io/execnb/nbio.html#nb2str',
+                             'execnb.nbio.new_nb': 'https://fastai.github.io/execnb/nbio.html#new_nb',
                              'execnb.nbio.read_nb': 'https://fastai.github.io/execnb/nbio.html#read_nb',
                              'execnb.nbio.write_nb': 'https://fastai.github.io/execnb/nbio.html#write_nb'},
             'execnb.shell': { 'execnb.shell.CaptureShell': 'https://fastai.github.io/execnb/shell.html#captureshell',

execnb/nbio.py

@@ -1,7 +1,7 @@
 # AUTOGENERATED! DO NOT EDIT! File to edit: ../nbs/01_nbio.ipynb.
 
 # %% auto 0
-__all__ = ['NbCell', 'dict2nb', 'read_nb', 'nb2dict', 'nb2str', 'write_nb']
+__all__ = ['NbCell', 'dict2nb', 'read_nb', 'nb2dict', 'nb2str', 'write_nb', 'new_nb']
 
 # %% ../nbs/01_nbio.ipynb 2
 from fastcore.imports import *
@@ -65,3 +65,8 @@ def nb2str(nb):
 def write_nb(nb, path):
     "Write `nb` to `path`"
     with maybe_open(path, 'w', encoding='utf-8') as f: f.write(nb2str(nb))
+
+# %% ../nbs/01_nbio.ipynb 35
+def new_nb():
+    "Returns an empty new notebook"
+    return dict2nb({'cells':[],'metadata':{},'nbformat':4,'nbformat_minor':5})

nbs/01_nbio.ipynb

@@ -446,6 +446,32 @@
     "finally: tmp.unlink()"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Creating a notebook"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "#|export\n",
+    "def new_nb():\n",
+    "    \"Returns an empty new notebook\"\n",
+    "    return dict2nb({'cells':[],'metadata':{},'nbformat':4,'nbformat_minor':5})"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Use this function when creating a new notebook. Useful for when you don't want to create a notebook on disk first and then read it."
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {},