[Python-Dev] PEP 561: Distributing and Packaging Type Information

Antoine Pitrou solipsis at pitrou.net
Fri Oct 27 05:31:04 EDT 2017

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;



More information about the Python-Dev mailing list