[Python-Dev] PEP 561: Distributing and Packaging Type Information (original) (raw)

Antoine Pitrou solipsis at pitrou.net
Fri Oct 27 05:43:20 EDT 2017

On Fri, 27 Oct 2017 11:31:04 +0200 Antoine Pitrou <solipsis at pitrou.net> wrote:

On Thu, 26 Oct 2017 15:42:19 -0700 Ethan Smith <ethan at ethanhs.me> wrote: > Stub Only Packages > '''''''''''''''''' > > For package maintainers wishing to ship stub files containing all of their > type information, it is prefered that the *.pyi stubs are alongside the > corresponding *.py files. However, the stubs may be put in a sub-folder > of the Python sources, with the same name the *.py files are in. For > example, the flyingcircus package would have its stubs in the folder > flyingcircus/flyingcircus/. This path is chosen so that if stubs are > not found in flyingcircus/ the type checker may treat the subdirectory as > a normal package. The normal resolution order of checking *.pyi before > *.py will be maintained.

I am not sure I understand the rationale for this. What would be the problem with looking for the stubs in a directory named, e.g; "flyingcircus/typing"?

I just saw Nathaniel asked the same question above. Sorry for the noise!

Regards

Antoine.

More information about the Python-Dev mailing list