fastapi/typer
61.3
Adequate · 17 November 2026
15k
lines of production code
Python
primary language
5
measurements over time
What this system is
Features
New internal scripts for release preparation and documentation management
Added a suite of internal scripts to streamline the release process and documentation workflow. The \prepare\_release.py\ script automates version bumping and release note updates, while \add\_latest\_release\_date.py\ ensures release notes are dated. Documentation management is handled by \docs.py\, which supports building, serving, and generating version-specific source files using Zensical and Ruff. Additional utility scripts include \lint.sh\ and \format.sh\ for code quality checks, \test.sh\ for running tests with coverage and local variables, and \test-files.sh\ to detect copy-paste errors in tutorials.
scripts · high confidence
Behavioural changes
1 commit (0 fixes) modifying docs\_src/arguments, docs\_src/multiple\_values, docs\_src/options
A change to existing behaviour in docs\_src/arguments, docs\_src/multiple\_values, docs\_src/options — 1 commit, 3 files: “📝 Update code examples to Python 3.9 (\#1459)” (refs \#1459).
_docs\_src/arguments, docs\_src/multiple\_values, docs\src/options · low confidence · unverified
12 commits (2 fixes) modifying docs\_src/commands
A change to existing behaviour in docs\_src/commands — 12 commits (2 fixs), 46 files: “✨ Show help items in order of definition (\#944)”; “📝 Update emoji used in Rich help formatting tutorial (\#1429)”; “🔧 Migrate from Black, isort, flake8, autoflake, pyupgrade to Ruff (\#763)”; and 9 more (refs \#944, \#1429, \#763, \#751, \#586, …).
_docs\src/commands · medium confidence · unverified
12 commits (2 fixes) modifying docs\_src/parameter\_types
A change to existing behaviour in docs\_src/parameter\_types — 12 commits (2 fixs), 52 files: “📝 Add Optional to docs for CLI Arguments and Options with a None default (\#131)”; “🔧 Migrate from Black, isort, flake8, autoflake, pyupgrade to Ruff (\#763)”; “✨ Add support for custom types and parsers (updates/builds upon PR \#443) (\#583)”; and 9 more (refs \#131, \#763, \#443, \#583, \#2010, …).
_docs\_src/parameter\types · medium confidence · unverified
2 commits (0 fixes) modifying docs\_src
A change to existing behaviour in docs\_src — 2 commits, 257 files: “📝 Adopt unversioned documentation snippets (\#2010)”; “✨ Use Pydantic for parameter validation (\#1831)” (refs \#2010, \#1831). Also in this area: Documentation examples updated to Python 3.10 syntax.
_docs\_src/one\_file\_per\command · medium confidence · unverified
4 commits (0 fixes) modifying docs\_src/exceptions
A change to existing behaviour in docs\_src/exceptions — 4 commits, 7 files: “📝 Adopt unversioned documentation snippets (\#2010)”; “📝 Update code examples to Python 3.9 (\#1459)”; “✨ Refactor and document handling pretty exceptions (\#422)”; and 1 more (refs \#2010, \#1459, \#422, \#1418).
_docs\src/exceptions · medium confidence · unverified
4 commits (0 fixes) modifying docs\_src/options\_autocompletion
A change to existing behaviour in docs\_src/options\_autocompletion — 4 commits, 19 files: “✨ Make \typer.run()\ not add completion scripts by default, it only makes sense in installed apps (\#488)”; “🔧 Migrate from Black, isort, flake8, autoflake, pyupgrade to Ruff (\#763)”; “📝 Adopt unversioned documentation snippets (\#2010)”; and 1 more (refs \#488, \#763, \#2010, \#1459).
_docs\_src/options\autocompletion · medium confidence · unverified
5 commits (0 fixes) modifying (repo-wide)
A change to existing behaviour in (repo-wide) — 5 commits, 49 files: “📝 Adopt unversioned documentation snippets (\#2010)”; “📝 Update code examples to Python 3.9 (\#1459)”; “✨ Richify, add integrations with Rich everywhere (\#419)”; and 2 more (refs \#2010, \#1459, \#419, \#137, \#1418).
(repo-wide) · medium confidence · unverified
6 commits (0 fixes) modifying docs\_src/arguments/help, docs\_src/multiple\_values/arguments\_with\_multiple\_values
A change to existing behaviour in docs\_src/arguments/help, docs\_src/multiple\_values/arguments\_with\_multiple\_values — 6 commits, 21 files: “🔧 Migrate from Black, isort, flake8, autoflake, pyupgrade to Ruff (\#763)”; “📝 Adopt unversioned documentation snippets (\#2010)”; “📝 Update code examples to Python 3.9 (\#1459)”; and 3 more (refs \#763, \#2010, \#1459, \#419, \#137, …).
_docs\_src/arguments/help, docs\_src/multiple\_values/arguments\_with\_multiple\values · medium confidence · unverified
6 commits (0 fixes) modifying docs\_src/options/callback
A change to existing behaviour in docs\_src/options/callback — 6 commits, 9 files: “📝 Adopt unversioned documentation snippets (\#2010)”; “📝 Update code examples to Python 3.9 (\#1459)”; “🔥 Remove support for Click 7, require Click 8+ (\#760)”; and 3 more (refs \#2010, \#1459, \#760, \#419, \#137, …).
_docs\src/options/callback · medium confidence · unverified
6 commits (0 fixes) modifying docs\_src/options/required
A change to existing behaviour in docs\_src/options/required — 6 commits, 4 files: “✨ Add support for PEP-593 \Annotated\ for specifying options and arguments (\#584)”; “📝 Adopt unversioned documentation snippets (\#2010)”; “📝 Update code examples to Python 3.9 (\#1459)”; and 3 more (refs \#584, \#2010, \#1459, \#419, \#137, …).
_docs\src/options/required · medium confidence · unverified
6 commits (0 fixes) modifying docs\_src/options/version
A change to existing behaviour in docs\_src/options/version — 6 commits, 7 files: “📝 Add Optional to docs for CLI Arguments and Options with a None default (\#131)”; “📝 Adopt unversioned documentation snippets (\#2010)”; “📝 Update code examples to Python 3.9 (\#1459)”; and 3 more (refs \#131, \#2010, \#1459, \#419, \#137, …).
_docs\src/options/version · medium confidence · unverified
6 commits (1 fix) modifying docs\_src/subcommands
A change to existing behaviour in docs\_src/subcommands — 6 commits (1 fix), 28 files: “🔥 Remove auto naming of groups added via \add\_typer\ based on the group's callback function name (\#1052)”; “📝 Adopt unversioned documentation snippets (\#2010)”; “📝 Update code examples to Python 3.9 (\#1459)”; and 3 more (refs \#1052, \#2010, \#1459, \#419, \#137, …).
_docs\src/subcommands · medium confidence · unverified
7 commits (0 fixes) modifying docs\_src/arguments/default
A change to existing behaviour in docs\_src/arguments/default — 7 commits, 5 files: “✨ Add support for PEP-593 \Annotated\ for specifying options and arguments (\#584)”; “📝 Adopt unversioned documentation snippets (\#2010)”; “📝 Update code examples to Python 3.9 (\#1459)”; and 4 more (refs \#584, \#2010, \#1459, \#419, \#137, …).
_docs\src/arguments/default · medium confidence · unverified
7 commits (0 fixes) modifying docs\_src/arguments/optional
A change to existing behaviour in docs\_src/arguments/optional — 7 commits, 8 files: “✨ Add support for PEP-593 \Annotated\ for specifying options and arguments (\#584)”; “📝 Adopt unversioned documentation snippets (\#2010)”; “📝 Update code examples to Python 3.9 (\#1459)”; and 4 more (refs \#584, \#2010, \#1459, \#983, \#419, …).
_docs\src/arguments/optional · medium confidence · unverified
7 commits (0 fixes) modifying docs\_src/options/help
A change to existing behaviour in docs\_src/options/help — 7 commits, 9 files: “🔧 Migrate from Black, isort, flake8, autoflake, pyupgrade to Ruff (\#763)”; “📝 Adopt unversioned documentation snippets (\#2010)”; “📝 Update code examples to Python 3.9 (\#1459)”; and 4 more (refs \#763, \#2010, \#1459, \#419, \#137, …).
_docs\src/options/help · medium confidence · unverified
7 commits (0 fixes) modifying docs\_src/progressbar
A change to existing behaviour in docs\_src/progressbar — 7 commits, 12 files: “📝 Add docs for using Rich with Typer (\#421)”; “📝 Adopt unversioned documentation snippets (\#2010)”; “📝 Update code examples to Python 3.9 (\#1459)”; and 4 more (refs \#421, \#2010, \#1459, \#419, \#199, …).
_docs\src/progressbar · medium confidence · unverified
7 commits (1 fix) modifying docs\_src/multiple\_values/multiple\_options
A change to existing behaviour in docs\_src/multiple\_values/multiple\_options — 7 commits (1 fix), 5 files: “📝 Add Optional to docs for CLI Arguments and Options with a None default (\#131)”; “📝 Adopt unversioned documentation snippets (\#2010)”; “📝 Update code examples to Python 3.9 (\#1459)”; and 4 more (refs \#131, \#2010, \#1459, \#419, \#137, …).
_docs\_src/multiple\_values/multiple\options · medium confidence · unverified
Typer 0.27.0: Complete codebase restructure and vendorization of Click
This release restructures the Typer codebase into a new modular layout, introducing dedicated modules for completion logic (\_completion\_classes.py, \_completion\_shared.py), type handling (\_types.py, \_typing.py), and a new CLI entry point (cli.py) that allows running Typer scripts directly via the \typer\ command. It vendors the Click library (exposed as \_click) to streamline dependencies and remove external Click requirements, while also introducing a new TyperChoice type for enum-based choices and a TyperException base class for error handling.
typer · high confidence
Test coverage
6 commits adding/updating tests in docs\_src/testing; Add CLI test fixtures for app extension, Rich markup, and documentation generation; Added CLI integration tests for Typer; Added comprehensive test suite for Typer functionality; Added comprehensive test suite for shell completion features; Added test assets for shell completion, hidden commands, and error formatting; Added test package initialization for CLI arguments; Added tests for CLI argument help output formatting; Added tests for CLI arguments and options accepting multiple values; Added tests for CLI arguments and options accepting multiple values; Added tests for CLI help and required option behavior; Added tests for CLI option naming and aliasing; Added tests for CLI parameter types: index, number, and verbose flags; Added tests for CLI path parameter handling; Added tests for app\_dir and launch tutorial examples; Added tests for boolean parameter types; Added tests for command callbacks; Added tests for command help, arguments, options, and name tutorials; Added tests for custom type parsing in CLI applications; Added tests for datetime and UUID CLI parameter types; Added tests for exception handling and traceback formatting; Added tests for one-or-multiple command tutorials; Added tests for option callbacks and version flags; Added tests for optional CLI arguments; Added tests for options autocompletion tutorials; Added tests for printing and progress bar tutorials; Added tests for prompt-based CLI options; Added tests for subcommand name and help customization; Added tests for subcommand tutorial examples; Added tests for terminating behavior in tutorial examples; Added tests for the one-file-per-command tutorial example; Added tests for tutorial command context and testing examples; Initialize test package for CLI Options; Initialize test package for commands.
Dependencies
Migrate build and dependency management to uv
The project has switched from pip/setuptools to uv for dependency resolution and environment management. This introduces a \pyproject.toml\ (implied by the lockfile and uv usage), a \uv.lock\ file for deterministic builds, and a \.python-version\ file pinning the runtime to Python 3.10. Development tooling is now driven by uv, with pre-commit hooks executing via \uv run\ and the CI workflow updated to use \uv sync\ for test execution.
(repo-wide) · high confidence
Migrate build system to PDM and update Python support
The project has migrated its build backend from Flit to PDM, replacing the legacy \pyproject.toml\ structure with modern PDM conventions. This change updates the minimum supported Python version to 3.10 and adds official support for Python 3.11, 3.12, 3.13, and 3.14. The runtime dependencies have been streamlined to \shellingham\, \rich\, \annotated-doc\, and \colorama\ (on Windows), while development tooling has shifted to use Ruff for linting and formatting, alongside updated versions of pytest, mypy, and other test utilities.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 58.2 → 61.3 (+3.1)
- Rubric changed (rubric-2026.11.2 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 59.9 → 76.7 (+16.8)
- Architecture 83.8 → 93.3 (+9.5)
- Maturity 56.3 → 60.7 (+4.4)
- Readiness 52.9 → 52.9 (0.0)
- Security 65.6 → 65.6 (0.0)
- Performance 100.0 → 100.0 (0.0)
Resolved (69)
- Duplicated block (10 lines × 2) (docs_src/parameter_types/path/tutorial001_an_py310.py)
- Duplicated block (11 lines × 2) (docs_src/options/callback/tutorial003_an_py310.py)
- Duplicated block (11 lines × 2) (docs_src/options/callback/tutorial004_an_py310.py)
- Duplicated block (15 lines × 2) (docs_src/options_autocompletion/tutorial005_an_py310.py)
- Duplicated block (15 lines × 2) (typer/main.py)
- Duplicated block (15–16 lines × 2) (typer/core.py)
- Duplicated block (17 lines × 2) (docs_src/options_autocompletion/tutorial003_an_py310.py)
- Duplicated block (17 lines × 2) (docs_src/options_autocompletion/tutorial007_an_py310.py)
- Duplicated block (17 lines × 2) (docs_src/options_autocompletion/tutorial008_an_py310.py)
- Duplicated block (17 lines × 4) (docs_src/options/version/tutorial002_an_py310.py)
- Duplicated block (18 lines × 2) (docs_src/options_autocompletion/tutorial004_an_py310.py)
- Duplicated block (18 lines × 2) (docs_src/options_autocompletion/tutorial009_an_py310.py)
- Duplicated block (20 lines × 2) (docs_src/parameter_types/custom_types/tutorial001_an_py310.py)
- Duplicated block (29 lines × 2) (docs_src/commands/options/tutorial001_an_py310.py)
- Duplicated block (5 lines × 2) (docs_src/multiple_values/multiple_options/tutorial001_an_py310.py)
- Duplicated block (51 lines × 2) (docs_src/commands/help/tutorial001_an_py310.py)
- Duplicated block (7 lines × 2) (docs_src/multiple_values/options_with_multiple_values/tutorial001_an_py310.py)
- Duplicated block (7 lines × 2) (typer/core.py)
- Duplicated block (9 lines × 2) (docs_src/parameter_types/file/tutorial004_an_py310.py)
- Duplicated block (9 lines × 5) (docs_src/first_steps/tutorial006_py310.py)
- …and 49 more
New (60)
- Duplicated block (10 lines × 2) (docs_src/parameter_types/path/tutorial001.py)
- Duplicated block (10 lines × 2) (typer/main.py)
- Duplicated block (11 lines × 2) (docs_src/options/callback/tutorial003.py)
- Duplicated block (11 lines × 2) (docs_src/options/callback/tutorial004.py)
- Duplicated block (15 lines × 2) (docs_src/options_autocompletion/tutorial005.py)
- Duplicated block (17 lines × 2) (docs_src/options_autocompletion/tutorial003.py)
- Duplicated block (17 lines × 2) (docs_src/options_autocompletion/tutorial007.py)
- Duplicated block (17 lines × 2) (docs_src/options_autocompletion/tutorial008.py)
- Duplicated block (17 lines × 4) (docs_src/options/version/tutorial002.py)
- Duplicated block (18 lines × 2) (docs_src/options_autocompletion/tutorial004.py)
- Duplicated block (18 lines × 2) (docs_src/options_autocompletion/tutorial009.py)
- Duplicated block (20 lines × 2) (docs_src/parameter_types/custom_types/tutorial001.py)
- Duplicated block (29 lines × 2) (docs_src/commands/options/tutorial001.py)
- Duplicated block (5 lines × 2) (docs_src/multiple_values/multiple_options/tutorial001.py)
- Duplicated block (51 lines × 2) (docs_src/commands/help/tutorial001.py)
- Duplicated block (7 lines × 2) (docs_src/multiple_values/options_with_multiple_values/tutorial001.py)
- Duplicated block (7 lines × 2) (typer/core.py)
- Duplicated block (9 lines × 2) (docs_src/parameter_types/file/tutorial004.py)
- Duplicated block (9 lines × 5) (docs_src/first_steps/tutorial006.py)
- Edited copies of one member (3 members, 7+ corresponding lines) (docs_src/progressbar/tutorial003.py)
- …and 40 more
Changes since last survey
- 31 commits — 31 feature/other, 0 fixes
By area
- docs/release-notes.md — 19 commits
- (root) — 5 commits
- scripts/docs.py — 2 commits
- .github/workflows — 1 commit
- docs/tutorial — 1 commit
- scripts/prepare_release.py — 1 commit
- tests/test_core.py — 1 commit
- tests/test_tutorial — 1 commit
Notable commits
- change: ✨ Use Pydantic for parameter validation (#1831)
- change: ⬆️ Add support for Python 3.15 and 3.15t (#2013)
- change: ⬆️ Upgrade markdown-include-variants to 0.0.10 (#2009)
- change: 🎨 Use the Zensical modern theme for docs (#2004)
- change: 🐛 Ensure that the default option name is not changed by setting a metavar (#1957)
- change: 🐛 Escape terminal controls in Pydantic validation errors (#2005)
- change: 👷 Limit the full test matrix to Python 3.15 (#2019)
- change: 📝 Add AI development guidance and coding agent notices (#2003)
- change: 📝 Adopt unversioned documentation snippets (#2010)
- change: 📝 Clarify compatibility changes in the 0.29.0 release notes (#2014)
- change: 📝 Explain Pydantic validation in the release notes (#2006)
- change: 📝 Update release notes
- change: 📝 Update release notes
- change: 📝 Update release notes
- change: 📝 Update release notes
- change: 📝 Update release notes
- change: 📝 Update release notes
- change: 📝 Update release notes
- change: 📝 Update release notes
- change: 📝 Update release notes
- …and 11 more
Architecture
- Unchanged — 0 containers · 1 contexts · 0 edges
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
fastapi/typer was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 17 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 695d84504ab52fcb1a8145949ff10accee1e97b5 — the exact code this score is about.
- Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.84+preprod-d645ca9bbedd.