René's URL Explorer Experiment


Title: Support file-level assertions as inline configuration · Issue #19013 · python/mypy · GitHub

Open Graph Title: Support file-level assertions as inline configuration · Issue #19013 · python/mypy

X Title: Support file-level assertions as inline configuration · Issue #19013 · python/mypy

Description: Feature One would be able to do: # mypy: assert=platform == "win32" and python_version >= "3.10" and the file would only be checked if sys.platform is win32 and the tuple sys.version_info is greater than or equal to (3, 10). This is simi...

Open Graph Description: Feature One would be able to do: # mypy: assert=platform == "win32" and python_version >= "3.10" and the file would only be checked if sys.platform is win32 and the tuple sys.version_info is greate...

X Description: Feature One would be able to do: # mypy: assert=platform == "win32" and python_version >= "3.10" and the file would only be checked if sys.platform is win32 and the tuple sys...

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

X: @github

direct link

Domain: github.com


Hey, it has json ld scripts:
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Support file-level assertions as inline configuration","articleBody":"**Feature**\n\nOne would be able to do:\n\n```python\n# mypy: assert=platform == \"win32\" and python_version >= \"3.10\"\n```\n\nand the file would only be checked if `sys.platform` is `win32` and the tuple `sys.version_info` is greater than or equal to `(3, 10)`. This is similar to the [environment markers](https://packaging.python.org/en/latest/specifications/dependency-specifiers/#environment-markers) used in dependency definitions but with only support for the two static [platform variables](https://mypy.readthedocs.io/en/stable/config_file.html#platform-configuration) that are already used by Mypy.\n\nImplementation-wise, there would be a pre-processing step that transforms the Python version string (if present) into a tuple. This way you can pass those two variables directly to `eval`.\n\n**Pitch**\n\nThis would significantly help in situations such as https://github.com/python/mypy/issues/19009. Brief recap:\n\n> When you have the following provider module:\n> \n> ```python\n> if sys.platform == \"win32\":\n>     from my_pkg._pty.windows import PtySession\n> else:\n>     from my_pkg._pty.unix import PtySession\n> ```\n> \n> and attempt importing this symbol from somewhere else, Mypy does not respect the platform condition.\n> \n> For example, if you call `pty.openpty()` inside `my_pkg._pty.unix` and run Mypy on Windows it will show:\n> \n> ```\n> Module has no attribute \"openpty\"  [attr-defined]\n> ```\n\nThe best solution available is adding a [top-level assertion](https://mypy.readthedocs.io/en/stable/common_issues.html#python-version-and-system-platform-checks) as introduced [here](https://github.com/python/mypy/pull/5894). For example, on top of the module `my_pkg._pty.unix` you would put `assert sys.platform != \"win32\"`.\n\nThis is suboptimal because it requires modifying runtime behavior. The `sys` import is required, perhaps only for the assertion, and if there are imports that only exist conditionally the assertion has to be in the middle of the standard import block on top.\n\nAdding a file-level comment is the most pragmatic option at hand, in lieu of adding an option that automatically propagates conditional static assertions to enclosed imports.","author":{"url":"https://github.com/ofek","@type":"Person","name":"ofek"},"datePublished":"2025-05-01T21:09:27Z","url":"https://github.com/python/mypy/issues/19013"}

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:c5927c82-f2ed-e27d-bacc-da432933af82
current-catalog-service-hash81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114
request-id91AE:3EE843:1190F29:1798FD7:6AFFCE52
html-safe-nonce86d61ce6d4376629d7c84382cd2a024bfab9151e9bf363be9d60a2317aee1a36
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI5MUFFOjNFRTg0MzoxMTkwRjI5OjE3OThGRDc6NkFGRkNFNTIiLCJ2aXNpdG9yX2lkIjoiMTU0ODMwODU2NzgwOTgzODY3NCIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9
visitor-hmac6e187197703c6f9e31f696a7d2d4191fd2e62634658d485b9a72153ff622e491
hovercard-subject-tagissue:3034722374
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/19013/issue_layout
twitter:imagehttps://opengraph.githubassets.com/fd1b3808a63ae7f0aff1e269cb18befee91a734c9b9ae21a1930294237051f55/python/mypy/issues/19013
twitter:cardsummary_large_image
og:imagehttps://opengraph.githubassets.com/fd1b3808a63ae7f0aff1e269cb18befee91a734c9b9ae21a1930294237051f55/python/mypy/issues/19013
og:image:altFeature One would be able to do: # mypy: assert=platform == "win32" and python_version >= "3.10" and the file would only be checked if sys.platform is win32 and the tuple sys.version_info is greate...
og:image:width1200
og:image:height600
og:site_nameGitHub
og:typeobject
og:author:usernameofek
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/19013#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fpython%2Fmypy%2Fissues%2F19013
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%2F19013
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/19013
Reloadhttps://github.com/python/mypy/issues/19013
Reloadhttps://github.com/python/mypy/issues/19013
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/19013
New issuehttps://github.com/login?return_to=https://github.com/python/mypy/issues/19013
Support file-level assertions as inline configurationhttps://github.com/python/mypy/issues/19013#top
featurehttps://github.com/python/mypy/issues?q=state%3Aopen%20label%3A%22feature%22
topic-configurationConfiguration files and flagshttps://github.com/python/mypy/issues?q=state%3Aopen%20label%3A%22topic-configuration%22
https://github.com/ofek
ofekhttps://github.com/ofek
on May 1, 2025https://github.com/python/mypy/issues/19013#issue-3034722374
environment markershttps://packaging.python.org/en/latest/specifications/dependency-specifiers/#environment-markers
platform variableshttps://mypy.readthedocs.io/en/stable/config_file.html#platform-configuration
#19009https://github.com/python/mypy/issues/19009
top-level assertionhttps://mypy.readthedocs.io/en/stable/common_issues.html#python-version-and-system-platform-checks
herehttps://github.com/python/mypy/pull/5894
ofekhttps://github.com/ofek
featurehttps://github.com/python/mypy/issues?q=state%3Aopen%20label%3A%22feature%22
on May 1, 2025https://github.com/python/mypy/issues/19013#event-17492567026
https://github.com/sterliakov
sterliakovhttps://github.com/sterliakov
on May 1, 2025https://github.com/python/mypy/issues/19013#issuecomment-2845804700
https://peps.python.org/pep-0781/https://peps.python.org/pep-0781/
https://github.com/ofek
ofekhttps://github.com/ofek
on May 1, 2025https://github.com/python/mypy/issues/19013#issuecomment-2845842926
sterliakovhttps://github.com/sterliakov
topic-configurationConfiguration files and flagshttps://github.com/python/mypy/issues?q=state%3Aopen%20label%3A%22topic-configuration%22
on May 2, 2025https://github.com/python/mypy/issues/19013#event-17502680373
https://github.com/dlech
dlechhttps://github.com/dlech
on May 17, 2025https://github.com/python/mypy/issues/19013#issuecomment-2888603069
https://mypy-play.net/?mypy=1.15&python=3.12&gist=b11740ebcbc73e8300ba64eb80eafd28https://mypy-play.net/?mypy=1.15&python=3.12&gist=b11740ebcbc73e8300ba64eb80eafd28
https://mypy-play.net/?mypy=1.15&python=3.12&gist=ebd7a55f45d19c31df4fd56d7911c5f3https://mypy-play.net/?mypy=1.15&python=3.12&gist=ebd7a55f45d19c31df4fd56d7911c5f3
https://github.com/dlech
dlechhttps://github.com/dlech
on May 17, 2025https://github.com/python/mypy/issues/19013#issuecomment-2888617598
Sign up for freehttps://github.com/signup?return_to=https://github.com/python/mypy/issues/19013
Sign in to commenthttps://github.com/login?return_to=https://github.com/python/mypy/issues/19013
featurehttps://github.com/python/mypy/issues?q=state%3Aopen%20label%3A%22feature%22
topic-configurationConfiguration files and flagshttps://github.com/python/mypy/issues?q=state%3Aopen%20label%3A%22topic-configuration%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.