René's URL Explorer Experiment


Title: Overlapping overloads false positive with ParamSpec shenanigans · Issue #21171 · python/mypy · GitHub

Open Graph Title: Overlapping overloads false positive with ParamSpec shenanigans · Issue #21171 · python/mypy

X Title: Overlapping overloads false positive with ParamSpec shenanigans · Issue #21171 · python/mypy

Description: Bug Report Abstract mypy incorrectly flags overloads of functions with certain signatures related to ParamSpec shenangians that do not overlap with previous overloads as being narrower than the previous overloads and thus impossible to m...

Open Graph Description: Bug Report Abstract mypy incorrectly flags overloads of functions with certain signatures related to ParamSpec shenangians that do not overlap with previous overloads as being narrower than the pre...

X Description: Bug Report Abstract mypy incorrectly flags overloads of functions with certain signatures related to ParamSpec shenangians that do not overlap with previous overloads as being narrower than the pre...

Opengraph URL: https://github.com/python/mypy/issues/21171

X: @github

direct link

Domain: github.com


Hey, it has json ld scripts:
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Overlapping overloads false positive with ParamSpec shenanigans","articleBody":"**Bug Report**\n\n**Abstract**\nmypy incorrectly flags overloads of functions with certain signatures related to ParamSpec shenangians that do not overlap with previous overloads as being narrower than the previous overloads and thus impossible to match.\n\n**Background**\nThere is a notable limitation of ParamSpec that makes it difficult to annotate functions operating on a function and its parameters, as well as some keyword arguments (optional or required). Currently, the best workaround is to use Any to annotate the variadic args and kwargs, but that still loses some typing information. See the below snippet from the python docs.\n\n````markdown\n[Concatenating Keyword Parameters](https://peps.python.org/pep-0612/#concatenating-keyword-parameters)\nIn principle the idea of concatenation as a means to modify a finite number of positional parameters could be expanded to include keyword parameters.\n\n```python\ndef add_n(f: Callable[P, R]) -> Callable[Concatenate[(\"n\", int), P], R]:\n  def inner(*args: P.args, n: int, **kwargs: P.kwargs) -> R:\n    # use n\n    return f(*args, **kwargs)\n  return inner\n```\n\nHowever, the key distinction is that while prepending positional-only parameters to a valid callable type always yields another valid callable type, the same cannot be said for adding keyword-only parameters. As alluded to [above](https://peps.python.org/pep-0612/#above) , the issue is name collisions. The parameters `Concatenate[(\"n\", int), P]` are only valid when P itself does not already have a parameter named `n`.\n\n```python\ndef innocent_wrapper(f: Callable[P, R]) -> Callable[P, R]:\n  def inner(*args: P.args, **kwargs: P.kwargs) -> R:\n    added = add_n(f)\n    return added(*args, n=1, **kwargs)\n  return inner\n\n@innocent_wrapper\ndef problem(n: int) -> None:\n  pass\n```\n\nCalling `problem(2)` works fine, but calling `problem(n=2)` leads to a `TypeError: problem() got multiple values for argument 'n'` from the call to added inside of innocent_wrapper.\n\nThis kind of situation could be avoided, and this kind of decorator could be typed if we could reify the constraint that a set of parameters not contain a certain name, with something like:\n\n```python\nP_without_n = ParamSpec(\"P_without_n\", banned_names=[\"n\"])\n\ndef add_n(\n  f: Callable[P_without_n, R]\n) -> Callable[Concatenate[(\"n\", int), P_without_n], R]: ...\n```\n\nThe call to add_n inside of innocent_wrapper could then be rejected since the callable was not guaranteed not to already have a parameter named n.\n\nHowever, enforcing these constraints would require enough additional implementation work that we judged this extension to be out of scope of this PEP. Fortunately the design of ParamSpecs are such that we can return to this idea later if there is sufficient demand.\n````\n\nThis indicates that the below construct is unfortunately unsupported:\n\n```python\nclass PriorityPool:\n    async def execute[T, **P](self, func: Callable[P, T], /, *args: P.args, priority: int = 0, **kwargs: P.kwargs) -> T: ...\n    # type checker error!\n```\n\n**To Reproduce**\nmypy w/ default config on the following:\n\n```python\n# test.pyi\nfrom _collections_abc import Callable\nfrom typing import Any, overload\n@overload\ndef bar[T, **P](f: Callable[P, T], *a: P.args, **k: P.kwargs) -> T: ...\n@overload\ndef bar[T](f: Callable[..., T], *a: Any, baz: int, **k: Any) -> T: ...\n```\n\n**Expected Behavior**\nNo issues.\nThe first overload is for when `baz` is not passed, and the variadic `*a` and `**k` will eventually passed to `f`, so the ParamSpec dictates that only arguments accepted by the function `f` should be passed. The second overload is the case where `baz` is passed as a keyword argument, but due to the above limitation, it is not possible to annotate `*a: P.args` and `**k: P.kwargs`, so they are annotated as `Any`. The overloads are mutually exclusive.\n\n**Actual Behavior**\nmypy emits an error.\ntest.pyi:6: error: Overloaded function signature 2 will never be matched: signature 1's parameter type(s) are the same or broader  [overload-cannot-match]\n\n**Your Environment**\n\n- Mypy version used: 1.19.1; compiled\n- Command used: `mypy test.pyi`\n- Mypy configuration options from `mypy.ini` (and other config files): None\n- Output of `python -vv`: Python 3.14.0 (tags/v3.14.0:ebf955d, Oct  7 2025, 10:15:03) [MSC v.1944 64 bit (AMD64)]\n","author":{"url":"https://github.com/jonathandung","@type":"Person","name":"jonathandung"},"datePublished":"2026-04-05T06:43:50Z","url":"https://github.com/python/mypy/issues/21171"}

react-profiling0
react-import-mapreact,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-controllervoltron_issues_fragments
route-actionissue_layout
fetch-noncev2:0a712c46-6ba3-b0ed-a54c-47382a5d0256
current-catalog-service-hash81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114
request-idD4A8:1F3799:289F096:3538A06:6B0007C4
html-safe-nonce842fc71266de4b8481cb741ed8d94c4b05bff7071e91ca532670616d8ad09efb
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJENEE4OjFGMzc5OToyODlGMDk2OjM1MzhBMDY6NkIwMDA3QzQiLCJ2aXNpdG9yX2lkIjoiNjg1MTEyMDA0NzUzNjk5ODM0MCIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9
visitor-hmacd556bdd7d459b0bc000b30007ce283595cef0cb5a3ed7da856a283bb449ceb6d
hovercard-subject-tagissue:4206757206
github-keyboard-shortcutsrepository,issues,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///voltron/issues_fragments/issue_layout
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/python/mypy/21171/issue_layout
twitter:imagehttps://opengraph.githubassets.com/b7c2a4b1054e83aac38ffb65750fc545a404a866fcafced19749d3b966209d5f/python/mypy/issues/21171
twitter:cardsummary_large_image
og:imagehttps://opengraph.githubassets.com/b7c2a4b1054e83aac38ffb65750fc545a404a866fcafced19749d3b966209d5f/python/mypy/issues/21171
og:image:altBug Report Abstract mypy incorrectly flags overloads of functions with certain signatures related to ParamSpec shenangians that do not overlap with previous overloads as being narrower than the pre...
og:image:width1200
og:image:height600
og:site_nameGitHub
og:typeobject
og:author:usernamejonathandung
hostnamegithub.com
expected-hostnamegithub.com
None0a0d8686a27478df474dd7415776a7a080cde8838b3cd92ea7601187572e5729
turbo-cache-controlno-preview
go-importgithub.com/python/mypy git https://github.com/python/mypy.git
octolytics-dimension-user_id1525981
octolytics-dimension-user_loginpython
octolytics-dimension-repository_id7053637
octolytics-dimension-repository_nwopython/mypy
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id7053637
octolytics-dimension-repository_network_root_nwopython/mypy
turbo-body-classeslogged-out env-production page-responsive
disable-turbofalse
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
release16a11879678aaf97e2a42c33ee70830aa084fa37
ui-targetfull
theme-color#1e2327
color-schemelight dark
react-app-nameissues

Links:

Skip to contenthttps://github.com/python/mypy/issues/21171#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fpython%2Fmypy%2Fissues%2F21171
GitHubRepository hosting, code review, and collaborationhttps://github.com/platform
CopilotAI coding agent for tasks, projects, and automated workhttps://github.com/features/copilot
ActionsCI/CD and automationhttps://github.com/features/actions
Code QualityQuality analysis, fixes, and enforcementhttps://github.com/features/code-quality
CodespacesCloud development environmentshttps://github.com/features/codespaces
Code SecurityVulnerability detection and remediationhttps://github.com/security/advanced-security/code-security
Secret ProtectionSecret scanning and leak preventionhttps://github.com/security/advanced-security/secret-protection
All Featureshttps://github.com/features
Documentationhttps://docs.github.com/en
Traininghttps://learn.github.com/skills
Certificationshttps://learn.github.com/credentials
Build with Copilothttps://github.com/features/ai
Customize Copilothttps://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-copilot-overview
Integrationshttps://github.com/marketplace
Trending reposhttps://github.com/trending
GitHub Sponsorshttps://github.com/open-source/sponsors
Developer articleshttps://github.com/resources/articles
ChangelogYour source for the latest features, improvements, and fixes across GitHub products, all in one place.https://github.blog/changelog/
Enterpriseshttps://github.com/enterprise
Teamhttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
See all industrieshttps://github.com/solutions/industry
Why GitHubhttps://github.com/why-github
Customer Storieshttps://github.com/customer-stories
Business insightshttps://github.com/solutions/executive-insights
Trust Centerhttps://github.com/trust-center
GitHub Advanced SecurityEnterprise-grade code securityhttps://github.com/security/advanced-security
Copilot for businessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/enterprise/premium-support
Documentationhttps://docs.github.com/en
Resource centerhttps://github.com/resources
Bloghttps://github.blog/
Events & webinarshttps://github.com/resources/events
Community Forumhttps://github.com/orgs/community/discussions
Customer Storieshttps://github.com/customer-stories
Integrationshttps://github.com/marketplace
Customer supporthttps://help.github.com/
Traininghttps://learn.github.com/skills
GitHub Statushttps://www.githubstatus.com/
Abouthttps://github.com/about
Partnershttps://github.com/partners
Changeloghttps://github.blog/changelog/
GitHub UniverseThe event for developers, by developers — talks, workshops, and what’s next for GitHub.https://githubuniverse.com/
Pricinghttps://github.com/pricing
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fpython%2Fmypy%2Fissues%2F21171
Sign uphttps://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fvoltron%2Fissues_fragments%2Fissue_layout&source=header-repo&source_repo=python%2Fmypy
Reloadhttps://github.com/python/mypy/issues/21171
Reloadhttps://github.com/python/mypy/issues/21171
Reloadhttps://github.com/python/mypy/issues/21171
pythonhttps://github.com/python
mypyhttps://github.com/python/mypy
Codehttps://github.com/python/mypy
Issues2.7k (2.7k)https://github.com/python/mypy/issues
Pull requests547 (547)https://github.com/python/mypy/pulls
Actionshttps://github.com/python/mypy/actions
Projectshttps://github.com/python/mypy/projects
Wikihttps://github.com/python/mypy/wiki
Security and qualityhttps://github.com/python/mypy/security
Insightshttps://github.com/python/mypy/insights
https://github.com/python/mypy
New issuehttps://github.com/login?return_to=https://github.com/python/mypy/issues/21171
New issuehttps://github.com/login?return_to=https://github.com/python/mypy/issues/21171
Overlapping overloads false positive with ParamSpec shenaniganshttps://github.com/python/mypy/issues/21171#top
bugmypy got something wronghttps://github.com/python/mypy/issues?q=state%3Aopen%20label%3A%22bug%22
topic-overloadshttps://github.com/python/mypy/issues?q=state%3Aopen%20label%3A%22topic-overloads%22
topic-paramspecPEP 612, ParamSpec, Concatenatehttps://github.com/python/mypy/issues?q=state%3Aopen%20label%3A%22topic-paramspec%22
https://github.com/jonathandung
jonathandunghttps://github.com/jonathandung
on Apr 5, 2026https://github.com/python/mypy/issues/21171#issue-4206757206
jonathandunghttps://github.com/jonathandung
bugmypy got something wronghttps://github.com/python/mypy/issues?q=state%3Aopen%20label%3A%22bug%22
on Apr 5, 2026https://github.com/python/mypy/issues/21171#event-24203862772
brianschuberthttps://github.com/brianschubert
topic-paramspecPEP 612, ParamSpec, Concatenatehttps://github.com/python/mypy/issues?q=state%3Aopen%20label%3A%22topic-paramspec%22
topic-overloadshttps://github.com/python/mypy/issues?q=state%3Aopen%20label%3A%22topic-overloads%22
on Apr 5, 2026https://github.com/python/mypy/issues/21171#event-24205797214
Sign up for freehttps://github.com/signup?return_to=https://github.com/python/mypy/issues/21171
Sign in to commenthttps://github.com/login?return_to=https://github.com/python/mypy/issues/21171
bugmypy got something wronghttps://github.com/python/mypy/issues?q=state%3Aopen%20label%3A%22bug%22
topic-overloadshttps://github.com/python/mypy/issues?q=state%3Aopen%20label%3A%22topic-overloads%22
topic-paramspecPEP 612, ParamSpec, Concatenatehttps://github.com/python/mypy/issues?q=state%3Aopen%20label%3A%22topic-paramspec%22
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width


URLs of crawlers that visited me.