nbdev 2.4.5__tar.gz → 2.4.7__tar.gz

{nbdev-2.4.5/nbdev.egg-info → nbdev-2.4.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nbdev
-Version: 2.4.5
+Version: 2.4.7
 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.8.14
 Requires-Dist: execnb>=0.1.12
 Requires-Dist: astunparse
 Requires-Dist: ghapi>=1.0.3

{nbdev-2.4.5 → nbdev-2.4.7}/nbdev/__init__.py

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

{nbdev-2.4.5 → nbdev-2.4.7}/nbdev/_modidx.py

@@ -322,37 +322,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.5 → nbdev-2.4.7}/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 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.5 → nbdev-2.4.7}/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.5 → nbdev-2.4.7}/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.5 → nbdev-2.4.7}/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.5 → nbdev-2.4.7}/nbdev/release.py

@@ -12,6 +12,7 @@ from fastcore.all import *
 from ghapi.core import *
 
 from datetime import datetime
+from packaging.version import Version
 import shutil,subprocess
 
 from .doclinks import *
@@ -71,8 +72,11 @@ def changelog(self:Release,
     "Create the CHANGELOG.md file, or return the proposed text if `debug` is `True`"
     if not self.changefile.exists(): self.changefile.write_text("# Release notes\n\n<!-- do not remove -->\n")
     marker = '<!-- do not remove -->\n'
-    try: self.commit_date = self.gh.repos.get_latest_release().published_at
-    except HTTP404NotFoundError: self.commit_date = '2000-01-01T00:00:004Z'
+    try: self.commit_date = (lr:=self.gh.repos.get_latest_release()).published_at
+    except HTTP404NotFoundError: lr,self.commit_date = None,'2000-01-01T00:00:004Z'
+    if lr and (Version(self.cfg.version) <= Version(lr.tag_name)): 
+        print(f'Error: Version bump required: expected: >{lr.tag_name}, got: {self.cfg.version}.')
+        raise SystemExit(1)
     res = f"\n## {self.cfg.version}\n"
     issues = self._issue_groups()
     res += '\n'.join(_issues_txt(*o) for o in zip(issues, self.groups.values()))

nbdev-2.4.7/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.5 → nbdev-2.4.7/nbdev.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nbdev
-Version: 2.4.5
+Version: 2.4.7
 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.8.14
 Requires-Dist: execnb>=0.1.12
 Requires-Dist: astunparse
 Requires-Dist: ghapi>=1.0.3

{nbdev-2.4.5 → nbdev-2.4.7}/nbdev.egg-info/requires.txt

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

{nbdev-2.4.5 → nbdev-2.4.7}/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.5
+version = 2.4.7
 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.8.14 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.5/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})'))