Typer

Fixes

* 🐛 Add missing `default_factory` in `Argument` overloads. PR [750](https://github.com/tiangolo/typer/pull/750) by [m9810223](https://github.com/m9810223).
* 🐛 Fix preserving case in enum values. PR [571](https://github.com/tiangolo/typer/pull/571) by [avaldebe](https://github.com/avaldebe).

Docs

* 📝 Remove obsolete references to `--install-completion` for `typer.run()` scripts. PR [595](https://github.com/tiangolo/typer/pull/595) by [tiangolo](https://github.com/tiangolo).

* 📝 Update docs example for a Typer/Click group to make new subcommands explicit. PR [755](https://github.com/tiangolo/typer/pull/755) by [svlandeg](https://github.com/svlandeg).
* 📝 Update docs for building a package, file structure example. PR [683](https://github.com/tiangolo/typer/pull/683) by [davidbgk](https://github.com/davidbgk).
* 📝 Update link in docs to the newest stable version of click. PR [675](https://github.com/tiangolo/typer/pull/675) by [javier171188](https://github.com/javier171188).
* 🔧 Add `CITATION.cff` file for academic citations. PR [681](https://github.com/tiangolo/typer/pull/681) by [tiangolo](https://github.com/tiangolo).
* ✏ Fix typo in `docs/tutorial/exceptions.md`. PR [702](https://github.com/tiangolo/typer/pull/702) by [menzenski](https://github.com/menzenski).
* ✏ Fix typo in `docs/tutorial/options/name.md`. PR [725](https://github.com/tiangolo/typer/pull/725) by [bwagner](https://github.com/bwagner).
* ✏ Fix typo in `docs/tutorial/arguments/optional.md`. PR [602](https://github.com/tiangolo/typer/pull/602) by [tadasgedgaudas](https://github.com/tadasgedgaudas).

Internal

* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [606](https://github.com/tiangolo/typer/pull/606) by [pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
* 👷 Install MkDocs Material Insiders only when secrets are available, for Dependabot. PR [685](https://github.com/tiangolo/typer/pull/685) by [tiangolo](https://github.com/tiangolo).
* ⚒️ Update build-docs.yml, do not zip docs. PR [645](https://github.com/tiangolo/typer/pull/645) by [tiangolo](https://github.com/tiangolo).
* 👷 Deploy docs to Cloudflare. PR [644](https://github.com/tiangolo/typer/pull/644) by [tiangolo](https://github.com/tiangolo).
* 👷 Upgrade CI for docs. PR [642](https://github.com/tiangolo/typer/pull/642) by [tiangolo](https://github.com/tiangolo).
* 👷 Update token for latest changes. PR [635](https://github.com/tiangolo/typer/pull/635) by [tiangolo](https://github.com/tiangolo).
* 👷 Update CI workflow dispatch for latest changes. PR [643](https://github.com/tiangolo/typer/pull/643) by [tiangolo](https://github.com/tiangolo).
* 👷 Update token for Material for MkDocs Insiders. PR [636](https://github.com/tiangolo/typer/pull/636) by [tiangolo](https://github.com/tiangolo).
* 🐛 Fix internal type annotations and bump mypy version. PR [638](https://github.com/tiangolo/typer/pull/638) by [paulo-raca](https://github.com/paulo-raca).
* 💡 Add comments to document overload definitions in code. PR [752](https://github.com/tiangolo/typer/pull/752) by [svlandeg](https://github.com/svlandeg).
* 🔥 Remove Jina QA Bot as it has been discontinued. PR [749](https://github.com/tiangolo/typer/pull/749) by [tiangolo](https://github.com/tiangolo).
* 👷 Update build docs CI cache paths. PR [707](https://github.com/tiangolo/typer/pull/707) by [tiangolo](https://github.com/tiangolo).
* 👷 Upgrade latest-changes GitHub Action. PR [691](https://github.com/tiangolo/typer/pull/691) by [tiangolo](https://github.com/tiangolo).

Features

* ✨ Add support for PEP-593 `Annotated` for specifying options and arguments. Initial PR [584](https://github.com/tiangolo/typer/pull/584) by [ryangalamb](https://github.com/ryangalamb).
* New docs: [Optional CLI arguments](https://typer.tiangolo.com/tutorial/arguments/optional/#an-alternative-cli-argument-declaration).
* It is no longer required to pass a default value of `...` to mark a *CLI Argument* or *CLI Option* as required.
* It is now recommended to use `Annotated` for `typer.Option()` and `typer.Argument()`.
* All the docs have been updated to recommend `Annotated`.

Docs

* 📝 Update docs examples for custom param types using `Annotated`, fix overloads for `typer.Argument`. PR [594](https://github.com/tiangolo/typer/pull/594) by [tiangolo](https://github.com/tiangolo).

Internal

* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [592](https://github.com/tiangolo/typer/pull/592) by [pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).

Features

* ✨ Add support for custom types and parsers. Initial PR [583](https://github.com/tiangolo/typer/pull/583) by [jpurviance](https://github.com/jpurviance). Based on original PR [#443](https://github.com/tiangolo/typer/pull/443) by [paulo-raca](https://github.com/paulo-raca).
* New docs: [CLI Parameter Types: Custom Types](https://typer.tiangolo.com/tutorial/parameter-types/custom-types/).

Upgrades

* ⬆ Upgrade Rich, support 13.x. PR [524](https://github.com/tiangolo/typer/pull/524) by [musicinmybrain](https://github.com/musicinmybrain).

Docs

* 📝 Tweak docs, Custom Types path, main page and READAME colors, broken links. PR [588](https://github.com/tiangolo/typer/pull/588) by [tiangolo](https://github.com/tiangolo).
* ✏ Fix spelling (shinny -> shiny). PR [586](https://github.com/tiangolo/typer/pull/586) by [runofthemill](https://github.com/runofthemill).
* 📝 Update docs about helping Typer. PR [547](https://github.com/tiangolo/typer/pull/547) by [tiangolo](https://github.com/tiangolo).
* ✏️ Fix typo in datetime docs. PR [495](https://github.com/tiangolo/typer/pull/495) by [huxuan](https://github.com/huxuan).
* ✏️ Add quotes to package name that includes brackets in docs. PR [475](https://github.com/tiangolo/typer/pull/475) by [gjolga](https://github.com/gjolga).

Internal

* ⬆ Bump dawidd6/action-download-artifact from 2.24.2 to 2.26.0. PR [558](https://github.com/tiangolo/typer/pull/558) by [dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [549](https://github.com/tiangolo/typer/pull/549) by [pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
* 🔧 Add `exclude_lines` to coverage configuration. PR [585](https://github.com/tiangolo/typer/pull/585) by [dmontagu](https://github.com/dmontagu).
* ⬆️ Upgrade analytics. PR [557](https://github.com/tiangolo/typer/pull/557) by [tiangolo](https://github.com/tiangolo).
* 🔧 Update new issue chooser to suggest GitHub Discussions. PR [544](https://github.com/tiangolo/typer/pull/544) by [tiangolo](https://github.com/tiangolo).
* 🔧 Add GitHub Discussion templates for questions. PR [541](https://github.com/tiangolo/typer/pull/541) by [tiangolo](https://github.com/tiangolo).
* 🔧 Update pre-commit, Python version, isort version. PR [542](https://github.com/tiangolo/typer/pull/542) by [tiangolo](https://github.com/tiangolo).
* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [512](https://github.com/tiangolo/typer/pull/512) by [pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
* ⬆ Bump nwtgck/actions-netlify from 1.2.4 to 2.0.0. PR [513](https://github.com/tiangolo/typer/pull/513) by [dependabot[bot]](https://github.com/apps/dependabot).
* 👷 Refactor CI artifact upload/download for docs previews. PR [516](https://github.com/tiangolo/typer/pull/516) by [tiangolo](https://github.com/tiangolo).
* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [500](https://github.com/tiangolo/typer/pull/500) by [pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
* ⬆ Bump actions/cache from 2 to 3. PR [496](https://github.com/tiangolo/typer/pull/496) by [dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Bump dawidd6/action-download-artifact from 2.24.1 to 2.24.2. PR [494](https://github.com/tiangolo/typer/pull/494) by [dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Bump dawidd6/action-download-artifact from 2.9.0 to 2.24.1. PR [491](https://github.com/tiangolo/typer/pull/491) by [dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Bump actions/setup-python from 2 to 4. PR [492](https://github.com/tiangolo/typer/pull/492) by [dependabot[bot]](https://github.com/apps/dependabot).
* 👷‍♂️ Consistently use `sys.executable` to run subprocesses, needed by OpenSUSE. PR [408](https://github.com/tiangolo/typer/pull/408) by [theMarix](https://github.com/theMarix).
* 👷‍♂️ Ensure the `PYTHONPATH` is set properly when testing the tutorial scripts. PR [407](https://github.com/tiangolo/typer/pull/407) by [theMarix](https://github.com/theMarix).

Features

* ✨ Make `typer.run()` not add completion scripts by default, it only makes sense in installed apps. Also update docs for handling [autocompletion in CLI options](https://typer.tiangolo.com/tutorial/options-autocompletion/). PR [#488](https://github.com/tiangolo/typer/pull/488) by [tiangolo](https://github.com/tiangolo).
* ✨ Add support for Python 3.11, tests in CI and official marker. PR [487](https://github.com/tiangolo/typer/pull/487) by [tiangolo](https://github.com/tiangolo).
* 👷 Add CI for Python 3.10. PR [384](https://github.com/tiangolo/typer/pull/384) by [tiangolo](https://github.com/tiangolo).

Fixes

* 🎨 Fix type annotation of `typer.run()`. PR [284](https://github.com/tiangolo/typer/pull/284) by [yassu](https://github.com/yassu).
* 🎨 Fix type annotations for `get_group`. PR [430](https://github.com/tiangolo/typer/pull/430) by [tiangolo](https://github.com/tiangolo).

Docs

* 📝 Add note about how subcommands with function names using underscores are converted to dashes. PR [403](https://github.com/tiangolo/typer/pull/403) by [targhs](https://github.com/targhs).
* 📝 Fix typo in docs at `docs/tutorial/commands/help.md`. PR [466](https://github.com/tiangolo/typer/pull/466) by [fepegar](https://github.com/fepegar).
* ✏ Fix link in docs to `datetime.strptime()`. PR [464](https://github.com/tiangolo/typer/pull/464) by [Kobu](https://github.com/Kobu).
* ✏ Update `first-steps.md`, clarify distinction between parameter and argument. PR [176](https://github.com/tiangolo/typer/pull/176) by [mccarthysean](https://github.com/mccarthysean).
* ✏ Fix broken plac link. PR [275](https://github.com/tiangolo/typer/pull/275) by [mgielda](https://github.com/mgielda).

Internal

* ✅ Add extra tests just for coverage because monkeypatching with strange imports confuses coverage. PR [490](https://github.com/tiangolo/typer/pull/490) by [tiangolo](https://github.com/tiangolo).
* 🔧 Tweak pytest coverage. PR [485](https://github.com/tiangolo/typer/pull/485) by [tiangolo](https://github.com/tiangolo).
* ➕ Bring back pytest-cov because coverage can't detect pytest-xdist. PR [484](https://github.com/tiangolo/typer/pull/484) by [tiangolo](https://github.com/tiangolo).
* ⬆ Bump actions/upload-artifact from 2 to 3. PR [477](https://github.com/tiangolo/typer/pull/477) by [dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Bump actions/checkout from 2 to 3. PR [478](https://github.com/tiangolo/typer/pull/478) by [dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [411](https://github.com/tiangolo/typer/pull/411) by [pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
* ⬆ Bump nwtgck/actions-netlify from 1.1.5 to 1.2.4. PR [479](https://github.com/tiangolo/typer/pull/479) by [dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Bump tiangolo/issue-manager from 0.2.0 to 0.4.0. PR [481](https://github.com/tiangolo/typer/pull/481) by [dependabot[bot]](https://github.com/apps/dependabot).
* 👷 Move from pytest-cov to coverage and Codecov to Smokeshow. PR [483](https://github.com/tiangolo/typer/pull/483) by [tiangolo](https://github.com/tiangolo).
* ➕ Add extra Material for MkDocs deps for docs. PR [482](https://github.com/tiangolo/typer/pull/482) by [tiangolo](https://github.com/tiangolo).
* 🔧 Update Dependabot config. PR [476](https://github.com/tiangolo/typer/pull/476) by [tiangolo](https://github.com/tiangolo).

Fixes

* 🐛 Fix setting `FORCE_TERMINAL` with colors 2. PR [424](https://github.com/tiangolo/typer/pull/424) by [tiangolo](https://github.com/tiangolo).
* 🐛 Fix setting `FORCE_TERMINAL` with colors. PR [423](https://github.com/tiangolo/typer/pull/423) by [tiangolo](https://github.com/tiangolo).

This release adds deep integrations with [Rich](https://rich.readthedocs.io/en/stable/). ✨

`rich` is an optional dependency, you can install it directly or it will be included when you install with:

console
$ pip install "typer[all]"


If Rich is available, it will be used to show the content from `--help` options, validation errors, and even errors in your app (exception tracebacks).

There are new options to group commands, *CLI arguments*, and *CLI options*, support for [Rich Console Markup](https://rich.readthedocs.io/en/stable/markup.html), and more! 🎉

Features

* ✨ Richify, add integrations with Rich everywhere. PR [419](https://github.com/tiangolo/typer/pull/419) by [tiangolo](https://github.com/tiangolo).
* Recommend Rich as the main information displaying tool, new docs: [Printing and Colors](https://typer.tiangolo.com/tutorial/printing/).
* For most use cases not using Rich, use plain `print()` instead of `typer.echo()` in the docs, to simplify the concepts and avoid confusions. New docs: [Printing and Colors - typer Echo](https://typer.tiangolo.com/tutorial/printing/#typer-echo).
* Define help panels for *CLI arguments*, new docs: [CLI Arguments with Help - CLI Argument help panels](https://typer.tiangolo.com/tutorial/arguments/help/#cli-argument-help-panels).
* Define help panels for *CLI options*, new docs: [CLI Options with Help - CLI Options help panels](https://typer.tiangolo.com/tutorial/options/help/#cli-options-help-panels).
* New docs for deprecating commands: [Commands - Command Help - Deprecate a Command](https://typer.tiangolo.com/tutorial/commands/help/#deprecate-a-command).
* Support for Rich Markdown in docstrings, *CLI parameters* `help`, and `epilog` with the new parameter `typer.Typer(rich_markup_mode="markdown")`, new docs: [Commands - Command Help - Rich Markdown and Markup](https://typer.tiangolo.com/tutorial/commands/help/#rich-markdown-and-markup).
* Support for Rich Markup (different from Markdown) in docstrings, *CLI parameters* `help`, and `epilog` with the new parameter `typer.Typer(rich_markup_mode="rich")`, new docs: [Commands - Command Help - Rich Markdown and Markup](https://typer.tiangolo.com/tutorial/commands/help/#rich-markdown-and-markup).
* Define help panels for *commands*, new docs: [Commands - Command Help - Help Panels](https://typer.tiangolo.com/tutorial/commands/help/#help-panels).
* New docs for setting an `epilog`, with support for Rich Markdown and Console Markup, new docs: [Commands - Command Help - Epilog](https://typer.tiangolo.com/tutorial/commands/help/#epilog).
* ✨ Refactor and document handling pretty exceptions. PR [422](https://github.com/tiangolo/typer/pull/422) by [tiangolo](https://github.com/tiangolo).
* Add support for customizing pretty short errors, new docs: [Exceptions and Errors](https://typer.tiangolo.com/tutorial/exceptions/).
* ✨ Allow configuring pretty errors when creating the Typer instance. PR [416](https://github.com/tiangolo/typer/pull/416) by [tiangolo](https://github.com/tiangolo).

Docs

* 📝 Add docs for using Rich with Typer. PR [421](https://github.com/tiangolo/typer/pull/421) by [tiangolo](https://github.com/tiangolo).
* Add new docs: [Ask with Prompt - Prompt with Rich](https://typer.tiangolo.com/tutorial/prompt/#prompt-with-rich).
* Add new docs to handle progress bars and spinners with Rich: [Progress Par](https://typer.tiangolo.com/tutorial/progressbar/).

Internal

* ⬆️ Upgrade codecov GitHub Action. PR [420](https://github.com/tiangolo/typer/pull/420) by [tiangolo](https://github.com/tiangolo).