Nbdev

Breaking Changes

- Combine preprocs and postprocs into new `Processor` class ([874](https://github.com/fastai/nbdev/issues/874))
- Rename `nbdev.read` to `nbdev.config` ([879](https://github.com/fastai/nbdev/issues/879))
- Use H3 for functions and properties, instead of H4 ([875](https://github.com/fastai/nbdev/issues/875))
- Remove `nbflags` directive ([871](https://github.com/fastai/nbdev/issues/871))
- Deprecate `config_key` in favor of `get_config` ([856](https://github.com/fastai/nbdev/pull/856)), thanks to [seeM](https://github.com/seeM)

New Features

- Add simple qmd generation functions in `nbdev.qmd` ([893](https://github.com/fastai/nbdev/issues/893))
- Add `FrontmatterProc` ([890](https://github.com/fastai/nbdev/issues/890))
- Improvements to `nbdev_new` and `nbdev_create_config` ([878](https://github.com/fastai/nbdev/pull/878)), thanks to [seeM](https://github.com/seeM)
- `nbdev_create_config` infers settings from git/GitHub, prompts for missing settings, and renders the settings file with commented sections
- `nbdev_new` uses `nbdev_create_config` instead of a file provided by `nbdev-template`, which means it'll benefit from future improvements to `nbdev_create_config` as well as always using latest defaults
- Add frontmatter bullet point processor ([873](https://github.com/fastai/nbdev/issues/873))
- Allow specifying port for preview ([872](https://github.com/fastai/nbdev/pull/872)), thanks to [dleen](https://github.com/dleen)
- `nbdev_new` renders notebooks with information from your config file ([866](https://github.com/fastai/nbdev/pull/866)), thanks to [seeM](https://github.com/seeM)
- Improve config documentation in `read` module ([864](https://github.com/fastai/nbdev/pull/864)), thanks to [seeM](https://github.com/seeM)
- Install quarto without root access ([860](https://github.com/fastai/nbdev/issues/860))
- Explain more detail during quarto installation process ([859](https://github.com/fastai/nbdev/issues/859))
- Automatically maintain `__version__` in `__init__.py` ([854](https://github.com/fastai/nbdev/issues/854))
- Prettify output for `nbdev_test` ([849](https://github.com/fastai/nbdev/pull/849)), thanks to [deven367](https://github.com/deven367)
- Ignore .ipynb_checkpoints folder in module dir ([848](https://github.com/fastai/nbdev/pull/848)), thanks to [dleen](https://github.com/dleen)
- Escape Footnotes from Docments Table ([847](https://github.com/fastai/nbdev/pull/847)), thanks to [hamelsmu](https://github.com/hamelsmu)
- Include filename in `nbdev_export` warning when nbdev1 syntax is used ([838](https://github.com/fastai/nbdev/pull/838)), thanks to [seeM](https://github.com/seeM)
- Show title if nbdev_filter errors ([828](https://github.com/fastai/nbdev/pull/828)), thanks to [hamelsmu](https://github.com/hamelsmu)
- Added "topics" to match GitHub's terminology ([817](https://github.com/fastai/nbdev/pull/817)), thanks to [tylere](https://github.com/tylere)
- Accelerate `quarto preview` ([748](https://github.com/fastai/nbdev/issues/748))
- Throw a warning when imports and code are mixed in a cell ([714](https://github.com/fastai/nbdev/issues/714))
- Make conda release work for anyone ([653](https://github.com/fastai/nbdev/issues/653))

Bugs Squashed

- `_all_` works for strings but not objects in py3.7 ([870](https://github.com/fastai/nbdev/issues/870))
- `show_doc` `title_level` argument has no effect ([869](https://github.com/fastai/nbdev/issues/869))
- `show_doc` sometimes does not show wrapped functions correctly ([863](https://github.com/fastai/nbdev/issues/863))
- `show_doc` treats functions decorated with `lru_cache` as classes ([862](https://github.com/fastai/nbdev/pull/862)), thanks to [seeM](https://github.com/seeM)
- Fix `show_doc` signature whitespace removal ([855](https://github.com/fastai/nbdev/pull/855)), thanks to [seeM](https://github.com/seeM)
- `nbdev_new` doesn't infer anything if no gitconfig ([846](https://github.com/fastai/nbdev/issues/846))
- `show_doc` paremeter default may render as footnote ([796](https://github.com/fastai/nbdev/issues/796))
- Conda description is empty ([745](https://github.com/fastai/nbdev/issues/745))

New Features

- add `nbdev_conda` to create and upload conda packages ([850](https://github.com/fastai/nbdev/issues/850))

New Features

- Add `custom_quarto_yml` setting ([842](https://github.com/fastai/nbdev/pull/842)), thanks to [benoit-cty](https://github.com/benoit-cty)
- Display multiline docstrings ([841](https://github.com/fastai/nbdev/issues/841))
- Include filename in `nbdev_export` warning when nbdev1 syntax is used ([835](https://github.com/fastai/nbdev/issues/835))
- Streamline `nbdev_new`: outputs are now in color, you can pass `--lib_name`, and it calls `nbdev_export` ([820](https://github.com/fastai/nbdev/pull/820)), thanks to [seeM](https://github.com/seeM)
- A command for uploading to the test pypi server ([818](https://github.com/fastai/nbdev/pull/818)), thanks to [tourdownunder](https://github.com/tourdownunder)
- Include notebook title in `nbdev_preview` error message ([802](https://github.com/fastai/nbdev/issues/802))
- Migrate collapsible code cell directives ([783](https://github.com/fastai/nbdev/pull/783)), thanks to [hamelsmu](https://github.com/hamelsmu)
- Simplify `jupyter_hooks` configuration ([780](https://github.com/fastai/nbdev/pull/780)), thanks to [seeM](https://github.com/seeM)
- Support `nbdev_install_hooks` in non-nbdev repos ([779](https://github.com/fastai/nbdev/pull/779)), thanks to [seeM](https://github.com/seeM)
- Allow users to provide user-level settings in ~/.config/nbdev/settings.ini ([778](https://github.com/fastai/nbdev/pull/778)), thanks to [seeM](https://github.com/seeM)
- Support `nbdev_install_hooks` in non-nbdev repos ([777](https://github.com/fastai/nbdev/issues/777))
- Port `doc()` from nbdev1 ([772](https://github.com/fastai/nbdev/issues/772))
- Make `show_doc` for function parameter defaults concise and deterministic ([771](https://github.com/fastai/nbdev/issues/771))
- Clean `id` from text `repr` outputs to further avoid git merge conflicts ([749](https://github.com/fastai/nbdev/issues/749))
- Add repo root to sys path on exec ([735](https://github.com/fastai/nbdev/issues/735))
- Use frontmatter `eval` and `showdoc` for controlling notebook execution ([734](https://github.com/fastai/nbdev/issues/734))

Bugs Squashed

- |exports directive does not show source code in the docs ([822](https://github.com/fastai/nbdev/issues/822))
- nbdev commands fail when `doc_path` contains whitespace ([813](https://github.com/fastai/nbdev/pull/813)), thanks to [mone27](https://github.com/mone27)
- `show_doc` html renderer is incorrectly formatted ([808](https://github.com/fastai/nbdev/issues/808))
- `show_doc` cell output is incorrectly styled ([807](https://github.com/fastai/nbdev/issues/807))
- links aren't rendered as code ([795](https://github.com/fastai/nbdev/pull/795)), thanks to [seeM](https://github.com/seeM)
- `clean_ids` corrupts string outputs ([794](https://github.com/fastai/nbdev/pull/794)), thanks to [seeM](https://github.com/seeM)
- quarto frontmatter is removed ([789](https://github.com/fastai/nbdev/issues/789))
- `nbdev_merge` fails on `git stash pop` conflict ([787](https://github.com/fastai/nbdev/pull/787)), thanks to [seeM](https://github.com/seeM)
- Hooks search Jupyter start directory instead of notebook directory for settings file ([784](https://github.com/fastai/nbdev/pull/784)), thanks to [dleen](https://github.com/dleen)
- Allow for dash in Quarto directives ([782](https://github.com/fastai/nbdev/pull/782)), thanks to [hamelsmu](https://github.com/hamelsmu)
- Fix directive migration when there is no test flag ([781](https://github.com/fastai/nbdev/pull/781)), thanks to [hamelsmu](https://github.com/hamelsmu)
- `nbdev_prepare` throws BrokenProcessPool error on MacOS ([731](https://github.com/fastai/nbdev/issues/731))
- settings.ini not inferred by `nbdev_new` on newly cloned repo on MacOS ([710](https://github.com/fastai/nbdev/issues/710))

New Features

- use global defaults instead of respecifying each time ([770](https://github.com/fastai/nbdev/pull/770)), thanks to [seeM](https://github.com/seeM)
- `get_config` works without a settings file ([768](https://github.com/fastai/nbdev/pull/768)), thanks to [seeM](https://github.com/seeM)
- add site url ([767](https://github.com/fastai/nbdev/pull/767)), thanks to [hamelsmu](https://github.com/hamelsmu)
- add `show_src` to display rich source code ([763](https://github.com/fastai/nbdev/pull/763)), thanks to [seeM](https://github.com/seeM)
- add support for `|exports` ([762](https://github.com/fastai/nbdev/issues/762))
- `nbdev_merge` prints info like `git merge` ([753](https://github.com/fastai/nbdev/issues/753))
- helpers to convert fp front matter to quarto front matter ([750](https://github.com/fastai/nbdev/pull/750)), thanks to [hamelsmu](https://github.com/hamelsmu)
- Streamline default settings ([747](https://github.com/fastai/nbdev/issues/747))
- Config keys (and their defaults) should all be documented in one place
- add `user` option to `jupyter_hooks` setting ([738](https://github.com/fastai/nbdev/pull/738)), thanks to [seeM](https://github.com/seeM)
- Add appropriate `output-file` to existing frontmatter ([728](https://github.com/fastai/nbdev/issues/728))

Bugs Squashed

- `nbdev_prepare` sometimes throws BrokenProcessPool error on MacOS ([731](https://github.com/fastai/nbdev/issues/731))
- Incorrect relative import from package root inside nested module ([773](https://github.com/fastai/nbdev/issues/773))
- Jupyter hooks break in environments without `nbdev` installed ([760](https://github.com/fastai/nbdev/issues/760))
- `nbdev_fix` breaks with empty `ours` patch ([752](https://github.com/fastai/nbdev/issues/752))
- fix `nbdev_merge` during rebase; fix `nbdev_fix` `nobackup` default ([737](https://github.com/fastai/nbdev/pull/737)), thanks to [seeM](https://github.com/seeM)
- non-notebooks do not have nbformat field ([732](https://github.com/fastai/nbdev/pull/732)), thanks to [dleen](https://github.com/dleen)

New Features

- add tools from fastrelease to nbdev ([733](https://github.com/fastai/nbdev/issues/733))

Bugs Squashed

- fix `nbdev_test` with no `--fname` in non-nbdev repos ([730](https://github.com/fastai/nbdev/pull/730)), thanks to [seeM](https://github.com/seeM)
- Auto-generated showdoc headers not in ToC ([703](https://github.com/fastai/nbdev/issues/703))

Breaking Changes

- `nbdev_sidebar` now looks for `.qmd` files instead of `.md` files

New Features

- automatically add `output:asis` for showdoc cells ([726](https://github.com/fastai/nbdev/issues/726))
- accelerate `nbdev_readme` ([715](https://github.com/fastai/nbdev/issues/715))
- deterministic `show_doc` and `DocmentTbl` `repr` ([707](https://github.com/fastai/nbdev/pull/707)), thanks to [seeM](https://github.com/seeM)

Bugs Squashed

- KeyError 'repo' when trying to create a new nbdev project with `nbdev_new` ([720](https://github.com/fastai/nbdev/issues/720))
- `show_doc` ends the details column at any `|` character ([712](https://github.com/fastai/nbdev/issues/712))
- only add to `.gitattributes` if missing ([706](https://github.com/fastai/nbdev/pull/706)), thanks to [seeM](https://github.com/seeM)