GitHub user yangdanny97 edited a comment on the discussion: A new home for 
pyarrow-stubs?

I suspect the reason why the manually written stubs are much longer is because 
of overloads, stubgen only generates a single def per function even if you can 
model the runtime behavior more precisely with multiple overloads.

Re: docstrings in stubs, there are 
[tools](https://github.com/AThePeanut4/docify) that can automatically apply 
them to stubs (perhaps as a build step when you publish the package) without 
needing to check them in and manually keep them in sync.

This section of the typing spec briefly discusses the tradeoffs of docstrings 
in stubs: 
https://typing.python.org/en/latest/guides/writing_stubs.html#docstrings





GitHub link: 
https://github.com/apache/arrow/discussions/45919#discussioncomment-14265165

----
This is an automatically sent email for [email protected].
To unsubscribe, please send an email to: [email protected]

Reply via email to