nbdev 3.2.0__tar.gz → 3.2.2__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nbdev
-Version: 3.2.0
+Version: 3.2.2
 Summary: Create delightful software with Jupyter Notebooks
 Author-email: "Jeremy Howard and the fast.ai community" <j@fast.ai>
 License: Apache-2.0
@@ -24,7 +24,7 @@ Requires-Dist: watchdog
 Requires-Dist: asttokens
 Requires-Dist: setuptools
 Requires-Dist: build
-Requires-Dist: fastgit
+Requires-Dist: fastgit>=0.0.7
 Requires-Dist: pyyaml
 Requires-Dist: tomli; python_version < "3.11"
 Provides-Extra: dev
@@ -36,7 +36,7 @@ Requires-Dist: matplotlib; extra == "dev"
 Requires-Dist: black; extra == "dev"
 Requires-Dist: svg.py; extra == "dev"
 Requires-Dist: nbclassic; extra == "dev"
-Requires-Dist: pysymbol_llm; extra == "dev"
+Requires-Dist: pysym2md>=0.0.6; extra == "dev"
 Requires-Dist: llms-txt; extra == "dev"
 Requires-Dist: sphinx; extra == "dev"
 Requires-Dist: plum-dispatch; extra == "dev"
@@ -51,55 +51,25 @@ Dynamic: license-file
 
 ## 🛑**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` 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!
-
-`nbdev` makes debugging and refactoring your code much easier than in
-traditional programming environments since you always have live objects
-at your fingertips. `nbdev` also promotes software engineering best
-practices because tests and documentation are first class.
-
-- **Documentation** is automatically generated using
-  [Quarto](https://quarto.org/) and hosted on [GitHub
-  Pages](https://pages.github.com/). Docs support LaTeX, are searchable,
-  and are automatically hyperlinked (including out-of-the-box support
-  for many packages via
-  [`nbdev-index`](https://github.com/fastai/nbdev-index))
-- **Publish packages to PyPI and conda** as well as tools to simplify
-  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. Sync is
-  robust: each exported cell is tagged with its unique notebook cell ID,
-  so `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
-  Actions](https://github.com/features/actions) that run your tests and
-  rebuild your docs
-- **Git-friendly notebooks** with [Jupyter/Git
-  hooks](https://nbdev.fast.ai/tutorials/git_friendly_jupyter.html) that
-  clean unwanted metadata and render merge conflicts in a human-readable
-  format
+**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` 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!
+
+`nbdev` makes debugging and refactoring your code much easier than in traditional programming environments since you always have live objects at your fingertips. `nbdev` also promotes software engineering best practices because tests and documentation are first class.
+
+- **Documentation** is automatically generated using [Quarto](https://quarto.org/) and hosted on [GitHub Pages](https://pages.github.com/). Docs support LaTeX, are searchable, and are automatically hyperlinked (including out-of-the-box support for many packages via [`nbdev-index`](https://github.com/fastai/nbdev-index))
+- **Publish packages to PyPI and conda** as well as tools to simplify 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. Sync is robust: each exported cell is tagged with its unique notebook cell ID, so `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 Actions](https://github.com/features/actions) that run your tests and rebuild your docs
+- **Git-friendly notebooks** with [Jupyter/Git hooks](https://nbdev.fast.ai/tutorials/git_friendly_jupyter.html) that clean unwanted metadata and render merge conflicts in a human-readable format
 - … and much more!
 
 ## Install
 
-nbdev works on macOS, Linux, and most Unix-style operating systems. It
-works on Windows under WSL, but not under cmd or Powershell.
+nbdev works on macOS, Linux, and most Unix-style operating systems. It works on Windows under WSL, but not under cmd or Powershell.
 
 You can install nbdev with pip:
 
@@ -107,27 +77,17 @@ You can install nbdev with pip:
 pip install nbdev
 ```
 
-Note that `nbdev` must be installed into the same Python environment
-that you use for both Jupyter and your project.
+Note that `nbdev` must be installed into the same Python environment that you use for both Jupyter and your project.
 
 ## How to use nbdev
 
-The best way to learn how to use nbdev is to complete either the
-[written walkthrough](https://nbdev.fast.ai/tutorials/tutorial.html) or
-video walkthrough:
+The best way to learn how to use nbdev is to complete either the [written walkthrough](https://nbdev.fast.ai/tutorials/tutorial.html) or video walkthrough:
 
-<a href="http://www.youtube.com/watch?v=l7zS8Ld4_iA" target="_blank"
-title="nbdev walkthrough"><img
-src="https://github.com/fastai/logos/raw/main/nbdev_walkthrough.png"
-style="border-radius: 10px" width="560" height="315" /></a>
+<a href="http://www.youtube.com/watch?v=l7zS8Ld4_iA" target="_blank" title="nbdev walkthrough"><img src="https://github.com/fastai/logos/raw/main/nbdev_walkthrough.png" style="border-radius: 10px" width="560" height="315" /></a>
 
-Alternatively, there’s a [shortened version of the video
-walkthrough](https://youtu.be/67FdzLSt4aA) with coding sections sped up
-using the `unsilence` Python library – it’s 27 minutes faster, but a bit
-harder to follow.
+Alternatively, there’s a [shortened version of the video walkthrough](https://youtu.be/67FdzLSt4aA) with coding sections sped up using the `unsilence` Python library – it’s 27 minutes faster, but a bit harder to follow.
 
-You can also run `nbdev-help` from the terminal to see the full list of
-available commands:
+You can also run `nbdev-help` from the terminal to see the full list of available commands:
 
 ``` python
 !nbdev-help
@@ -172,45 +132,26 @@ available commands:
 
 ### Q: What is the warning “Found a cell containing mix of imports and computations. Please use separate cells”?
 
-A: You should not have cells that are not exported, *and* contain a mix
-of `import` statements along with other code. For instance, don’t do
-this in a single cell:
+A: You should not have cells that are not exported, *and* contain a mix of `import` statements along with other code. For instance, don’t do this in a single cell:
 
 ``` python
 import some_module
 some_module.something()
 ```
 
-Instead, split this into two cells, one which does `import some_module`,
-and the other which does `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.
+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
-[`show_doc`](https://nbdev.fast.ai/api/showdoc.html#show_doc) functions
-in your notebooks. When you mix imports with other code, that other code
-will be run too, which can cause errors (or at least slowdowns) when
-creating your website.
+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 [`show_doc`](https://nbdev.fast.ai/api/showdoc.html#show_doc) functions in your notebooks. When you mix imports with other code, that other code will be run too, which can cause errors (or at least slowdowns) when creating your website.
 
 ### Q: Why is nbdev asking for root access? How do I install Quarto without root access?
 
-A: When you setup your first project, nbdev will attempt to
-automatically download and install [Quarto](https://quarto.org/) for
-you. This is the program that we use to create your documentation
-website.
+A: When you setup your first project, nbdev will attempt to automatically download and install [Quarto](https://quarto.org/) for you. This is the program that we use to create your documentation website.
 
-Quarto’s standard installation process requires root access, and nbdev
-will therefore ask for your root password during installation. For most
-people, this will work fine and everything will be handled automatically
-– if so, you can skip over the rest of this section, which talks about
-installing without root access.
+Quarto’s standard installation process requires root access, and nbdev will therefore ask for your root password during installation. For most people, this will work fine and everything will be handled automatically – if so, you can skip over the rest of this section, which talks about installing without root access.
 
-If you need to install Quarto without root access on Linux, first `cd`
-to wherever you want to store it, then [download
-Quarto](https://quarto.org/docs/get-started/), and type:
+If you need to install Quarto without root access on Linux, first `cd` to wherever you want to store it, then [download Quarto](https://quarto.org/docs/get-started/), and type:
 
 ``` bash
 dpkg -x quarto*.deb .
@@ -220,39 +161,18 @@ mkdir -p ~/.local/bin
 ln -s "$(pwd)"/quarto/bin/quarto ~/.local/bin
 ```
 
-To use this non-root version of Quarto, you’ll need `~/.local/bin` in
-your [`PATH` environment
-variable](https://linuxize.com/post/how-to-add-directory-to-path-in-linux/).
-(Alternatively, change the `ln -s` step to place the symlink somewhere
-else in your path.)
+To use this non-root version of Quarto, you’ll need `~/.local/bin` in your [`PATH` environment variable](https://linuxize.com/post/how-to-add-directory-to-path-in-linux/). (Alternatively, change the `ln -s` step to place the symlink somewhere else in your path.)
 
 ### Q: Someone told me not to use notebooks for “serious” software development!
 
-A: [Watch this video](https://youtu.be/9Q6sLbz37gk). Don’t worry, we
-still get this too, despite having used `nbdev` for a wide range of
-“very serious” software projects over the last three years, including
-[deep learning libraries](https://github.com/fastai/fastai), [API
-clients](https://github.com/fastai/ghapi), [Python language
-extensions](https://github.com/fastai/fastcore), [terminal user
-interfaces](https://github.com/nat/ghtop), and more!
+A: [Watch this video](https://youtu.be/9Q6sLbz37gk). Don’t worry, we still get this too, despite having used `nbdev` for a wide range of “very serious” software projects over the last three years, including [deep learning libraries](https://github.com/fastai/fastai), [API clients](https://github.com/fastai/ghapi), [Python language extensions](https://github.com/fastai/fastcore), [terminal user interfaces](https://github.com/nat/ghtop), and more!
 
 ## Contributing
 
-If you want to contribute to `nbdev`, be sure to review the
-[contributions
-guidelines](https://github.com/fastai/nbdev/blob/master/CONTRIBUTING.md).
-This project adheres to fastai’s [code of
-conduct](https://github.com/fastai/nbdev/blob/master/CODE_OF_CONDUCT.md).
-By participating, you are expected to uphold this code. In general, we
-strive to abide by generally accepted best practices in open-source
-software development.
+If you want to contribute to `nbdev`, be sure to review the [contributions guidelines](https://github.com/fastai/nbdev/blob/master/CONTRIBUTING.md). This project adheres to fastai’s [code of conduct](https://github.com/fastai/nbdev/blob/master/CODE_OF_CONDUCT.md). By participating, you are expected to uphold this code. In general, we strive to abide by generally accepted best practices in open-source software development.
 
-Make sure you have `nbdev`’s git hooks installed by running
-`nbdev-install-hooks` in the cloned repository.
+Make sure you have `nbdev`’s git hooks installed by running `nbdev-install-hooks` in the cloned repository.
 
 ## Copyright
 
-Copyright © 2019 onward fast.ai, Inc. Licensed under the Apache License,
-Version 2.0 (the “License”); you may not use this project’s files except
-in compliance with the License. A copy of the License is provided in the
-LICENSE file in this repository.
+Copyright © 2019 onward fast.ai, Inc. Licensed under the Apache License, Version 2.0 (the “License”); you may not use this project’s files except in compliance with the License. A copy of the License is provided in the LICENSE file in this repository.

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

@@ -7,55 +7,25 @@
 
 ## 🛑**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` 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!
-
-`nbdev` makes debugging and refactoring your code much easier than in
-traditional programming environments since you always have live objects
-at your fingertips. `nbdev` also promotes software engineering best
-practices because tests and documentation are first class.
-
-- **Documentation** is automatically generated using
-  [Quarto](https://quarto.org/) and hosted on [GitHub
-  Pages](https://pages.github.com/). Docs support LaTeX, are searchable,
-  and are automatically hyperlinked (including out-of-the-box support
-  for many packages via
-  [`nbdev-index`](https://github.com/fastai/nbdev-index))
-- **Publish packages to PyPI and conda** as well as tools to simplify
-  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. Sync is
-  robust: each exported cell is tagged with its unique notebook cell ID,
-  so `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
-  Actions](https://github.com/features/actions) that run your tests and
-  rebuild your docs
-- **Git-friendly notebooks** with [Jupyter/Git
-  hooks](https://nbdev.fast.ai/tutorials/git_friendly_jupyter.html) that
-  clean unwanted metadata and render merge conflicts in a human-readable
-  format
+**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` 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!
+
+`nbdev` makes debugging and refactoring your code much easier than in traditional programming environments since you always have live objects at your fingertips. `nbdev` also promotes software engineering best practices because tests and documentation are first class.
+
+- **Documentation** is automatically generated using [Quarto](https://quarto.org/) and hosted on [GitHub Pages](https://pages.github.com/). Docs support LaTeX, are searchable, and are automatically hyperlinked (including out-of-the-box support for many packages via [`nbdev-index`](https://github.com/fastai/nbdev-index))
+- **Publish packages to PyPI and conda** as well as tools to simplify 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. Sync is robust: each exported cell is tagged with its unique notebook cell ID, so `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 Actions](https://github.com/features/actions) that run your tests and rebuild your docs
+- **Git-friendly notebooks** with [Jupyter/Git hooks](https://nbdev.fast.ai/tutorials/git_friendly_jupyter.html) that clean unwanted metadata and render merge conflicts in a human-readable format
 - … and much more!
 
 ## Install
 
-nbdev works on macOS, Linux, and most Unix-style operating systems. It
-works on Windows under WSL, but not under cmd or Powershell.
+nbdev works on macOS, Linux, and most Unix-style operating systems. It works on Windows under WSL, but not under cmd or Powershell.
 
 You can install nbdev with pip:
 
@@ -63,27 +33,17 @@ You can install nbdev with pip:
 pip install nbdev
 ```
 
-Note that `nbdev` must be installed into the same Python environment
-that you use for both Jupyter and your project.
+Note that `nbdev` must be installed into the same Python environment that you use for both Jupyter and your project.
 
 ## How to use nbdev
 
-The best way to learn how to use nbdev is to complete either the
-[written walkthrough](https://nbdev.fast.ai/tutorials/tutorial.html) or
-video walkthrough:
+The best way to learn how to use nbdev is to complete either the [written walkthrough](https://nbdev.fast.ai/tutorials/tutorial.html) or video walkthrough:
 
-<a href="http://www.youtube.com/watch?v=l7zS8Ld4_iA" target="_blank"
-title="nbdev walkthrough"><img
-src="https://github.com/fastai/logos/raw/main/nbdev_walkthrough.png"
-style="border-radius: 10px" width="560" height="315" /></a>
+<a href="http://www.youtube.com/watch?v=l7zS8Ld4_iA" target="_blank" title="nbdev walkthrough"><img src="https://github.com/fastai/logos/raw/main/nbdev_walkthrough.png" style="border-radius: 10px" width="560" height="315" /></a>
 
-Alternatively, there’s a [shortened version of the video
-walkthrough](https://youtu.be/67FdzLSt4aA) with coding sections sped up
-using the `unsilence` Python library – it’s 27 minutes faster, but a bit
-harder to follow.
+Alternatively, there’s a [shortened version of the video walkthrough](https://youtu.be/67FdzLSt4aA) with coding sections sped up using the `unsilence` Python library – it’s 27 minutes faster, but a bit harder to follow.
 
-You can also run `nbdev-help` from the terminal to see the full list of
-available commands:
+You can also run `nbdev-help` from the terminal to see the full list of available commands:
 
 ``` python
 !nbdev-help
@@ -128,45 +88,26 @@ available commands:
 
 ### Q: What is the warning “Found a cell containing mix of imports and computations. Please use separate cells”?
 
-A: You should not have cells that are not exported, *and* contain a mix
-of `import` statements along with other code. For instance, don’t do
-this in a single cell:
+A: You should not have cells that are not exported, *and* contain a mix of `import` statements along with other code. For instance, don’t do this in a single cell:
 
 ``` python
 import some_module
 some_module.something()
 ```
 
-Instead, split this into two cells, one which does `import some_module`,
-and the other which does `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.
+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
-[`show_doc`](https://nbdev.fast.ai/api/showdoc.html#show_doc) functions
-in your notebooks. When you mix imports with other code, that other code
-will be run too, which can cause errors (or at least slowdowns) when
-creating your website.
+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 [`show_doc`](https://nbdev.fast.ai/api/showdoc.html#show_doc) functions in your notebooks. When you mix imports with other code, that other code will be run too, which can cause errors (or at least slowdowns) when creating your website.
 
 ### Q: Why is nbdev asking for root access? How do I install Quarto without root access?
 
-A: When you setup your first project, nbdev will attempt to
-automatically download and install [Quarto](https://quarto.org/) for
-you. This is the program that we use to create your documentation
-website.
+A: When you setup your first project, nbdev will attempt to automatically download and install [Quarto](https://quarto.org/) for you. This is the program that we use to create your documentation website.
 
-Quarto’s standard installation process requires root access, and nbdev
-will therefore ask for your root password during installation. For most
-people, this will work fine and everything will be handled automatically
-– if so, you can skip over the rest of this section, which talks about
-installing without root access.
+Quarto’s standard installation process requires root access, and nbdev will therefore ask for your root password during installation. For most people, this will work fine and everything will be handled automatically – if so, you can skip over the rest of this section, which talks about installing without root access.
 
-If you need to install Quarto without root access on Linux, first `cd`
-to wherever you want to store it, then [download
-Quarto](https://quarto.org/docs/get-started/), and type:
+If you need to install Quarto without root access on Linux, first `cd` to wherever you want to store it, then [download Quarto](https://quarto.org/docs/get-started/), and type:
 
 ``` bash
 dpkg -x quarto*.deb .
@@ -176,39 +117,18 @@ mkdir -p ~/.local/bin
 ln -s "$(pwd)"/quarto/bin/quarto ~/.local/bin
 ```
 
-To use this non-root version of Quarto, you’ll need `~/.local/bin` in
-your [`PATH` environment
-variable](https://linuxize.com/post/how-to-add-directory-to-path-in-linux/).
-(Alternatively, change the `ln -s` step to place the symlink somewhere
-else in your path.)
+To use this non-root version of Quarto, you’ll need `~/.local/bin` in your [`PATH` environment variable](https://linuxize.com/post/how-to-add-directory-to-path-in-linux/). (Alternatively, change the `ln -s` step to place the symlink somewhere else in your path.)
 
 ### Q: Someone told me not to use notebooks for “serious” software development!
 
-A: [Watch this video](https://youtu.be/9Q6sLbz37gk). Don’t worry, we
-still get this too, despite having used `nbdev` for a wide range of
-“very serious” software projects over the last three years, including
-[deep learning libraries](https://github.com/fastai/fastai), [API
-clients](https://github.com/fastai/ghapi), [Python language
-extensions](https://github.com/fastai/fastcore), [terminal user
-interfaces](https://github.com/nat/ghtop), and more!
+A: [Watch this video](https://youtu.be/9Q6sLbz37gk). Don’t worry, we still get this too, despite having used `nbdev` for a wide range of “very serious” software projects over the last three years, including [deep learning libraries](https://github.com/fastai/fastai), [API clients](https://github.com/fastai/ghapi), [Python language extensions](https://github.com/fastai/fastcore), [terminal user interfaces](https://github.com/nat/ghtop), and more!
 
 ## Contributing
 
-If you want to contribute to `nbdev`, be sure to review the
-[contributions
-guidelines](https://github.com/fastai/nbdev/blob/master/CONTRIBUTING.md).
-This project adheres to fastai’s [code of
-conduct](https://github.com/fastai/nbdev/blob/master/CODE_OF_CONDUCT.md).
-By participating, you are expected to uphold this code. In general, we
-strive to abide by generally accepted best practices in open-source
-software development.
+If you want to contribute to `nbdev`, be sure to review the [contributions guidelines](https://github.com/fastai/nbdev/blob/master/CONTRIBUTING.md). This project adheres to fastai’s [code of conduct](https://github.com/fastai/nbdev/blob/master/CODE_OF_CONDUCT.md). By participating, you are expected to uphold this code. In general, we strive to abide by generally accepted best practices in open-source software development.
 
-Make sure you have `nbdev`’s git hooks installed by running
-`nbdev-install-hooks` in the cloned repository.
+Make sure you have `nbdev`’s git hooks installed by running `nbdev-install-hooks` in the cloned repository.
 
 ## Copyright
 
-Copyright © 2019 onward fast.ai, Inc. Licensed under the Apache License,
-Version 2.0 (the “License”); you may not use this project’s files except
-in compliance with the License. A copy of the License is provided in the
-LICENSE file in this repository.
+Copyright © 2019 onward fast.ai, Inc. Licensed under the Apache License, Version 2.0 (the “License”); you may not use this project’s files except in compliance with the License. A copy of the License is provided in the LICENSE file in this repository.

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

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

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

@@ -283,6 +283,7 @@ d = { 'settings': { 'branch': 'main',
                               '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'),
+                              'nbdev.quarto._fix_quarto_nav': ('api/quarto.html#_fix_quarto_nav', 'nbdev/quarto.py'),
                               'nbdev.quarto._install_linux': ('api/quarto.html#_install_linux', 'nbdev/quarto.py'),
                               'nbdev.quarto._install_mac': ('api/quarto.html#_install_mac', 'nbdev/quarto.py'),
                               'nbdev.quarto._nbglob_docs': ('api/quarto.html#_nbglob_docs', 'nbdev/quarto.py'),
@@ -312,11 +313,17 @@ d = { 'settings': { 'branch': 'main',
                                'nbdev.release.Release.changelog': ('api/release.html#release.changelog', 'nbdev/release.py'),
                                'nbdev.release.Release.latest_notes': ('api/release.html#release.latest_notes', 'nbdev/release.py'),
                                'nbdev.release.Release.release': ('api/release.html#release.release', 'nbdev/release.py'),
+                               'nbdev.release._check_changelog_base': ('api/release.html#_check_changelog_base', 'nbdev/release.py'),
                                'nbdev.release._find_config': ('api/release.html#_find_config', 'nbdev/release.py'),
                                'nbdev.release._get_conda_meta': ('api/release.html#_get_conda_meta', 'nbdev/release.py'),
+                               'nbdev.release._is_ancestor': ('api/release.html#_is_ancestor', 'nbdev/release.py'),
                                'nbdev.release._issue_txt': ('api/release.html#_issue_txt', 'nbdev/release.py'),
                                'nbdev.release._issues_txt': ('api/release.html#_issues_txt', 'nbdev/release.py'),
                                'nbdev.release._load_json': ('api/release.html#_load_json', 'nbdev/release.py'),
+                               'nbdev.release._release_branch': ('api/release.html#_release_branch', 'nbdev/release.py'),
+                               'nbdev.release._release_head': ('api/release.html#_release_head', 'nbdev/release.py'),
+                               'nbdev.release._remote_shas': ('api/release.html#_remote_shas', 'nbdev/release.py'),
+                               'nbdev.release._require_release_branch': ('api/release.html#_require_release_branch', 'nbdev/release.py'),
                                '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'),
@@ -338,6 +345,7 @@ d = { 'settings': { 'branch': 'main',
                                'nbdev.release.write_requirements': ('api/release.html#write_requirements', 'nbdev/release.py')},
             'nbdev.scrubmagics': {},
             'nbdev.serve': { 'nbdev.serve._is_qpy': ('api/serve.html#_is_qpy', 'nbdev/serve.py'),
+                             'nbdev.serve._keep_file': ('api/serve.html#_keep_file', 'nbdev/serve.py'),
                              '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-3.2.0 → nbdev-3.2.2}/nbdev/diff.py

@@ -25,7 +25,7 @@ def read_nb_from_git(
     path = Path(path)
     if path.is_absolute(): path = path.relative_to(g.top())
     if ref is None: return read_nb(g.top()/path)
-    raw = g.show(f'{ref}:{path}', split=False)
+    raw = g.show(f'{ref}:{path}')
     return dict2nb(json.loads(raw))
 
 # %% ../nbs/api/19_diff.ipynb #3ac25702

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

@@ -174,6 +174,11 @@ website:
   description: "{description}"
   repo-branch: {branch}
   repo-url: "{git_url}"
+
+format-links:
+  - html
+  - format: commonmark
+    text: Markdown
 """
 
 # %% ../nbs/api/14_quarto.ipynb #38124450
@@ -269,17 +274,18 @@ def _save_cached_readme(cache, cfg):
 def nbdev_readme(
     path:str=None, # Path to notebooks
     chk_time:bool=False): # Only build if out of date
-    "Create README.md from readme_nb (index.ipynb by default)"
+    "Create README.md from readme_nb (index.ipynb by default). Skips if the file doesn't exist."
     cfg = get_config()
     path = Path(path) if path else cfg.nbs_path
+    if not (path/cfg.readme_nb).exists(): return
     _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)
+        cache = proc_nbs(path, file_glob=Path(cfg.readme_nb).name)
         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')
+        _sprun(f'cd "{cache}" && quarto render "{cache/cfg.readme_nb}" -o README.md -t gfm --no-execute -M wrap:preserve')
         
     _save_cached_readme(cache, cfg)
 
@@ -310,11 +316,17 @@ def nbdev_contributing(
     if chk_time and _doc_mtime_not_older(cfg.config_path / 'CONTRIBUTING.md' , contrib_nb_path): return
     
     with _SidebarYmlRemoved(path): # to avoid rendering whole website
-        cache = proc_nbs(path)
-        _sprun(f'cd "{cache}" && quarto render "{cache/contrib_nb_name}" -o CONTRIBUTING.md -t gfm --no-execute')
+        cache = proc_nbs(path, file_glob=Path(contrib_nb_name).name)
+        _sprun(f'cd "{cache}" && quarto render "{cache/contrib_nb_name}" -o CONTRIBUTING.md -t gfm --no-execute -M wrap:preserve')
         
     _save_cached_contributing(cache, cfg, contrib_nb_name)
 
+# %% ../nbs/api/14_quarto.ipynb #8e1627d3
+def _fix_quarto_nav(doc_path):
+    "Anchor quarto-nav.js's clean-URL regex, which otherwise breaks `index.html.md` alternate-format links (quarto-dev/quarto-cli#14667)"
+    p = Path(doc_path)/'site_libs/quarto-nav/quarto-nav.js'
+    if p.exists(): p.write_text(p.read_text().replace(r'.replace(/\/index\.html/, "/")', r'.replace(/\/index\.html(?=[?#]|$)/, "/")'))
+
 # %% ../nbs/api/14_quarto.ipynb #37d16049
 @call_parse
 @delegates(_nbglob_docs)
@@ -329,6 +341,7 @@ def nbdev_docs(
     _sprun(f'cd "{cache}" && quarto render --no-cache')
     shutil.rmtree(cfg.doc_path, ignore_errors=True)
     move(cache/cfg.doc_path.name, cfg.config_path)
+    _fix_quarto_nav(cfg.doc_path)
 
 # %% ../nbs/api/14_quarto.ipynb #23886f9c
 @call_parse

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

@@ -29,9 +29,7 @@ def _find_config(): return get_config()
 def _issue_txt(issue):
     res = '- {} ([#{}]({}))'.format(issue.title.strip(), issue.number, issue.html_url)
     if hasattr(issue, 'pull_request'): res += ', thanks to [@{}]({})'.format(issue.user.login, issue.user.html_url)
-    res += '\n'
-    if not issue.body: return res
-    return res + f"  - {issue.body.strip()}\n"
+    return res
 
 def _issues_txt(iss, label):
     if not iss: return ''
@@ -42,6 +40,25 @@ 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 #e5861010
+def _require_release_branch(branch):
+    if not branch: raise SystemExit('Cannot release from detached HEAD; create a maintenance branch first')
+    return branch
+
+def _release_branch(): return _require_release_branch(run('git branch --show-current').strip())
+def _is_ancestor(ref): return subprocess.run(['git', 'merge-base', '--is-ancestor', ref, 'HEAD'], capture_output=True).returncode == 0
+def _remote_shas(s): return {o.split()[0] for o in s.splitlines()}
+
+def _check_changelog_base(tag):
+    if _is_ancestor(tag): return
+    raise SystemExit(f'HEAD does not contain the latest release ({tag}). Write CHANGELOG.md manually, then run with --no_changelog.')
+
+def _release_head():
+    _release_branch()
+    head = run('git rev-parse HEAD').strip()
+    if head not in _remote_shas(run('git ls-remote --heads origin')): raise SystemExit(f'Release commit {head[:7]} is not on origin; push the current branch first')
+    return head
+
 # %% ../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`"
@@ -82,12 +99,16 @@ async def changelog(self:Release,
     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"
+    if lr:
+        run('git fetch --tags --quiet')
+        _check_changelog_base(lr.tag_name)
+        if 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\n"
     issues = await self._issue_groups()
-    res += '\n'.join(_issues_txt(*o) for o in zip(issues, self.groups.values()))
+    sections = (_issues_txt(*o) for o in zip(issues, self.groups.values()))
+    res += '\n\n'.join(filter(None, sections))
     if debug: return res
     res = update_changelog(self.changefile.read_text(), self.cfg.version, res, marker)
     shutil.copy(self.changefile, self.changefile.with_suffix(".bak"))
@@ -100,7 +121,7 @@ async def release(self:Release):
     "Tag and create a release in GitHub for the current version"
     ver = self.cfg.version
     notes = self.latest_notes()
-    await self.gh.create_release(ver, branch=self.cfg.branch, body=notes)
+    await self.gh.create_release(ver, branch=_release_head(), body=notes)
     return ver
 
 # %% ../nbs/api/18_release.ipynb #22101171
@@ -139,15 +160,18 @@ async def release_git(token:str=None):
 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)
+    no_changelog:store_true=False,  # Skip changelog creation (assumes CHANGELOG.md is up to date)
+    no_editor:store_true=False,  # Skip opening CHANGELOG.md in an editor
+    yes:store_true=False  # Release without asking for confirmation
 ):
-    "Calls `nbdev-changelog`, lets you edit the result, then pushes to git and calls `nbdev-release-git`"
+    "Create the changelog, optionally edit it, then push and create the GitHub release"
     cfg = _find_config()
+    _release_branch()
     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)
+    if not no_editor: subprocess.run([os.environ.get('EDITOR','nano'), cfg.config_path/'CHANGELOG.md'])
+    if not yes and not input("Make release now? (y/n) ").lower().startswith('y'): sys.exit(1)
     run('git commit -am release')
-    run('git push')
+    run('git push --set-upstream origin HEAD')
     print(f"Released {await push_release(token, repo=repo)}")
 
 # %% ../nbs/api/18_release.ipynb #5b4d4aa2

{nbdev-3.2.0 → nbdev-3.2.2}/nbdev/serve.py

@@ -10,6 +10,7 @@ __all__ = ['proc_nbs']
 # %% ../nbs/api/17_serve.ipynb #6899a335
 import ast,subprocess,threading,sys
 from shutil import rmtree,copy2
+from fnmatch import fnmatch
 
 from fastcore.utils import *
 from fastcore.parallel import parallel
@@ -53,20 +54,27 @@ def _proc_file(s, cache, path, mtime=None):
     if md is not None: return s,d,md.strip()
     else: copy2(s,d)
 
+# %% ../nbs/api/17_serve.ipynb #eac159fb
+def _keep_file(f:Path, file_glob='', file_re=''):
+    "Keep all non-notebook files; keep notebooks matching `file_glob` and `file_re` (empty patterns match all)"
+    if f.suffix!='.ipynb': return True
+    return (not file_glob or fnmatch(f.name, file_glob)) and (not file_re or bool(re.search(file_re, f.name)))
+
 # %% ../nbs/api/17_serve.ipynb #14463227
 @delegates(nbglob_cli)
 def proc_nbs(
     path:str='', # Path to notebooks
     n_workers:int=defaults.cpus,  # Number of workers
     force:bool=False,  # Ignore cache and build all
-    file_glob:str='', # Only include files matching glob
-    file_re:str='', # Only include files matching glob
+    file_glob:str='', # Only process notebooks matching glob (other files are always included)
+    file_re:str='', # Only process notebooks matching regex (other files are always included)
     **kwargs):
     "Process notebooks in `path` for docs rendering"
     cfg = get_config()
     cache = cfg.config_path/'_proc'
     path = Path(path or cfg.nbs_path)
     files = nbglob(path, func=Path, file_glob='', file_re='', **kwargs)
+    if file_glob or file_re: files = files.filter(_keep_file, file_glob=file_glob, file_re=file_re)
     if (path/'_quarto.yml').exists(): files.append(path/'_quarto.yml')
     if (path/'_brand.yml').exists(): files.append(path/'_brand.yml')
     if (path/'_extensions').exists(): files.extend(nbglob(path/'_extensions', func=Path, file_glob='', file_re='', skip_file_re='^[.]'))

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nbdev
-Version: 3.2.0
+Version: 3.2.2
 Summary: Create delightful software with Jupyter Notebooks
 Author-email: "Jeremy Howard and the fast.ai community" <j@fast.ai>
 License: Apache-2.0
@@ -24,7 +24,7 @@ Requires-Dist: watchdog
 Requires-Dist: asttokens
 Requires-Dist: setuptools
 Requires-Dist: build
-Requires-Dist: fastgit
+Requires-Dist: fastgit>=0.0.7
 Requires-Dist: pyyaml
 Requires-Dist: tomli; python_version < "3.11"
 Provides-Extra: dev
@@ -36,7 +36,7 @@ Requires-Dist: matplotlib; extra == "dev"
 Requires-Dist: black; extra == "dev"
 Requires-Dist: svg.py; extra == "dev"
 Requires-Dist: nbclassic; extra == "dev"
-Requires-Dist: pysymbol_llm; extra == "dev"
+Requires-Dist: pysym2md>=0.0.6; extra == "dev"
 Requires-Dist: llms-txt; extra == "dev"
 Requires-Dist: sphinx; extra == "dev"
 Requires-Dist: plum-dispatch; extra == "dev"
@@ -51,55 +51,25 @@ Dynamic: license-file
 
 ## 🛑**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` 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!
-
-`nbdev` makes debugging and refactoring your code much easier than in
-traditional programming environments since you always have live objects
-at your fingertips. `nbdev` also promotes software engineering best
-practices because tests and documentation are first class.
-
-- **Documentation** is automatically generated using
-  [Quarto](https://quarto.org/) and hosted on [GitHub
-  Pages](https://pages.github.com/). Docs support LaTeX, are searchable,
-  and are automatically hyperlinked (including out-of-the-box support
-  for many packages via
-  [`nbdev-index`](https://github.com/fastai/nbdev-index))
-- **Publish packages to PyPI and conda** as well as tools to simplify
-  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. Sync is
-  robust: each exported cell is tagged with its unique notebook cell ID,
-  so `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
-  Actions](https://github.com/features/actions) that run your tests and
-  rebuild your docs
-- **Git-friendly notebooks** with [Jupyter/Git
-  hooks](https://nbdev.fast.ai/tutorials/git_friendly_jupyter.html) that
-  clean unwanted metadata and render merge conflicts in a human-readable
-  format
+**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` 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!
+
+`nbdev` makes debugging and refactoring your code much easier than in traditional programming environments since you always have live objects at your fingertips. `nbdev` also promotes software engineering best practices because tests and documentation are first class.
+
+- **Documentation** is automatically generated using [Quarto](https://quarto.org/) and hosted on [GitHub Pages](https://pages.github.com/). Docs support LaTeX, are searchable, and are automatically hyperlinked (including out-of-the-box support for many packages via [`nbdev-index`](https://github.com/fastai/nbdev-index))
+- **Publish packages to PyPI and conda** as well as tools to simplify 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. Sync is robust: each exported cell is tagged with its unique notebook cell ID, so `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 Actions](https://github.com/features/actions) that run your tests and rebuild your docs
+- **Git-friendly notebooks** with [Jupyter/Git hooks](https://nbdev.fast.ai/tutorials/git_friendly_jupyter.html) that clean unwanted metadata and render merge conflicts in a human-readable format
 - … and much more!
 
 ## Install
 
-nbdev works on macOS, Linux, and most Unix-style operating systems. It
-works on Windows under WSL, but not under cmd or Powershell.
+nbdev works on macOS, Linux, and most Unix-style operating systems. It works on Windows under WSL, but not under cmd or Powershell.
 
 You can install nbdev with pip:
 
@@ -107,27 +77,17 @@ You can install nbdev with pip:
 pip install nbdev
 ```
 
-Note that `nbdev` must be installed into the same Python environment
-that you use for both Jupyter and your project.
+Note that `nbdev` must be installed into the same Python environment that you use for both Jupyter and your project.
 
 ## How to use nbdev
 
-The best way to learn how to use nbdev is to complete either the
-[written walkthrough](https://nbdev.fast.ai/tutorials/tutorial.html) or
-video walkthrough:
+The best way to learn how to use nbdev is to complete either the [written walkthrough](https://nbdev.fast.ai/tutorials/tutorial.html) or video walkthrough:
 
-<a href="http://www.youtube.com/watch?v=l7zS8Ld4_iA" target="_blank"
-title="nbdev walkthrough"><img
-src="https://github.com/fastai/logos/raw/main/nbdev_walkthrough.png"
-style="border-radius: 10px" width="560" height="315" /></a>
+<a href="http://www.youtube.com/watch?v=l7zS8Ld4_iA" target="_blank" title="nbdev walkthrough"><img src="https://github.com/fastai/logos/raw/main/nbdev_walkthrough.png" style="border-radius: 10px" width="560" height="315" /></a>
 
-Alternatively, there’s a [shortened version of the video
-walkthrough](https://youtu.be/67FdzLSt4aA) with coding sections sped up
-using the `unsilence` Python library – it’s 27 minutes faster, but a bit
-harder to follow.
+Alternatively, there’s a [shortened version of the video walkthrough](https://youtu.be/67FdzLSt4aA) with coding sections sped up using the `unsilence` Python library – it’s 27 minutes faster, but a bit harder to follow.
 
-You can also run `nbdev-help` from the terminal to see the full list of
-available commands:
+You can also run `nbdev-help` from the terminal to see the full list of available commands:
 
 ``` python
 !nbdev-help
@@ -172,45 +132,26 @@ available commands:
 
 ### Q: What is the warning “Found a cell containing mix of imports and computations. Please use separate cells”?
 
-A: You should not have cells that are not exported, *and* contain a mix
-of `import` statements along with other code. For instance, don’t do
-this in a single cell:
+A: You should not have cells that are not exported, *and* contain a mix of `import` statements along with other code. For instance, don’t do this in a single cell:
 
 ``` python
 import some_module
 some_module.something()
 ```
 
-Instead, split this into two cells, one which does `import some_module`,
-and the other which does `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.
+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
-[`show_doc`](https://nbdev.fast.ai/api/showdoc.html#show_doc) functions
-in your notebooks. When you mix imports with other code, that other code
-will be run too, which can cause errors (or at least slowdowns) when
-creating your website.
+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 [`show_doc`](https://nbdev.fast.ai/api/showdoc.html#show_doc) functions in your notebooks. When you mix imports with other code, that other code will be run too, which can cause errors (or at least slowdowns) when creating your website.
 
 ### Q: Why is nbdev asking for root access? How do I install Quarto without root access?
 
-A: When you setup your first project, nbdev will attempt to
-automatically download and install [Quarto](https://quarto.org/) for
-you. This is the program that we use to create your documentation
-website.
+A: When you setup your first project, nbdev will attempt to automatically download and install [Quarto](https://quarto.org/) for you. This is the program that we use to create your documentation website.
 
-Quarto’s standard installation process requires root access, and nbdev
-will therefore ask for your root password during installation. For most
-people, this will work fine and everything will be handled automatically
-– if so, you can skip over the rest of this section, which talks about
-installing without root access.
+Quarto’s standard installation process requires root access, and nbdev will therefore ask for your root password during installation. For most people, this will work fine and everything will be handled automatically – if so, you can skip over the rest of this section, which talks about installing without root access.
 
-If you need to install Quarto without root access on Linux, first `cd`
-to wherever you want to store it, then [download
-Quarto](https://quarto.org/docs/get-started/), and type:
+If you need to install Quarto without root access on Linux, first `cd` to wherever you want to store it, then [download Quarto](https://quarto.org/docs/get-started/), and type:
 
 ``` bash
 dpkg -x quarto*.deb .
@@ -220,39 +161,18 @@ mkdir -p ~/.local/bin
 ln -s "$(pwd)"/quarto/bin/quarto ~/.local/bin
 ```
 
-To use this non-root version of Quarto, you’ll need `~/.local/bin` in
-your [`PATH` environment
-variable](https://linuxize.com/post/how-to-add-directory-to-path-in-linux/).
-(Alternatively, change the `ln -s` step to place the symlink somewhere
-else in your path.)
+To use this non-root version of Quarto, you’ll need `~/.local/bin` in your [`PATH` environment variable](https://linuxize.com/post/how-to-add-directory-to-path-in-linux/). (Alternatively, change the `ln -s` step to place the symlink somewhere else in your path.)
 
 ### Q: Someone told me not to use notebooks for “serious” software development!
 
-A: [Watch this video](https://youtu.be/9Q6sLbz37gk). Don’t worry, we
-still get this too, despite having used `nbdev` for a wide range of
-“very serious” software projects over the last three years, including
-[deep learning libraries](https://github.com/fastai/fastai), [API
-clients](https://github.com/fastai/ghapi), [Python language
-extensions](https://github.com/fastai/fastcore), [terminal user
-interfaces](https://github.com/nat/ghtop), and more!
+A: [Watch this video](https://youtu.be/9Q6sLbz37gk). Don’t worry, we still get this too, despite having used `nbdev` for a wide range of “very serious” software projects over the last three years, including [deep learning libraries](https://github.com/fastai/fastai), [API clients](https://github.com/fastai/ghapi), [Python language extensions](https://github.com/fastai/fastcore), [terminal user interfaces](https://github.com/nat/ghtop), and more!
 
 ## Contributing
 
-If you want to contribute to `nbdev`, be sure to review the
-[contributions
-guidelines](https://github.com/fastai/nbdev/blob/master/CONTRIBUTING.md).
-This project adheres to fastai’s [code of
-conduct](https://github.com/fastai/nbdev/blob/master/CODE_OF_CONDUCT.md).
-By participating, you are expected to uphold this code. In general, we
-strive to abide by generally accepted best practices in open-source
-software development.
+If you want to contribute to `nbdev`, be sure to review the [contributions guidelines](https://github.com/fastai/nbdev/blob/master/CONTRIBUTING.md). This project adheres to fastai’s [code of conduct](https://github.com/fastai/nbdev/blob/master/CODE_OF_CONDUCT.md). By participating, you are expected to uphold this code. In general, we strive to abide by generally accepted best practices in open-source software development.
 
-Make sure you have `nbdev`’s git hooks installed by running
-`nbdev-install-hooks` in the cloned repository.
+Make sure you have `nbdev`’s git hooks installed by running `nbdev-install-hooks` in the cloned repository.
 
 ## Copyright
 
-Copyright © 2019 onward fast.ai, Inc. Licensed under the Apache License,
-Version 2.0 (the “License”); you may not use this project’s files except
-in compliance with the License. A copy of the License is provided in the
-LICENSE file in this repository.
+Copyright © 2019 onward fast.ai, Inc. Licensed under the Apache License, Version 2.0 (the “License”); you may not use this project’s files except in compliance with the License. A copy of the License is provided in the LICENSE file in this repository.

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

@@ -6,7 +6,7 @@ watchdog
 asttokens
 setuptools
 build
-fastgit
+fastgit>=0.0.7
 pyyaml
 
 [:python_version < "3.11"]
@@ -21,7 +21,7 @@ matplotlib
 black
 svg.py
 nbclassic
-pysymbol_llm
+pysym2md>=0.0.6
 llms-txt
 sphinx
 plum-dispatch

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

@@ -20,11 +20,11 @@ classifiers = [
 ]
 dynamic = ["version"]
 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'", ]
+    "setuptools", "build", "fastgit>=0.0.7", "pyyaml", "tomli; python_version < '3.11'", ]
 
 [project.optional-dependencies]
 dev = [ "ipywidgets", "nbdev-numpy", "nbdev-stdlib", "pandas", "matplotlib", "black", "svg.py", "nbclassic",
-    "pysymbol_llm", "llms-txt", "sphinx", "plum-dispatch", ]
+    "pysym2md>=0.0.6", "llms-txt", "sphinx", "plum-dispatch", ]
 
 [project.urls]
 Repository = "https://github.com/AnswerDotAI/nbdev"