Title: Missing or Incomplete Type Annotations for Table Rows and Cell Paragraphs · Issue #1627 · python-openxml/python-docx · GitHub
Open Graph Title: Missing or Incomplete Type Annotations for Table Rows and Cell Paragraphs · Issue #1627 · python-openxml/python-docx
X Title: Missing or Incomplete Type Annotations for Table Rows and Cell Paragraphs · Issue #1627 · python-openxml/python-docx
Description: The type information for very common operations remains incomplete or missing. Specifically, when iterating over table rows and when accessing paragraphs inside a table cell, the types are either unannotated or annotated in a way that do...
Open Graph Description: The type information for very common operations remains incomplete or missing. Specifically, when iterating over table rows and when accessing paragraphs inside a table cell, the types are either u...
X Description: The type information for very common operations remains incomplete or missing. Specifically, when iterating over table rows and when accessing paragraphs inside a table cell, the types are either u...
Opengraph URL: https://github.com/python-openxml/python-docx/issues/1627
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Missing or Incomplete Type Annotations for Table Rows and Cell Paragraphs","articleBody":"The type information for very common operations remains incomplete or missing. Specifically, when iterating over table rows and when accessing paragraphs inside a table cell, the types are either unannotated or annotated in a way that does not propagate to the user-facing API.\n\n**Current Behavior**\n\n_Iterating over table rows:_\n\n```python\nfor row in table.rows:\n for cell in row.cells: # no type hints\n ...\n```\nThe `_Row.cells` property lacks return type annotation. \n\n_Iterating over paragraphs in a cell:_\n\n```python\nfor para in cell.paragraphs: # no type hints\n ...\n```\nThe `_Cell.paragraphs` property lacks return type annotation too. \n\n**Impact**\n\nStatic analysis fails: mypy/pyright/ty cannot catch type errors. Developers do not get suggestions for attributes.\n\n**Proposed Solution**\n\nAdopt ruff's ANN (flake8-annotations) and PYI (flake8-pyi) rules to enforce complete and correct annotations.\n\n```toml\nselect = [\n \"ANN\",\n \"PYI\",\n ...\n```\n","author":{"url":"https://github.com/max-marek","@type":"Person","name":"max-marek"},"datePublished":"2026-10-07T09:17:06Z","url":"https://github.com/python-openxml/python-docx/issues/1627"}
| 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:72768077-45ff-8076-2f58-6a7e7c2d162b |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | 80E2:15D941:2242B7:2DF2CF:6AFF6396 |
| html-safe-nonce | 436f44a855026f3ac9a3b2431409074be346c29e2564b84fce51de5022fc634a |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI4MEUyOjE1RDk0MToyMjQyQjc6MkRGMkNGOjZBRkY2Mzk2IiwidmlzaXRvcl9pZCI6IjUxODM5NTAzODIyOTU1NDA3MCIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9 |
| visitor-hmac | 97e1eec5ff698e7c9dc6dfbffc8cc09cd3bd2efe0feed8e9ae5203b6fe04c5dd |
| hovercard-subject-tag | issue:5742487163 |
| 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-openxml/python-docx/1627/issue_layout |
| twitter:image | https://opengraph.githubassets.com/0a034591623705cfadcd7d3cde73080509c9d89d4cf84419e476b02d70b90519/python-openxml/python-docx/issues/1627 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/0a034591623705cfadcd7d3cde73080509c9d89d4cf84419e476b02d70b90519/python-openxml/python-docx/issues/1627 |
| og:image:alt | The type information for very common operations remains incomplete or missing. Specifically, when iterating over table rows and when accessing paragraphs inside a table cell, the types are either u... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | max-marek |
| hostname | github.com |
| expected-hostname | github.com |
| None | 41b58589a1c4eda1e3c8904144a412b88ca4455f63ca2ad3629f2e9f3c3a1d12 |
| turbo-cache-control | no-preview |
| go-import | github.com/python-openxml/python-docx git https://github.com/python-openxml/python-docx.git |
| octolytics-dimension-user_id | 3403760 |
| octolytics-dimension-user_login | python-openxml |
| octolytics-dimension-repository_id | 13592924 |
| octolytics-dimension-repository_nwo | python-openxml/python-docx |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 13592924 |
| octolytics-dimension-repository_network_root_nwo | python-openxml/python-docx |
| 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 | 8968d6d6acc65d74e4df332d23932dd3fd0502a4 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width