nbdev 2.4.3__py3-none-any.whl → 2.4.11__py3-none-any.whl

nbdev/release.py

@@ -2,30 +2,31 @@
 
 # AUTOGENERATED! DO NOT EDIT! File to edit: ../nbs/api/18_release.ipynb.
 
-# %% auto 0
+# %% auto #0
 __all__ = ['GH_HOST', 'CONDA_WARNING', 'Release', 'changelog', 'release_git', 'release_gh', 'pypi_json', 'latest_pypi',
            'pypi_details', 'conda_output_path', 'write_conda_meta', 'write_requirements', 'anaconda_upload',
            'release_conda', 'chk_conda_rel', 'release_pypi', 'release_both', 'bump_version', 'nbdev_bump_version']
 
-# %% ../nbs/api/18_release.ipynb
+# %% ../nbs/api/18_release.ipynb #c35cc2b8
 from fastcore.all import *
 from ghapi.core import *
 
 from datetime import datetime
+from packaging.version import Version
 import shutil,subprocess
 
 from .doclinks import *
 
-# %% ../nbs/api/18_release.ipynb
+# %% ../nbs/api/18_release.ipynb #7e554523
 GH_HOST = "https://api.github.com"
 
-# %% ../nbs/api/18_release.ipynb
+# %% ../nbs/api/18_release.ipynb #e220cefa
 def _find_config(cfg_name="settings.ini"):
     cfg_path = Path().absolute()
     while cfg_path != cfg_path.parent and not (cfg_path/cfg_name).exists(): cfg_path = cfg_path.parent
     return Config(cfg_path, cfg_name)
 
-# %% ../nbs/api/18_release.ipynb
+# %% ../nbs/api/18_release.ipynb #1972609a
 def _issue_txt(issue):
     res = '- {} ([#{}]({}))'.format(issue.title.strip(), issue.number, issue.html_url)
     if hasattr(issue, 'pull_request'): res += ', thanks to [@{}]({})'.format(issue.user.login, issue.user.html_url)
@@ -42,7 +43,7 @@ def _load_json(cfg, k):
     try: return json.loads(cfg[k])
     except json.JSONDecodeError as e: raise Exception(f"Key: `{k}` in .ini file is not a valid JSON string: {e}")
 
-# %% ../nbs/api/18_release.ipynb
+# %% ../nbs/api/18_release.ipynb #0b36471a
 class Release:
     def __init__(self, owner=None, repo=None, token=None, **groups):
         "Create CHANGELOG.md from GitHub issues"
@@ -62,17 +63,20 @@ 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
+# %% ../nbs/api/18_release.ipynb #aa22dfe3
 @patch
 def changelog(self:Release,
               debug=False): # Just print the latest changes, instead of updating file
     "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()))
@@ -82,7 +86,7 @@ def changelog(self:Release,
     self.changefile.write_text(res)
     run(f'git add {self.changefile}')
 
-# %% ../nbs/api/18_release.ipynb
+# %% ../nbs/api/18_release.ipynb #068421c6
 @patch
 def release(self:Release):
     "Tag and create a release in GitHub for the current version"
@@ -91,7 +95,7 @@ def release(self:Release):
     self.gh.create_release(ver, branch=self.cfg.branch, body=notes)
     return ver
 
-# %% ../nbs/api/18_release.ipynb
+# %% ../nbs/api/18_release.ipynb #22101171
 @patch
 def latest_notes(self:Release):
     "Latest CHANGELOG entry"
@@ -100,7 +104,7 @@ def latest_notes(self:Release):
     if not len(its)>0: return ''
     return '\n'.join(its[1].splitlines()[1:]).strip()
 
-# %% ../nbs/api/18_release.ipynb
+# %% ../nbs/api/18_release.ipynb #01cb1ca4
 @call_parse
 def changelog(
     debug:store_true=False,  # Print info to be added to CHANGELOG, instead of updating file
@@ -110,7 +114,7 @@ def changelog(
     res = Release(repo=repo).changelog(debug=debug)
     if debug: print(res)
 
-# %% ../nbs/api/18_release.ipynb
+# %% ../nbs/api/18_release.ipynb #6d3c5cd8
 @call_parse
 def release_git(
     token:str=None  # Optional GitHub token (otherwise `token` file is used)
@@ -119,7 +123,7 @@ def release_git(
     ver = Release(token=token).release()
     print(f"Released {ver}")
 
-# %% ../nbs/api/18_release.ipynb
+# %% ../nbs/api/18_release.ipynb #ad73518a
 @call_parse
 def release_gh(
     token:str=None  # Optional GitHub token (otherwise `token` file is used)
@@ -134,7 +138,7 @@ def release_gh(
     ver = Release(token=token).release()
     print(f"Released {ver}")
 
-# %% ../nbs/api/18_release.ipynb
+# %% ../nbs/api/18_release.ipynb #5b4d4aa2
 from fastcore.all import *
 from .config import *
 from .cli import *
@@ -146,18 +150,18 @@ except ImportError: from pip._vendor.packaging.version import parse
 
 _PYPI_URL = 'https://pypi.org/pypi/'
 
-# %% ../nbs/api/18_release.ipynb
+# %% ../nbs/api/18_release.ipynb #4070bbef
 def pypi_json(s):
     "Dictionary decoded JSON for PYPI path `s`"
     return urljson(f'{_PYPI_URL}{s}/json')
 
-# %% ../nbs/api/18_release.ipynb
+# %% ../nbs/api/18_release.ipynb #1985c8b1
 def latest_pypi(name):
     "Latest version of `name` on pypi"
     return max(parse(r) for r,o in pypi_json(name)['releases'].items()
                if not parse(r).is_prerelease and not nested_idx(o, 0, 'yanked'))
 
-# %% ../nbs/api/18_release.ipynb
+# %% ../nbs/api/18_release.ipynb #ab0bfd9a
 def pypi_details(name):
     "Version, URL, and SHA256 for `name` from pypi"
     ver = str(latest_pypi(name))
@@ -165,7 +169,7 @@ def pypi_details(name):
     rel = [o for o in pypi['urls'] if o['packagetype']=='sdist'][0]
     return ver,rel['url'],rel['digests']['sha256']
 
-# %% ../nbs/api/18_release.ipynb
+# %% ../nbs/api/18_release.ipynb #431f625b
 import shlex
 from subprocess import Popen, PIPE, CalledProcessError
 
@@ -179,12 +183,12 @@ def _run(cmd):
     if p.returncode != 0: raise CalledProcessError(p.returncode, p.args)
     return res
 
-# %% ../nbs/api/18_release.ipynb
+# %% ../nbs/api/18_release.ipynb #6a9d34ab
 def conda_output_path(name, build='build'):
     "Output path for conda build"
     return run(f'conda {build} --output {name}').strip().replace('\\', '/')
 
-# %% ../nbs/api/18_release.ipynb
+# %% ../nbs/api/18_release.ipynb #99fb71c2
 def _write_yaml(path, name, d1, d2):
     path = Path(path)
     p = path/name
@@ -194,7 +198,7 @@ def _write_yaml(path, name, d1, d2):
         yaml.safe_dump(d1, f)
         yaml.safe_dump(d2, f)
 
-# %% ../nbs/api/18_release.ipynb
+# %% ../nbs/api/18_release.ipynb #5c78f115
 def _get_conda_meta():
     cfg = get_config()
     name,ver = cfg.lib_name,cfg.version
@@ -236,12 +240,12 @@ def _get_conda_meta():
     }
     return name,d1,d2
 
-# %% ../nbs/api/18_release.ipynb
+# %% ../nbs/api/18_release.ipynb #b911bd4d
 def write_conda_meta(path='conda'):
     "Writes a `meta.yaml` file to the `conda` directory of the current directory"
     _write_yaml(path, *_get_conda_meta())
 
-# %% ../nbs/api/18_release.ipynb
+# %% ../nbs/api/18_release.ipynb #7550557f
 @call_parse
 def write_requirements(path:str=''):
     "Writes a `requirements.txt` file to `directory` based on settings.ini."
@@ -250,7 +254,7 @@ def write_requirements(path:str=''):
     req = '\n'.join([cfg.get(k, '').replace(' ', '\n') for k in ['requirements', 'pip_requirements']])
     (d/'requirements.txt').mk_write(req)
 
-# %% ../nbs/api/18_release.ipynb
+# %% ../nbs/api/18_release.ipynb #715ae3ac
 CONDA_WARNING='Conda support for nbdev is deprecated and scheduled for removal in a future version.'
 
 def anaconda_upload(name, loc=None, user=None, token=None, env_token=None):
@@ -263,7 +267,7 @@ def anaconda_upload(name, loc=None, user=None, token=None, env_token=None):
     if not loc: raise Exception("Failed to find output")
     return _run(f'anaconda {token} upload {user} {loc} --skip-existing')
 
-# %% ../nbs/api/18_release.ipynb
+# %% ../nbs/api/18_release.ipynb #952bc33d
 @call_parse
 def release_conda(
     path:str='conda', # Path where package will be created
@@ -295,7 +299,7 @@ def release_conda(
     if 'anaconda upload' not in res: return print(f"{res}\n\nFailed. Check auto-upload not set in .condarc. Try `--do_build False`.")
     return anaconda_upload(name, loc)
 
-# %% ../nbs/api/18_release.ipynb
+# %% ../nbs/api/18_release.ipynb #0500d972
 def chk_conda_rel(
     nm:str,  # Package name on pypi
     apkg:str=None,  # Anaconda Package (defaults to {nm})
@@ -309,7 +313,7 @@ def chk_conda_rel(
     pypitag = latest_pypi(nm)
     if force or not condatag or pypitag > max(condatag): return f'{pypitag}'
 
-# %% ../nbs/api/18_release.ipynb
+# %% ../nbs/api/18_release.ipynb #bf55df9b
 @call_parse
 def release_pypi(
     repository:str="pypi" # Respository to upload to (defined in ~/.pypirc)
@@ -319,7 +323,7 @@ def release_pypi(
     system(f'cd {_dir}  && rm -rf dist build && python -m build')
     system(f'twine upload --repository {repository} {_dir}/dist/*')
 
-# %% ../nbs/api/18_release.ipynb
+# %% ../nbs/api/18_release.ipynb #06edfcb0
 @call_parse
 def release_both(
     path:str='conda', # Path where package will be created
@@ -335,7 +339,7 @@ def release_both(
     release_conda.__wrapped__(path, do_build=do_build, build_args=build_args, skip_upload=skip_upload, mambabuild=mambabuild, upload_user=upload_user)
     nbdev_bump_version.__wrapped__()
 
-# %% ../nbs/api/18_release.ipynb
+# %% ../nbs/api/18_release.ipynb #6380dd5a
 def bump_version(version, part=2, unbump=False):
     version = version.split('.')
     incr = -1 if unbump else 1
@@ -343,7 +347,7 @@ def bump_version(version, part=2, unbump=False):
     for i in range(part+1, 3): version[i] = '0'
     return '.'.join(version)
 
-# %% ../nbs/api/18_release.ipynb
+# %% ../nbs/api/18_release.ipynb #c0f64b2c
 @call_parse
 def nbdev_bump_version(
     part:int=2,  # Part of version to bump

nbdev/serve.py

@@ -2,10 +2,10 @@
 
 # AUTOGENERATED! DO NOT EDIT! File to edit: ../nbs/api/17_serve.ipynb.
 
-# %% auto 0
+# %% auto #0
 __all__ = ['proc_nbs']
 
-# %% ../nbs/api/17_serve.ipynb
+# %% ../nbs/api/17_serve.ipynb #6899a335
 import ast,subprocess,threading,sys
 from shutil import rmtree,copy2
 
@@ -19,7 +19,7 @@ from .doclinks import nbglob_cli,nbglob
 from .processors import FilterDefaults
 import nbdev.serve_drv
 
-# %% ../nbs/api/17_serve.ipynb
+# %% ../nbs/api/17_serve.ipynb #65766a33
 def _is_qpy(path:Path):
     "Is `path` a py script starting with frontmatter?"
     path = Path(path)
@@ -34,7 +34,7 @@ def _is_qpy(path:Path):
         vl = v.splitlines()
         if vl[0]=='---' and vl[-1]=='---': return '\n'.join(vl[1:-1])
 
-# %% ../nbs/api/17_serve.ipynb
+# %% ../nbs/api/17_serve.ipynb #abc3835a
 def _proc_file(s, cache, path, mtime=None):
     skips = ('_proc', '_docs', '_site', 'settings.ini')
     if not s.is_file() or any(o[0]=='.' or o in skips for o in s.parts): return
@@ -51,7 +51,7 @@ def _proc_file(s, cache, path, mtime=None):
     if md is not None: return s,d,md.strip()
     else: copy2(s,d)
 
-# %% ../nbs/api/17_serve.ipynb
+# %% ../nbs/api/17_serve.ipynb #14463227
 @delegates(nbglob_cli)
 def proc_nbs(
     path:str='', # Path to notebooks

nbdev/showdoc.py

@@ -2,7 +2,7 @@
 
 # AUTOGENERATED! DO NOT EDIT! File to edit: ../nbs/api/08_showdoc.ipynb.
 
-# %% ../nbs/api/08_showdoc.ipynb 2
+# %% ../nbs/api/08_showdoc.ipynb #7f371f15
 from __future__ import annotations
 from .doclinks import *
 from .config import get_config
@@ -16,153 +16,13 @@ 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']
+# %% auto #0
+__all__ = ['BasicMarkdownRenderer', 'show_doc', '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
+# %% ../nbs/api/08_showdoc.ipynb #abe98f5c
 def _ext_link(url, txt, xtra=""): return f'[{txt}]({url}){{target="_blank" {xtra}}}'
 
-class BasicMarkdownRenderer(ShowDocRenderer):
+class BasicMarkdownRenderer(MarkdownRenderer):
     "Markdown renderer for `show_doc`"
     def _repr_markdown_(self):
         doc = '---\n\n'
@@ -170,14 +30,9 @@ class BasicMarkdownRenderer(ShowDocRenderer):
         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_
+        return doc+super()._repr_markdown_()
 
-# %% ../nbs/api/08_showdoc.ipynb
+# %% ../nbs/api/08_showdoc.ipynb #1256ef79
 def show_doc(sym,  # Symbol to document
              renderer=None,  # Optional renderer (defaults to markdown)
              name:str|None=None,  # Optionally override displayed name of `sym`
@@ -192,60 +47,17 @@ def show_doc(sym,  # Symbol to document
     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
+# %% ../nbs/api/08_showdoc.ipynb #eb1f0530
 def doc(elt):
     "Show `show_doc` info along with link to docs"
-    BasicHtmlRenderer(elt).doc()
+    return BasicMarkdownRenderer(elt)
 
-# %% ../nbs/api/08_showdoc.ipynb
+# %% ../nbs/api/08_showdoc.ipynb #35043aa7-6b60-4ddf-8949-39a78577f23d
 def showdoc_nm(tree):
     "Get the fully qualified name for showdoc."
     return ifnone(patch_name(tree), tree.name)
 
-# %% ../nbs/api/08_showdoc.ipynb
+# %% ../nbs/api/08_showdoc.ipynb #e947414d
 def colab_link(path):
     "Get a link to the notebook at `path` on Colab"
     from IPython.display import Markdown

nbdev/sync.py

@@ -2,10 +2,10 @@
 
 # AUTOGENERATED! DO NOT EDIT! File to edit: ../nbs/api/06_sync.ipynb.
 
-# %% auto 0
+# %% auto #0
 __all__ = ['absolute_import', 'nbdev_update']
 
-# %% ../nbs/api/06_sync.ipynb
+# %% ../nbs/api/06_sync.ipynb #ea6a935c
 from .imports import *
 from .config import *
 from .maker import *
@@ -21,7 +21,7 @@ from fastcore.xtras import *
 import ast
 import importlib
 
-# %% ../nbs/api/06_sync.ipynb
+# %% ../nbs/api/06_sync.ipynb #fde5667d
 def absolute_import(name, fname, level):
     "Unwarps a relative import in `name` according to `fname`"
     if not level: return name
@@ -29,7 +29,7 @@ def absolute_import(name, fname, level):
     if not name: return '.'.join(mods)
     return '.'.join(mods[:len(mods)-level+1]) + f".{name}"
 
-# %% ../nbs/api/06_sync.ipynb
+# %% ../nbs/api/06_sync.ipynb #54ab1e17
 @functools.lru_cache(maxsize=None)
 def _mod_files():
     midx_spec = importlib.util.spec_from_file_location("_modidx", get_config().lib_path / "_modidx.py")
@@ -38,41 +38,44 @@ def _mod_files():
 
     return L(files for mod in midx.d['syms'].values() for _,files in mod.values()).unique()
 
-# %% ../nbs/api/06_sync.ipynb
+# %% ../nbs/api/06_sync.ipynb #64d51ab6
 _re_import = re.compile(r"from\s+\S+\s+import\s+\S")
 
-# %% ../nbs/api/06_sync.ipynb
+# %% ../nbs/api/06_sync.ipynb #9075f993
 def _to_absolute(code, py_path, lib_dir):
     if not _re_import.search(code): return code
     res = update_import(code, ast.parse(code).body, str(py_path.relative_to(lib_dir).parent), absolute_import)
     return ''.join(res) if res else code
 
-# %% ../nbs/api/06_sync.ipynb
+# %% ../nbs/api/06_sync.ipynb #27ae8834
 def _update_nb(nb_path, cells, lib_dir):
     "Update notebook `nb_path` with contents from `cells`"
     nbp = NBProcessor(nb_path, ExportModuleProc(), rm_directives=False)
     nbp.process()
+    # Build a dict of cell_id -> cell for fast lookup
+    nb_cells_by_id = {c['id']: c for c in nbp.nb.cells if c.get('id')}
     for cell in cells:
         assert cell.nb_path == nb_path
-        nbcell = nbp.nb.cells[cell.idx]
+        nbcell = nb_cells_by_id.get(cell.cell_id)
+        if nbcell is None:
+            raise ValueError(f"Cell ID '{cell.cell_id}' not found in notebook '{nb_path}'")
         dirs,_ = _partition_cell(nbcell, 'python')
         nbcell.source = ''.join(dirs) + _to_absolute(cell.code, cell.py_path, lib_dir)
     write_nb(nbp.nb, nb_path)
 
-# %% ../nbs/api/06_sync.ipynb
+# %% ../nbs/api/06_sync.ipynb #46c9e605
 def _update_mod(py_path, lib_dir):
     "Propagate changes from cells in module `py_path` to corresponding notebooks"
     py_cells = L(_iter_py_cells(py_path)).filter(lambda o: o.nb != 'auto')
     for nb_path,cells in groupby(py_cells, 'nb_path').items(): _update_nb(nb_path, cells, lib_dir)
 
-# %% ../nbs/api/06_sync.ipynb
+# %% ../nbs/api/06_sync.ipynb #60b5b528
 @call_parse
 def nbdev_update(fname:str=None): # A Python file name to update
     "Propagate change in modules matching `fname` to notebooks that created them"
     if fname and fname.endswith('.ipynb'): raise ValueError("`nbdev_update` operates on .py files.  If you wish to convert notebooks instead, see `nbdev_export`.")
     if os.environ.get('IN_TEST',0): return
     cfg = get_config()
-    if not cfg.cell_number: raise ValueError("`nbdev_update` does not support without cell_number in .py files. Please check your settings.ini")
     fname = Path(fname or cfg.lib_path)
     lib_dir = cfg.lib_path.parent
     files = globtastic(fname, file_glob='*.py', skip_folder_re='^[_.]').filter(lambda x: str(Path(x).absolute().relative_to(lib_dir) in _mod_files()))

nbdev/test.py

@@ -2,10 +2,10 @@
 
 # AUTOGENERATED! DO NOT EDIT! File to edit: ../nbs/api/12_test.ipynb.
 
-# %% auto 0
+# %% auto #0
 __all__ = ['test_nb', 'nbdev_test']
 
-# %% ../nbs/api/12_test.ipynb
+# %% ../nbs/api/12_test.ipynb #45e10c3f
 import time,os,sys,traceback,contextlib, inspect
 from fastcore.basics import *
 from fastcore.imports import *
@@ -22,7 +22,7 @@ from .frontmatter import FrontmatterProc
 from execnb.nbio import *
 from execnb.shell import *
 
-# %% ../nbs/api/12_test.ipynb
+# %% ../nbs/api/12_test.ipynb #3f4fa1ad
 def test_nb(fn,  # file name of notebook to test
             skip_flags=None,  # list of flags marking cells to skip
             force_flags=None,  # list of flags marking cells to always run
@@ -57,7 +57,7 @@ def test_nb(fn,  # file name of notebook to test
     if do_print: print(f'- Completed {fn}')
     return res,time.time()-start
 
-# %% ../nbs/api/12_test.ipynb
+# %% ../nbs/api/12_test.ipynb #d8bf1f1b-935d-4b69-ba96-827c5d7213f0
 def _keep_file(p:Path, # filename for which to check for `indicator_fname`
                ignore_fname:str # filename that will result in siblings being ignored
                 ) -> bool:
@@ -65,7 +65,7 @@ def _keep_file(p:Path, # filename for which to check for `indicator_fname`
     if p.exists(): return not bool(p.parent.ls().attrgot('name').filter(lambda x: x == ignore_fname))
     else: True
 
-# %% ../nbs/api/12_test.ipynb
+# %% ../nbs/api/12_test.ipynb #f8cc6a61-a48e-4ab1-89a9-18316ca795d6
 @call_parse
 @delegates(nbglob_cli)
 def nbdev_test(