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

Guenter Milde via Docutils-users <[email protected]> Wed, 22 Dec 2021 09:04:09 -0000 (UTC)
Newsgroups gmane.text.docutils.user
Message-ID <[email protected]>
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



_______________________________________________
Docutils-users mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/docutils-users

Please use "Reply All" to reply to the list.