GitHub user dangotbanned edited a comment on the discussion: A new home for pyarrow-stubs?
> They are available from IPython, why would they not be available from IDEs? > The question is, why would users need docstrings in stubs if the stubs are > shipped with PyArrow itself? @pitrou the issue is you need an `IPython` kernel running to see most `pyarrow` docstrings. So any packages downstream from `pyarrow` that wants static typing either needs to: - develop in an dynamic environment - or do a lot of context switching to refer to [api docs](https://arrow.apache.org/docs/python/api.html) In [`narwhals`](https://github.com/narwhals-dev/narwhals), we haven't updated to the `pyarrow-stubs` version that has them yet - so we currently see this in an IDE <img width="900" alt="image" src="https://github.com/user-attachments/assets/c66701e1-60fe-42fe-bcf7-6d41aab0508c"; /> That is a pretty big difference to a package that defines annotations and docstrings inline <img width="900" alt="image" src="https://github.com/user-attachments/assets/180787b8-eb1d-4eb1-82ae-17df6b366732"; /> Fully sympathise with you though that the `cython` aspect complicates things 😔 GitHub link: https://github.com/apache/arrow/discussions/45919#discussioncomment-14275856 ---- This is an automatically sent email for [email protected]. To unsubscribe, please send an email to: [email protected]
