nbdev 2.4.9__tar.gz → 3.0.6__tar.gz

{nbdev-2.4.9 → nbdev-3.0.6}/CONTRIBUTING.md

@@ -2,11 +2,21 @@
 
 ## How to get started
 
-Before anything else, please install the git hooks that run automatic scripts during each commit and merge to strip the notebooks of superfluous metadata (and avoid merge conflicts). After cloning the repository, run the following command inside it:
+Install nbdev in editable mode with development dependencies:
+```sh
+pip install -e '.[dev]'
 ```
+
+Before anything else, please install the git hooks that run automatic scripts during each commit and merge to strip the notebooks of superfluous metadata (and avoid merge conflicts). After cloning the repository, run the following command inside it:
+```sh
 nbdev_install_hooks
 ```
 
+Run the test suite to ensure everything is working:
+```sh
+nbdev_test
+```
+
 ## Did you find a bug?
 
 * Ensure the bug was not already reported by searching on GitHub under Issues.

{nbdev-2.4.9/nbdev.egg-info → nbdev-3.0.6}/PKG-INFO

@@ -1,26 +1,22 @@
 Metadata-Version: 2.4
 Name: nbdev
-Version: 2.4.9
+Version: 3.0.6
 Summary: Create delightful software with Jupyter Notebooks
-Home-page: https://github.com/AnswerDotAI/nbdev
-Author: Jeremy Howard and Hamel Husain
-Author-email: j@fast.ai
-License: Apache Software License 2.0
+Author-email: "Jeremy Howard and the fast.ai community" <j@fast.ai>
+License: Apache-2.0
+Project-URL: Repository, https://github.com/AnswerDotAI/nbdev
 Project-URL: Documentation, https://nbdev.fast.ai/
-Keywords: nbdev fastai jupyter notebook export
+Keywords: nbdev,fastai,jupyter,notebook,export
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Natural Language :: English
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: License :: OSI Approved :: Apache Software License
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: packaging
-Requires-Dist: fastcore>=1.11.0
+Requires-Dist: fastcore>=1.12.3
 Requires-Dist: execnb>=0.1.12
 Requires-Dist: astunparse
 Requires-Dist: ghapi>=1.0.3
@@ -29,7 +25,8 @@ Requires-Dist: asttokens
 Requires-Dist: setuptools
 Requires-Dist: build
 Requires-Dist: fastgit
-Requires-Dist: PyYAML
+Requires-Dist: pyyaml
+Requires-Dist: tomli; python_version < "3.11"
 Provides-Extra: dev
 Requires-Dist: ipywidgets; extra == "dev"
 Requires-Dist: nbdev-numpy; extra == "dev"
@@ -43,20 +40,7 @@ Requires-Dist: pysymbol_llm; extra == "dev"
 Requires-Dist: llms-txt; extra == "dev"
 Requires-Dist: sphinx; extra == "dev"
 Requires-Dist: plum-dispatch; extra == "dev"
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: keywords
-Dynamic: license
 Dynamic: license-file
-Dynamic: project-url
-Dynamic: provides-extra
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
 
 # Getting Started
 
@@ -65,6 +49,22 @@ Dynamic: summary
 
 ![CI](https://github.com/fastai/nbdev/actions/workflows/test.yaml/badge.svg)
 
+## 🛑**Jan 2026 Major Version Update – Breaking Change**🛑
+
+**nbdev3 is here!** As many of you have been requesting, configuration
+has moved from `settings.ini` to `pyproject.toml`, following modern
+Python packaging standards ([PEP
+621](https://peps.python.org/pep-0621/)). Your project metadata now
+lives in the standard `[project]` section, while nbdev-specific settings
+go in `[tool.nbdev]`.
+
+**Migrating from nbdev2:** Run
+[`nbdev_migrate_config`](https://nbdev.fast.ai/api/migrate.html#nbdev_migrate_config)
+in your project root to automatically convert your `settings.ini` to
+`pyproject.toml` and update your GitHub Actions workflows to use
+nbdev3-compatible versions. Your existing notebooks and code don’t need
+any changes.
+
 `nbdev` is a notebook-driven development platform. Simply write
 notebooks with lightweight markup and get high-quality documentation,
 tests, continuous integration, and packaging for free!
@@ -84,7 +84,10 @@ practices because tests and documentation are first class.
   package releases. Python best practices are automatically followed,
   for example, only exported objects are included in `__all__`
 - **Two-way sync between notebooks and plaintext source code** allowing
-  you to use your IDE for code navigation or quick edits
+  you to use your IDE for code navigation or quick edits. Sync is
+  robust: each exported cell is tagged with its unique notebook cell ID,
+  so [`nbdev_update`](https://nbdev.fast.ai/api/sync.html#nbdev_update)
+  always updates the correct cell
 - **Tests** written as ordinary notebook cells are run in parallel with
   a single command
 - **Continuous integration** out-of-the-box with [GitHub
@@ -107,12 +110,6 @@ You can install nbdev with pip:
 pip install nbdev
 ```
 
-… or with conda (or mamba):
-
-``` sh
-conda install -c fastai nbdev
-```
-
 Note that `nbdev` must be installed into the same Python environment
 that you use for both Jupyter and your project.
 
@@ -139,11 +136,13 @@ available commands:
 !nbdev_help
 ```
 
-    nbdev_bump_version        Increment version in settings.ini by one
+    nb_export                 Export a single nbdev notebook to a python script.
+    nbdev_bump_version        Increment version in __init__.py by one
     nbdev_changelog           Create a CHANGELOG.md file from closed and labeled GitHub issues
     nbdev_clean               Clean all notebooks in `fname` to avoid merge conflicts
     nbdev_conda               Create a `meta.yaml` file ready to be built into a package, and optionally build and upload it
-    nbdev_create_config       Create a config file.
+    nbdev_contributing        Create CONTRIBUTING.md from contributing_nb (defaults to 'contributing.ipynb' if present). Skips if the file doesn't exist.
+    nbdev_create_config       Create a pyproject.toml config file.
     nbdev_docs                Create Quarto docs and README.md
     nbdev_export              Export notebooks in `path` to Python modules
     nbdev_filter              A notebook filter for Quarto
@@ -154,6 +153,7 @@ available commands:
     nbdev_install_quarto      Install latest Quarto on macOS or Linux, prints instructions for Windows
     nbdev_merge               Git merge driver for notebooks
     nbdev_migrate             Convert all markdown and notebook files in `path` from v1 to v2
+    nbdev_migrate_config      Migrate settings.ini to pyproject.toml
     nbdev_new                 Create an nbdev project.
     nbdev_prepare             Export, test, and clean notebooks, and render README if needed
     nbdev_preview             Preview docs locally
@@ -163,12 +163,13 @@ available commands:
     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_git         Tag and create a release in GitHub for the current version
-    nbdev_requirements        Writes a `requirements.txt` file to `directory` based on settings.ini.
+    nbdev_requirements        Writes a `requirements.txt` file to `directory` based on pyproject.toml.
     nbdev_sidebar             Create sidebar.yml
     nbdev_test                Test in parallel notebooks matching `path`, passing along `flags`
-    nbdev_trust               Trust notebooks matching `fname`
+    nbdev_trust               Trust notebooks matching `fname`.
     nbdev_update              Propagate change in modules matching `fname` to notebooks that created them
     nbdev_update_license      Allows you to update the license of your project.
+    watch_export              Use `nb_export` on ipynb files in `nbs` directory on changes using nbdev config if available
 
 ## FAQ
 

{nbdev-2.4.9 → nbdev-3.0.6}/README.md

@@ -5,6 +5,22 @@
 
 ![CI](https://github.com/fastai/nbdev/actions/workflows/test.yaml/badge.svg)
 
+## 🛑**Jan 2026 Major Version Update – Breaking Change**🛑
+
+**nbdev3 is here!** As many of you have been requesting, configuration
+has moved from `settings.ini` to `pyproject.toml`, following modern
+Python packaging standards ([PEP
+621](https://peps.python.org/pep-0621/)). Your project metadata now
+lives in the standard `[project]` section, while nbdev-specific settings
+go in `[tool.nbdev]`.
+
+**Migrating from nbdev2:** Run
+[`nbdev_migrate_config`](https://nbdev.fast.ai/api/migrate.html#nbdev_migrate_config)
+in your project root to automatically convert your `settings.ini` to
+`pyproject.toml` and update your GitHub Actions workflows to use
+nbdev3-compatible versions. Your existing notebooks and code don’t need
+any changes.
+
 `nbdev` is a notebook-driven development platform. Simply write
 notebooks with lightweight markup and get high-quality documentation,
 tests, continuous integration, and packaging for free!
@@ -24,7 +40,10 @@ practices because tests and documentation are first class.
   package releases. Python best practices are automatically followed,
   for example, only exported objects are included in `__all__`
 - **Two-way sync between notebooks and plaintext source code** allowing
-  you to use your IDE for code navigation or quick edits
+  you to use your IDE for code navigation or quick edits. Sync is
+  robust: each exported cell is tagged with its unique notebook cell ID,
+  so [`nbdev_update`](https://nbdev.fast.ai/api/sync.html#nbdev_update)
+  always updates the correct cell
 - **Tests** written as ordinary notebook cells are run in parallel with
   a single command
 - **Continuous integration** out-of-the-box with [GitHub
@@ -47,12 +66,6 @@ You can install nbdev with pip:
 pip install nbdev
 ```
 
-… or with conda (or mamba):
-
-``` sh
-conda install -c fastai nbdev
-```
-
 Note that `nbdev` must be installed into the same Python environment
 that you use for both Jupyter and your project.
 
@@ -79,11 +92,13 @@ available commands:
 !nbdev_help
 ```
 
-    nbdev_bump_version        Increment version in settings.ini by one
+    nb_export                 Export a single nbdev notebook to a python script.
+    nbdev_bump_version        Increment version in __init__.py by one
     nbdev_changelog           Create a CHANGELOG.md file from closed and labeled GitHub issues
     nbdev_clean               Clean all notebooks in `fname` to avoid merge conflicts
     nbdev_conda               Create a `meta.yaml` file ready to be built into a package, and optionally build and upload it
-    nbdev_create_config       Create a config file.
+    nbdev_contributing        Create CONTRIBUTING.md from contributing_nb (defaults to 'contributing.ipynb' if present). Skips if the file doesn't exist.
+    nbdev_create_config       Create a pyproject.toml config file.
     nbdev_docs                Create Quarto docs and README.md
     nbdev_export              Export notebooks in `path` to Python modules
     nbdev_filter              A notebook filter for Quarto
@@ -94,6 +109,7 @@ available commands:
     nbdev_install_quarto      Install latest Quarto on macOS or Linux, prints instructions for Windows
     nbdev_merge               Git merge driver for notebooks
     nbdev_migrate             Convert all markdown and notebook files in `path` from v1 to v2
+    nbdev_migrate_config      Migrate settings.ini to pyproject.toml
     nbdev_new                 Create an nbdev project.
     nbdev_prepare             Export, test, and clean notebooks, and render README if needed
     nbdev_preview             Preview docs locally
@@ -103,12 +119,13 @@ available commands:
     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_git         Tag and create a release in GitHub for the current version
-    nbdev_requirements        Writes a `requirements.txt` file to `directory` based on settings.ini.
+    nbdev_requirements        Writes a `requirements.txt` file to `directory` based on pyproject.toml.
     nbdev_sidebar             Create sidebar.yml
     nbdev_test                Test in parallel notebooks matching `path`, passing along `flags`
-    nbdev_trust               Trust notebooks matching `fname`
+    nbdev_trust               Trust notebooks matching `fname`.
     nbdev_update              Propagate change in modules matching `fname` to notebooks that created them
     nbdev_update_license      Allows you to update the license of your project.
+    watch_export              Use `nb_export` on ipynb files in `nbs` directory on changes using nbdev config if available
 
 ## FAQ
 

{nbdev-2.4.9 → nbdev-3.0.6}/nbdev/__init__.py

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

{nbdev-2.4.9 → nbdev-3.0.6}/nbdev/_modidx.py

@@ -28,23 +28,31 @@ d = { 'settings': { 'branch': 'main',
                            'nbdev.cli.nbdev_new': ('api/cli.html#nbdev_new', 'nbdev/cli.py'),
                            'nbdev.cli.nbdev_update_license': ('api/cli.html#nbdev_update_license', 'nbdev/cli.py'),
                            'nbdev.cli.watch_export': ('api/cli.html#watch_export', 'nbdev/cli.py')},
-            'nbdev.config': { 'nbdev.config._apply_defaults': ('api/config.html#_apply_defaults', 'nbdev/config.py'),
+            'nbdev.config': { 'nbdev.config.ConfigToml': ('api/config.html#configtoml', 'nbdev/config.py'),
+                              'nbdev.config.ConfigToml.__getattr__': ('api/config.html#configtoml.__getattr__', 'nbdev/config.py'),
+                              'nbdev.config.ConfigToml.__getitem__': ('api/config.html#configtoml.__getitem__', 'nbdev/config.py'),
+                              'nbdev.config.ConfigToml.__init__': ('api/config.html#configtoml.__init__', 'nbdev/config.py'),
+                              'nbdev.config.ConfigToml.d': ('api/config.html#configtoml.d', 'nbdev/config.py'),
+                              'nbdev.config.ConfigToml.get': ('api/config.html#configtoml.get', 'nbdev/config.py'),
+                              'nbdev.config.ConfigToml.path': ('api/config.html#configtoml.path', 'nbdev/config.py'),
+                              'nbdev.config.ConfigToml.version': ('api/config.html#configtoml.version', 'nbdev/config.py'),
                               'nbdev.config._basic_export_nb': ('api/config.html#_basic_export_nb', 'nbdev/config.py'),
-                              'nbdev.config._cfg2txt': ('api/config.html#_cfg2txt', 'nbdev/config.py'),
                               'nbdev.config._fetch_from_git': ('api/config.html#_fetch_from_git', 'nbdev/config.py'),
+                              'nbdev.config._find_nbdev_pyproject': ('api/config.html#_find_nbdev_pyproject', 'nbdev/config.py'),
                               'nbdev.config._get_info': ('api/config.html#_get_info', 'nbdev/config.py'),
                               'nbdev.config._git_repo': ('api/config.html#_git_repo', 'nbdev/config.py'),
+                              'nbdev.config._has_nbdev': ('api/config.html#_has_nbdev', 'nbdev/config.py'),
                               'nbdev.config._has_py': ('api/config.html#_has_py', 'nbdev/config.py'),
-                              'nbdev.config._nbdev_config_file': ('api/config.html#_nbdev_config_file', 'nbdev/config.py'),
-                              'nbdev.config._prompt_user': ('api/config.html#_prompt_user', 'nbdev/config.py'),
-                              'nbdev.config._type': ('api/config.html#_type', 'nbdev/config.py'),
-                              'nbdev.config._xdg_config_paths': ('api/config.html#_xdg_config_paths', 'nbdev/config.py'),
+                              'nbdev.config._load_toml': ('api/config.html#_load_toml', 'nbdev/config.py'),
+                              'nbdev.config._user_config': ('api/config.html#_user_config', 'nbdev/config.py'),
                               'nbdev.config.add_init': ('api/config.html#add_init', 'nbdev/config.py'),
-                              'nbdev.config.config_key': ('api/config.html#config_key', 'nbdev/config.py'),
+                              'nbdev.config.bump_version': ('api/config.html#bump_version', 'nbdev/config.py'),
                               'nbdev.config.create_output': ('api/config.html#create_output', 'nbdev/config.py'),
                               'nbdev.config.get_config': ('api/config.html#get_config', 'nbdev/config.py'),
                               'nbdev.config.is_nbdev': ('api/config.html#is_nbdev', 'nbdev/config.py'),
                               'nbdev.config.nbdev_create_config': ('api/config.html#nbdev_create_config', 'nbdev/config.py'),
+                              'nbdev.config.read_version': ('api/config.html#read_version', 'nbdev/config.py'),
+                              'nbdev.config.set_version': ('api/config.html#set_version', 'nbdev/config.py'),
                               'nbdev.config.show_src': ('api/config.html#show_src', 'nbdev/config.py'),
                               'nbdev.config.update_proj': ('api/config.html#update_proj', 'nbdev/config.py'),
                               'nbdev.config.update_version': ('api/config.html#update_version', 'nbdev/config.py'),
@@ -145,15 +153,20 @@ d = { 'settings': { 'branch': 'main',
                              'nbdev.merge.unpatch': ('api/merge.html#unpatch', 'nbdev/merge.py')},
             'nbdev.migrate': { 'nbdev.migrate.MigrateProc': ('api/migrate.html#migrateproc', 'nbdev/migrate.py'),
                                'nbdev.migrate.MigrateProc.begin': ('api/migrate.html#migrateproc.begin', 'nbdev/migrate.py'),
+                               'nbdev.migrate._build_classifiers': ('api/migrate.html#_build_classifiers', 'nbdev/migrate.py'),
                                'nbdev.migrate._cat_slug': ('api/migrate.html#_cat_slug', 'nbdev/migrate.py'),
                                'nbdev.migrate._co': ('api/migrate.html#_co', 'nbdev/migrate.py'),
                                'nbdev.migrate._convert_callout': ('api/migrate.html#_convert_callout', 'nbdev/migrate.py'),
                                'nbdev.migrate._convert_video': ('api/migrate.html#_convert_video', 'nbdev/migrate.py'),
                                'nbdev.migrate._file_slug': ('api/migrate.html#_file_slug', 'nbdev/migrate.py'),
+                               'nbdev.migrate._fmt_script': ('api/migrate.html#_fmt_script', 'nbdev/migrate.py'),
                                'nbdev.migrate._fp_convert': ('api/migrate.html#_fp_convert', 'nbdev/migrate.py'),
                                'nbdev.migrate._fp_fm': ('api/migrate.html#_fp_fm', 'nbdev/migrate.py'),
                                'nbdev.migrate._fp_image': ('api/migrate.html#_fp_image', 'nbdev/migrate.py'),
                                'nbdev.migrate._is_jekyll_post': ('api/migrate.html#_is_jekyll_post', 'nbdev/migrate.py'),
+                               'nbdev.migrate._migrate_workflows': ('api/migrate.html#_migrate_workflows', 'nbdev/migrate.py'),
+                               'nbdev.migrate._nbdev_migrate_config': ('api/migrate.html#_nbdev_migrate_config', 'nbdev/migrate.py'),
+                               'nbdev.migrate._py_val': ('api/migrate.html#_py_val', 'nbdev/migrate.py'),
                                'nbdev.migrate._re_v1': ('api/migrate.html#_re_v1', 'nbdev/migrate.py'),
                                'nbdev.migrate._repl_directives': ('api/migrate.html#_repl_directives', 'nbdev/migrate.py'),
                                'nbdev.migrate._repl_v1dir': ('api/migrate.html#_repl_v1dir', 'nbdev/migrate.py'),
@@ -161,11 +174,13 @@ d = { 'settings': { 'branch': 'main',
                                'nbdev.migrate._replace_fm': ('api/migrate.html#_replace_fm', 'nbdev/migrate.py'),
                                'nbdev.migrate._rm_quote': ('api/migrate.html#_rm_quote', 'nbdev/migrate.py'),
                                'nbdev.migrate._subv1': ('api/migrate.html#_subv1', 'nbdev/migrate.py'),
+                               'nbdev.migrate._toml_val': ('api/migrate.html#_toml_val', 'nbdev/migrate.py'),
                                'nbdev.migrate._v': ('api/migrate.html#_v', 'nbdev/migrate.py'),
                                'nbdev.migrate.fp_md_fm': ('api/migrate.html#fp_md_fm', 'nbdev/migrate.py'),
                                'nbdev.migrate.migrate_md': ('api/migrate.html#migrate_md', 'nbdev/migrate.py'),
                                'nbdev.migrate.migrate_nb': ('api/migrate.html#migrate_nb', 'nbdev/migrate.py'),
-                               'nbdev.migrate.nbdev_migrate': ('api/migrate.html#nbdev_migrate', 'nbdev/migrate.py')},
+                               'nbdev.migrate.nbdev_migrate': ('api/migrate.html#nbdev_migrate', 'nbdev/migrate.py'),
+                               'nbdev.migrate.nbdev_migrate_config': ('api/migrate.html#nbdev_migrate_config', 'nbdev/migrate.py')},
             'nbdev.process': { 'nbdev.process.NBProcessor': ('api/process.html#nbprocessor', 'nbdev/process.py'),
                                'nbdev.process.NBProcessor.__init__': ('api/process.html#nbprocessor.__init__', 'nbdev/process.py'),
                                'nbdev.process.NBProcessor._proc': ('api/process.html#nbprocessor._proc', 'nbdev/process.py'),
@@ -303,12 +318,12 @@ d = { 'settings': { 'branch': 'main',
                                'nbdev.release._run': ('api/release.html#_run', 'nbdev/release.py'),
                                'nbdev.release._write_yaml': ('api/release.html#_write_yaml', 'nbdev/release.py'),
                                'nbdev.release.anaconda_upload': ('api/release.html#anaconda_upload', 'nbdev/release.py'),
-                               'nbdev.release.bump_version': ('api/release.html#bump_version', 'nbdev/release.py'),
                                'nbdev.release.changelog': ('api/release.html#changelog', 'nbdev/release.py'),
                                'nbdev.release.chk_conda_rel': ('api/release.html#chk_conda_rel', 'nbdev/release.py'),
                                'nbdev.release.conda_output_path': ('api/release.html#conda_output_path', 'nbdev/release.py'),
                                'nbdev.release.latest_pypi': ('api/release.html#latest_pypi', 'nbdev/release.py'),
                                'nbdev.release.nbdev_bump_version': ('api/release.html#nbdev_bump_version', 'nbdev/release.py'),
+                               'nbdev.release.push_release': ('api/release.html#push_release', 'nbdev/release.py'),
                                'nbdev.release.pypi_details': ('api/release.html#pypi_details', 'nbdev/release.py'),
                                'nbdev.release.pypi_json': ('api/release.html#pypi_json', 'nbdev/release.py'),
                                'nbdev.release.release_both': ('api/release.html#release_both', 'nbdev/release.py'),
@@ -322,16 +337,10 @@ d = { 'settings': { 'branch': 'main',
                              'nbdev.serve._proc_file': ('api/serve.html#_proc_file', 'nbdev/serve.py'),
                              'nbdev.serve.proc_nbs': ('api/serve.html#proc_nbs', 'nbdev/serve.py')},
             'nbdev.serve_drv': {},
-            'nbdev.showdoc': { 'nbdev.showdoc.BasicHtmlRenderer': ('api/showdoc.html#basichtmlrenderer', 'nbdev/showdoc.py'),
-                               'nbdev.showdoc.BasicHtmlRenderer._repr_html_': ( 'api/showdoc.html#basichtmlrenderer._repr_html_',
-                                                                                'nbdev/showdoc.py'),
-                               'nbdev.showdoc.BasicHtmlRenderer.doc': ('api/showdoc.html#basichtmlrenderer.doc', 'nbdev/showdoc.py'),
-                               'nbdev.showdoc.BasicMarkdownRenderer': ('api/showdoc.html#basicmarkdownrenderer', 'nbdev/showdoc.py'),
+            'nbdev.showdoc': { 'nbdev.showdoc.BasicMarkdownRenderer': ('api/showdoc.html#basicmarkdownrenderer', 'nbdev/showdoc.py'),
                                'nbdev.showdoc.BasicMarkdownRenderer._repr_markdown_': ( 'api/showdoc.html#basicmarkdownrenderer._repr_markdown_',
                                                                                         'nbdev/showdoc.py'),
-                               'nbdev.showdoc._create_html_table': ('api/showdoc.html#_create_html_table', 'nbdev/showdoc.py'),
                                'nbdev.showdoc._ext_link': ('api/showdoc.html#_ext_link', 'nbdev/showdoc.py'),
-                               'nbdev.showdoc._html_link': ('api/showdoc.html#_html_link', 'nbdev/showdoc.py'),
                                'nbdev.showdoc.colab_link': ('api/showdoc.html#colab_link', 'nbdev/showdoc.py'),
                                'nbdev.showdoc.doc': ('api/showdoc.html#doc', 'nbdev/showdoc.py'),
                                'nbdev.showdoc.show_doc': ('api/showdoc.html#show_doc', 'nbdev/showdoc.py'),

{nbdev-2.4.9 → nbdev-3.0.6}/nbdev/clean.py

@@ -2,31 +2,31 @@
 
 # AUTOGENERATED! DO NOT EDIT! File to edit: ../nbs/api/11_clean.ipynb.
 
-# %% auto 0
+# %% auto #0
 __all__ = ['nbdev_trust', 'clean_nb', 'process_write', 'nbdev_clean', 'clean_jupyter', 'nbdev_install_hooks']
 
-# %% ../nbs/api/11_clean.ipynb
+# %% ../nbs/api/11_clean.ipynb #07637414
 import ast,warnings,stat
 from astunparse import unparse
 from textwrap import indent
 
 from execnb.nbio import *
 from fastcore.script import *
-from fastcore.basics import *
-from fastcore.imports import *
+from fastcore.utils import *
+from fastcore.xtras import *
 
 from .imports import *
 from .config import *
 from .sync import *
 from .process import first_code_ln
 
-# %% ../nbs/api/11_clean.ipynb
+# %% ../nbs/api/11_clean.ipynb #4259f92c
 @call_parse
 def nbdev_trust(
     fname:str=None,  # A notebook name or glob to trust
     force_all:bool=False  # Also trust notebooks that haven't changed
 ):
-    "Trust notebooks matching `fname`"
+    "Trust notebooks matching `fname`."
     try: from nbformat.sign import NotebookNotary
     except:
         import warnings
@@ -47,7 +47,7 @@ def nbdev_trust(
         if not NotebookNotary().check_signature(nb): NotebookNotary().sign(nb)
     check_fname.touch(exist_ok=True)
 
-# %% ../nbs/api/11_clean.ipynb
+# %% ../nbs/api/11_clean.ipynb #a2ba2b4c
 _repr_id_re = re.compile('(<.*?)( at 0x[0-9a-fA-F]+)(>)')
 
 _sub = partial(_repr_id_re.sub, r'\1\3')
@@ -57,7 +57,7 @@ def _skip_or_sub(x): return _sub(x) if "at 0x" in x else x
 def _clean_cell_output_id(lines):
     return _skip_or_sub(lines) if isinstance(lines,str) else [_skip_or_sub(o) for o in lines]
 
-# %% ../nbs/api/11_clean.ipynb
+# %% ../nbs/api/11_clean.ipynb #b4cde615
 def _clean_cell_output(cell, clean_ids):
     "Remove `cell` output execution count and optionally ids from text reprs"
     outputs = cell.get('outputs', [])
@@ -71,7 +71,7 @@ def _clean_cell_output(cell, clean_ids):
         if 'text' in o and clean_ids: o['text'] = _clean_cell_output_id(o['text'])
 #         o.get('metadata', {}).pop('tags', None)
 
-# %% ../nbs/api/11_clean.ipynb
+# %% ../nbs/api/11_clean.ipynb #2ba79c93
 def _clean_cell(cell, clear_all, allowed_metadata_keys, clean_ids):
     "Clean `cell` by removing superfluous metadata or everything except the input if `clear_all`"
     if 'execution_count' in cell: cell['execution_count'] = None
@@ -81,8 +81,9 @@ def _clean_cell(cell, clear_all, allowed_metadata_keys, clean_ids):
     if cell['source'] == ['']: cell['source'] = []
     cell['metadata'] = {} if clear_all else {
         k:v for k,v in cell['metadata'].items() if k in allowed_metadata_keys}
+    if 'id' not in cell: cell['id'] = rtoken_hex(4)
 
-# %% ../nbs/api/11_clean.ipynb
+# %% ../nbs/api/11_clean.ipynb #e8101222
 def clean_nb(
     nb, # The notebook to clean
     clear_all=False, # Remove all cell metadata and cell outputs?
@@ -99,13 +100,15 @@ def clean_nb(
     if nb.get('metadata', {}).get('kernelspec', {}).get('name', None):
         nb['metadata']['kernelspec']['display_name'] = nb["metadata"]["kernelspec"]["name"]
     nb['metadata'] = {k:v for k,v in nb['metadata'].items() if k in metadata_keys}
+    # Cell IDs were added in nbformat 4.5
+    if nb.get('nbformat') == 4 and nb.get('nbformat_minor', 0) < 5: nb['nbformat_minor'] = 5
 
-# %% ../nbs/api/11_clean.ipynb
+# %% ../nbs/api/11_clean.ipynb #604d83e6
 def _reconfigure(*strms):
     for s in strms:
         if hasattr(s,'reconfigure'): s.reconfigure(encoding='utf-8')
 
-# %% ../nbs/api/11_clean.ipynb
+# %% ../nbs/api/11_clean.ipynb #d251837f
 def process_write(warn_msg, proc_nb, f_in, f_out=None, disp=False):
     if not f_out: f_out = f_in
     if isinstance(f_in, (str,Path)): f_in = Path(f_in).open(encoding="utf-8")
@@ -118,16 +121,16 @@ def process_write(warn_msg, proc_nb, f_in, f_out=None, disp=False):
         warn(f'{warn_msg}')
         warn(e)
 
-# %% ../nbs/api/11_clean.ipynb
+# %% ../nbs/api/11_clean.ipynb #714357ce
 def _nbdev_clean(nb, path=None, clear_all=None):
     cfg = get_config(path=path)
     clear_all = clear_all or cfg.clear_all
-    allowed_metadata_keys = cfg.get("allowed_metadata_keys").split()
-    allowed_cell_metadata_keys = cfg.get("allowed_cell_metadata_keys").split()
+    allowed_metadata_keys = cfg.get("allowed_metadata_keys") or []
+    allowed_cell_metadata_keys = cfg.get("allowed_cell_metadata_keys") or []
     clean_nb(nb, clear_all, allowed_metadata_keys, allowed_cell_metadata_keys, cfg.clean_ids)
     if path: nbdev_trust.__wrapped__(path)
 
-# %% ../nbs/api/11_clean.ipynb
+# %% ../nbs/api/11_clean.ipynb #6af3b9d4
 @call_parse
 def nbdev_clean(
     fname:str=None, # A notebook name or glob to clean
@@ -143,15 +146,14 @@ def nbdev_clean(
     if fname is None: fname = get_config().nbs_path
     for f in globtastic(fname, file_glob='*.ipynb', skip_folder_re='^[_.]'): _write(f_in=f, disp=disp)
 
-# %% ../nbs/api/11_clean.ipynb
+# %% ../nbs/api/11_clean.ipynb #f84289fc
 def clean_jupyter(path, model, **kwargs):
     "Clean Jupyter `model` pre save to `path`"
     if not (model['type']=='notebook' and model['content']['nbformat']==4): return
-    get_config.cache_clear() # Allow config changes without restarting Jupyter
     jupyter_hooks = get_config(path=path).jupyter_hooks
     if jupyter_hooks: _nbdev_clean(model['content'], path=path)
 
-# %% ../nbs/api/11_clean.ipynb
+# %% ../nbs/api/11_clean.ipynb #b7c19563
 _pre_save_hook_src = '''
 def nbdev_clean_jupyter(**kwargs):
     try: from nbdev.clean import clean_jupyter
@@ -161,7 +163,7 @@ def nbdev_clean_jupyter(**kwargs):
 c.ContentsManager.pre_save_hook = nbdev_clean_jupyter'''.strip()
 _pre_save_hook_re = re.compile(r'c\.(File)?ContentsManager\.pre_save_hook')
 
-# %% ../nbs/api/11_clean.ipynb
+# %% ../nbs/api/11_clean.ipynb #fcb8df4b
 def _add_jupyter_hooks(src, path):
     if _pre_save_hook_src in src: return
     mod = ast.parse(src)
@@ -179,12 +181,12 @@ def _add_jupyter_hooks(src, path):
     if src: src+='\n\n'
     return src+_pre_save_hook_src
 
-# %% ../nbs/api/11_clean.ipynb
+# %% ../nbs/api/11_clean.ipynb #cc677e44
 def _git_root(): 
     try: return Path(run('git rev-parse --show-toplevel'))
     except OSError: return None
 
-# %% ../nbs/api/11_clean.ipynb
+# %% ../nbs/api/11_clean.ipynb #e6083614
 @call_parse
 def nbdev_install_hooks():
     "Install Jupyter and git hooks to automatically clean, trust, and fix merge conflicts in notebooks"