Title: emit attribute/variable docstrings · Issue #21645 · python/mypy · GitHub
Open Graph Title: emit attribute/variable docstrings · Issue #21645 · python/mypy
X Title: emit attribute/variable docstrings · Issue #21645 · python/mypy
Description: Feature stubgen --include-docstrings currently emits module, class, and function/method docstrings, but drops attribute (variable) docstrings — the string literal immediately following a variable assignment (PEP 224-style), which Pyright...
Open Graph Description: Feature stubgen --include-docstrings currently emits module, class, and function/method docstrings, but drops attribute (variable) docstrings — the string literal immediately following a variable a...
X Description: Feature stubgen --include-docstrings currently emits module, class, and function/method docstrings, but drops attribute (variable) docstrings — the string literal immediately following a variable a...
Opengraph URL: https://github.com/python/mypy/issues/21645
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"emit attribute/variable docstrings","articleBody":"**Feature**\n\nstubgen --include-docstrings currently emits module, class, and function/method docstrings, but drops attribute (variable) docstrings — the string literal immediately following a variable assignment (PEP 224-style), which Pyright/Pylance read for hover and completion docs. I'd like --include-docstrings to also carry these through into the generated .pyi, for module-level variables, class/instance attributes, dataclass fields, and TypedDict items.\n\n**Pitch**\n\nminimal repro on mypy 2.1.0:\n\nclass ResourceAttrs(TypedDict, total=False):\n \"\"\"Shared resource attributes.\"\"\"\n name: NotRequired[str]\n \"\"\"Resource name.\"\"\"\nActual: the field docstring is dropped; only the class docstring survives.\nExpected: the \"\"\"Resource name.\"\"\" line is preserved under name:.\n\nWhy it matters: attribute docstrings are the standard, tool-supported way to document TypedDict/dataclass/class fields; when a project ships a stub-only package built by stubgen, all per-field docs are silently lost even though the source has them. In my case, I am trying to build stubs for type completion on kwargs in an IDE like VS Code. I am trying to better document kwargs where they have been used historically, and with the full source code the IDE can tooltip the class property docstrings on hover (hover over the name key above shows \"Resource name.\", but this could be a more detailed docstring explaining the usage and impact of each keyword argument in the kwargs.\n\n**Workaround**: class property documentation could be bubbled up into the class docstring, but this can be a bit more overwhelming as kwargs grows.\n\nContext: this is the unfinished \"members\" part of #11965 (closed by #13284, which did module/class/function only). Related: #16114, #16543, #17200, #17964.\n","author":{"url":"https://github.com/JLowe-N","@type":"Person","name":"JLowe-N"},"datePublished":"2026-06-24T20:23:43Z","url":"https://github.com/python/mypy/issues/21645"}
| 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:8cbfaf8a-12de-90dd-ba5b-4245ebcd4446 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | 9BC6:28B491:319691:3FBF78:6AFFC727 |
| html-safe-nonce | 9a92644c9b7e7ec34a3ef15608f1cc1480d20a04973c0a7e3b59f33e1a1e8c9c |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI5QkM2OjI4QjQ5MTozMTk2OTE6M0ZCRjc4OjZBRkZDNzI3IiwidmlzaXRvcl9pZCI6IjU0ODU3NDAxNDMwMjMyMTIzMjciLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ== |
| visitor-hmac | 366a963a2122764f11bdcbdb9ed02974c1ad95d8397319dfd3c7a9e58663f16c |
| hovercard-subject-tag | issue:4738162481 |
| 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/21645/issue_layout |
| twitter:image | https://opengraph.githubassets.com/59cb010909b58de244c6d926fe3bf575784a5c4abd886ab2912de88d156bb525/python/mypy/issues/21645 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/59cb010909b58de244c6d926fe3bf575784a5c4abd886ab2912de88d156bb525/python/mypy/issues/21645 |
| og:image:alt | Feature stubgen --include-docstrings currently emits module, class, and function/method docstrings, but drops attribute (variable) docstrings — the string literal immediately following a variable a... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | JLowe-N |
| hostname | github.com |
| expected-hostname | github.com |
| None | 1e805b832df235bb21305db712c3b6432920019dfc12cb25b9cb8d3b0c9403cf |
| 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 | 8fa4a54e6871c7908eda1c246ad5972982c0b59d |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width