nbdev 3.0.18__tar.gz → 3.2.0__tar.gz

{nbdev-3.0.18/nbdev.egg-info → nbdev-3.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nbdev
-Version: 3.0.18
+Version: 3.2.0
 Summary: Create delightful software with Jupyter Notebooks
 Author-email: "Jeremy Howard and the fast.ai community" <j@fast.ai>
 License: Apache-2.0
@@ -16,10 +16,10 @@ Classifier: License :: OSI Approved :: Apache Software License
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: fastcore>=1.12.35
-Requires-Dist: execnb>=0.1.12
+Requires-Dist: fastcore>=1.14.6
+Requires-Dist: execnb>=0.2.4
 Requires-Dist: astunparse
-Requires-Dist: ghapi>=1.0.3
+Requires-Dist: ghapi>=2.0.0
 Requires-Dist: watchdog
 Requires-Dist: asttokens
 Requires-Dist: setuptools
@@ -158,7 +158,7 @@ available commands:
     nbdev-pypi                Create and upload Python package to PyPI
     nbdev-readme              Create README.md from readme_nb (index.ipynb by default)
     nbdev-release-both        Release both conda and PyPI packages
-    nbdev-release-gh          Calls `nbdev_changelog`, lets you edit the result, then pushes to git and calls `nbdev_release_git`
+    nbdev-release-gh          Calls `nbdev-changelog`, lets you edit the result, then pushes to git and calls `nbdev-release-git`
     nbdev-release-git         Tag and create a release in GitHub for the current version
     nbdev-requirements        Writes a `requirements.txt` file to `directory` based on pyproject.toml.
     nbdev-sidebar             Create sidebar.yml
@@ -184,6 +184,9 @@ some_module.something()
 Instead, split this into two cells, one which does `import some_module`,
 and the other which does `some_module.something()`.
 
+Only top-level statements count: `try: import` blocks and imports inside
+function definitions are fine.
+
 The reason for this is that when we create your documentation website,
 we ensure that all of the signatures for functions you document are up
 to date, by running the imports, exported cells, and

{nbdev-3.0.18 → nbdev-3.2.0}/README.md

@@ -114,7 +114,7 @@ available commands:
     nbdev-pypi                Create and upload Python package to PyPI
     nbdev-readme              Create README.md from readme_nb (index.ipynb by default)
     nbdev-release-both        Release both conda and PyPI packages
-    nbdev-release-gh          Calls `nbdev_changelog`, lets you edit the result, then pushes to git and calls `nbdev_release_git`
+    nbdev-release-gh          Calls `nbdev-changelog`, lets you edit the result, then pushes to git and calls `nbdev-release-git`
     nbdev-release-git         Tag and create a release in GitHub for the current version
     nbdev-requirements        Writes a `requirements.txt` file to `directory` based on pyproject.toml.
     nbdev-sidebar             Create sidebar.yml
@@ -140,6 +140,9 @@ some_module.something()
 Instead, split this into two cells, one which does `import some_module`,
 and the other which does `some_module.something()`.
 
+Only top-level statements count: `try: import` blocks and imports inside
+function definitions are fine.
+
 The reason for this is that when we create your documentation website,
 we ensure that all of the signatures for functions you document are up
 to date, by running the imports, exported cells, and

{nbdev-3.0.18 → nbdev-3.2.0}/nbdev/__init__.py

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

{nbdev-3.0.18 → nbdev-3.2.0}/nbdev/_modidx.py

@@ -225,6 +225,7 @@ d = { 'settings': { 'branch': 'main',
                                   'nbdev.processors._is_showdoc': ('api/processors.html#_is_showdoc', 'nbdev/processors.py'),
                                   'nbdev.processors._re_hideline': ('api/processors.html#_re_hideline', 'nbdev/processors.py'),
                                   'nbdev.processors._show_docs': ('api/processors.html#_show_docs', 'nbdev/processors.py'),
+                                  'nbdev.processors._tl_contains': ('api/processors.html#_tl_contains', 'nbdev/processors.py'),
                                   'nbdev.processors._want_doc': ('api/processors.html#_want_doc', 'nbdev/processors.py'),
                                   'nbdev.processors.add_fold': ('api/processors.html#add_fold', 'nbdev/processors.py'),
                                   'nbdev.processors.add_links': ('api/processors.html#add_links', 'nbdev/processors.py'),
@@ -278,6 +279,7 @@ d = { 'settings': { 'branch': 'main',
                                                                             'nbdev/quarto.py'),
                               'nbdev.quarto._SidebarYmlRemoved.__init__': ( 'api/quarto.html#_sidebarymlremoved.__init__',
                                                                             'nbdev/quarto.py'),
+                              'nbdev.quarto._chk_nbdev_yml': ('api/quarto.html#_chk_nbdev_yml', 'nbdev/quarto.py'),
                               'nbdev.quarto._copytree': ('api/quarto.html#_copytree', 'nbdev/quarto.py'),
                               'nbdev.quarto._doc_mtime_not_older': ('api/quarto.html#_doc_mtime_not_older', 'nbdev/quarto.py'),
                               'nbdev.quarto._ensure_quarto': ('api/quarto.html#_ensure_quarto', 'nbdev/quarto.py'),
@@ -286,6 +288,7 @@ d = { 'settings': { 'branch': 'main',
                               'nbdev.quarto._nbglob_docs': ('api/quarto.html#_nbglob_docs', 'nbdev/quarto.py'),
                               'nbdev.quarto._pre': ('api/quarto.html#_pre', 'nbdev/quarto.py'),
                               'nbdev.quarto._pre_docs': ('api/quarto.html#_pre_docs', 'nbdev/quarto.py'),
+                              'nbdev.quarto._readme_cands': ('api/quarto.html#_readme_cands', 'nbdev/quarto.py'),
                               'nbdev.quarto._recursive_parser': ('api/quarto.html#_recursive_parser', 'nbdev/quarto.py'),
                               'nbdev.quarto._save_cached_contributing': ('api/quarto.html#_save_cached_contributing', 'nbdev/quarto.py'),
                               'nbdev.quarto._save_cached_readme': ('api/quarto.html#_save_cached_readme', 'nbdev/quarto.py'),
@@ -330,6 +333,7 @@ d = { 'settings': { 'branch': 'main',
                                'nbdev.release.release_gh': ('api/release.html#release_gh', 'nbdev/release.py'),
                                'nbdev.release.release_git': ('api/release.html#release_git', 'nbdev/release.py'),
                                'nbdev.release.release_pypi': ('api/release.html#release_pypi', 'nbdev/release.py'),
+                               'nbdev.release.update_changelog': ('api/release.html#update_changelog', 'nbdev/release.py'),
                                'nbdev.release.write_conda_meta': ('api/release.html#write_conda_meta', 'nbdev/release.py'),
                                'nbdev.release.write_requirements': ('api/release.html#write_requirements', 'nbdev/release.py')},
             'nbdev.scrubmagics': {},

{nbdev-3.0.18 → nbdev-3.2.0}/nbdev/cli.py

@@ -71,25 +71,25 @@ def _render_nb(fn, cfg):
     fn.write_text(txt)
 
 # %% ../nbs/api/13_cli.ipynb #dd385911-aa8f-44e7-8d46-7b8a20f3b010
-def _update_repo_meta(cfg):
+async def _update_repo_meta(cfg):
     "Enable gh pages and update the homepage and description in your GitHub repo."
     token=os.getenv('GITHUB_TOKEN')
     if token:
-        from ghapi.core import GhApi
+        from ghapi.core import GhApi, APIError
         api = GhApi(owner=cfg.user, repo=cfg.repo, token=token)
-        try: api.repos.update(homepage=f'{cfg.doc_host}{cfg.doc_baseurl}', description=cfg.description)
-        except HTTPError:print(f"Could not update the description & URL on the repo: {cfg.user}/{cfg.repo} using $GITHUB_TOKEN.\n"
+        try: await api.repos.update(homepage=f'{cfg.doc_host}{cfg.doc_baseurl}', description=cfg.description)
+        except APIError:print(f"Could not update the description & URL on the repo: {cfg.user}/{cfg.repo} using $GITHUB_TOKEN.\n"
                   "Use a token with the correction permissions or perform these steps manually.")
 
 # %% ../nbs/api/13_cli.ipynb #c4a663d9
 @call_parse
 @delegates(nbdev_create_config)
-def nbdev_new(**kwargs):
+async def nbdev_new(**kwargs):
     "Create an nbdev project."
     from ghapi.core import GhApi
     nbdev_create_config.__wrapped__(**kwargs)
     cfg = get_config()
-    if (Path('.git')).exists(): _update_repo_meta(cfg)
+    if (Path('.git')).exists(): await _update_repo_meta(cfg)
     else: print(f"No git repo found. Run: gh repo create {cfg.user}/{cfg.repo} --public --source=.")
     path = Path()
 
@@ -103,8 +103,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 = (await 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)
@@ -137,20 +137,21 @@ mapping = {
 
 # %% ../nbs/api/13_cli.ipynb #a1116ee1-f5cb-4b63-8630-b64cd2ae3c12
 @call_parse
-def nbdev_update_license(
+async def nbdev_update_license(
     to: str=None, # update license to
 ):
     "Allows you to update the license of your project."
     from ghapi.core import GhApi
     warnings.filterwarnings("ignore")
-    avail_lic = GhApi().licenses.get_all_commonly_used().map(lambda x: x['key'])
+    api = GhApi()
+    avail_lic = (await api.licenses.get_all_commonly_used()).map(lambda x: x['key'])
 
     cfg = get_config()
     curr_lic = cfg.license
 
     mapped = mapping.get(to, None)
     if mapped not in avail_lic: raise ValueError(f"{to} is not an available license")
-    body = GhApi().licenses.get(mapped)['body']
+    body = (await api.licenses.get(mapped))['body']
 
     copyright = f"{datetime.now().year}, {cfg.author}"
     body = body.replace('[year], [fullname]', copyright)
@@ -168,18 +169,21 @@ def nbdev_update_license(
 # %% ../nbs/api/13_cli.ipynb #412b4cd2
 @call_parse
 @delegates(nb_export, but=['procs', 'mod_maker'])
-def nb_export_cli(nbname, 
-                  debug:store_true=False, # Debug flag 
-                  **kwargs): 
+def nb_export_cli(
+    nbname,
+    debug:store_true=False, # Debug flag
+    **kwargs
+):
     "Export a single nbdev notebook to a python script."
     return nb_export(nbname=nbname, debug=debug, **kwargs)
 
 # %% ../nbs/api/13_cli.ipynb #aaa472e7
 @call_parse
-def watch_export(nbs:str=None, # Nb directory to watch for changes
-                 lib:str=None, # Export directory to write py files to
-                 force:bool=False # Ignore nbdev config if in nbdev project
-                ):
+def watch_export(
+    nbs:str=None, # Nb directory to watch for changes
+    lib:str=None, # Export directory to write py files to
+    force:bool=False # Ignore nbdev config if in nbdev project
+):
     '''Use `nb_export` on ipynb files in `nbs` directory on changes using nbdev config if available'''
     cfg = get_config() if is_nbdev() else None
     nbs = nbs or (cfg.nbs_path if cfg else '.')

{nbdev-3.0.18 → nbdev-3.2.0}/nbdev/config.py

@@ -38,18 +38,16 @@ def _git_repo():
 
 # %% ../nbs/api/01_config.ipynb #6eeafafd
 def _get_info(owner, repo, default_branch='main', default_kw='nbdev'):
-    from ghapi.all import GhApi
-    api = GhApi(owner=owner, repo=repo, token=os.getenv('GITHUB_TOKEN'))
-    
-    try: r = api.repos.get()
-    except HTTPError:
+    from ghapi.all import call_gh, APIError
+    try: r = call_gh('repos.get', owner=owner, repo=repo)
+    except APIError:
         msg= [f"""Could not access repo: {owner}/{repo} to find your default branch - `{default_branch}` assumed.
 Edit `pyproject.toml` if this is incorrect.
 In the future, you can allow nbdev to see private repos by setting the environment variable GITHUB_TOKEN as described here:
 https://nbdev.fast.ai/api/release.html#setup"""]
         print(''.join(msg))
         return default_branch,default_kw,''
-    
+
     return r.default_branch, default_kw if not getattr(r, 'topics', []) else ' '.join(r.topics), r.description
 
 # %% ../nbs/api/01_config.ipynb #35d5c037
@@ -170,7 +168,7 @@ def _find_nbdev_pyproject(path=None):
 # %% ../nbs/api/01_config.ipynb #3dac70e0
 nbdev_defaults = dict(nbs_path='nbs', doc_path='_docs', tst_flags='notest', recursive=True, readme_nb='index.ipynb',
     clean_ids=True, clear_all=False, put_version_in_init=True, jupyter_hooks=False, custom_sidebar=False, branch='main',
-    doc_procs=[], export_procs=[])
+    doc_procs=[], export_procs=[], exec_profile=True)
 
 _path_keys = 'lib_path', 'nbs_path', 'doc_path'
 
@@ -238,7 +236,7 @@ def get_config(path=None, also_settings=False):
         nbdev = {**user, **d.get('tool', {}).get('nbdev', {})}
         return ConfigToml(nbdev, d.get('project', {}), cfg_file)
     if also_settings:
-        from fastcore.foundation import Config
+        from fastcore.xtras import Config
         cfg = Config.find('settings.ini', path)
         if cfg: return cfg
     cfg_path = Path(path or Path.cwd()).expanduser().absolute()
@@ -267,7 +265,8 @@ def nbpath2docurl(nb_path):
     "Hosted docs URL (with `.md` suffix) for notebook `nb_path`, or '' if no `doc_host`"
     cfg = get_config()
     if not cfg.doc_host: return ''
-    p = Path(nb_path).resolve().relative_to(cfg.path('nbs_path'))
+    try: p = Path(nb_path).resolve().relative_to(cfg.path('nbs_path'))
+    except ValueError: return ""
     return f"{cfg.doc_host.rstrip('/')}{cfg.doc_baseurl.rstrip('/')}/{nbpath2html(p).as_posix()}.md"
 
 # %% ../nbs/api/01_config.ipynb #163177f2

{nbdev-3.0.18 → nbdev-3.2.0}/nbdev/doclinks.py

@@ -146,14 +146,16 @@ def nbdev_export(
     **kwargs):
     "Export notebooks in `path` to Python modules"
     if os.environ.get('IN_TEST',0): return
-    if not is_nbdev(): raise Exception('`nbdev-export` must be called from a directory within a nbdev project.')
-    cfg = get_config()
-    procs = procs.split() if procs else cfg.get('export_procs', [])
-    procs = [import_obj(p) for p in procs] if procs else None
-    files = nbglob(path=path, as_path=True, **kwargs).sorted('name')
-    for f in files: nb_export(f, procs=procs)
-    add_init(cfg.lib_path)
-    _build_modidx()
+    if path: path = Path(path).resolve()
+    if not is_nbdev(path): raise Exception('`nbdev-export` must be called from a directory within a nbdev project.')
+    with working_directory(get_config(path).config_path if path else '.'):
+        cfg = get_config()
+        procs = procs.split() if procs else cfg.get('export_procs', [])
+        procs = [import_obj(p) for p in procs] if procs else None
+        files = nbglob(path=path, as_path=True, **kwargs).sorted('name')
+        for f in files: nb_export(f, procs=procs)
+        add_init(cfg.lib_path)
+        _build_modidx()
 
 # %% ../nbs/api/05_doclinks.ipynb #3134c22b
 typs = 'module','class','method','function'

{nbdev-3.0.18 → nbdev-3.2.0}/nbdev/export.py

@@ -36,14 +36,15 @@ class ExportModuleProc:
     _exports_=_export_
 
 # %% ../nbs/api/04_export.ipynb #76717e36
-def nb_export(nbname:str,        # Filename of notebook 
-              lib_path:str=None, # Path to destination library.  If not in a nbdev project, defaults to current directory.
-              procs=None,        # Processors to use
-              name:str=None,     # Name of python script {name}.py to create.
-              mod_maker=ModuleMaker,
-              debug:bool=False,  # Debug mode
-              solo_nb:bool=False # Export single notebook outside of an nbdev project.
-             ):
+def nb_export(
+    nbname:str,        # Filename of notebook
+    lib_path:str=None, # Path to destination library.  If not in a nbdev project, defaults to current directory.
+    procs=None,        # Processors to use
+    name:str=None,     # Name of python script {name}.py to create.
+    mod_maker=ModuleMaker,
+    debug:bool=False,  # Debug mode
+    solo_nb:bool=False # Export single notebook outside of an nbdev project.
+):
     "Create module(s) from notebook"
     if lib_path is None: lib_path = get_config().lib_path if is_nbdev() else '.'
     exp = ExportModuleProc()

{nbdev-3.0.18 → nbdev-3.2.0}/nbdev/merge.py

@@ -46,7 +46,8 @@ def _make_conflict(a,b, branch1, branch2):
     return _make_md(f'{_BEG} {branch1}') + a+_make_md(_MID)+b + _make_md(f'{_END} {branch2}')
 
 def _merge_cells(a, b, brancha, branchb, theirs):
-    matches = SequenceMatcher(None, a, b).get_matching_blocks()
+    def _k(cs): return [(c.cell_type,c.source) for c in cs]
+    matches = SequenceMatcher(None, _k(a), _k(b)).get_matching_blocks()
     res,prev_sa,prev_sb,conflict = [],0,0,False
     for sa,sb,sz in matches:
         ca,cb = a[prev_sa:sa],b[prev_sb:sb]
@@ -59,11 +60,13 @@ def _merge_cells(a, b, brancha, branchb, theirs):
 
 # %% ../nbs/api/07_merge.ipynb #cc492d30
 @call_parse
-def nbdev_fix(nbname:str, # Notebook filename to fix
-               outname:str=None, # Filename of output notebook (defaults to `nbname`)
-               nobackup:bool_arg=True, # Do not backup `nbname` to `nbname`.bak if `outname` not provided
-               theirs:bool=False, # Use their outputs and metadata instead of ours
-               noprint:bool=False): # Do not print info about whether conflicts are found
+def nbdev_fix(
+    nbname:str, # Notebook filename to fix
+    outname:str=None, # Filename of output notebook (defaults to `nbname`)
+    nobackup:bool_arg=True, # Do not backup `nbname` to `nbname`.bak if `outname` not provided
+    theirs:bool=False, # Use their outputs and metadata instead of ours
+    noprint:bool=False # Do not print info about whether conflicts are found
+):
     "Create working notebook from conflicted notebook `nbname`"
     nbname = Path(nbname)
     if not nobackup and not outname: shutil.copy(nbname, nbname.with_suffix('.ipynb.bak'))

{nbdev-3.0.18 → nbdev-3.2.0}/nbdev/migrate.py

@@ -32,11 +32,12 @@ def _file_slug(fname):
     return dt + p.stem[11:]    
 
 # %% ../nbs/api/16_migrate.ipynb #689bf354
-def _replace_fm(d:dict, # dictionary you wish to conditionally change
-                k:str,  # key to check 
-                val:str,# value to check if d[k] == v
-                repl_dict:dict #dictionary that will be used as a replacement 
-               ):
+def _replace_fm(
+    d:dict, # dictionary you wish to conditionally change
+    k:str,  # key to check
+    val:str,# value to check if d[k] == v
+    repl_dict:dict #dictionary that will be used as a replacement
+):
     "replace key `k` in dict `d` if d[k] == val with `repl_dict`"
     if str(d.get(k, '')).lower().strip() == str(val.lower()).strip():
         d.pop(k)
@@ -191,8 +192,9 @@ def _migrate_workflows(path):
     wf_path = Path(path) / '.github/workflows'
     if not wf_path.exists(): return
     replacements = [
-        ('fastai/workflows/quarto-ghp@', 'fastai/workflows/quarto-ghp3@'),
-        ('fastai/workflows/nbdev-ci@', 'fastai/workflows/nbdev3-ci@'),
+        ('fastai/workflows/quarto-ghp@', 'AnswerDotAI/workflows/quarto-ghp3@'),
+        ('fastai/workflows/nbdev-ci@', 'AnswerDotAI/workflows/nbdev3-ci@'),
+        ('fastai/workflows/', 'AnswerDotAI/workflows/'),
     ]
     for f in (*wf_path.glob('*.yml'), *wf_path.glob('*.yaml')):
         txt = f.read_text()

{nbdev-3.0.18 → nbdev-3.2.0}/nbdev/processors.py

@@ -128,7 +128,8 @@ def add_links(cell):
     if cell.cell_type == 'markdown': cell.source = nl.linkify(cell.source)
     for o in cell.get('outputs', []):
         if hasattr(o, 'data') and hasattr(o['data'], 'text/markdown'):
-            o.data['text/markdown'] = [nl.link_line(s) for s in o.data['text/markdown']]
+            md = o.data['text/markdown']
+            o.data['text/markdown'] = nl.linkify(''.join(md) if isinstance(md, list) else md)
 
 # %% ../nbs/api/10_processors.ipynb #809e9225
 def add_fold(cell):
@@ -142,7 +143,7 @@ _re_ansi_escape = re.compile(r'\x1B(?:[@-Z\\-_]|\[[0-?]*[ -/]*[@-~])')
 def strip_ansi(cell):
     "Strip Ansi Characters."
     for outp in cell.get('outputs', []):
-        if outp.get('name')=='stdout': outp['text'] = [_re_ansi_escape.sub('', o) for o in outp.text]
+        if outp.get('name')=='stdout': outp['text'] = _re_ansi_escape.sub('', outp.text)
 
 # %% ../nbs/api/10_processors.ipynb #640b7eca
 def strip_hidden_metadata(cell):
@@ -169,7 +170,7 @@ def filter_stream_(cell, *words):
     if not words: return
     for outp in cell.get('outputs', []):
         if outp.output_type == 'stream':
-            outp['text'] = [l for l in outp.text if not re.search('|'.join(words), l)]
+            outp['text'] = ''.join(l for l in outp.text.splitlines(True) if not re.search('|'.join(words), l))
 
 # %% ../nbs/api/10_processors.ipynb #848fd452-3d63-4c41-aaa6-e14cbeb9fdcd
 _aimagics_pattern = re.compile(r'^\s*(%%ai.? |%%ai.?$)', re.MULTILINE)
@@ -181,11 +182,15 @@ def ai_magics(cell):
         cell.source = '\n'.join(cell.source.splitlines()[1:])
 
 # %% ../nbs/api/10_processors.ipynb #5a9c8fd4
-_magics_pattern = re.compile(r'^\s*(%%|%).*', re.MULTILINE)
+_def_strip_magics = '%load_ext %autoreload %reload_ext %matplotlib %config'
 
 def clean_magics(cell):
-    "A preprocessor to remove cell magic commands"
-    if cell.cell_type == 'code': cell.source = _magics_pattern.sub('', cell.source).strip()
+    "Remove housekeeping magics: those named in the `strip_magics` config (space-separated, default `_def_strip_magics`)"
+    mm = str(get_config().get('strip_magics', _def_strip_magics)).split()
+    if not mm or cell.cell_type != 'code': return
+    pat = re.compile(rf"^\s*({'|'.join(re.escape(m) for m in mm)})\b.*", re.MULTILINE)
+    cell.source = pat.sub('', cell.source).strip()
+
 
 # %% ../nbs/api/10_processors.ipynb #93e27a52
 _re_hdr_dash = re.compile(r'^#+\s+.*\s+-\s*$', re.MULTILINE)
@@ -222,6 +227,8 @@ def _ast_contains(trees, types):
         for node in ast.walk(tree):
             if isinstance(node, types): return True
 
+def _tl_contains(trees, types): return any(isinstance(t, types) for t in trees)
+
 def _do_eval(cell):
     if cell_lang(cell) != 'python': return
     if not cell.source or 'nbdev_export'+'()' in cell.source: return
@@ -232,7 +239,7 @@ def _do_eval(cell):
     _show_dirs = {'export','exports','exporti','exec_doc'}
     if cell.directives_.keys() & _show_dirs: return True
     if _ast_contains(trees, (ast.Import, ast.ImportFrom)):
-        if _ast_contains(trees, (ast.Expr, ast.Assign)):
+        if _tl_contains(trees, (ast.Import, ast.ImportFrom)) and _tl_contains(trees, (ast.Expr, ast.Assign)):
             warn(f'Found cells containing imports and other code. See FAQ.\n---\n{cell.source}\n---\n')
         return True
     if _show_docs(trees): return True
@@ -242,7 +249,7 @@ class exec_show_docs(Processor):
     "Execute cells needed for `show_docs` output, including exported cells and imports"
     def begin(self):
         if nb_lang(self.nb) != 'python': return
-        self.k = CaptureShell()
+        self.k = CaptureShell(profile=bool(get_config().exec_profile))
         self.k.run_cell('from nbdev.showdoc import show_doc')
 
     def __call__(self, cell):

{nbdev-3.0.18 → nbdev-3.2.0}/nbdev/qmd.py

@@ -14,10 +14,12 @@ from fastcore.utils import *
 from fastcore.meta import delegates
 
 # %% ../nbs/api/15_qmd.ipynb #5a64f1f4
-def meta(md,  # Markdown to add meta to
-         classes=None,  # List of CSS classes to add
-         style=None,  # Dict of CSS styles to add
-         **kwargs):   # Additional attributes to add to meta
+def meta(
+    md,  # Markdown to add meta to
+    classes=None,  # List of CSS classes to add
+    style=None,  # Dict of CSS styles to add
+    **kwargs # Additional attributes to add to meta
+):
     "A metadata section for qmd div in `{}`"
     if style: kwargs['style'] = "; ".join(f'{k}: {v}' for k,v in style.items())
     props = ' '.join(f'{k}="{v}"' for k,v in kwargs.items())
@@ -29,21 +31,25 @@ def meta(md,  # Markdown to add meta to
     return md + ("{" + meta + "}" if meta else "")
 
 # %% ../nbs/api/15_qmd.ipynb #52637a70
-def div(txt,  # Markdown to add meta to
-        classes=None,  # List of CSS classes to add
-        style=None,  # Dict of CSS styles to add
-        **kwargs):
+def div(
+    txt,  # Markdown to add meta to
+    classes=None,  # List of CSS classes to add
+    style=None,  # Dict of CSS styles to add
+    **kwargs
+):
     "A qmd div with optional metadata section"
     return meta("::: ", classes=classes, style=style, **kwargs) + f"\n\n{txt}\n\n:::\n\n"
 
 # %% ../nbs/api/15_qmd.ipynb #f9f499f4
-def img(fname,  # Image to link to
-        classes=None,  # List of CSS classes to add
-        style=None,   # Dict of CSS styles to add
-        height=None,  # Height attribute
-        relative=None,  # Tuple of (position,px)
-        link=False,   # Hyperlink to this image
-        **kwargs):
+def img(
+    fname,  # Image to link to
+    classes=None,  # List of CSS classes to add
+    style=None,   # Dict of CSS styles to add
+    height=None,  # Height attribute
+    relative=None,  # Tuple of (position,px)
+    link=False,   # Hyperlink to this image
+    **kwargs
+):
     "A qmd image"
     kwargs,style = kwargs or {}, style or {}
     if height: kwargs["height"]= f"{height}px"
@@ -55,23 +61,27 @@ def img(fname,  # Image to link to
     return  f'[{res}]({fname})' if link else res
 
 # %% ../nbs/api/15_qmd.ipynb #16d7aa5f
-def btn(txt, # Button text
-        link,  # Button link URL
-        classes=None,  # List of CSS classes to add
-        style=None,    # Dict of CSS styles to add
-        **kwargs):
+def btn(
+    txt, # Button text
+    link,  # Button link URL
+    classes=None,  # List of CSS classes to add
+    style=None,    # Dict of CSS styles to add
+    **kwargs
+):
     "A qmd button"
     return meta(f'[{txt}]({link})', classes=classes, style=style, role="button")
 
 # %% ../nbs/api/15_qmd.ipynb #e414ed33
-def tbl_row(cols:list,  # Auto-stringified columns to show in the row
-           ):
+def tbl_row(
+    cols:list,  # Auto-stringified columns to show in the row
+):
     "Create a markdown table row from `cols`"
     return '|' + '|'.join(str(c or '') for c in cols) + '|'
 
 # %% ../nbs/api/15_qmd.ipynb #38f0641b
-def tbl_sep(sizes:int|list=3  # List of column sizes, or single `int` if all sizes the same
-           ):
+def tbl_sep(
+    sizes:int|list=3  # List of column sizes, or single `int` if all sizes the same
+):
     "Create a markdown table separator with relative column size `sizes`"
     if isinstance(sizes,int): sizes = [3]*sizes
     return tbl_row('-'*s for s in sizes)

{nbdev-3.0.18 → nbdev-3.2.0}/nbdev/quarto.py

@@ -196,10 +196,16 @@ def _ensure_quarto():
     print("Quarto is not installed. We will download and install it for you.")
     install.__wrapped__()
 
+# %% ../nbs/api/14_quarto.ipynb #66163c30
+def _chk_nbdev_yml(path):
+    "Fail early if `nbdev.yml` is missing from `path`, since without it quarto silently renders to the wrong location"
+    if not (path/'nbdev.yml').exists(): raise FileNotFoundError(f"{path/'nbdev.yml'} not found, so docs/README can not be built correctly.")
+
 # %% ../nbs/api/14_quarto.ipynb #6b880922
 def _pre_docs(path=None, n_workers:int=defaults.cpus, **kwargs):
     cfg = get_config()
     path = Path(path) if path else cfg.nbs_path
+    _chk_nbdev_yml(path)
     _ensure_quarto()
     refresh_quarto_yml()
     import nbdev.doclinks
@@ -243,15 +249,20 @@ def _copytree(a,b):
         copy_tree(a, b)
 
 # %% ../nbs/api/14_quarto.ipynb #caeaa153
+def _readme_cands(cache, cfg):
+    "Locations where `quarto render -o README.md` may put its output, which differs by quarto version"
+    return cache/cfg.doc_path.name/'README.md', cache/'README.md'
+
 def _save_cached_readme(cache, cfg):
-    tmp_doc_path = cache/cfg.doc_path.name
-    readme = tmp_doc_path/'README.md'
-    if readme.exists():
-        readme_path = cfg.config_path/'README.md'
-        if readme_path.exists(): readme_path.unlink() # py37 doesn't have `missing_ok`
-        move(readme, cfg.config_path)
-        _rdmi = tmp_doc_path/((cache/cfg.readme_nb).stem + '_files') # Supporting files for README
-        if _rdmi.exists(): _copytree(_rdmi, cfg.config_path/_rdmi.name)
+    cands = _readme_cands(cache, cfg)
+    readme = next((f for f in cands if f.exists()), None)
+    if not readme: raise FileNotFoundError(f"quarto render did not produce a README.md in any of: {cands}")
+    readme_path = cfg.config_path/'README.md'
+    if readme_path.exists(): readme_path.unlink() # py37 doesn't have `missing_ok`
+    move(readme, cfg.config_path)
+    _rdmi = readme.parent/((cache/cfg.readme_nb).stem + '_files') # Supporting files for README
+    if _rdmi.exists(): _copytree(_rdmi, cfg.config_path/_rdmi.name)
+
 
 # %% ../nbs/api/14_quarto.ipynb #45d6bb5d
 @call_parse
@@ -261,10 +272,13 @@ def nbdev_readme(
     "Create README.md from readme_nb (index.ipynb by default)"
     cfg = get_config()
     path = Path(path) if path else cfg.nbs_path
+    _chk_nbdev_yml(path)
     if chk_time and _doc_mtime_not_older(cfg.config_path/'README.md', path/cfg.readme_nb): return
 
     with _SidebarYmlRemoved(path): # to avoid rendering whole website
         cache = proc_nbs(path)
+        for f in _readme_cands(cache, cfg):
+            if f.exists(): f.unlink() # remove stale renders from either quarto layout
         _sprun(f'cd "{cache}" && quarto render "{cache/cfg.readme_nb}" -o README.md -t gfm --no-execute')
         
     _save_cached_readme(cache, cfg)

{nbdev-3.0.18 → nbdev-3.2.0}/nbdev/release.py

@@ -5,8 +5,8 @@ Docs: https://nbdev.fast.ai/api/release.html.md"""
 # AUTOGENERATED! DO NOT EDIT! File to edit: ../nbs/api/18_release.ipynb.
 
 # %% auto #0
-__all__ = ['GH_HOST', 'CONDA_WARNING', 'Release', 'changelog', 'push_release', 'release_git', 'release_gh', 'pypi_json',
-           'latest_pypi', 'pypi_details', 'conda_output_path', 'write_conda_meta', 'write_requirements',
+__all__ = ['GH_HOST', 'CONDA_WARNING', 'update_changelog', 'Release', 'changelog', 'push_release', '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', 'nbdev_bump_version']
 
 # %% ../nbs/api/18_release.ipynb #c35cc2b8
@@ -15,7 +15,7 @@ from ghapi.core import *
 
 from datetime import datetime
 from packaging.version import Version
-import shutil,subprocess
+import shutil,subprocess,asyncio
 
 from .doclinks import *
 
@@ -42,6 +42,12 @@ 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 #dcaba486
+def update_changelog(txt, ver, notes, marker='<!-- do not remove -->\n'):
+    "Insert `notes` into changelog `txt` after `marker`, replacing any existing section for `ver`"
+    txt = re.sub(rf'\n## {re.escape(ver)}\n.*?(?=\n## |\Z)', '', txt, flags=re.S)
+    return txt.replace(marker, marker+notes+'\n')
+
 # %% ../nbs/api/18_release.ipynb #0b36471a
 class Release:
     def __init__(self, owner=None, repo=None, token=None, **groups):
@@ -52,6 +58,7 @@ class Release:
             default_groups=dict(breaking="Breaking Changes", enhancement="New Features", bug="Bugs Squashed")
             groups=_load_json(self.cfg, 'label_groups') if 'label_groups' in self.cfg else default_groups
         os.chdir(self.cfg.config_path)
+        if repo and '/' in repo: owner,repo = repo.split('/', 1)
         owner,repo = owner or self.cfg.user, repo or self.cfg.repo
         token = ifnone(token, os.getenv('NBDEV_TOKEN',None))
         if not token and Path('token').exists(): token = Path('token').read_text().strip()
@@ -60,38 +67,40 @@ class Release:
         self.gh = GhApi(owner, repo, token)
         self.groups = groups
 
-    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, threadpool=True)
+    async def _issues(self, label):
+        return await self.gh.issues.list_for_repo(state='closed', sort='created', filter='all', since=self.commit_date, labels=label)
+    async def _issue_groups(self): return await asyncio.gather(*map(self._issues, self.groups.keys()))
 
 # %% ../nbs/api/18_release.ipynb #aa22dfe3
 @patch
-def changelog(self:Release,
+async 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 = (lr:=self.gh.repos.get_latest_release()).published_at
-    except HTTP404NotFoundError: lr,self.commit_date = None,'2000-01-01T00:00:004Z'
+    try: self.commit_date = (lr:=await self.gh.repos.get_latest_release()).published_at
+    except APIError as e:
+        if e.status_code != 404: raise
+        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()
+    issues = await self._issue_groups()
     res += '\n'.join(_issues_txt(*o) for o in zip(issues, self.groups.values()))
     if debug: return res
-    res = self.changefile.read_text().replace(marker, marker+res+"\n")
+    res = update_changelog(self.changefile.read_text(), self.cfg.version, res, marker)
     shutil.copy(self.changefile, self.changefile.with_suffix(".bak"))
     self.changefile.write_text(res)
     run(f'git add {self.changefile}')
 
 # %% ../nbs/api/18_release.ipynb #068421c6
 @patch
-def release(self:Release):
+async def release(self:Release):
     "Tag and create a release in GitHub for the current version"
     ver = self.cfg.version
     notes = self.latest_notes()
-    self.gh.create_release(ver, branch=self.cfg.branch, body=notes)
+    await self.gh.create_release(ver, branch=self.cfg.branch, body=notes)
     return ver
 
 # %% ../nbs/api/18_release.ipynb #22101171
@@ -105,38 +114,41 @@ def latest_notes(self:Release):
 
 # %% ../nbs/api/18_release.ipynb #01cb1ca4
 @call_parse
-def changelog(
+async def changelog(
     debug:store_true=False,  # Print info to be added to CHANGELOG, instead of updating file
-    repo:str=None,  # repo to use instead of `lib_name` from pyproject.toml
+    repo:str=None,  # "repo" or "owner/repo" to use instead of pyproject.toml values
+    token:str=None,  # Optional GitHub token (otherwise `token` file is used)
 ):
     "Create a CHANGELOG.md file from closed and labeled GitHub issues"
-    res = Release(repo=repo).changelog(debug=debug)
+    res = await Release(repo=repo, token=token).changelog(debug=debug)
     if debug: print(res)
 
 # %% ../nbs/api/18_release.ipynb #15b66643
-def push_release(token:str=None):
+async def push_release(token:str=None, repo:str=None):
     "Create a GitHub release (changelog should already be committed/pushed). Returns the release."
-    return Release(token=token).release()
+    return await Release(repo=repo, token=token).release()
 
 # %% ../nbs/api/18_release.ipynb #6d3c5cd8
 @call_parse
-def release_git(token:str=None):
+async def release_git(token:str=None):
     "Tag and create a release in GitHub for the current version"
-    print(f"Released {push_release(token)}")
+    print(f"Released {await push_release(token)}")
 
 # %% ../nbs/api/18_release.ipynb #94ee72b1
 @call_parse
-def release_gh(
-    token:str=None  # Optional GitHub token (otherwise `token` file is used)
+async def release_gh(
+    token:str=None,  # Optional GitHub token (otherwise `token` file is used)
+    repo:str=None,  # "repo" or "owner/repo" to use instead of pyproject.toml values
+    no_changelog:store_true=False  # Skip changelog creation (assumes CHANGELOG.md is up to date)
 ):
     "Calls `nbdev-changelog`, lets you edit the result, then pushes to git and calls `nbdev-release-git`"
     cfg = _find_config()
-    Release().changelog()
+    if not no_changelog: await Release(repo=repo).changelog()
     subprocess.run([os.environ.get('EDITOR','nano'), cfg.config_path/'CHANGELOG.md'])
     if not input("Make release now? (y/n) ").lower().startswith('y'): sys.exit(1)
     run('git commit -am release')
     run('git push')
-    print(f"Released {push_release(token)}")
+    print(f"Released {await push_release(token, repo=repo)}")
 
 # %% ../nbs/api/18_release.ipynb #5b4d4aa2
 from fastcore.all import *

{nbdev-3.0.18 → nbdev-3.2.0}/nbdev/showdoc.py

@@ -34,10 +34,12 @@ class BasicMarkdownRenderer(MarkdownRenderer):
         return doc+super()._repr_markdown_()
 
 # %% ../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`
-             title_level:int=3):  # Heading level to use for symbol name
+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

{nbdev-3.0.18 → nbdev-3.2.0}/nbdev/test.py

@@ -25,48 +25,60 @@ from fastcore.nbio import *
 from execnb.shell import *
 
 # %% ../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
-            do_print=False,  # print completion?
-            showerr=True,  # print errors to stderr?
-            basepath=None,  # path to add to sys.path
-            verbose=False,  # stream stdout/stderr from cells to console?
-            save=False):  # write outputs back to notebook on success?
+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
+    do_print=False,  # print completion?
+    showerr=True,  # print errors to stderr?
+    basepath=None,  # path to add to sys.path
+    verbose=False,  # stream stdout/stderr from cells to console?
+    save=False,  # write outputs back to notebook on success?
+    profile:bool=None # load the IPython profile, as `ipykernel` does? (default: `exec_profile` config key)
+):
     "Execute tests in notebook in `fn` except those with `skip_flags`"
     faulthandler.register(signal.SIGINT, file=sys.__stderr__, all_threads=True, chain=True)
+    fn = Path(fn)
     if basepath: sys.path.insert(0, str(basepath))
-    if not IN_NOTEBOOK: os.environ["IN_TEST"] = '1'
-    flags=set(L(skip_flags)) - set(L(force_flags))
-    nb = NBProcessor(fn, rm_directives=False, process=True).nb
-    fm = nb_frontmatter(nb)
-    if str2bool(fm.get('skip_exec', False)) or nb_lang(nb) != 'python': return True, 0
-
-    def _no_eval(cell):
-        if cell.cell_type != 'code': return True
-        if 'nbdev_export'+'(' in cell.source: return True
-        direc = getattr(cell, 'directives_', {}) or {}
-        if direc.get('eval:', [''])[0].lower() == 'false': return True
-        return flags & direc.keys()
-    
-    start = time.time()
-    k = CaptureShell(fn)
-    if do_print: print(f'Starting {fn}')
+    prev_test = os.environ.get('IN_TEST')
+    if not IN_NOTEBOOK: os.environ['IN_TEST'] = '1'
     try:
-        with working_directory(fn.parent):
-            k.run_all(nb, exc_stop=True, preproc=_no_eval, verbose=verbose)
-            if save: write_nb(nb, fn)
-            res = True
-    except: 
-        if showerr: sys.stderr.write(k.prettytb(fname=fn)+'\n')
-        res=False
-    if do_print: print(f'- Completed {fn}')
-    return res,time.time()-start
+        flags=set(L(skip_flags)) - set(L(force_flags))
+        nb = NBProcessor(fn, rm_directives=False, process=True).nb
+        fm = nb_frontmatter(nb)
+        if str2bool(fm.get('skip_exec', False)) or nb_lang(nb) != 'python': return True, 0
+
+        def _no_eval(cell):
+            if cell.cell_type != 'code': return True
+            if 'nbdev_export'+'(' in cell.source: return True
+            direc = getattr(cell, 'directives_', {}) or {}
+            if direc.get('eval:', [''])[0].lower() == 'false': return True
+            return flags & direc.keys()
+
+        start = time.time()
+        if profile is None: profile = bool(get_config(fn.parent).exec_profile)
+        k = CaptureShell(fn, profile=profile)
+        if do_print: print(f'Starting {fn}')
+        try:
+            with working_directory(fn.parent):
+                k.run_all(nb, exc_stop=True, preproc=_no_eval, verbose=verbose)
+                if save: write_nb(nb, fn)
+                res = True
+        except: 
+            if showerr: sys.stderr.write(k.prettytb(fname=fn)+'\n')
+            res=False
+        if do_print: print(f'- Completed {fn}')
+        return res,time.time()-start
+    finally:
+        if prev_test is None: os.environ.pop('IN_TEST', None)
+        else: os.environ['IN_TEST'] = prev_test
+
 
 # %% ../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:
+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:
     "Returns False if `indicator_fname` is a sibling to `fname` else True"
     if p.exists(): return not bool(p.parent.ls().attrgot('name').filter(lambda x: x == ignore_fname))
     else: True
@@ -84,9 +96,11 @@ def nbdev_test(
     ignore_fname:str='.notest', # Filename that will result in siblings being ignored
     verbose:bool=False, # Print stdout/stderr from notebook cells?
     save:bool=False, # Write outputs back to notebooks on success?
-    **kwargs):
+    **kwargs
+):
     "Test in parallel notebooks matching `path`, passing along `flags`"
-    skip_flags = get_config().tst_flags
+    cfg = get_config(Path(path).resolve() if path else None)
+    skip_flags = cfg.tst_flags
     if isinstance(skip_flags, str): skip_flags = skip_flags.split()
     force_flags = flags.split()
     files = nbglob(path, as_path=True, **kwargs)
@@ -96,10 +110,10 @@ def nbdev_test(
     if n_workers is None: n_workers = 0 if len(files)==1 else min(num_cpus(), 8)
     if IN_NOTEBOOK: kw = {'method':'spawn'} if os.name=='nt' else {'method':'forkserver'}
     else: kw = {'method':'forkserver'} if sys.platform=='darwin' else {}
-    wd_pth = get_config().nbs_path
+    wd_pth = cfg.nbs_path
     with working_directory(wd_pth if (wd_pth and wd_pth.exists()) else os.getcwd()):
         results = parallel(test_nb, files, skip_flags=skip_flags, force_flags=force_flags, n_workers=n_workers,
-                           basepath=get_config().config_path, pause=pause, do_print=do_print, verbose=verbose, save=save, **kw)
+                           basepath=cfg.config_path, pause=pause, do_print=do_print, verbose=verbose, save=save, **kw)
     passed,times = zip(*results)
     if all(passed): print("Success.")
     else: 

{nbdev-3.0.18 → nbdev-3.2.0/nbdev.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nbdev
-Version: 3.0.18
+Version: 3.2.0
 Summary: Create delightful software with Jupyter Notebooks
 Author-email: "Jeremy Howard and the fast.ai community" <j@fast.ai>
 License: Apache-2.0
@@ -16,10 +16,10 @@ Classifier: License :: OSI Approved :: Apache Software License
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: fastcore>=1.12.35
-Requires-Dist: execnb>=0.1.12
+Requires-Dist: fastcore>=1.14.6
+Requires-Dist: execnb>=0.2.4
 Requires-Dist: astunparse
-Requires-Dist: ghapi>=1.0.3
+Requires-Dist: ghapi>=2.0.0
 Requires-Dist: watchdog
 Requires-Dist: asttokens
 Requires-Dist: setuptools
@@ -158,7 +158,7 @@ available commands:
     nbdev-pypi                Create and upload Python package to PyPI
     nbdev-readme              Create README.md from readme_nb (index.ipynb by default)
     nbdev-release-both        Release both conda and PyPI packages
-    nbdev-release-gh          Calls `nbdev_changelog`, lets you edit the result, then pushes to git and calls `nbdev_release_git`
+    nbdev-release-gh          Calls `nbdev-changelog`, lets you edit the result, then pushes to git and calls `nbdev-release-git`
     nbdev-release-git         Tag and create a release in GitHub for the current version
     nbdev-requirements        Writes a `requirements.txt` file to `directory` based on pyproject.toml.
     nbdev-sidebar             Create sidebar.yml
@@ -184,6 +184,9 @@ some_module.something()
 Instead, split this into two cells, one which does `import some_module`,
 and the other which does `some_module.something()`.
 
+Only top-level statements count: `try: import` blocks and imports inside
+function definitions are fine.
+
 The reason for this is that when we create your documentation website,
 we ensure that all of the signatures for functions you document are up
 to date, by running the imports, exported cells, and

{nbdev-3.0.18 → nbdev-3.2.0}/nbdev.egg-info/requires.txt

@@ -1,7 +1,7 @@
-fastcore>=1.12.35
-execnb>=0.1.12
+fastcore>=1.14.6
+execnb>=0.2.4
 astunparse
-ghapi>=1.0.3
+ghapi>=2.0.0
 watchdog
 asttokens
 setuptools

{nbdev-3.0.18 → nbdev-3.2.0}/pyproject.toml

@@ -19,7 +19,7 @@ classifiers = [
     "License :: OSI Approved :: Apache Software License",
 ]
 dynamic = ["version"]
-dependencies = [ "fastcore>=1.12.35", "execnb>=0.1.12", "astunparse", "ghapi>=1.0.3", "watchdog", "asttokens",
+dependencies = [ "fastcore>=1.14.6", "execnb>=0.2.4", "astunparse", "ghapi>=2.0.0", "watchdog", "asttokens",
     "setuptools", "build", "fastgit", "pyyaml", "tomli; python_version < '3.11'", ]
 
 [project.optional-dependencies]
@@ -82,3 +82,6 @@ readme_nb = "getting_started.ipynb"
 jupyter_hooks = true
 allowed_cell_metadata_keys = ['solveit_ai']
 
+
+[tool.chkstyle]
+skip_paths = ["_modidx.py"]