Re: [Docutils-users] Type hints for Docutils - docutils-stubs or types-docutils?

[Guenter M. <mi...@us...>]

Dear Matt,

On 2021-12-21, Matt Documatt wrote:
> Hi, there are at least two projects trying to do the same - provide
> type hints for Docutils.

> In past, I used docutils-stub
> (https://github.com/tk0miya/docutils-stubs), but it doesn't cover a few
> past versions. It is the work of great Sphinx guy Takeshi Komya.

> Recently, I discovered types-docutils
> (https://pypi.org/project/types-docutils/) that look "official" as it
> is part of typeshed.

> Which one to use? Who maintains the second one?

Both are 3rd party projects. While Takeshi Komya is a regular
contributor to docutils-devel and the ticket system, types-docutils is
completely independent. It seems to be a "community project" with several
contributors visible in
https://github.com/python/typeshed/tree/master/stubs/docutils.
I am not aware of problem reports for either of them.


After dropping support for Python 2.7, Docutils may start annotating public
classes, functions, and methods.

Günter