nbdev 2.4.6__tar.gz → 2.4.8__tar.gz

{nbdev-2.4.6/nbdev.egg-info → nbdev-2.4.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nbdev
-Version: 2.4.6
+Version: 2.4.8
 Summary: Create delightful software with Jupyter Notebooks
 Home-page: https://github.com/AnswerDotAI/nbdev
 Author: Jeremy Howard and Hamel Husain
@@ -20,7 +20,7 @@ Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: packaging
-Requires-Dist: fastcore>=1.8.0
+Requires-Dist: fastcore>=1.11.0
 Requires-Dist: execnb>=0.1.12
 Requires-Dist: astunparse
 Requires-Dist: ghapi>=1.0.3

{nbdev-2.4.6 → nbdev-2.4.8}/nbdev/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "2.4.6"
+__version__ = "2.4.8"
 
 from .doclinks import nbdev_export
 from .showdoc import show_doc

{nbdev-2.4.6 → nbdev-2.4.8}/nbdev/_modidx.py

@@ -49,6 +49,13 @@ d = { 'settings': { 'branch': 'main',
                               'nbdev.config.update_proj': ('api/config.html#update_proj', 'nbdev/config.py'),
                               'nbdev.config.update_version': ('api/config.html#update_version', 'nbdev/config.py'),
                               'nbdev.config.write_cells': ('api/config.html#write_cells', 'nbdev/config.py')},
+            'nbdev.diff': { 'nbdev.diff._cell_changes': ('api/diff.html#_cell_changes', 'nbdev/diff.py'),
+                            'nbdev.diff._nb_srcdict': ('api/diff.html#_nb_srcdict', 'nbdev/diff.py'),
+                            'nbdev.diff.cell_diffs': ('api/diff.html#cell_diffs', 'nbdev/diff.py'),
+                            'nbdev.diff.changed_cells': ('api/diff.html#changed_cells', 'nbdev/diff.py'),
+                            'nbdev.diff.nbs_pair': ('api/diff.html#nbs_pair', 'nbdev/diff.py'),
+                            'nbdev.diff.read_nb_from_git': ('api/diff.html#read_nb_from_git', 'nbdev/diff.py'),
+                            'nbdev.diff.source_diff': ('api/diff.html#source_diff', 'nbdev/diff.py')},
             'nbdev.doclinks': { 'nbdev.doclinks.NbdevLookup': ('api/doclinks.html#nbdevlookup', 'nbdev/doclinks.py'),
                                 'nbdev.doclinks.NbdevLookup.__getitem__': ( 'api/doclinks.html#nbdevlookup.__getitem__',
                                                                             'nbdev/doclinks.py'),
@@ -322,37 +329,9 @@ d = { 'settings': { 'branch': 'main',
                                'nbdev.showdoc.BasicMarkdownRenderer': ('api/showdoc.html#basicmarkdownrenderer', 'nbdev/showdoc.py'),
                                'nbdev.showdoc.BasicMarkdownRenderer._repr_markdown_': ( 'api/showdoc.html#basicmarkdownrenderer._repr_markdown_',
                                                                                         'nbdev/showdoc.py'),
-                               'nbdev.showdoc.DocmentTbl': ('api/showdoc.html#docmenttbl', 'nbdev/showdoc.py'),
-                               'nbdev.showdoc.DocmentTbl.__eq__': ('api/showdoc.html#docmenttbl.__eq__', 'nbdev/showdoc.py'),
-                               'nbdev.showdoc.DocmentTbl.__init__': ('api/showdoc.html#docmenttbl.__init__', 'nbdev/showdoc.py'),
-                               'nbdev.showdoc.DocmentTbl._columns': ('api/showdoc.html#docmenttbl._columns', 'nbdev/showdoc.py'),
-                               'nbdev.showdoc.DocmentTbl._hdr_list': ('api/showdoc.html#docmenttbl._hdr_list', 'nbdev/showdoc.py'),
-                               'nbdev.showdoc.DocmentTbl._repr_markdown_': ( 'api/showdoc.html#docmenttbl._repr_markdown_',
-                                                                             'nbdev/showdoc.py'),
-                               'nbdev.showdoc.DocmentTbl._row': ('api/showdoc.html#docmenttbl._row', 'nbdev/showdoc.py'),
-                               'nbdev.showdoc.DocmentTbl._row_list': ('api/showdoc.html#docmenttbl._row_list', 'nbdev/showdoc.py'),
-                               'nbdev.showdoc.DocmentTbl.has_docment': ('api/showdoc.html#docmenttbl.has_docment', 'nbdev/showdoc.py'),
-                               'nbdev.showdoc.DocmentTbl.has_return': ('api/showdoc.html#docmenttbl.has_return', 'nbdev/showdoc.py'),
-                               'nbdev.showdoc.DocmentTbl.hdr_str': ('api/showdoc.html#docmenttbl.hdr_str', 'nbdev/showdoc.py'),
-                               'nbdev.showdoc.DocmentTbl.params_str': ('api/showdoc.html#docmenttbl.params_str', 'nbdev/showdoc.py'),
-                               'nbdev.showdoc.DocmentTbl.return_str': ('api/showdoc.html#docmenttbl.return_str', 'nbdev/showdoc.py'),
-                               'nbdev.showdoc.ShowDocRenderer': ('api/showdoc.html#showdocrenderer', 'nbdev/showdoc.py'),
-                               'nbdev.showdoc.ShowDocRenderer.__init__': ('api/showdoc.html#showdocrenderer.__init__', 'nbdev/showdoc.py'),
-                               'nbdev.showdoc._bold': ('api/showdoc.html#_bold', 'nbdev/showdoc.py'),
                                'nbdev.showdoc._create_html_table': ('api/showdoc.html#_create_html_table', 'nbdev/showdoc.py'),
-                               'nbdev.showdoc._docstring': ('api/showdoc.html#_docstring', 'nbdev/showdoc.py'),
-                               'nbdev.showdoc._escape_markdown': ('api/showdoc.html#_escape_markdown', 'nbdev/showdoc.py'),
                                'nbdev.showdoc._ext_link': ('api/showdoc.html#_ext_link', 'nbdev/showdoc.py'),
-                               'nbdev.showdoc._f_name': ('api/showdoc.html#_f_name', 'nbdev/showdoc.py'),
-                               'nbdev.showdoc._fmt_anno': ('api/showdoc.html#_fmt_anno', 'nbdev/showdoc.py'),
-                               'nbdev.showdoc._fmt_sig': ('api/showdoc.html#_fmt_sig', 'nbdev/showdoc.py'),
-                               'nbdev.showdoc._fullname': ('api/showdoc.html#_fullname', 'nbdev/showdoc.py'),
                                'nbdev.showdoc._html_link': ('api/showdoc.html#_html_link', 'nbdev/showdoc.py'),
-                               'nbdev.showdoc._list2row': ('api/showdoc.html#_list2row', 'nbdev/showdoc.py'),
-                               'nbdev.showdoc._maybe_nm': ('api/showdoc.html#_maybe_nm', 'nbdev/showdoc.py'),
-                               'nbdev.showdoc._non_empty_keys': ('api/showdoc.html#_non_empty_keys', 'nbdev/showdoc.py'),
-                               'nbdev.showdoc._show_param': ('api/showdoc.html#_show_param', 'nbdev/showdoc.py'),
-                               'nbdev.showdoc._wrap_sig': ('api/showdoc.html#_wrap_sig', 'nbdev/showdoc.py'),
                                'nbdev.showdoc.colab_link': ('api/showdoc.html#colab_link', 'nbdev/showdoc.py'),
                                'nbdev.showdoc.doc': ('api/showdoc.html#doc', 'nbdev/showdoc.py'),
                                'nbdev.showdoc.show_doc': ('api/showdoc.html#show_doc', 'nbdev/showdoc.py'),

{nbdev-2.4.6 → nbdev-2.4.8}/nbdev/cli.py

@@ -101,7 +101,8 @@ def nbdev_new(**kwargs):
     if tag is None:
         with warnings.catch_warnings():
             warnings.simplefilter('ignore', UserWarning)
-            tag = GhApi(gh_host='https://api.github.com', authenticate=False).repos.get_latest_release(org_or_usr, repo).tag_name
+            tag = GhApi(gh_host='https://api.github.com', authenticate=False
+                       ).repos.get_latest_release(org_or_usr, repo).tag_name
 
     url = f"https://github.com/{org_or_usr}/{repo}/archive/{tag}.tar.gz"
     extract_tgz(url)
@@ -184,10 +185,16 @@ def watch_export(nbs:str=None, # Nb directory to watch for changes
     lib = lib or (cfg.lib_path if cfg else '.')
     if cfg and (nbs != cfg.nbs_path or lib != cfg.lib_path) and not force:
         raise ValueError("In nbdev project. Use --force to override config.")
+    run(f'nbdev_export')
     def _export(e,lib=lib):
         p = e.src_path
-        if (not '.ipynb_checkpoints' in p and p.endswith('.ipynb') and not Path(p).name.startswith('.~')):
-            if e.event_type == 'modified': run(f'nb_export --lib_path {lib} "{p}"')
+        if (not '.ipynb_checkpoints' in p and p.endswith('.ipynb') and not Path(p).name.startswith(('tmp','.~'))):
+            if e.event_type == 'modified':
+                time.sleep(0.1)
+                try: run(f'nb_export --lib_path {lib} "{p}"')
+                except IOError:
+                    time.sleep(0.3)
+                    run(f'nb_export --lib_path {lib} "{p}"')
     with fs_watchdog(_export, nbs):
         while True: time.sleep(1)
 

nbdev-2.4.8/nbdev/diff.py

@@ -0,0 +1,92 @@
+"""Get ipynb diffs by cell"""
+
+# AUTOGENERATED! DO NOT EDIT! File to edit: ../nbs/api/19_diff.ipynb.
+
+# %% auto 0
+__all__ = ['read_nb_from_git', 'nbs_pair', 'changed_cells', 'source_diff', 'cell_diffs']
+
+# %% ../nbs/api/19_diff.ipynb
+import json
+from fastcore.utils import *
+from fastcore.meta import delegates
+from difflib import unified_diff
+from fastgit import Git
+from execnb.nbio import *
+
+# %% ../nbs/api/19_diff.ipynb
+def read_nb_from_git(
+    g:Git, # The git object
+    path, # The path to the notebook (absolute or relative to git root)
+    ref=None # The git ref to read from (e.g. HEAD); None for working dir
+)->AttrDict: # The notebook
+    "Read notebook from git ref (e.g. HEAD) at path, or working dir if ref is None"
+    path = Path(path)
+    if path.is_absolute(): path = path.relative_to(g.top())
+    if ref is None: return read_nb(g.top()/path)
+    raw = g.show(f'{ref}:{path}', split=False)
+    return dict2nb(json.loads(raw))
+
+# %% ../nbs/api/19_diff.ipynb
+def _nb_srcdict(g:Git, nb_path, ref=None, f=noop):
+    "Dict of id->source"
+    nb = read_nb_from_git(g, nb_path, ref)
+    return {c['id']: f(c) for c in nb.cells}
+
+# %% ../nbs/api/19_diff.ipynb
+def nbs_pair(
+    nb_path, # Path to the notebook
+    ref_a='HEAD', # First git ref (None for working dir)
+    ref_b=None, # Second git ref (None for working dir)
+    f=noop  # Function to call on contents
+): # Tuple of two notebooks
+    "NBs at two refs; None means working dir. By default provides HEAD and working dir"
+    nb_path = Path(nb_path).resolve()
+    g = Git(nb_path.parent)
+    return _nb_srcdict(g, nb_path, ref_a, f), _nb_srcdict(g, nb_path, ref_b, f)
+
+# %% ../nbs/api/19_diff.ipynb
+def _cell_changes(
+    nb_path, # Path to the notebook
+    fn, # function to call to get dict values
+    ref_a='HEAD', # First git ref (None for working dir)
+    ref_b=None, # Second git ref (None for working dir)
+    adds=True, # Include cells in b but not in a
+    changes=True, # Include cells with different content
+    dels=False, # Include cells in a but not in b
+    metadata=False, # Consider cell metadata when comparing
+    outputs=False # Consider cell outputs when comparing
+): # Dict of results
+    "Apply fn(cell_id, old_content, new_content) to changed cells between two refs"
+    def cell_content(c):
+        res = c.get('source', '')
+        if metadata: res += '\n# metadata: ' + json.dumps(c.get('metadata', {}), sort_keys=True)
+        if outputs: res += '\n# outputs: ' + json.dumps(c.get('outputs', []), sort_keys=True)
+        return res
+    old,new = nbs_pair(nb_path, ref_a, ref_b, f=cell_content)
+    res = {}
+    if adds: res |= {cid: fn(cid, '', new[cid]) for cid in new if cid not in old}
+    if changes: res |= {cid: fn(cid, old[cid], new[cid]) for cid in new if cid in old and new[cid] != old[cid]}
+    if dels: res |= {cid: fn(cid, old[cid], '') for cid in old if cid not in new}
+    return res
+
+# %% ../nbs/api/19_diff.ipynb
+@delegates(_cell_changes)
+def changed_cells(nb_path, **kwargs):
+    "Return set of cell IDs for changed/added/deleted cells between two refs"
+    def f(cid,o,n): return cid
+    return set(_cell_changes(nb_path, f, **kwargs).keys())
+
+# %% ../nbs/api/19_diff.ipynb
+def source_diff(
+    old_source, # Original source string
+    new_source # New source string
+): # Unified diff string
+    "Return unified diff string for source change"
+    return '\n'.join(unified_diff(old_source.splitlines(), new_source.splitlines(), lineterm=''))
+
+# %% ../nbs/api/19_diff.ipynb
+@delegates(_cell_changes)
+def cell_diffs(nb_path, **kwargs):
+    "{cell_id:diff} for changed/added/deleted cells between two refs"
+    def f(cid,o,n): return source_diff(o,n)
+    return _cell_changes(nb_path, f, **kwargs)

{nbdev-2.4.6 → nbdev-2.4.8}/nbdev/export.py

@@ -85,7 +85,7 @@ def nb_export(nbname:str,        # Filename of notebook
             all_cells = exp.in_all[mod]
             nm = ifnone(name, getattr(exp, 'default_exp', None) if mod=='#' else mod)
             if not nm:
-                warn(f"Notebook '{nbname}' uses `#|export` without `#|default_exp` cell.\n"
+                warn(f"Notebook '{nbname}' uses `#| export` without `#| default_exp` cell.\n"
                      "Note nbdev2 no longer supports nbdev1 syntax. Run `nbdev_migrate` to upgrade.\n"
                      "See https://nbdev.fast.ai/getting_started.html for more information.")
                 return

{nbdev-2.4.6 → nbdev-2.4.8}/nbdev/process.py

@@ -35,7 +35,7 @@ def _quarto_re(lang=None): return re.compile(_dir_pre(lang) + r'\s*[\w|-]+\s*:')
 # %% ../nbs/api/03_process.ipynb
 def _directive(s, lang='python'):
     s = re.sub('^'+_dir_pre(lang), f"{langs[lang]}|", s)
-    if s.strip().endswith(':'): s = s.replace(':', '') # You can append colon at the end to be Quarto compliant.  Ex: #|hide:
+    if s.strip().endswith(':'): s = s.replace(':', '') # You can append colon at the end to be Quarto compliant.  Ex: #| hide:
     if ':' in s: s = s.replace(':', ': ')
     s = (s.strip()[2:]).strip().split()
     if not s: return None

{nbdev-2.4.6 → nbdev-2.4.8}/nbdev/quarto.py

@@ -70,7 +70,7 @@ def _sort(a):
     x,y = a
     if y.startswith('index.'): return x,'00'
     return a
-#|export
+#| export
 _def_file_re = r'\.(?:ipynb|qmd|html)$'
 
 @delegates(nbglob_cli)

{nbdev-2.4.6 → nbdev-2.4.8}/nbdev/release.py

@@ -63,7 +63,7 @@ class Release:
 
     def _issues(self, label):
         return self.gh.issues.list_for_repo(state='closed', sort='created', filter='all', since=self.commit_date, labels=label)
-    def _issue_groups(self): return parallel(self._issues, self.groups.keys(), progress=False)
+    def _issue_groups(self): return parallel(self._issues, self.groups.keys(), progress=False, threadpool=True)
 
 # %% ../nbs/api/18_release.ipynb
 @patch

nbdev-2.4.8/nbdev/showdoc.py

@@ -0,0 +1,113 @@
+"""Display symbol documentation in notebook and website"""
+
+# AUTOGENERATED! DO NOT EDIT! File to edit: ../nbs/api/08_showdoc.ipynb.
+
+# %% ../nbs/api/08_showdoc.ipynb 2
+from __future__ import annotations
+from .doclinks import *
+from .config import get_config
+
+from fastcore.docments import *
+from fastcore.utils import *
+
+from importlib import import_module
+import inspect, sys
+from collections import OrderedDict
+from textwrap import fill
+from types import FunctionType
+
+# %% auto 0
+__all__ = ['BasicMarkdownRenderer', 'show_doc', 'BasicHtmlRenderer', 'doc', 'showdoc_nm', 'colab_link']
+
+# %% ../nbs/api/08_showdoc.ipynb
+def _ext_link(url, txt, xtra=""): return f'[{txt}]({url}){{target="_blank" {xtra}}}'
+
+class BasicMarkdownRenderer(MarkdownRenderer):
+    "Markdown renderer for `show_doc`"
+    def _repr_markdown_(self):
+        doc = '---\n\n'
+        src = NbdevLookup().code(self.fn)
+        if src: doc += _ext_link(src, 'source', 'style="float:right; font-size:smaller"') + '\n\n'
+        h = '#'*self.title_level
+        doc += f'{h} {self.nm}\n\n'
+        return doc+super()._repr_markdown_()
+
+# %% ../nbs/api/08_showdoc.ipynb
+def show_doc(sym,  # Symbol to document
+             renderer=None,  # Optional renderer (defaults to markdown)
+             name:str|None=None,  # Optionally override displayed name of `sym`
+             title_level:int=3):  # Heading level to use for symbol name
+    "Show signature and docstring for `sym`"
+    if renderer is None: renderer = get_config().get('renderer', None)
+    if renderer is None: renderer=BasicMarkdownRenderer
+    elif isinstance(renderer,str):
+        p,m = renderer.rsplit('.', 1)
+        renderer = getattr(import_module(p), m)
+    if isinstance_str(sym, "Function"): pass
+    elif isinstance_str(sym, "TypeDispatch"): pass  # use _str as TypeDispatch will be removed from fastcore
+    else:return renderer(sym or show_doc, name=name, title_level=title_level)
+
+# %% ../nbs/api/08_showdoc.ipynb
+def _create_html_table(table_str):
+    def split_row(row):
+        return re.findall(r'\|(?:(?:\\.|[^|\\])*)', row)
+    
+    def unescape_cell(cell): 
+        return cell.strip(' *|').replace(r'\|', '|')
+    
+    lines = table_str.strip().split('\n')
+    header = [f"<th>{unescape_cell(cell)}</th>" for cell in split_row(lines[0])]
+    rows = [[f"<td>{unescape_cell(cell)}</td>" for cell in split_row(line)] for line in lines[2:]]
+    
+    return f'''<table>
+    <thead><tr>{' '.join(header)}</tr></thead>
+    <tbody>{''.join(f'<tr>{" ".join(row)}</tr>' for row in rows)}</tbody>
+    </table>'''
+
+# %% ../nbs/api/08_showdoc.ipynb
+def _html_link(url, txt): return f'<a href="{url}" target="_blank" rel="noreferrer noopener">{txt}</a>'
+
+# %% ../nbs/api/08_showdoc.ipynb
+from fastcore.docments import _fmt_sig
+
+# %% ../nbs/api/08_showdoc.ipynb
+class BasicHtmlRenderer(ShowDocRenderer):
+    "HTML renderer for `show_doc`"
+    def _repr_html_(self):
+        doc = '<hr/>\n'
+        src = NbdevLookup().code(self.fn)
+        doc += f'<h{self.title_level}>{self.nm}</h{self.title_level}>\n'
+        sig = _fmt_sig(self.sig) if self.sig else ''
+        # Escape < and > characters in the signature
+        sig = sig.replace('<', '&lt;').replace('>', '&gt;')
+        doc += f'<blockquote><pre><code>{self.nm} {sig}</code></pre></blockquote>'
+        if self.docs:
+            doc += f"<p><i>{self.docs}</i></p>"
+        if src: doc += f"<br/>{_html_link(src, 'source')}"
+        if self.dm.has_docment: doc += _create_html_table(str(self.dm))
+        return doc
+
+    def doc(self):
+        "Show `show_doc` info along with link to docs"
+        from IPython.display import display,HTML
+        res = self._repr_html_()
+        display(HTML(res))
+
+# %% ../nbs/api/08_showdoc.ipynb
+def doc(elt):
+    "Show `show_doc` info along with link to docs"
+    BasicHtmlRenderer(elt).doc()
+
+# %% ../nbs/api/08_showdoc.ipynb
+def showdoc_nm(tree):
+    "Get the fully qualified name for showdoc."
+    return ifnone(patch_name(tree), tree.name)
+
+# %% ../nbs/api/08_showdoc.ipynb
+def colab_link(path):
+    "Get a link to the notebook at `path` on Colab"
+    from IPython.display import Markdown
+    cfg = get_config()
+    pre = 'https://colab.research.google.com/github/'
+    res = f'{pre}{cfg.user}/{cfg.repo}/blob/{cfg.branch}/{cfg.nbs_path.name}/{path}.ipynb'
+    display(Markdown(f'[Open `{path}` in Colab]({res})'))

{nbdev-2.4.6 → nbdev-2.4.8/nbdev.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nbdev
-Version: 2.4.6
+Version: 2.4.8
 Summary: Create delightful software with Jupyter Notebooks
 Home-page: https://github.com/AnswerDotAI/nbdev
 Author: Jeremy Howard and Hamel Husain
@@ -20,7 +20,7 @@ Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: packaging
-Requires-Dist: fastcore>=1.8.0
+Requires-Dist: fastcore>=1.11.0
 Requires-Dist: execnb>=0.1.12
 Requires-Dist: astunparse
 Requires-Dist: ghapi>=1.0.3

{nbdev-2.4.6 → nbdev-2.4.8}/nbdev.egg-info/SOURCES.txt

@@ -10,6 +10,7 @@ nbdev/_modidx.py
 nbdev/clean.py
 nbdev/cli.py
 nbdev/config.py
+nbdev/diff.py
 nbdev/doclinks.py
 nbdev/export.py
 nbdev/extract_attachments.py

{nbdev-2.4.6 → nbdev-2.4.8}/nbdev.egg-info/requires.txt

@@ -1,5 +1,5 @@
 packaging
-fastcore>=1.8.0
+fastcore>=1.11.0
 execnb>=0.1.12
 astunparse
 ghapi>=1.0.3

{nbdev-2.4.6 → nbdev-2.4.8}/settings.ini

@@ -9,13 +9,13 @@ author = Jeremy Howard and Hamel Husain
 author_email = j@fast.ai
 branch = main
 min_python = 3.9
-version = 2.4.6
+version = 2.4.8
 audience = Developers
 language = English
 custom_sidebar = True
 license = apache2
 status = 5
-requirements = fastcore>=1.8.0 execnb>=0.1.12 astunparse ghapi>=1.0.3 watchdog asttokens setuptools build
+requirements = fastcore>=1.11.0 execnb>=0.1.12 astunparse ghapi>=1.0.3 watchdog asttokens setuptools build
 pip_requirements = PyYAML
 conda_requirements = pyyaml
 conda_user = fastai

nbdev-2.4.6/nbdev/showdoc.py

@@ -1,255 +0,0 @@
-"""Display symbol documentation in notebook and website"""
-
-# AUTOGENERATED! DO NOT EDIT! File to edit: ../nbs/api/08_showdoc.ipynb.
-
-# %% ../nbs/api/08_showdoc.ipynb 2
-from __future__ import annotations
-from .doclinks import *
-from .config import get_config
-
-from fastcore.docments import *
-from fastcore.utils import *
-
-from importlib import import_module
-import inspect, sys
-from collections import OrderedDict
-from textwrap import fill
-from types import FunctionType
-
-# %% auto 0
-__all__ = ['DocmentTbl', 'ShowDocRenderer', 'BasicMarkdownRenderer', 'show_doc', 'BasicHtmlRenderer', 'doc', 'showdoc_nm',
-           'colab_link']
-
-# %% ../nbs/api/08_showdoc.ipynb
-def _non_empty_keys(d:dict): return L([k for k,v in d.items() if v != inspect._empty])
-def _bold(s): return f'**{s}**' if s.strip() else s
-
-# %% ../nbs/api/08_showdoc.ipynb
-def _escape_markdown(s):
-    for c in '|^': s = re.sub(rf'\\?\{c}', rf'\{c}', s)
-    return s.replace('\n', '<br>')
-
-# %% ../nbs/api/08_showdoc.ipynb
-def _maybe_nm(o):
-    if (o == inspect._empty): return ''
-    else: return o.__name__ if hasattr(o, '__name__') else _escape_markdown(str(o))
-
-# %% ../nbs/api/08_showdoc.ipynb
-def _list2row(l:list): return '| '+' | '.join([_maybe_nm(o) for o in l]) + ' |'
-
-# %% ../nbs/api/08_showdoc.ipynb
-class DocmentTbl:
-    # this is the column order we want these items to appear
-    _map = OrderedDict({'anno':'Type', 'default':'Default', 'docment':'Details'})
-
-    def __init__(self, obj, verbose=True, returns=True):
-        "Compute the docment table string"
-        self.verbose = verbose
-        self.returns = False if isdataclass(obj) else returns
-        try: self.params = L(signature_ex(obj, eval_str=True).parameters.keys())
-        except (ValueError,TypeError): self.params=[]
-        try: _dm = docments(obj, full=True, returns=returns)
-        except: _dm = {}
-        if 'self' in _dm: del _dm['self']
-        for d in _dm.values(): d['docment'] = ifnone(d['docment'], inspect._empty)
-        self.dm = _dm
-
-    @property
-    def _columns(self):
-        "Compute the set of fields that have at least one non-empty value so we don't show tables empty columns"
-        cols = set(flatten(L(self.dm.values()).filter().map(_non_empty_keys)))
-        candidates = self._map if self.verbose else {'docment': 'Details'}
-        return OrderedDict({k:v for k,v in candidates.items() if k in cols})
-
-    @property
-    def has_docment(self): return 'docment' in self._columns and self._row_list
-
-    @property
-    def has_return(self): return self.returns and bool(_non_empty_keys(self.dm.get('return', {})))
-
-    def _row(self, nm, props):
-        "unpack data for single row to correspond with column names."
-        return [nm] + [props[c] for c in self._columns]
-
-    @property
-    def _row_list(self):
-        "unpack data for all rows."
-        ordered_params = [(p, self.dm[p]) for p in self.params if p != 'self' and p in self.dm]
-        return L([self._row(nm, props) for nm,props in ordered_params])
-
-    @property
-    def _hdr_list(self): return ['  '] + [_bold(l) for l in L(self._columns.values())]
-
-    @property
-    def hdr_str(self):
-        "The markdown string for the header portion of the table"
-        md = _list2row(self._hdr_list)
-        return md + '\n' + _list2row(['-' * len(l) for l in self._hdr_list])
-
-    @property
-    def params_str(self):
-        "The markdown string for the parameters portion of the table."
-        return '\n'.join(self._row_list.map(_list2row))
-
-    @property
-    def return_str(self):
-        "The markdown string for the returns portion of the table."
-        return _list2row(['**Returns**']+[_bold(_maybe_nm(self.dm['return'][c])) for c in self._columns])
-
-    def _repr_markdown_(self):
-        if not self.has_docment: return ''
-        _tbl = [self.hdr_str, self.params_str]
-        if self.has_return: _tbl.append(self.return_str)
-        return '\n'.join(_tbl)
-
-    def __eq__(self,other): return self.__str__() == str(other).strip()
-
-    __str__ = _repr_markdown_
-    __repr__ = basic_repr()
-
-# %% ../nbs/api/08_showdoc.ipynb
-def _docstring(sym):
-    npdoc = parse_docstring(sym)
-    return '\n\n'.join([npdoc['Summary'], npdoc['Extended']]).strip()
-
-# %% ../nbs/api/08_showdoc.ipynb
-def _fullname(o):
-    module,name = getattr(o, "__module__", None),qual_name(o)
-    return name if module is None or module in ('__main__','builtins') else module + '.' + name
-
-class ShowDocRenderer:
-    def __init__(self, sym, name:str|None=None, title_level:int=3):
-        "Show documentation for `sym`"
-        sym = getattr(sym, '__wrapped__', sym)
-        sym = getattr(sym, 'fget', None) or getattr(sym, 'fset', None) or sym
-        store_attr()
-        self.nm = name or qual_name(sym)
-        self.isfunc = inspect.isfunction(sym)
-        try: self.sig = signature_ex(sym, eval_str=True)
-        except (ValueError,TypeError): self.sig = None
-        self.docs = _docstring(sym)
-        self.dm = DocmentTbl(sym)
-        self.fn = _fullname(sym)
-
-    __repr__ = basic_repr()
-
-# %% ../nbs/api/08_showdoc.ipynb
-def _f_name(o): return f'<function {o.__name__}>' if isinstance(o, FunctionType) else None
-def _fmt_anno(o): return inspect.formatannotation(o).strip("'").replace(' ','')
-
-def _show_param(param):
-    "Like `Parameter.__str__` except removes: quotes in annos, spaces, ids in reprs"
-    kind,res,anno,default = param.kind,param._name,param._annotation,param._default
-    kind = '*' if kind==inspect._VAR_POSITIONAL else '**' if kind==inspect._VAR_KEYWORD else ''
-    res = kind+res
-    if anno is not inspect._empty: res += f':{_f_name(anno) or _fmt_anno(anno)}'
-    if default is not inspect._empty: res += f'={_f_name(default) or repr(default)}'
-    return res
-
-# %% ../nbs/api/08_showdoc.ipynb
-def _fmt_sig(sig):
-    if sig is None: return ''
-    p = {k:v for k,v in sig.parameters.items()}
-    _params = [_show_param(p[k]) for k in p.keys() if k != 'self']
-    return "(" + ', '.join(_params)  + ")"
-
-def _wrap_sig(s):
-    "wrap a signature to appear on multiple lines if necessary."
-    pad = '> ' + ' ' * 5
-    indent = pad + ' ' * (s.find('(') + 1)
-    return fill(s, width=80, initial_indent=pad, subsequent_indent=indent)
-
-# %% ../nbs/api/08_showdoc.ipynb
-def _ext_link(url, txt, xtra=""): return f'[{txt}]({url}){{target="_blank" {xtra}}}'
-
-class BasicMarkdownRenderer(ShowDocRenderer):
-    "Markdown renderer for `show_doc`"
-    def _repr_markdown_(self):
-        doc = '---\n\n'
-        src = NbdevLookup().code(self.fn)
-        if src: doc += _ext_link(src, 'source', 'style="float:right; font-size:smaller"') + '\n\n'
-        h = '#'*self.title_level
-        doc += f'{h} {self.nm}\n\n'
-        sig = _wrap_sig(f"{self.nm} {_fmt_sig(self.sig)}") if self.sig else ''
-        doc += f'{sig}'
-        if self.docs: doc += f"\n\n*{self.docs}*"
-        if self.dm.has_docment: doc += f"\n\n{self.dm}"
-        return doc
-    __repr__=__str__=_repr_markdown_
-
-# %% ../nbs/api/08_showdoc.ipynb
-def show_doc(sym,  # Symbol to document
-             renderer=None,  # Optional renderer (defaults to markdown)
-             name:str|None=None,  # Optionally override displayed name of `sym`
-             title_level:int=3):  # Heading level to use for symbol name
-    "Show signature and docstring for `sym`"
-    if renderer is None: renderer = get_config().get('renderer', None)
-    if renderer is None: renderer=BasicMarkdownRenderer
-    elif isinstance(renderer,str):
-        p,m = renderer.rsplit('.', 1)
-        renderer = getattr(import_module(p), m)
-    if isinstance_str(sym, "Function"): pass
-    elif isinstance_str(sym, "TypeDispatch"): pass  # use _str as TypeDispatch will be removed from fastcore
-    else:return renderer(sym or show_doc, name=name, title_level=title_level)
-
-# %% ../nbs/api/08_showdoc.ipynb
-def _create_html_table(table_str):
-    def split_row(row):
-        return re.findall(r'\|(?:(?:\\.|[^|\\])*)', row)
-    
-    def unescape_cell(cell): 
-        return cell.strip(' *|').replace(r'\|', '|')
-    
-    lines = table_str.strip().split('\n')
-    header = [f"<th>{unescape_cell(cell)}</th>" for cell in split_row(lines[0])]
-    rows = [[f"<td>{unescape_cell(cell)}</td>" for cell in split_row(line)] for line in lines[2:]]
-    
-    return f'''<table>
-    <thead><tr>{' '.join(header)}</tr></thead>
-    <tbody>{''.join(f'<tr>{" ".join(row)}</tr>' for row in rows)}</tbody>
-    </table>'''
-
-# %% ../nbs/api/08_showdoc.ipynb
-def _html_link(url, txt): return f'<a href="{url}" target="_blank" rel="noreferrer noopener">{txt}</a>'
-
-# %% ../nbs/api/08_showdoc.ipynb
-class BasicHtmlRenderer(ShowDocRenderer):
-    "HTML renderer for `show_doc`"
-    def _repr_html_(self):
-        doc = '<hr/>\n'
-        src = NbdevLookup().code(self.fn)
-        doc += f'<h{self.title_level}>{self.nm}</h{self.title_level}>\n'
-        sig = _fmt_sig(self.sig) if self.sig else ''
-        # Escape < and > characters in the signature
-        sig = sig.replace('<', '&lt;').replace('>', '&gt;')
-        doc += f'<blockquote><pre><code>{self.nm} {sig}</code></pre></blockquote>'
-        if self.docs:
-            doc += f"<p><i>{self.docs}</i></p>"
-        if src: doc += f"<br/>{_html_link(src, 'source')}"
-        if self.dm.has_docment: doc += _create_html_table(str(self.dm))
-        return doc
-
-    def doc(self):
-        "Show `show_doc` info along with link to docs"
-        from IPython.display import display,HTML
-        res = self._repr_html_()
-        display(HTML(res))
-
-# %% ../nbs/api/08_showdoc.ipynb
-def doc(elt):
-    "Show `show_doc` info along with link to docs"
-    BasicHtmlRenderer(elt).doc()
-
-# %% ../nbs/api/08_showdoc.ipynb
-def showdoc_nm(tree):
-    "Get the fully qualified name for showdoc."
-    return ifnone(patch_name(tree), tree.name)
-
-# %% ../nbs/api/08_showdoc.ipynb
-def colab_link(path):
-    "Get a link to the notebook at `path` on Colab"
-    from IPython.display import Markdown
-    cfg = get_config()
-    pre = 'https://colab.research.google.com/github/'
-    res = f'{pre}{cfg.user}/{cfg.repo}/blob/{cfg.branch}/{cfg.nbs_path.name}/{path}.ipynb'
-    display(Markdown(f'[Open `{path}` in Colab]({res})'))