python-openxml/python-docx

Request for Complete Typing Support in python-docx

taabishm2 opened this issue · 1 comments

python-docx currently lacks type hints. This absence causes numerous type errors when running mypy, making it difficult to use the library in type-checked codebases. mypy output indicates multiple type errors throughout python-docx, including incompatible types in assignments, missing return statements, and argument type mismatches.

Task: Add type hints directly to the codebase to provide static typing support compliant with PEP 561. Alternatively, create or support an external stub package (e.g., types-docx).

scanny commented

Try updating your version of python-docx. Those were added recently. There might still be some missing further down in the library but the API you're likely to use should have good coverage.