0.21.0

Breaking Changes

• ➖ Drop support for Python 3.8. PR #1464 by @tiangolo.
• ➖ Drop support for Python 3.8 in CI. PR #1463 by @YuriiMotov and @tiangolo.

Docs

• 📝 Update code examples to Python 3.9. PR #1459 by @YuriiMotov.

Internal

• 💚 Move ruff dependency to shared requirements-docs-tests.txt to fix "Build docs" workflow in CI. PR #1458 by @YuriiMotov.
• ⬆ Bump markdown-include-variants from 0.0.5 to 0.0.8. PR #1442 by @dependabot[bot].
• 👷 Add pre-commit workflow. PR #1453 by @tiangolo.
• 👷 Configure coverage, error on main tests, don't wait for Smokeshow. PR #1448 by @YuriiMotov.
• 👷 Run Smokeshow always, even on test failures. PR #1447 by @YuriiMotov.
• 🔨 Add Typer script to generate example variants for Python files. PR #1452 by @tiangolo.

0.20.1

Features

• ✨ Add support for standard tracebacks via the env TYPER_STANDARD_TRACEBACK. PR #1299 by @colin-nolan.

Fixes

• 🐛 Ensure that options_metavar is passed through correctly. PR #816 by @gar1t.
• 🐛 Ensure an optional argument is shown in brackets, even when metavar is set. PR #1409 by @svlandeg.
• 🐛 Ensure that the default rich_markup_mode is interpreted correctly. PR #1304 by @svlandeg.

Refactors

• ♻️ Refactor the handling of shellingham. PR #1347 by @nathanjmcdougall.

Docs

• 📝 Ensure that bold letters are rendered correctly in printing.md. PR #1365 by @svlandeg.
• 🩺 Update test badge to only reflect pushes to master. PR #1414 by @svlandeg.
• 📝 Update console output on the Rich help formatting page. PR #1430 by @svlandeg.
• 📝 Update emoji used in Rich help formatting tutorial. PR #1429 by @svlandeg.
• 📝 Remove duplicate explanation how the path is resolved. PR #956 by @dennis-rall.
• 📝 Update docs to use Typer() more prominently. PR #1418 by @svlandeg.
• 💄 Use font 'Fira Code' to fix display of Rich panels in docs in Windows. PR #1419 by @tiangolo.

Internal

• 🔨 Add --showlocals to test.sh. PR #1169 by @rickwporter.
• ⬆ Bump ruff from 0.14.6 to 0.14.8. PR #1436 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1434 by @pre-commit-ci[bot].
• ✅ Update tests to use mod.app . PR #1427 by @svlandeg.
• ⬆ Bump actions/checkout from 5 to 6. PR #1426 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1425 by @pre-commit-ci[bot].
• ⬆ Bump ruff from 0.14.5 to 0.14.6. PR #1423 by @dependabot[bot].
• ⬆ Bump actions/checkout from 5 to 6. PR #1417 by @dependabot[bot].
• 👷 Upgrade latest-changes GitHub Action and pin actions/checkout@v5. PR #1424 by @tiangolo.
• 🔧 Upgrade Material for MkDocs and remove insiders. PR #1416 by @tiangolo.
• ⬆ Bump mkdocs-material from 9.6.23 to 9.7.0. PR #1404 by @dependabot[bot].
• ⬆ Bump mkdocs-macros-plugin from 1.4.1 to 1.5.0. PR #1406 by @dependabot[bot].
• ⬆ Bump ruff from 0.14.4 to 0.14.5. PR #1407 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1413 by @pre-commit-ci[bot].
• ⬆ Bump ruff from 0.14.3 to 0.14.4. PR #1402 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1403 by @pre-commit-ci[bot].
• ⬆ Bump ruff from 0.14.2 to 0.14.3. PR #1396 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1399 by @pre-commit-ci[bot].
• ⬆ Bump mkdocs-material from 9.6.22 to 9.6.23. PR #1398 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1394 by @pre-commit-ci[bot].
• ⬆ Bump ruff from 0.14.1 to 0.14.2. PR #1383 by @dependabot[bot].
• ⬆ Bump actions/upload-artifact from 4 to 5. PR #1388 by @dependabot[bot].
• ⬆ Bump mkdocs-macros-plugin from 1.4.0 to 1.4.1. PR #1389 by @dependabot[bot].
• ⬆ Bump actions/download-artifact from 5 to 6. PR #1391 by @dependabot[bot].
• 🔧 Add PEP-639 license metadata. PR #1387 by @svlandeg.
• ⬆ Bump mypy from 1.11.2 to 1.14.1. PR #1375 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1380 by @pre-commit-ci[bot].
• ⬆ Bump ruff from 0.14.0 to 0.14.1. PR #1379 by @dependabot[bot].

0.20.0

Features

• ✨ Enable command suggestions on typo by default. PR #1371 by @savannahostrowski.

Upgrades

• ⬆️ Add support for Python 3.14. PR #1372 by @svlandeg.

Internal

• 👷 Add nightly workflow to run tests against CPython main branch. PR #1374 by @savannahostrowski.
• ⬆ Bump mkdocs-material from 9.6.21 to 9.6.22. PR #1377 by @dependabot[bot].
• 🔧 Configure reminder for waiting label in issue-manager. PR #1378 by @YuriiMotov.
• ⬆ Bump ruff from 0.13.3 to 0.14.0. PR #1368 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1376 by @pre-commit-ci[bot].
• ⬆ Bump mkdocs-macros-plugin from 1.3.9 to 1.4.0. PR #1354 by @dependabot[bot].
• ⬆ Bump mkdocs-material from 9.6.20 to 9.6.21. PR #1360 by @dependabot[bot].
• ⬆ Bump mypy from 1.4.1 to 1.11.2. PR #957 by @dependabot[bot].
• ⬆ Bump astral-sh/setup-uv from 6 to 7. PR #1369 by @dependabot[bot].
• ⬆ Bump ruff from 0.13.2 to 0.13.3. PR #1366 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1367 by @pre-commit-ci[bot].
• ⬆ Bump tiangolo/issue-manager from 0.5.1 to 0.6.0. PR #1361 by @dependabot[bot].
• ⬆ Bump ruff from 0.13.1 to 0.13.2. PR #1357 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1358 by @pre-commit-ci[bot].
• 👷 Update docs previews comment, single comment, add failure status. PR #1359 by @tiangolo.

0.19.2

Fixes

• 🐛 Fix list convertor with an empty list default factory . PR #1350 by @svlandeg.

Refactors

• 🔥 Drop support for Python 3.7. PR #830 by @kinuax.

Internal

• ⬆ Bump ruff from 0.13.0 to 0.13.1. PR #1339 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1351 by @pre-commit-ci[bot].
• ⬆ Bump markdown-include-variants from 0.0.4 to 0.0.5. PR #1348 by @dependabot[bot].

0.19.1

Note: this is the last version to support Python 3.7, going forward Typer will require Python 3.8+. And soon Python 3.8 will also be dropped as Python 3.8 reached it's end of life almost a year ago.

Fixes

• 🐛 Ensure that Optional[list] values work correctly with callbacks. PR #1018 by @solesensei.

0.19.0

Features

• ✨ Support typing.Literal to define a set of predefined choices. PR #429 by @blackary.
• ✨ Allow setting an environment variable to None in CliRunner.invoke. PR #1303 by @arjenzorgdoc.

Refactors

• ✅ Use Ruff rules to ensure safe lazy-loading of rich. PR #1297 by @nathanjmcdougall.
• ✅ Avoid rich formatting in number test. PR #1305 by @svlandeg.

Docs

• 📝 Clarify single-command vs multi-command behaviour in README. PR #1268 by @MorgenPronk.

0.18.0

Fixes

• 👽️ Ensure compatibility with Click 8.3.0 by restoring the original value_is_missing function. PR #1333 by @svlandeg.

Upgrades

• 📌 Remove pin for Click < 8.3.0 now that there's a fix for the changes. PR #1346 by @tiangolo.

0.17.5

Fixes

• ⬇️ Restrict Click to below 8.3.0 to handle changes in the new version. PR #1336 by @svlandeg.

Internal

• ⬆ Bump mkdocs-material from 9.6.14 to 9.6.20. PR #1308 by @dependabot[bot].
• ⬆ Bump mkdocs-material from 9.5.50 to 9.6.14. PR #1223 by @dependabot[bot].
• ⬆ Bump actions/download-artifact from 4 to 5. PR #1269 by @dependabot[bot].
• ⬆ Bump ruff from 0.12.12 to 0.13.0. PR #1302 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1307 by @pre-commit-ci[bot].
• ⬆ Update pytest-cov requirement from <7.0.0,>=2.10.0 to >=2.10.0,<8.0.0. PR #1301 by @dependabot[bot].
• ⬆ Bump actions/setup-python from 5 to 6. PR #1291 by @dependabot[bot].
• ⬆ Bump ruff from 0.12.11 to 0.12.12. PR #1295 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1300 by @pre-commit-ci[bot].
• ⬆ Bump actions/labeler from 5 to 6. PR #1296 by @dependabot[bot].

0.17.4

Fixes

• 🐛 Make sure rich.markup is imported when rendering help text. PR #1290 by @g-arjones.

Internal

• ⬆ Bump pypa/gh-action-pypi-publish from 1.12.4 to 1.13.0. PR #1292 by @dependabot[bot].
• ⬆ Bump ruff from 0.12.10 to 0.12.11. PR #1283 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1288 by @pre-commit-ci[bot].
• 👷 Set permissions for conflict detector workflow. PR #1287 by @svlandeg.
• 👷 Detect and label merge conflicts on PRs automatically. PR #1286 by @svlandeg.

0.17.3

Features

• ✨ Allow annotated parsing with a subclass of Path. PR #1183 by @emfdavid.