Title: Narrow `match` value type based on earlier cases · Issue #20189 · python/mypy · GitHub
Open Graph Title: Narrow `match` value type based on earlier cases · Issue #20189 · python/mypy
X Title: Narrow `match` value type based on earlier cases · Issue #20189 · python/mypy
Description: Optional static typing for Python. Contribute to python/mypy development by creating an account on GitHub.
Open Graph Description: Optional static typing for Python. Contribute to python/mypy development by creating an account on GitHub.
X Description: Optional static typing for Python. Contribute to python/mypy development by creating an account on GitHub.
Opengraph URL: https://github.com/python/mypy
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Narrow `match` value type based on earlier cases","articleBody":"**Bug Report**\n\nMypy does not exclude types from earlier match cases in subsequent cases. This makes it difficult to work with values that could match multiple cases.\n\nI'm specifically running into this when trying to handle types from the OpenAI and Anthropic Python SDKs. The type annotations in those libraries frequently have patterns like `content: Union[str, Iterable[ContentArrayOfContentPart], None]`. Applying a `match/case` statement to the `content` causes issues in the `case Iterable():` case, because Mypy thinks that the value could still be a string (even though that was handled in a previous case).\n\n**To Reproduce**\n\n[Playground URL](https://mypy-play.net/?mypy=latest&python=3.12&gist=520de783347cc3de504cea3b2a76b6ab)\n\n```python\nimport random\nfrom collections.abc import Iterable\nfrom typing import assert_never\n\nx: str | list[int]\nif random.random() \u003c 0.5:\n x = \"a\"\nelse:\n x = [1, 2, 3]\n\nmatch x:\n case str():\n reveal_type(x)\n case Iterable():\n reveal_type(x)\n case _:\n assert_never(x)\n```\n\n**Expected Behavior**\n\nI would expect Mypy to show a revealed type of _only_ `builtins.list[builtins.int]` for `x` on line 17, like:\n```\nmain.py:15: note: Revealed type is \"builtins.str\"\nmain.py:17: note: Revealed type is \"builtins.list[builtins.int]\"\nSuccess: no issues found in 1 source file\n```\n\n**Actual Behavior**\n\nEven though a string would never make it to the second case, `x` on line 17 is still considered to possibly be a string:\n```\nmain.py:15: note: Revealed type is \"builtins.str\"\nmain.py:17: note: Revealed type is \"builtins.str | builtins.list[builtins.int]\"\nSuccess: no issues found in 1 source file\n```\n\n**Your Environment**\n\n- Mypy version used: 1.18.2\n- Mypy command-line flags: N/A\n- Mypy configuration options from `mypy.ini` (and other config files): N/A\n- Python version used: 3.12","author":{"url":"https://github.com/connorbrinton","@type":"Person","name":"connorbrinton"},"datePublished":"2025-11-05T21:42:31Z","url":"https://github.com/python/mypy/issues/20189"}
| 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 | /:user_id/:repository/issues/:id(.:format) |
| route-controller | issues |
| route-action | show |
| fetch-nonce | v2:ba5bc9fe-f7c4-666c-5ba0-deba4fb11516 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | D1AC:3E987B:CF5D9E:1168C47:6B0054E4 |
| html-safe-nonce | 452bea38c9b0c1583af2bb588cd4e3f495911e4a6a91c0399c0bae2fba8fdd17 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJEMUFDOjNFOTg3QjpDRjVEOUU6MTE2OEM0Nzo2QjAwNTRFNCIsInZpc2l0b3JfaWQiOiI1NTIxMDE3Mzg5NDg0ODg5MzE2IiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0= |
| visitor-hmac | dc57b660bd10f1062d9b753ea8bdbd116294b4e8e572a28dd621835b77ebf264 |
| hovercard-subject-tag | repository:7053637 |
| 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/python/mypy/issues/20189 |
| twitter:image | https://opengraph.githubassets.com/f79ae5636353a0db17350af0a02700f2e9c3bbcf096f9450bf0c369c77cd1022/python/mypy |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/f79ae5636353a0db17350af0a02700f2e9c3bbcf096f9450bf0c369c77cd1022/python/mypy |
| og:image:alt | Optional static typing for Python. Contribute to python/mypy development by creating an account on GitHub. |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| hostname | github.com |
| expected-hostname | github.com |
| None | f420f4996e6b1ff1ccd6d7683f8134f4b5f0f8a50124c210dbfe7490e5644abb |
| turbo-cache-control | no-cache |
| 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 | 26e00df917aba0f128135dc073ea0c5e33a70d40 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width