nbdev 3.1.0__tar.gz → 3.2.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nbdev
-Version: 3.1.0
+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,7 +16,7 @@ Classifier: License :: OSI Approved :: Apache Software License
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: fastcore>=1.14.1
+Requires-Dist: fastcore>=1.14.6
 Requires-Dist: execnb>=0.2.4
 Requires-Dist: astunparse
 Requires-Dist: ghapi>=2.0.0
@@ -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.1.0 → 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.1.0 → nbdev-3.2.0}/nbdev/__init__.py

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

{nbdev-3.1.0 → 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'),
@@ -287,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'),

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

@@ -169,18 +169,21 @@ async 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.1.0 → nbdev-3.2.0}/nbdev/config.py

@@ -236,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()
@@ -265,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.1.0 → 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.1.0 → nbdev-3.2.0}/nbdev/merge.py

@@ -60,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.1.0 → 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.1.0 → nbdev-3.2.0}/nbdev/processors.py

@@ -182,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)
@@ -223,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
@@ -233,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

{nbdev-3.1.0 → 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.1.0 → nbdev-3.2.0}/nbdev/quarto.py

@@ -249,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
@@ -272,6 +277,8 @@ def nbdev_readme(
 
     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.1.0 → 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.1.0 → nbdev-3.2.0}/nbdev/test.py

@@ -25,15 +25,17 @@ 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?
-            profile:bool=None):  # load the IPython profile, as `ipykernel` does? (default: `exec_profile` config key)
+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)
@@ -73,9 +75,10 @@ def test_nb(fn,  # file name of notebook to 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
@@ -93,7 +96,8 @@ 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`"
     cfg = get_config(Path(path).resolve() if path else None)
     skip_flags = cfg.tst_flags

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nbdev
-Version: 3.1.0
+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,7 +16,7 @@ Classifier: License :: OSI Approved :: Apache Software License
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: fastcore>=1.14.1
+Requires-Dist: fastcore>=1.14.6
 Requires-Dist: execnb>=0.2.4
 Requires-Dist: astunparse
 Requires-Dist: ghapi>=2.0.0
@@ -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.1.0 → nbdev-3.2.0}/nbdev.egg-info/requires.txt

@@ -1,4 +1,4 @@
-fastcore>=1.14.1
+fastcore>=1.14.6
 execnb>=0.2.4
 astunparse
 ghapi>=2.0.0

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

@@ -19,7 +19,7 @@ classifiers = [
     "License :: OSI Approved :: Apache Software License",
 ]
 dynamic = ["version"]
-dependencies = [ "fastcore>=1.14.1", "execnb>=0.2.4", "astunparse", "ghapi>=2.0.0", "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]