Title: [2.2 regression] Internal mypy error related to circular imports and TypedDict · Issue #21741 · python/mypy · GitHub
Open Graph Title: [2.2 regression] Internal mypy error related to circular imports and TypedDict · Issue #21741 · python/mypy
X Title: [2.2 regression] Internal mypy error related to circular imports and TypedDict · Issue #21741 · python/mypy
Description: Crash Report I have observed a regression in mypy 2.2.0 and up where code that used to type check now causes an internal mypy error. An example of this can be seen here. QCoDeS/Qcodes_contrib_drivers#576 https://github.com/QCoDeS/Qcodes_...
Open Graph Description: Crash Report I have observed a regression in mypy 2.2.0 and up where code that used to type check now causes an internal mypy error. An example of this can be seen here. QCoDeS/Qcodes_contrib_drive...
X Description: Crash Report I have observed a regression in mypy 2.2.0 and up where code that used to type check now causes an internal mypy error. An example of this can be seen here. QCoDeS/Qcodes_contrib_drive...
Opengraph URL: https://github.com/python/mypy/issues/21741
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"[2.2 regression] Internal mypy error related to circular imports and TypedDict","articleBody":"\u003c!--\n Use this form only if mypy reports an \"INTERNAL ERROR\" and/or gives a traceback.\n Please include the traceback and all other messages below (use `mypy --show-traceback`).\n-->\n\n**Crash Report**\n\nI have observed a regression in mypy 2.2.0 and up where code that used to type check now causes an internal mypy error. An example of this can be seen here. https://github.com/QCoDeS/Qcodes_contrib_drivers/pull/576 https://github.com/QCoDeS/Qcodes_contrib_drivers/actions/runs/29298819262/job/86978061271?pr=576 as well as a more minimal example linked below.\n\n**Traceback**\n\n```python-traceback\n❯ uv run mypy mypy_repro\\ --show-traceback\nmypy_repro\\m_nd.py: error: Cannot resolve TypedDict item (possible cyclic definition) [misc]\nmypy_repro\\m_param.py:28: error: INTERNAL ERROR -- Please try using mypy master on GitHub:\nhttps://mypy.readthedocs.io/en/stable/common_issues.html#using-a-development-mypy-build\nPlease report a bug at https://github.com/python/mypy/issues\nversion: 2.4.0+dev.67eecf07fea3fa4bbaab9d46cd28372a8ded330b\nTraceback (most recent call last):\n File \"\u003cfrozen runpy>\", line 203, in _run_module_as_main\n File \"\u003cfrozen runpy>\", line 88, in _run_code\n File \"D:\\source\\repos\\mypy_22_issue\\.venv\\Scripts\\mypy.exe\\__main__.py\", line 10, in \u003cmodule>\n sys.exit(console_entry())\n File \"D:\\source\\opensource\\mypy\\mypy\\__main__.py\", line 16, in console_entry\n main()\n File \"D:\\source\\opensource\\mypy\\mypy\\main.py\", line 154, in main\n res, messages, blockers = run_build(sources, options, fscache, t0, stdout, stderr)\n File \"D:\\source\\opensource\\mypy\\mypy\\main.py\", line 244, in run_build\n res = build.build(sources, options, None, flush_errors, fscache, stdout, stderr)\n File \"D:\\source\\opensource\\mypy\\mypy\\build.py\", line 422, in build\n result = build_inner(\n File \"D:\\source\\opensource\\mypy\\mypy\\build.py\", line 537, in build_inner\n graph = dispatch(sources, manager, stdout, connect_threads)\n File \"D:\\source\\opensource\\mypy\\mypy\\build.py\", line 4146, in dispatch\n process_graph(graph, manager)\n File \"D:\\source\\opensource\\mypy\\mypy\\build.py\", line 4614, in process_graph\n done, still_working, results = manager.wait_for_done(graph)\n File \"D:\\source\\opensource\\mypy\\mypy\\build.py\", line 1484, in wait_for_done\n process_stale_scc(graph, next_scc, self)\n File \"D:\\source\\opensource\\mypy\\mypy\\build.py\", line 4782, in process_stale_scc\n mypy.semanal_main.semantic_analysis_for_scc(graph, scc, manager.errors)\n File \"D:\\source\\opensource\\mypy\\mypy\\semanal_main.py\", line 92, in semantic_analysis_for_scc\n process_functions(graph, scc, patches)\n File \"D:\\source\\opensource\\mypy\\mypy\\semanal_main.py\", line 275, in process_functions\n process_top_level_function(\n File \"D:\\source\\opensource\\mypy\\mypy\\semanal_main.py\", line 314, in process_top_level_function\n deferred, incomplete, progress = semantic_analyze_target(\n File \"D:\\source\\opensource\\mypy\\mypy\\semanal_main.py\", line 380, in semantic_analyze_target\n analyzer.refresh_partial(\n File \"D:\\source\\opensource\\mypy\\mypy\\semanal.py\", line 709, in refresh_partial\n self.accept(node)\n File \"D:\\source\\opensource\\mypy\\mypy\\semanal.py\", line 7732, in accept\n node.accept(self)\n ~~~~~~~~~~~^^^^^^\n File \"D:\\source\\opensource\\mypy\\mypy\\nodes.py\", line 1165, in accept\n return visitor.visit_func_def(self)\n ~~~~~~~~~~~~~~~~~~~~~~^^^^^^\n File \"D:\\source\\opensource\\mypy\\mypy\\semanal.py\", line 991, in visit_func_def\n self.analyze_func_def(defn)\n ~~~~~~~~~~~~~~~~~~~~~^^^^^^\n File \"D:\\source\\opensource\\mypy\\mypy\\semanal.py\", line 1036, in analyze_func_def\n self.defer(defn)\n ~~~~~~~~~~^^^^^^\n File \"D:\\source\\opensource\\mypy\\mypy\\semanal.py\", line 7333, in defer\n assert not self.final_iteration, \"Must not defer during final iteration\"\n ^^^^^^^^^^^^^^^^^^^^^^^^\nAssertionError: Must not defer during final iteration\n\nmypy_repro\\m_param.py:28: note: use --pdb to drop into pdb\n```\n\n**To Reproduce**\n\nRun mypy on the code in the following repo https://github.com/jenshnielsen/mypy_22_issue\nNote that since this is related to circular imports, I was not able to minimize this below 4 files\n\n**Your Environment**\n\n\u003c!-- Include as many relevant details about the environment you experienced the bug in -->\n\n- Mypy version used: 2.2.0, 2.3.0 as well as master as of 67eecf07fea3fa4bbaab9d46cd28372a8ded330b\n- Mypy command-line flags: None\n- Mypy configuration options from `mypy.ini` (and other config files): Empty config\n- Python version used: 3.14.6\n- Operating system and version: Windows 11\n\n\u003c!--\nYou can freely edit this text, please remove all the lines\nyou believe are unnecessary.\n-->\n","author":{"url":"https://github.com/jenshnielsen","@type":"Person","name":"jenshnielsen"},"datePublished":"2026-07-16T17:45:11Z","url":"https://github.com/python/mypy/issues/21741"}
| 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:e49d5f5a-e6c9-14fc-d83b-0e6c4d97f469 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | C754:144E47:33B44D4:447F624:6B003844 |
| html-safe-nonce | 0e5d6eab76a74b824ec2f20e13ef0b3711f0799707266d3fbf648e6300f04ce2 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJDNzU0OjE0NEU0NzozM0I0NEQ0OjQ0N0Y2MjQ6NkIwMDM4NDQiLCJ2aXNpdG9yX2lkIjoiNTk4NzE3MDExMDE3ODA4MDgzNiIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9 |
| visitor-hmac | 7ff3c0a5fd8f3c97aee2523420b8137d17c7d8013e1d4c70b4e81cc1ecf5f58f |
| hovercard-subject-tag | issue:4904590414 |
| 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/21741/issue_layout |
| twitter:image | https://opengraph.githubassets.com/586835e005c0e277e3065bce2c863bc28e05a49dedd5a58c2deeec3dd2b4e449/python/mypy/issues/21741 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/586835e005c0e277e3065bce2c863bc28e05a49dedd5a58c2deeec3dd2b4e449/python/mypy/issues/21741 |
| og:image:alt | Crash Report I have observed a regression in mypy 2.2.0 and up where code that used to type check now causes an internal mypy error. An example of this can be seen here. QCoDeS/Qcodes_contrib_drive... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | jenshnielsen |
| hostname | github.com |
| expected-hostname | github.com |
| None | 7d0829bbde9e48b2486cb5dd6d147896eb01d32134627091f818958a935ef3f0 |
| 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 | f3f3a43ca095cdea3abbb394112e971f9fdb94fa |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width