datapythonista commented on PR #750: URL: https://github.com/apache/datafusion-python/pull/750#issuecomment-2224424124
Thanks @simicd, this is very helpful. I was assuming they'd use the `__doc__` attribute, but seems like VS Code is internally using pylance which is static code analyzer and it only works when the docstring is written below the class or object definition. For pandas that means that half of the docstrings won't work either (I guess that's what you meant when you were talking about Polars). Not sure if it'd be feasible to automatically generate all the Python wrappers when packaging, with the PyO3 docstrings. That would solve both the docs problem and the maintenance problem. But not sure how complex that could be, and if more difficult to maintain than the wrappers themselves. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: github-unsubscr...@datafusion.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org --------------------------------------------------------------------- To unsubscribe, e-mail: github-unsubscr...@datafusion.apache.org For additional commands, e-mail: github-h...@datafusion.apache.org
