Typer

Features

* 💄 Unify the width of the Rich console for help and errors. PR [788](https://github.com/fastapi/typer/pull/788) by [racinmat](https://github.com/racinmat).
* 🚸 Improve assertion error message if a group is not a valid subclass. PR [425](https://github.com/fastapi/typer/pull/425) by [chrisburr](https://github.com/chrisburr).

Fixes

* 🐛 Ensure `rich_markup_mode=None` disables Rich formatting. PR [859](https://github.com/fastapi/typer/pull/859) by [svlandeg](https://github.com/svlandeg).
* 🐛 Fix sourcing of completion path for Git Bash. PR [801](https://github.com/fastapi/typer/pull/801) by [svlandeg](https://github.com/svlandeg).
* 🐛 Fix PowerShell completion with incomplete word. PR [360](https://github.com/fastapi/typer/pull/360) by [patricksurry](https://github.com/patricksurry).

Refactors

* 🔥 Remove Python 3.6 specific code paths. PR [850](https://github.com/fastapi/typer/pull/850) by [svlandeg](https://github.com/svlandeg).
* 🔥 Clean up redundant code. PR [858](https://github.com/fastapi/typer/pull/858) by [svlandeg](https://github.com/svlandeg).

Docs

* ♻️ Use F-strings in Click examples in docs. PR [891](https://github.com/fastapi/typer/pull/891) by [svlandeg](https://github.com/svlandeg).
* 📝Add missing `main.py` in tutorial on CLI option names. PR [868](https://github.com/fastapi/typer/pull/868) by [fsramalho](https://github.com/fsramalho).
* 📝 Fix broken link. PR [835](https://github.com/fastapi/typer/pull/835) by [OhioDschungel6](https://github.com/OhioDschungel6).
* 📝 Update package docs with the latest versions of Typer and Poetry. PR [781](https://github.com/fastapi/typer/pull/781) by [kinuax](https://github.com/kinuax).
* 📝 Update the Progress Bar tutorial with correct output. PR [199](https://github.com/fastapi/typer/pull/199) by [n1ckdm](https://github.com/n1ckdm).
* 📝 Add docs and scripts to test completion in different shells. PR [953](https://github.com/fastapi/typer/pull/953) by [tiangolo](https://github.com/tiangolo).
* ✏️ Fix a typo in `docs/virtual-environments.md`. PR [952](https://github.com/fastapi/typer/pull/952) by [tiangolo](https://github.com/tiangolo).
* ✏️ Fix typo in `docs/contributing.md`. PR [947](https://github.com/fastapi/typer/pull/947) by [tiangolo](https://github.com/tiangolo).
* 📝 Add docs for virtual environments, environment variables, and update contributing. PR [946](https://github.com/fastapi/typer/pull/946) by [tiangolo](https://github.com/tiangolo).

Internal

* 🔨 Pre-install dependencies in Docker so that testing in Docker is faster. PR [954](https://github.com/fastapi/typer/pull/954) by [tiangolo](https://github.com/tiangolo).
* ✅ Add `needs_bash` test fixture. PR [888](https://github.com/fastapi/typer/pull/888) by [svlandeg](https://github.com/svlandeg).
* ⬆ Bump mkdocs-material from 9.5.18 to 9.5.33. PR [945](https://github.com/fastapi/typer/pull/945) by [dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Bump pillow from 10.3.0 to 10.4.0. PR [939](https://github.com/fastapi/typer/pull/939) by [dependabot[bot]](https://github.com/apps/dependabot).
* 👷 Fix issue-manager. PR [948](https://github.com/fastapi/typer/pull/948) by [tiangolo](https://github.com/tiangolo).
* 🙈 Remove extra line in .gitignore. PR [936](https://github.com/fastapi/typer/pull/936) by [tiangolo](https://github.com/tiangolo).
* ⬆ Update pytest-cov requirement from <5.0.0,>=2.10.0 to >=2.10.0,<6.0.0. PR [844](https://github.com/fastapi/typer/pull/844) by [dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Bump pypa/gh-action-pypi-publish from 1.8.11 to 1.9.0. PR [865](https://github.com/fastapi/typer/pull/865) by [dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Update pytest requirement from <8.0.0,>=4.4.0 to >=4.4.0,<9.0.0. PR [915](https://github.com/fastapi/typer/pull/915) by [dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Update pytest-sugar requirement from <0.10.0,>=0.9.4 to >=0.9.4,<1.1.0. PR [841](https://github.com/fastapi/typer/pull/841) by [dependabot[bot]](https://github.com/apps/dependabot).

Features

* ✨ Add support for Python 3.12, tests in CI and official marker. PR [807](https://github.com/tiangolo/typer/pull/807) by [ivantodorovich](https://github.com/ivantodorovich).

Fixes

* 🐛 Fix support for `UnionType` (e.g. `str | None`) with Python 3.11. PR [548](https://github.com/fastapi/typer/pull/548) by [jonaslb](https://github.com/jonaslb).
* 🐛 Fix `zsh` autocompletion installation. PR [237](https://github.com/fastapi/typer/pull/237) by [alexjurkiewicz](https://github.com/alexjurkiewicz).
* 🐛 Fix usage of `Annotated` with future annotations in Python 3.7+. PR [814](https://github.com/fastapi/typer/pull/814) by [ivantodorovich](https://github.com/ivantodorovich).
* 🐛 Fix `shell_complete` not working for Arguments. PR [737](https://github.com/fastapi/typer/pull/737) by [bckohan](https://github.com/bckohan).

Docs

* 📝 Update docs links, from tiangolo to new fastapi org. PR [919](https://github.com/fastapi/typer/pull/919) by [tiangolo](https://github.com/tiangolo).
* 📝 Add docs for team and repo management. PR [917](https://github.com/tiangolo/typer/pull/917) by [tiangolo](https://github.com/tiangolo).

Internal

* 🔧 Add URLs to `pyproject.toml`, show up in PyPI. PR [931](https://github.com/fastapi/typer/pull/931) by [tiangolo](https://github.com/tiangolo).
* 👷 Do not sync labels as it overrides manually added labels. PR [930](https://github.com/fastapi/typer/pull/930) by [tiangolo](https://github.com/tiangolo).
* 👷 Update labeler GitHub Action to add only one label. PR [927](https://github.com/fastapi/typer/pull/927) by [tiangolo](https://github.com/tiangolo).
* 👷 Update labeler GitHub Actions permissions and dependencies. PR [926](https://github.com/fastapi/typer/pull/926) by [tiangolo](https://github.com/tiangolo).
* 👷 Add GitHub Action label-checker. PR [925](https://github.com/fastapi/typer/pull/925) by [tiangolo](https://github.com/tiangolo).
* 👷 Add GitHub Action labeler. PR [924](https://github.com/fastapi/typer/pull/924) by [tiangolo](https://github.com/tiangolo).
* 👷 Add GitHub Action add-to-project. PR [922](https://github.com/fastapi/typer/pull/922) by [tiangolo](https://github.com/tiangolo).
* 🔨 Update docs.py script to enable dirty reload conditionally. PR [918](https://github.com/tiangolo/typer/pull/918) by [tiangolo](https://github.com/tiangolo).
* 🔧 Update MkDocs previews. PR [916](https://github.com/tiangolo/typer/pull/916) by [tiangolo](https://github.com/tiangolo).
* 👷 Upgrade build docs configs. PR [914](https://github.com/tiangolo/typer/pull/914) by [tiangolo](https://github.com/tiangolo).
* 🔧 Update MkDocs to have titles in Markdown files instead of config. PR [913](https://github.com/tiangolo/typer/pull/913) by [tiangolo](https://github.com/tiangolo).
* 👷 Add alls-green for test-redistribute. PR [911](https://github.com/tiangolo/typer/pull/911) by [tiangolo](https://github.com/tiangolo).
* 👷 Update docs-previews to handle no docs changes. PR [912](https://github.com/tiangolo/typer/pull/912) by [tiangolo](https://github.com/tiangolo).
* 👷🏻 Show docs deployment status and preview URLs in comment. PR [910](https://github.com/tiangolo/typer/pull/910) by [tiangolo](https://github.com/tiangolo).
* 🔧 Enable auto dark mode from system. PR [908](https://github.com/tiangolo/typer/pull/908) by [tiangolo](https://github.com/tiangolo).
* 💄 Add dark mode logo. PR [907](https://github.com/tiangolo/typer/pull/907) by [tiangolo](https://github.com/tiangolo).
* 🔧 Update tabs and admonitions with new syntax and new MkDocs features. PR [906](https://github.com/tiangolo/typer/pull/906) by [tiangolo](https://github.com/tiangolo).
* 🔧 Enable MkDocs Material features. PR [905](https://github.com/tiangolo/typer/pull/905) by [tiangolo](https://github.com/tiangolo).
* 🔧 Enable dark mode for docs. PR [904](https://github.com/tiangolo/typer/pull/904) by [tiangolo](https://github.com/tiangolo).
* ➖ Do not install jieba for MkDocs Material as there are no chinese translations. PR [903](https://github.com/tiangolo/typer/pull/903) by [tiangolo](https://github.com/tiangolo).
* 🙈 Add MkDocs Material cache to gitignore. PR [902](https://github.com/tiangolo/typer/pull/902) by [tiangolo](https://github.com/tiangolo).
* 🔨 Update lint script. PR [901](https://github.com/tiangolo/typer/pull/901) by [tiangolo](https://github.com/tiangolo).
* 🔧 Update MkDocs configs and docs build setup. PR [900](https://github.com/tiangolo/typer/pull/900) by [tiangolo](https://github.com/tiangolo).
* ⬆ Bump actions/cache from 3 to 4. PR [839](https://github.com/tiangolo/typer/pull/839) by [dependabot[bot]](https://github.com/apps/dependabot).
* 🍱 Update Typer icon and logo. PR [899](https://github.com/tiangolo/typer/pull/899) by [tiangolo](https://github.com/tiangolo).
* 👷 Update issue-manager.yml GitHub Action permissions. PR [897](https://github.com/tiangolo/typer/pull/897) by [tiangolo](https://github.com/tiangolo).
* 👷 Refactor GitHub Action to comment docs deployment URLs and update token, preparing for GitHub org. PR [896](https://github.com/tiangolo/typer/pull/896) by [tiangolo](https://github.com/tiangolo).
* 🔨 Update docs Termynal scripts to not include line nums for local dev. PR [882](https://github.com/tiangolo/typer/pull/882) by [tiangolo](https://github.com/tiangolo).
* ⬆ Bump black from 23.3.0 to 24.3.0. PR [837](https://github.com/tiangolo/typer/pull/837) by [dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Bump pillow from 10.1.0 to 10.3.0. PR [836](https://github.com/tiangolo/typer/pull/836) by [dependabot[bot]](https://github.com/apps/dependabot).
* ✅ Add CI configs to run tests on Windows and MacOS. PR [824](https://github.com/tiangolo/typer/pull/824) by [svlandeg](https://github.com/svlandeg).
* 👷 Update GitHub Actions to upload and download artifacts. PR [829](https://github.com/tiangolo/typer/pull/829) by [tiangolo](https://github.com/tiangolo).
* 👷 Tweak CI for test-redistribute, add needed env vars for slim. PR [827](https://github.com/tiangolo/typer/pull/827) by [tiangolo](https://github.com/tiangolo).
* ✅ Generalize test suite to run on Windows. PR [810](https://github.com/tiangolo/typer/pull/810) by [svlandeg](https://github.com/svlandeg).
* ✅ Add `__init__.py` files to fix test suite. PR [809](https://github.com/tiangolo/typer/pull/809) by [svlandeg](https://github.com/svlandeg).
* 🔧 Update MkDocs Material, enable plugins. PR [813](https://github.com/tiangolo/typer/pull/813) by [tiangolo](https://github.com/tiangolo).
* 🔧 Tweak development scripts and configs after migration to PDM, Ruff, etc.. PR [797](https://github.com/tiangolo/typer/pull/797) by [tiangolo](https://github.com/tiangolo).

Fixes

* 🐛 Fix Rich formatting with no commands. PR [796](https://github.com/tiangolo/typer/pull/796) by [svlandeg](https://github.com/svlandeg).

Features

* ✨ Improve column help display, ensure commands column width is the same on all panels. PR [567](https://github.com/tiangolo/typer/pull/567) by [ssbarnea](https://github.com/ssbarnea).

Fixes

* 🐛 Add support for an argument of type `Optional[Tuple]` and default value `None`. PR [757](https://github.com/tiangolo/typer/pull/757) by [Asthestarsfalll](https://github.com/Asthestarsfalll).

Docs

* 🔧 Fix typo in Github template. PR [793](https://github.com/tiangolo/typer/pull/793) by [svlandeg](https://github.com/svlandeg).
* 📝 Fix typos in documentation. PR [761](https://github.com/tiangolo/typer/pull/761) by [svlandeg](https://github.com/svlandeg).
* 📝 Update console output with Click 8 messages. PR [789](https://github.com/tiangolo/typer/pull/789) by [svlandeg](https://github.com/svlandeg).
* 📝 Remove references to a .rst README generated by poetry new. PR [632](https://github.com/tiangolo/typer/pull/632) by [jonasmmiguel](https://github.com/jonasmmiguel).

Now you don't need to install `typer[all]`. When you install `typer` it comes with the default optional dependencies and the `typer` command.

If you don't want the extra optional dependencies (`rich` and `shellingham`), you can install `typer-slim` instead.

You can also install `typer-slim[standard]`, which includes the default optional dependencies, but not the `typer` command.

Now the package `typer-cli` doesn't add anything on top of what `typer` has, it only depends on `typer`, and is there only for backwards compatibility, so that projects that depend on `typer-cli` can get the latest features of the `typer` command while they upgrade their dependencies to require `typer` directly.

Features

* ✨ Add support for `typer ./someprogram.py utils docs --title`. PR [782](https://github.com/tiangolo/typer/pull/782) by [tiangolo](https://github.com/tiangolo).

Fixes

* 🐛 Fix broken installation when upgrading from `typer <0.12.0` to `typer >=0.12.0`, make `typer` independent of `typer-slim`, include `typer` command in `typer` package. PR [791](https://github.com/tiangolo/typer/pull/791) by [tiangolo](https://github.com/tiangolo).

This fixes a problem that would break the `typer` installation directory when upgrading from `typer <0.12.0` to `typer >=0.12.0`, see issue [790](https://github.com/tiangolo/typer/issues/790).

By installing the latest version (`0.12.1`) it fixes it, for any previous version, even if the installation directory was already broken by the previous upgrade.

Internal

* 👷 Add cron to run test once a week on monday. PR [783](https://github.com/tiangolo/typer/pull/783) by [estebanx64](https://github.com/estebanx64).

In version `0.12.0`, the `typer` package depends on `typer-slim[standard]` which includes the default dependencies (instead of `typer[all]`) and `typer-cli` (that provides the `typer` command).

If you don't want the extra optional dependencies (`rich` and `shellingham`), you can install `typer-slim` instead.

You can also install `typer-slim[standard]`, which includes the default optional dependencies, but not the `typer` command.

In version `0.12.0` the `typer-cli` package only provides the `typer` command, but the code is still in the main code, so even without installing `typer-cli`, it can be called with `python -m typer`.

This approach of having `typer` depend on `typer-slim[standard]` instead of including the whole code and dependencies itself caused an issue when upgrading from `typer <0.12.0` to `typer >=0.12.0`, see issue [790](https://github.com/tiangolo/typer/issues/790). This is fixed in version `0.12.1`.

Features

* ✨ Add `typer-slim` package without extras, make `typer` include `typer-slim[default]` and integrate Typer CLI (`typer` command) into Typer. PR [780](https://github.com/tiangolo/typer/pull/780) by [tiangolo](https://github.com/tiangolo).

Internal

* 🔧 Temporarily disable social plugin while a MkDocs issue is handled. PR [779](https://github.com/tiangolo/typer/pull/779) by [tiangolo](https://github.com/tiangolo).
* 👷 Fix install MkDocs Insiders only when available. PR [778](https://github.com/tiangolo/typer/pull/778) by [tiangolo](https://github.com/tiangolo).