
@Paul
... missing resource is a central set of typing documentation that includes examples, FAQs and best practices as well as reference materials
Like Sebastian, I agree, and this is something we're making progress on.
... easy way of testing that the stubs are correct
mypy ships with a tool called stubtest. It's what typeshed uses to validate itself against CPython. I recently wrote up documentation for it, see here: https://mypy.readthedocs.io/en/latest/stubtest.html
A lot of the frustration I see being expressed here (including my own) seems to come from the fact that it's so difficult to actually take that sort of "I can ignore it if I don't use it"
Thanks for not staying quiet and helping us make typing better. In particular, I think one takeaway from this thread is that a lot of our documentation is focussed on "how to get started with typing my code", and not much addressed at library authors with limited time to deal with typing questions (like "what is a PEP 561" and "if my type hints are incomplete does that cause problems for my users") On Thu, 2 Dec 2021 at 15:34, Rob Cliffe via Python-Dev < python-dev@python.org> wrote:
I assume you accidentally pressed Send prematurely. Still, maybe you have inadvertently listed everything that is agreed about typing PEPs. π Rob Cliffe
On 02/12/2021 23:20, Christopher Barker wrote:
for library authors.
Providing high quality stubs and the best user experience is not easy. But I believe that referring people to typeshed can help.
This is actually very helpful. It provides an answer for open source projects for which do users want typing.
One can say to the users that want type stubs for the library that they are encouraged to contribute those stubs to type shed themselves and once they have been tested and vetted they can be included in the project.
itβs not unlike any other feature request. The developer of an open source project is under no obligation to provide any feature asked for, but a well-managed project will encourage useful contributions from users.
-CHB -- Christopher Barker, PhD (Chris)
Python Language Consulting - Teaching - Scientific Software Development - Desktop GUI and Web Development - wxPython, numpy, scipy, Cython
_______________________________________________ Python-Dev mailing list -- python-dev@python.org To unsubscribe send an email to python-dev-leave@python.orghttps://mail.python.org/mailman3/lists/python-dev.python.org/ Message archived at https://mail.python.org/archives/list/python-dev@python.org/message/ASO2PUTE... Code of Conduct: http://python.org/psf/codeofconduct/
_______________________________________________ Python-Dev mailing list -- python-dev@python.org To unsubscribe send an email to python-dev-leave@python.org https://mail.python.org/mailman3/lists/python-dev.python.org/ Message archived at https://mail.python.org/archives/list/python-dev@python.org/message/7AF22G3S... Code of Conduct: http://python.org/psf/codeofconduct/