PEP 561: Clarify the rules for extension only packages #2318
Description
PEP-0561 does not mention extension packages, packages that consist of just an .so file. Given that PEP-484 mentions extension modules as a use case for stub files, should PEP-561 make it more clear what the ideal layout of an extension only package is?
It appears to be valid to have a package structure like the following:
.../site-packages/
mypackage/
__init__.pyi
py.typed
mypackage.cpython-37m-x86_64-linux-gnu.so
Activity
AA-Turner commented on Feb 9, 2022
We rarely update Accepted PEPs -- this might be better to add to typing documentation. Pinging @ethanhs as author and @JelleZijlstra as a typing ecosytem expert for where the best place to put this information would be (CPython typing docs, python/typing docs, etc).
A
emmatyping commented on Feb 9, 2022
PEP 561 does say
So I think your layout is correct. I think this could be clarified in the python/typing docs.
JelleZijlstra commented on Feb 9, 2022
Yes, an issue on the PEPs repo isn't the right place to discuss this. I think we can put it in https://typing.readthedocs.io/en/latest/ (still under construction), so feel free to open an issue over at github.com/python/typing.
AWhetter commented on Feb 10, 2022
I've opened an issue with typing, which is linked above. Thank you for the help everyone!