Title: `Annotated[int]` (no metadata) is not reported in type aliases and functional NamedTuple/TypedDict fields · Issue #22498 · python/mypy · GitHub
Open Graph Title: `Annotated[int]` (no metadata) is not reported in type aliases and functional NamedTuple/TypedDict fields · Issue #22498 · python/mypy
X Title: `Annotated[int]` (no metadata) is not reported in type aliases and functional NamedTuple/TypedDict fields · Issue #22498 · python/mypy
Description: Bug Report mypy reports Annotated[int] with no metadata when it is used as a variable or parameter annotation (Annotated[...] must have exactly one type argument and at least one annotation), but not when it is the right-hand side of an ...
Open Graph Description: Bug Report mypy reports Annotated[int] with no metadata when it is used as a variable or parameter annotation (Annotated[...] must have exactly one type argument and at least one annotation), but n...
X Description: Bug Report mypy reports Annotated[int] with no metadata when it is used as a variable or parameter annotation (Annotated[...] must have exactly one type argument and at least one annotation), but n...
Opengraph URL: https://github.com/python/mypy/issues/22498
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"`Annotated[int]` (no metadata) is not reported in type aliases and functional NamedTuple/TypedDict fields","articleBody":"**Bug Report**\n\nmypy reports `Annotated[int]` with no metadata when it is used as a variable or parameter annotation (`Annotated[...] must have exactly one type argument and at least one annotation`), but not when it is the right-hand side of an alias or a field type in the functional `NamedTuple` / `TypedDict` forms. The alias then silently means `int`.\n\nThe typing spec says \"There must be at least one metadata element (`Annotated[int]` is not valid)\", and CPython raises `TypeError` for it.\n\n**To Reproduce**\n\n```python\nfrom typing import Annotated, TypeAlias\n\nx: Annotated[int] = 1 # error: Annotated[...] must have exactly one type argument and at least one annotation\nA: TypeAlias = Annotated[int] # expected: error, nothing reported\nB = Annotated[int] # expected: error, nothing reported\n```\n\nSame for `type C = Annotated[int]`, `N = NamedTuple(\"N\", [(\"x\", Annotated[int])])` and `T = TypedDict(\"T\", {\"x\": Annotated[int]})` (nothing reported in any of them).\n\n**Expected Behavior**\n\nThe same error as for `x: Annotated[int]`.\n\n**Actual Behavior**\n\n```\n$ mypy --python-version 3.12 repro.py\nrepro.py:3: error: Annotated[...] must have exactly one type argument and at least one annotation [valid-type]\nFound 1 error in 1 file (checked 1 source file)\n```\n\nRuntime (3.12): `TypeError: Annotated[...] should be used with at least two arguments (a type and an annotation).`\n\nWhere it seems to come from (from reading the source on master `d1bad9f7`, not debugged): `mypy/exprtotype.py` L125 replaces `Annotated[X, ...]` by `X` when `args` is non-empty, and the \"at least one annotation\" check (`len(t.args) \u003c 2`) is in `mypy/typeanal.py` L744, which this path does not reach. PR #21503 added the `and args` there for the zero-argument crash; the one-argument case is still passed through.\n\n**Your Environment**\n\n- Mypy version used: 2.4.1 (also master `d1bad9f7`)\n- Mypy command-line flags: none (`--python-version 3.12`)\n- Mypy configuration options: none\n- Python version used: 3.12\n","author":{"url":"https://github.com/seunghyun-24","@type":"Person","name":"seunghyun-24"},"datePublished":"2026-11-16T14:57:56Z","url":"https://github.com/python/mypy/issues/22498"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:4d8ac1cf-9683-967c-eef0-5fd8fd63f335 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | BE92:3A13A0:227A797:2EC8031:6B002800 |
| html-safe-nonce | 92c2c8f3a04e5bd101238924bc81c1d58e9cda1f80f1908632e5ebf7ace89832 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJCRTkyOjNBMTNBMDoyMjdBNzk3OjJFQzgwMzE6NkIwMDI4MDAiLCJ2aXNpdG9yX2lkIjoiNDYwNDQzODI0NTczMDY5MTA3MiIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9 |
| visitor-hmac | 6fc21e1430d92539212cfa7a53d35895cb84437d913ef1a2454d5341587a536b |
| hovercard-subject-tag | issue:6423987897 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/python/mypy/22498/issue_layout |
| twitter:image | https://opengraph.githubassets.com/16d2cb5a8557f28cb601ddfdb70e77701e18749a545e15c49934f9fad4aca881/python/mypy/issues/22498 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/16d2cb5a8557f28cb601ddfdb70e77701e18749a545e15c49934f9fad4aca881/python/mypy/issues/22498 |
| og:image:alt | Bug Report mypy reports Annotated[int] with no metadata when it is used as a variable or parameter annotation (Annotated[...] must have exactly one type argument and at least one annotation), but n... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | seunghyun-24 |
| hostname | github.com |
| expected-hostname | github.com |
| None | 4eb4cba0d69f045374ac15de9666d22b0961e1d555cc3824f36b7734c00c78e0 |
| turbo-cache-control | no-preview |
| go-import | github.com/python/mypy git https://github.com/python/mypy.git |
| octolytics-dimension-user_id | 1525981 |
| octolytics-dimension-user_login | python |
| octolytics-dimension-repository_id | 7053637 |
| octolytics-dimension-repository_nwo | python/mypy |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 7053637 |
| octolytics-dimension-repository_network_root_nwo | python/mypy |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 44c658b24abf00491fb7ae5f56d42c9f38cbeab2 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width