fix: Expose to_pandas_kwargs in read_parquet for pyarrow engine

[FilipRazek]

• closes ENH: Expose to_pandas_kwargs in read_parquet for pyarrow engine #49236
• Tests added and passed if fixing a bug or adding a new feature
• All code checks passed.
• Added type annotations to new arguments/methods/functions.
• Added an entry in the latest doc/source/whatsnew/vX.X.X.rst file if fixing a bug or adding a new feature.

[WillAyd]

Hmm this design feels weird to me. What arguments would realistically be passed through this?

[FilipRazek]

In the underlying issue, the OP needs to send timestamp_as_object=True to .to_pandas, to control how the data is formatted as a dataframe.
If it is not a real concern, I can close this PR.

[phofl]

I am +1 on this, the most important is probably types_mapper, which is a real PITA that this is not possible at the moment

[WillAyd]

Something like read_pandas(to_pandas_kwargs=...) feels strange to me from an API perspective, and has the downside of really intertwining the APIs of the libraries. If we later decide to change the allowable to_pandas_kwargs or pyarrow decides to change their API it would be quite messy

Why not just encourage users to call pa.parquet.read_table in such a case directly?

[FilipRazek]

Would updating the documentation be sufficient in your opinion?

[github-actions]

This pull request is stale because it has been open for thirty days with no activity. Please update and respond to this comment if you're still interested in working on this.

[FilipRazek]

@WillAyd ?

[WillAyd]

Sure I think documenting this is a reasonable approach

[mroeschke]

Thanks for the pull request, but it appears to have gone stale. If interested in continuing, please merge in the main branch, address any review comments and/or failing tests, and we can reopen.